Rozdział 24 · Co dalej? Roadmap Python- deweloperPierwszy wkład w Open Source
Mały wkład do sprawdzenia, szacunek dla zasad projektu, review i licencji.
Pierwszy depozyt może być niewielki
Open Source nie wymaga zaczynać od nowego algorytmu w CPython. Poprawka literówki, powtarzalny bug report, test dla potwierdzonego błędu lub wyjaśnienie przykładu może być wartościowym wkładem. Wartość określana jest regułami konkretnego projektu i jakością interakcji.
Sekwencja robocza
- Wybierz projekt: sprawdzić zakres, działalność, licencję i przydatność swoich umiejętności.
- Przeczytaj README: rozumieć przydział, instalację i wspierane wersje.
- Przeczytaj CONTRIBUTING: stosować code of conduct, szablony i polecenia walidacyjne.
- Wybierz Issue: znajdź małe zweryfikowane zadanie lub uzgodnij nowe.
- Powtórz: zapisać minimalny scenariusz w obsługiwanej wersji.
- Utwórz fork lub branch: stosować się do zasad projektu i wyizolować zmianę.
- Wprowadź zmianę: diff skupiać się i nie mieszać niezwiązanych z tym zmian.
- Przeprowadz testy: dodać weryfikowalny dowód i przeprowadzić lokalne weryfikacje.
- Otwórz Pull Request: opisz powód, zakres i przeprowadzoną kontrolę.
- Przejdź review: spokojnie odpowiadać na pytania oraz omawiać żądania i kompromisy.
- Wprowadź poprawki: zaktualizować kod i testy; po rozwiązaniu podziękować uczestnikom.
Umiejętności społeczne są częścią inżynierii
Towarzyszący projektowi mają mało czasu. Krótki kontekst, powtarzalny przykład i ukierunkowany diff skracają czas na review.. Niezgody omawiaj poprzez wymagania i kompromisy. Nie traktuj uwagi do kodu jako oceny osoby i nie wymagaj natychmiastowej odpowiedzi.
Licencje i pochodzenie kodu
Publicznie dostępny kod nie oznacza pozwolenia na jego kopiowanie bez warunków. Przeczytaj licencję projektu źródłowego i docelowego, zachowaj obowiązkowe powiadomienia i nie wklejaj kodu nieznanego pochodzenia. Jeśli warunki są niejasne, zadaj pytanie opiekunom projektu lub wybierz własną implementację. To zasada edukacyjna, a nie porada prawna.