Najlepszym miejscem do rozpoczęcia jakiegokolwiek wkładu w open source jest coś, co pasuje do twojej wiedzy, doświadczenia i obszaru zainteresowań.

Przed rozpoczęciem

Zanim zaczniesz wnosić swój wkład, warto zapoznać się z projektem jako całością. jako całości. Jeśli jeszcze nie zapoznałeś się z BeeWare Tutorial, zacznij od niego. To da ci zapoznać się z najważniejszymi narzędziami BeeWare, aby zobaczyć, jak wszystkie pasują do siebie.

Po ukończeniu tego samouczka będziesz gotowy, aby wybrać coś do pracy. do pracy. Jeśli miałeś jakiekolwiek problemy z ukończeniem samouczka - jeśli napotkałeś błąd błąd lub jeśli język użyty do opisania jakiegoś kroku nie był jasny - to świetne miejsce do świetne miejsce, by zacząć! Jeśli uda ci się przełożyć swoje doświadczenia na ulepszenie samouczka, następna osoba, która go wykona, nie napotka tego samego problemu. nie napotka tego samego problemu.

Jeśli jednak twoje doświadczenie z samouczkiem było całkowicie bezproblemowe (i mamy nadzieję, że mamy nadzieję!), oto kilka pomysłów na to, gdzie można się zaangażować, w zależności od umiejętności i zainteresowań.

Programowanie w Pythonie

Walizka

Jeśli chciałbyś wnieść swój wkład w narzędzie, które ma jasno zdefiniowany problem ale wymaga usunięcia błędów i dodania nowych funkcji, Briefcase może być projektem dla ciebie. dla Ciebie. Briefcase jest narzędziem do pakowania projektu Python jako samodzielnej aplikacji GUI. aplikację GUI. Pobiera ono plik konfiguracyjny pyproject.toml i wykorzystuje te dane konfiguracyjne do generowania instalatorów lub dystrybucji pakietów aplikacji.

The Briefcase issue tracker zawiera kolekcję sugestii funkcji (i mniejszą liczbę błędów). Jeśli to twój pierwszy raz, poszukaj jednego z ticketów oznaczonych jako good pierwszy issue - są to zgłoszenia, które zostały specjalnie wybrane. są to wydania, które zostały specjalnie wybrane dla pierwszych współpracowników, ponieważ powinny być stosunkowo proste do wdrożenie. Pomocne może okazać się również filtrowanie zgłoszeń dla platformy, której faktycznie używasz do rozwoju - trudno będzie naprawić błąd trudno będzie naprawić błąd Linuksa, jeśli nie masz maszyny z Linuksem do testowania!

Jeśli chcesz wnieść swój wkład w konkretny projekt, możesz również filtrować pierwsze dobre wydania według konkretnych projektów, korzystając z tych linków:

Wybierz zgłoszenie, zostaw komentarz, że przyglądasz się problemowi i spróbuj opracować pull request implementujący poprawkę!

Programowanie GUI

Jeśli masz doświadczenie z natywną biblioteką widżetów - Cocoa na macOS, GTK+ w systemie Linux, Windows Forms lub natywnymi bibliotekami iOS lub Android, możesz być w stanie pomóc z Toga. Toga to wieloplatformowy zestaw narzędzi widżetów - zapewnia wspólny interfejs dla elementów interfejsu użytkownika, takich jak przyciski i drzewa.

Toga ma już zdefiniowany szereg interfejsów, jednak ich implementacja implementacja tych interfejsów nie jest kompletna na wszystkich platformach. Wybierz widżet i zaimplementuj go na wybranej platformie!

