Jak wnieść wkład w Open Source?

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

Transcript of Jak wnieść wkład w Open Source?

Page 1: Jak wnieść wkład w Open Source?

Jak wnieść wkładw Open Source?

@tomaszbak@selleo

Page 2: Jak wnieść wkład w Open Source?

O mnie

● Selleo (software development house)

● Ruby On Rails od 2005

● programista “Full Stack”

Page 3: Jak wnieść wkład w Open Source?

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

Page 4: Jak wnieść wkład w Open Source?

Zalety Open Source

● swobodne wykorzystanie

● społeczność użytkowników

● szybkość innowacji

Page 5: Jak wnieść wkład w Open Source?

Problemy Open Source

● konieczność częstej aktualizacji

● zależności komponentów

● zależność od jednej osoby

● jakość kodu, testów i dokumentacji

Page 6: Jak wnieść wkład w Open Source?

Zaangażowanie w Open Source to

● okazja do nauki

● dzielenie się swoją wiedzą

● potwierdzenie naszych umiejętności

Page 7: Jak wnieść wkład w Open Source?

Od czego zacząć?

● dokumentacja● lista błędów● kod i testy● modyfikacje (branche i forki)● CONTRIBUTING.md

Page 8: Jak wnieść wkład w Open Source?

Przykład

● https://github.com/trending?l=javascript● mohebifar/xto6

○ Turn your ES5 code into readable ES6○ Issue: Comments are removed after transpiling

Page 9: Jak wnieść wkład w Open Source?

Pobranie i uruchomienie

[Fork]

git clone [email protected]:tb/xto6.git

npm install

npm test

Page 10: Jak wnieść wkład w Open Source?

Naprawa błędu

● dokumentacja, testy i kod projektu● dokumentacja bibliotek

○ acorn - JavaScript-based JavaScript parser ○ escodegen - ECMAScript code generator

● dodanie testu● zmiany w kodzie

Page 11: Jak wnieść wkład w Open Source?

Opublikowanie poprawki

git checkout -b comments

git commit -m 'keep comments, fixes #19'

git push --set-upstream origin comments

[Create pull request]

Page 12: Jak wnieść wkład w Open Source?

0

1

2

3

comments

Pull Request

https://help.github.com/articles/using-pull-requests/

master

Page 13: Jak wnieść wkład w Open Source?
Page 14: Jak wnieść wkład w Open Source?
Page 15: Jak wnieść wkład w Open Source?

Czynniki sukcesu Pull Request

● jasno zdefiniowany problem

● kompletne rozwiązanie

● uwzględnienie standardów projektu

● minimalna ilość nowego kodu

Page 16: Jak wnieść wkład w Open Source?

Co wyniosłem?

● creationix/nvm - Node Version Manager

● xto6 ma obsługę CoffeeScript

Page 17: Jak wnieść wkład w Open Source?

Inne formy wsparcia

● GitHub ★

● wpis na social media

● artykuł na blogu

● pomoc użytkownikom

● sprawdzenie wersji beta lub Pull Requestu

Page 18: Jak wnieść wkład w Open Source?

Dzięki!

@tomaszbak