Przejdź do treści

Przewodnik po składkach

Istnieje wiele sposobów, aby wesprzeć BeeWare. Niniejsze przewodniki zawierają wszystkie informacje niezbędne do wniesienia swojego wkładu.

Co mogę zrobić?

Napraw problem

Najbardziej oczywistym wkładem, jaki możesz wnieść, jest napisanie kodu, który naprawi znany błąd.

Wdrożenie nowej funkcji

Czy w BeeWare brakuje funkcji, którą chciałbyś zobaczyć? Możesz wdrożyć nową funkcję.

Napisz dokumentację

Żadna funkcja nie jest kompletna, dopóki nie zostanie dobrze udokumentowana. Pisanie dokumentacji to sposób na wniesienie wkładu, który nie wymaga pisania kodu.

Klasyfikacja problemu

Za każdym razem, gdy ktoś zgłasza nową usterkę, należy ją poddać ocenie. Ocena usterki polega na przeanalizowaniu informacji przekazanych przez zgłaszającego i próbie odtworzenia opisanego przez niego problemu.

Sprawdź pull request

Po przesłaniu pull requestu musi on zostać sprawdzony, zanim będzie można go połączyć. Niezależnie od tego, czy dobrze znasz treść, prawdopodobnie możesz pomóc w sprawdzaniu pull requestu.

Zaproponuj nową funkcję

Masz sugestię lub pomysł na nowe uzupełnienie jednego z narzędzi BeeWare? Możesz zaproponować nową funkcję do rozważenia.

Przetłumacz treść

BeeWare prowadzi różnorodną dokumentację w wielu językach. Jeśli znasz język inny niż angielski, możesz pomóc w tłumaczeniu treści.

Użyj narzędzi

Masz pomysł na aplikację stworzoną przy użyciu Toga? Masz już aplikację, którą można spakować za pomocą Briefcase? Możesz skorzystać z narzędzi i podzielić się swoimi wrażeniami.

Jak mogę pomóc?

Skonfiguruj środowisko programistyczne

Zanim zaczniesz współpracować z BeeWare, musisz skonfigurować swoje środowisko programistyczne.

Odtwórz problem

Przed naprawieniem problemu należy sprawdzić, czy rzeczywiście występuje. Odtworzenie problemu jest również ważną częścią procesu selekcji.

Praca z gałęzią

Przygotowując się do przesłania wkładu, zawsze pracuj z gałęzią.

Unikaj rozszerzania zakresu projektu

Ważne jest, aby zachować koncentrację i unikać rozszerzania zakresu prac w ramach swojego wkładu.

Zaproponuj nową funkcję

Aby zaproponować nową funkcję, wykonaj następujące czynności.

Pisz, uruchamiaj i testuj kod

Aby zaktualizować lub dodać kod, musisz napisać, uruchomić i przetestować swój kod.

Dokumentacja dotycząca kompilacji

Aby zaktualizować dokumentację lub wnieść swój wkład, musisz umieć tworzyć dokumenty.

Napisz dokumentację

Aby wnieść swój wkład w dokumentację, należy napisać nową treść lub zaktualizować istniejącą treść.

Dodaj informację o zmianie

Do każdego pull requestu należy dołączyć informację o zmianach.

Prześlij żądanie ściągnięcia

Gdy zmiany będą gotowe, należy przesłać pull request do weryfikacji.

Napisz recenzję

Jeśli czujesz się komfortowo, możesz przekazać opinię na temat wkładu innej osoby.

Przetłumacz treść

BeeWare korzysta z Weblate do tłumaczeń, co wymaga wykonania kilku kroków, aby rozpocząć pracę.

Zgłoś nową sprawę

Jeśli napotkasz nowy problem lub błąd, warto zgłosić problem.

Co będzie dalej?

Przegląd pull requestów

Po przesłaniu pull requestu następnym krokiem jest przegląd PR.

Proces zwolnienia

Połączone wkłady przejdą przez proces publikacji.

Przewodniki stylistyczne

Przewodnik po stylu kodowania

Oto wytyczne dotyczące przekazywania kodu do projektów BeeWare.

Przewodnik stylistyczny dotyczący dokumentacji

Oto wytyczne dotyczące dostarczania dokumentacji do projektów BeeWare.