Nawet jeśli nie znasz natywnej biblioteki widżetów, nadal możesz być w stanie pomóc z Toga. Pisanie nowych widżetów jest o wiele mniej skomplikowane niż może się wydawać. Każda platforma posiada dokumentację dotyczącą korzystania z natywnych API, a proces tłumaczenia dokumentacji platformy z innego języka (np. z innego języka (np. Objective C lub C#) jest stosunkowo prostym procesem. stosunkowo prostym procesem. Istniejący kod powinien dać ci kilka wskazówek w jaki sposób można to zrobić, a zespół BeeWare chętnie pomoże w razie potrzeby. pomoże. Wskocz na BeeWare Discord, a zrobimy wszystko, co w naszej mocy, aby pomóc! możemy pomóc!

Even if you're not up for transforming code from one language to another, Toga's core library — as well as Travertino, a subpackage covering styling and layout — are pure Python, and platform-agnostic. Take a look at issues not tagged with a specific platform — many of them can probably be fixed with little or no change to any platform-specific code.

Dokumentacja

Dobra dokumentacja jest niezbędna dla każdego udanego projektu. Wiemy, że Toga i Briefcase wymagają znacznych ulepszeń w ich dokumentacji. Ukończyłeś samouczek; teraz spójrz na dokumentację spojrzeć na dokumentację dla Toga i Briecase. Briefcase i sprawdź, czy możesz znaleźć sposób na ulepszenie samouczków, odniesień i przewodników tematycznych, które tam są tam.

Samouczki

Jednym z najlepszych sposobów na wniesienie wkładu jest upewnienie się, że nasza dokumentacja wprowadzająca i dokumentacja jest solidna jak skała. Wybierz interesujący Cię projekt z pakietu pakietu BeeWare i postaraj się postępować zgodnie z przewodnikiem wprowadzającym i samouczka. Jeśli nie możesz znaleźć przewodnika dla początkujących - to jest to pierwsza rzecz do zgłoszenia!

Podczas pracy z samouczkiem zwróć uwagę na wszystko, co nie ma sensu lub nie działa. ma sensu lub nie działa. Następnie otwórz raport o błędzie dla tych problemów.

Windows

Jeśli jesteś użytkownikiem systemu Windows, BeeWare zdecydowanie może skorzystać z Twojej pomocy. Główny zespół główny zespół używa Linuksa i macOS w codziennym rozwoju, w wyniku czego w rezultacie bardzo łatwo jest o niekompatybilność z systemem Windows. To jest prawie zawsze spowodowane niedopatrzeniem. Identyfikacja - a może nawet problemów z uruchamianiem narzędzi BeeWare w systemie Windows jest ogromną pomoc.

Języki

Czy mówisz w języku innym niż angielski? Obecnie główny zespół są rodzimymi użytkownikami języka angielskiego. Zapewnienie tłumaczenia dokumentacji lub zupełnie nowych samouczków lub przewodników w swoim ojczystym języku języku ojczystym to świetny sposób na wniesienie swojego wkładu. Wybierz projekt, który ma już dokumentację i przetłumacz ten tekst. Alternatywnie, zacznij od zera i napisać zupełnie nowy poradnik.

Jeśli posługujesz się językiem z niełacińskim zestawem znaków (np. rosyjskim lub chińskim) lub chińskim) lub językiem ze skryptem od prawej do lewej (np. hebrajskim lub arabski), będziesz w stanie wskazać wszystkie miejsca, w których przyjęliśmy proste kodowanie ASCII lub konwencje od lewej do prawej. Wybierz dowolny z aktywnych projektów BeeWare i spróbuj użyć go w swoim ojczystym języku. języka. Jeśli napotkasz jakieś problemy, zgłoś je jako błędy. jeśli czujesz się szczególnie odważny, sprawdź, czy możesz znaleźć sposób na naprawić błąd.

Praktyczne zastosowanie

Jednym z najlepszych sposobów na określenie, gdzie są nasze luki - zarówno w dokumentacji, jak i API dokumentacji i interfejsach API - jest to, aby ludzie faktycznie używali BeeWare do budowania czegoś. Tak więc, jeśli żaden z dotychczasowych pomysłów nie brzmi interesująco, dlaczego nie spróbować czegoś własnego? Skorzystaj z pakietu BeeWare, aby zbudować aplikację zawsze chciałeś - wizualizację źródła danych na pulpicie lub aplikację mobilną do śledzenia aplikacja mobilna do śledzenia aktywności - cokolwiek to jest, spróbuj to zbudować. spróbuj ją zbudować.

Możemy niemal zagwarantować, że napotkasz problemy. BeeWare jest wciąż bardzo młody projekt. Ale problemy, które napotkasz, dadzą nam świetną wskazówkę wskazówkę, czym należy się zająć. Wskaże nam, jakich widżetów widżety i jaką dokumentację należy poprawić. Tak więc, gdy napotkasz problemy z tworzeniem własnej aplikacji, rejestruj problemy z projektami BeeWare, które spowodowały problemy. które spowodowały problemy. Umożliwi nam to zidentyfikowanie tego, co musimy poprawić - i może to być nawet źródło inspiracji dla Ciebie, aby wnieść swój wkład! wnieść swój wkład!

Uczestnicy po raz pierwszy

Chcesz zacząć od małego? Gdy już trochę poszperasz w samouczkach, sprawdź wydania BeeWare oznaczone jako [good first issue]