Jak wnieść wkład w Open Source?

1. Jak wnieść wkład
w Open Source?
@tomaszbak
@selleo

2. O mnie
● Selleo (software development house)
● Ruby On Rails od 2005
● programista “Full Stack”

3. Open Source to
● dostępność kodu źródłowego
● swobodna redystrybucja (także modyfikacji)
● niedyskryminowanie obszarów zastosowań
Pełna definicja - http://opensource.org/osd

4. Zalety Open Source
● swobodne wykorzystanie
● społeczność użytkowników
● szybkość innowacji

5. Problemy Open Source
● konieczność częstej aktualizacji
● zależności komponentów
● zależność od jednej osoby
● jakość kodu, testów i dokumentacji

6. Zaangażowanie w Open Source to
● okazja do nauki
● dzielenie się swoją wiedzą
● potwierdzenie naszych umiejętności

7. Od czego zacząć?
● dokumentacja
● lista błędów
● kod i testy
● modyfikacje (branche i forki)
● CONTRIBUTING.md

8. Przykład
● https://github.com/trending?l=javascript
● mohebifar/xto6
○ Turn your ES5 code into readable ES6
○ Issue: Comments are removed after transpiling

9. Pobranie i uruchomienie
[Fork]
git clone git@github.com:tb/xto6.git
npm install
npm test

10. Naprawa błędu
● dokumentacja, testy i kod projektu
● dokumentacja bibliotek
○ acorn - JavaScript-based JavaScript parser
○ escodegen - ECMAScript code generator
● dodanie testu
● zmiany w kodzie

11. Opublikowanie poprawki
git checkout -b comments
git commit -m 'keep comments, fixes #19'
git push --set-upstream origin comments
[Create pull request]

12. 0
1
2
3
comments
Pull Request
https://help.github.com/articles/using-pull-requests/
master

15. Czynniki sukcesu Pull Request
● jasno zdefiniowany problem
● kompletne rozwiązanie
● uwzględnienie standardów projektu
● minimalna ilość nowego kodu

16. Co wyniosłem?
● creationix/nvm - Node Version Manager
● xto6 ma obsługę CoffeeScript

17. Inne formy wsparcia
● GitHub ★
● wpis na social media
● artykuł na blogu
● pomoc użytkownikom
● sprawdzenie wersji beta lub Pull Requestu

18. Dzięki!
@tomaszbak