Witamy w BeeWare Sprints!
Witamy! Cieszymy się, że zdecydowałeś się do nas dołączyć! Jeśli jeszcze jeszcze nie przedstawiłeś się jednemu z członków zespołu Bee, zrób to. Po Gdy już to zrobisz, wróć tutaj, aby rozpocząć.
Co to jest sprint?
Sprint to nieustrukturyzowana okazja do spędzenia kilku godzin lub dni na pracując wspólnie nad projektem Open Source. Często są one powiązane z z konferencją; sprint po konferencji stanowi okazję do przekształcenia energii, entuzjazmu i zainteresowania, które wygenerowała konferencja w ulepszenia oprogramowania, z którego korzystamy na co dzień.
Sprinty są również okazją do wprowadzenia ludzi w proces współtworzenia projektu. Mamy nadzieję, że będziesz się tak dobrze bawić podczas sprintu, że wrócisz do domu i będziesz kontynuować wnosić swój wkład!
Nie ma znaczenia, ile masz doświadczenia. masz. Podczas poprzednich sprintów, połączyliśmy wkład osób na wszystkich poziomach doświadczenia - uczniowie szkół średnich, niedawni absolwenci bootcampów, ludzie, którzy nie uważają się za programistów i doświadczonych deweloperów. Bez względu na poziom doświadczenia - możemy znaleźć sposób, abyś mógł wnieść swój wkład.
Kod to nie jedyny sposób, w jaki można wnieść swój wkład. Projekt taki jak BeeWare to znacznie więcej niż tylko kod - potrzebujemy ludzi do pisania, korekty i tłumaczenia dokumentacji; potrzebujemy ludzi do poprawy projektowania stron internetowych; nawet proces przechodzenia przez błędy, które zostały zgłoszonych lata temu i ustalanie, czy zostały one naprawione po drodze jest cennym wkładem.
Wstępne pytania
Aby rozpocząć, zadamy kilka pytań, abyśmy mogli ocenić Twoje zainteresowania i doświadczenie. Pomoże nam to znaleźć najlepszy sposób na wniesienie swojego wkładu. Przeanalizuj pytania, zrób notatki, a następnie znajdź członka Bee Team i podziel się swoimi odpowiedziami. Jeśli nie rozumiesz pytania - nie przejmuj się tym! Daj nam znać, co co wiesz, a my będziemy pracować razem, aby to rozgryźć.
**Czy korzystałeś wcześniej z BeeWare?
Jeśli jeszcze tego nie zrobiłeś, zacznij od zapoznania się z BeeWare Tutorial. Da ci to wprowadzenie do tego, czym jest projekt BeeWare i jak jego elementy projektu pasują do siebie. Jeśli napotkasz jakiekolwiek problemy podczas samouczka, rób notatki - ponieważ upewnienie się, że nikt inny nie ma tego samego to świetny temat na pierwszy wpis!
Po ukończeniu samouczka przynajmniej do kroku 4, przejdź do następnego pytania. następnego pytania.
**Jaki sprzęt komputerowy masz ze sobą?
Sprzęt, który posiadasz, nakłada praktyczne ograniczenia na to, do czego możesz się przyczynić. można wnieść. Na przykład, jeśli masz laptopa z systemem Windows, nie będziesz w stanie nie będziesz w stanie pracować nad niczym związanym z iOS. Czy twój laptop działa pod kontrolą systemu Windows, macOS, Linux lub innego? Czy twój telefon jest urządzeniem z systemem iOS lub Android? Czy urządzenia zostały dostarczone przez przez pracodawcę, czy są to urządzenia osobiste?
**Jakie masz doświadczenie w pisaniu kodu w Pythonie?
Jesteś nowy w programowaniu? Weteranem Pythona? Weteranem kodowania, który który dopiero zaczął uczyć się Pythona? Świeżo upieczonym absolwentem bootcampu? Chcemy znaleźć problem, który jest dobrze dopasowany do Twojego poziomu doświadczenia.
**Czy jesteś zaznajomiony z procesami kontrybucji na Githubie?
Czy korzystasz z GitHub (lub podobnej witryny do udostępniania kodu) do hostowania swojego własnego kodu lub współtworzenia projektów innych osób? Czy wiesz, czym jest CI (ciągła integracja)? Czy brałeś udział w projekcie, który ma haki pre-commit? Gdybym poprosił cię o "rebase twojego PR względem main", czy wiedziałbyś co zrobić?
**Czy uczestniczyłeś wcześniej w projekcie Open Source?
Czy brałeś udział w sprincie w przeszłości? Czy kiedykolwiek przesłałeś PR (pull request) do projektu Open Source? Czy wiesz, jak używać Github do tworzenia pull requestów?
**Czy masz jakieś inne specjalne umiejętności, które mogą być przydatne?
Czy znasz API GUI (takie jak Winforms, Cocoa lub GTK)? Czy masz dogłębną wiedzę na temat wewnętrznych aspektów danego systemu operacyjnego? Czy jesteś ekspertem w języku programowania innym niż niż Python? Jeśli nie masz żadnych specjalnych umiejętności, to nie jest to żaden problem. ale jeśli mamy w swoich rękach guru Windows, chcemy mieć pewność, że te umiejętności są upewnić się, że te umiejętności zostaną dobrze wykorzystane.
**Dlaczego do nas dołączyłeś i czym się interesujesz?
"Brzmisz jak przyjazny projekt" to całkiem dobra odpowiedź. Jeśli jednak jest więcej powodów, dla których dołączyłeś do nas dzisiaj, daj nam znać. Jesteś zainteresowany rozwojem mobilnym lub desktopowym? Opakowania? Strony internetowe? Aplikacje konsolowe? Jeśli nie masz konkretnego zainteresowania - co wydaje się najbardziej interesujące na podstawie tego, co do tej pory widziałeś o BeeWare? do tej pory?
Teraz znajdź członka zespołu Bee Team, aby podzielić się swoimi odpowiedziami. Mogą zadać zadać kilka dodatkowych pytań; ale wtedy wskażą ci kierunek obszar, w którym powinieneś być w stanie wnieść swój wkład.
Znajdź swój problem
Jeśli rozmawiałeś z członkiem Bee Team, prawdopodobnie wskazał ci on część projektu BeeWare. część projektu BeeWare, w której możesz wnieść swój wkład. może nawet zasugerował konkretną kwestię do pracy. Jeśli nie konkretnej sprawy, prawdopodobnie wskazali ci "Dobre pierwsze sprawy" dla tego projektu. Good First Issues" dla tego projektu. Co to oznacza?
GitHub udostępnia listę problemów, która pozwala BeeWare (i innym projektom) śledzić wszystkie zgłoszone problemy. projektom) śledzenie wszystkich zgłoszonych problemów - w tym Obejmuje to jawne błędy, nieoczekiwane zachowanie, które może być błędem, prośby o nowe funkcje, prośby o więcej dokumentacji - wszystko co może być sposobem na ulepszenie BeeWare. W miarę zgłaszania nowych błędów zgłoszone, zespół Bee oznaczy niektóre z nich jako sprawy, które są dobrze dobrze nadają się dla osób, które po raz pierwszy wnoszą swój wkład - sprawy, które nie wymagają natychmiastowej poprawki, ale są dobrze zdefiniowane lub łatwe do odtworzenia i prawdopodobnie mają dobry trop co do przyczyny. Problemy te są oznaczone jako "dobry pierwsza sprawa", aby ułatwić ich znalezienie.
Aby przefiltrować listę zgłoszeń GitHub według etykiety "dobre pierwsze zgłoszenie", wykonaj następujące kroki następujące kroki:
- Kliknij przycisk "Etykiety" nad listą spraw, aby aktywować menu rozwijane. rozwijane menu.
- Wpisz słowo "good" w polu wyszukiwania u góry rozwijanego menu. menu rozwijanego.
- Kliknij "dobry pierwszy numer" na przefiltrowanej liście.
Po znalezieniu zagadnienia, które wydaje się interesujące, przeczytaj wszystkie komentarze do postu i opublikuj komentarz w dyskusji, mówiąc, że że przyglądasz się temu zagadnieniu (np. "Przyglądam się temu podczas sprintów PyCon US 2025"). BeeWare nie "przydziela" zgłoszeń - przyjmujemy zgłoszenia od każdego. od każdego. Jednak w sytuacji sprintu musimy upewnić się, że nie skończymy z dwiema osobami pracującymi nad tym samym zagadnieniem. nad tym samym zagadnieniem - pozostawienie komentarza jest lekkim sposobem na koordynację między współtwórcami. współtwórcami.
Jeśli nadal nie możesz znaleźć niczego, co chciałbyś zrobić, znajdź członka Bee Team a oni pomogą ci zawęzić do konkretnej kwestii.
Konfiguracja środowiska programistycznego
Po znalezieniu błędu należy skonfigurować środowisko programistyczne aby móc pracować nad poprawką. Każdy projekt BeeWare ma swój własny przewodnik:
Jeśli projektu nie ma na tej liście, sprawdź README projektu, aby uzyskać szczegółowe informacje jak go skonfigurować. Jeśli którakolwiek z instrukcji nie ma sensu (lub nie możesz znaleźć tych instrukcji), znajdź członka zespołu Bee Team, a a oni ci pomogą. A jeśli uważasz, że możesz poprawić instrukcje, aby inne osoby nie napotkały tego samego problemu, ulepszenie jest cennym wkładem!
Teraz możesz zacząć pracować nad swoim problemem!
Co się stanie po przesłaniu mojego PR?
Po przesłaniu pull requesta i przejściu przez niego wszystkich automatycznych kontroli wszystkie automatyczne kontrole, jesteś gotowy do przeglądu. Poinformuj jednego z członków zespołu zespołu, że masz PR gotowy do przeglądu, a oni się nim zajmą. przyjrzy.
Jeśli jest to twój pierwszy PR, jest całkiem prawdopodobne, że recenzja znajdzie pewne problemy. problemy. Może to być przypadek brzegowy, którego nie wziąłeś pod uwagę, lub konwencja konwencja kodu, której nie przestrzegałeś. Nie zniechęcaj się! Nikt - nawet nawet główny zespół - nie otrzymuje PR-ów w 100% poprawnych za pierwszym razem.
Gdy PR przejdzie pomyślnie weryfikację, recenzent połączy PR - i gotowe. i gotowe! Gratulacje - przyczyniłeś się do rozwoju BeeWare! Jeśli jest to twój pierwszy wkład w BeeWare, zdobyłeś również BeeWare Challenge Coin - znajdź członka zespołu głównego zespołu, a on da ci monetę!
Pomocy! Utknąłem!
Jeśli utkniesz w jakimkolwiek punkcie po drodze, znajdź członka zespołu Bee Team. Nie bój się zadać każdego pytania. Jeśli utkniesz, chcemy Cię z niego wyciągnąć. Jeśli jesteś zdezorientowany, to dlatego, że temat jest skomplikowany, a my nie wyjaśniliśmy go wystarczająco dobrze. Jesteśmy chętni do pomóc - i chcemy mieć pewność, że sprint zakończy się sukcesem.
What if I don't complete my contribution during the sprint?
No problem! You can submit a contribution at any time. A goal of the sprints is to encourage and empower you to continue contributing throughout the rest of the year. The Bee Team are available to help with any part of this process.
If you were already working on a GitHub issue or submitted a PR, you can continue to communicate through GitHub. If you have other questions or need real-time help, the best place to find us is the BeeWare Discord server. We're looking forward to continuing to work with you!