Etykiety to przydatna funkcja GitHuba, która umożliwia filtrowanie problemów i żądań scalenia. Pomagają znaleźć ciekawe zadania, które pasują do Twojego poziomu doświadczenia.
W przypadku naszych repozytoriów dodawanie nowych etykiet do problemów jest obsługiwane wyłącznie przez główny zespół Blockly, aby mieć pewność, że nie trafią one w niewłaściwe miejsce.
Rozmiar
Niektóre problemy są niewielkie i przyjemne, a inne mogą wymagać tygodni pracy. Te etykiety pomagają określić, ile pracy prawdopodobnie będzie wymagać rozwiązanie problemu.
- Dobry pierwszy problem: te problemy są odpowiednie dla osób, które dopiero zaczynają korzystać z repozytorium. Powinny one zajmować mniej niż pół dnia pracy i wymagać ograniczonej znajomości bazy kodu. Możesz od razu zacząć pracować nad tymi problemami bez konieczności uzyskania zgody zespołu.
Jurysdykcja
Praca nad powszechnie używanym repozytorium może być delikatnym procesem, a niektóre problemy mogą być bardziej wrażliwe niż inne. Te etykiety pomagają określić, które problemy są otwarte na współtworzenie, a których należy unikać.
- Wymagana pomoc: Te problemy są zarezerwowane dla współtwórców. Często są to funkcje, które zdaniem zespołu podstawowego byłyby przydatne, ale nie ma on czasu na ich wdrożenie. Mogą one wymagać dyskusji lub wdrożenia, dlatego sprawdź etykietę stanu, aby dowiedzieć się, jakie działania są potrzebne. To dobre miejsce, aby znaleźć ciekawe projekty kreatywne.
- Wewnętrzne: te problemy są zarezerwowane dla członków zespołu podstawowego. Często są to wrażliwe lub złożone błędy, które wymagają specjalnej dyskusji. Lepiej ich unikać, ponieważ sytuacja w ich pobliżu może się szybko zmienić.
- Żadne: problemy, które nie mają żadnej etykiety, mogą być rozwiązywane przez osoby współtworzące projekt i członków zespołu głównego. Jeśli widzisz nieoznaczony problem, który Cię interesuje, możesz go rozwiązać.
Stan
Niektóre problemy (zwłaszcza prośby o dodanie funkcji) przechodzą kilka etapów, zanim zostaną uznane za „zamknięte”. Te etykiety informują, na jakim etapie jest obecnie problem, dzięki czemu możesz dowiedzieć się, co należy zrobić dalej.
- Dyskusja: te problemy są w fazie dyskusji, co oznacza, że przed wdrożeniem trzeba jeszcze odpowiedzieć na pewne pytania. Jeśli masz jakieś przemyślenia na ten temat, zostaw komentarz. Zawsze chętnie poznamy Twoją opinię.
- Wdrażanie: Te problemy zostały już wystarczająco omówione, aby można było je jasno zdefiniować, i przeszły do fazy wdrażania. Są one w trakcie wdrażania lub już zostały wdrożone. Jeśli chcesz się zająć którymś z tych problemów, przeczytaj cały opis, a potem zostaw komentarz z informacją, nad którą częścią chcesz pracować. Następnie możesz zacząć.
- Żaden: problemy, które nie mają żadnej z tych etykiet, mogą być w dowolnym stanie. Jeśli masz opinię na temat tego, jak należy rozwiązać problem, zostaw komentarz. Jeśli chcesz pracować nad tym problemem, najlepiej zostaw komentarz z pytaniem, czy jest on gotowy do wdrożenia.
Typ
Różne problemy wymagają różnych reakcji. Niektóre wymagają tylko zmiany kilku wierszy kodu, a inne – wielu dyskusji i projektów. Te etykiety informują, jakiego rodzaju działania wymaga dany problem.
- Błąd: Te problemy wskazują na błąd w kodzie. Często wymagają one debugowania, aby zdiagnozować przyczynę problemu, ale niektóre można rozwiązać w mgnieniu oka. Jeśli lubisz zagłębiać się w szczegóły, aby dowiedzieć się, jak działa kod, te numery będą dla Ciebie idealne. Możesz pomóc, naprawiając błąd lub analizując problem i pisząc jasne wyjaśnienie jego głównej przyczyny.
- Prośba o dodanie funkcji: te problemy dotyczą funkcji, które ktoś chciałby dodać. Może to dotyczyć całego repozytorium lub pojedynczego projektu. Jeśli lubisz rozwijać pomysły na projekty i dodawać nowe funkcje, te problemy mogą być dla Ciebie idealne.
- Pytanie: Te problemy dokumentują pytanie, które ktoś ma na temat bazy kodu. Zazwyczaj te pytania są przekierowywane na forum dla programistów, ale jeśli widzisz pytanie, na które możesz odpowiedzieć, nie wahaj się tego zrobić.
Kategoria
To repozytorium zawiera kilka różnych rodzajów projektów, które są przeznaczone dla różnych grup odbiorców. Jeśli interesują Cię samouczki lub wtyczki, te etykiety pomogą Ci znaleźć problemy, które Cię interesują.
- Codelab te problemy dotyczą ćwiczeń z programowania Blockly, czyli zestawu interaktywnych samouczków.
- Przykład: Te problemy dotyczą przykładów Blockly, czyli zestawu samodzielnych wersji demonstracyjnych pokazujących, jak włączać i rozszerzać Blockly.
- Wtyczka: problemy te dotyczą wtyczek Blockly, czyli zbioru rozszerzeń, które dodają funkcje do Blockly.
Projekt
Jeśli chcesz jeszcze bardziej precyzyjnie oznaczać treści, możesz też używać tagów do poszczególnych projektów. Zwykle są one tworzone w przypadku wtyczek, z którymi wiąże się więcej problemów, ale mogą też dotyczyć ćwiczeń z programowania i przykładów. Jeśli interesuje Cię konkretny projekt, te etykiety pomogą Ci znaleźć problemy z nim związane.
Aby sprawdzić, czy projekt, który Cię interesuje, ma etykietę, zapoznaj się z pełną listą etykiet:
Inne
Jak w przypadku każdej kolekcji, jest kilka wyjątków, o których też warto wiedzieć. Te etykiety mogą nie być tak przydatne, gdy szukasz problemu do rozwiązania, ale nadal mogą dostarczać informacji.
- Triage: te problemy nie zostały jeszcze odpowiednio oznaczone przez zespół główny. Problemy z tą etykietą mogą już zawierać inną prostą etykietę, np. błąd lub prośba o funkcję, ale wkrótce prawdopodobnie dodamy kolejne etykiety.
- Zduplikowane: te problemy dokumentują problem, prośbę lub pytanie, które zostały już omówione w innym zgłoszeniu. Ta etykieta informuje, że nie należy odpowiadać na ten problem, tylko na pierwotny.