Etykiety to fajna funkcja GitHuba, która pozwala filtrować problemy i pobierać żądania. Pomagają znaleźć fajne tematy do pracy dopasowane do Twojego poziomu doświadczenia.
W przypadku naszych repozytoriów dodawanie nowych etykiet do problemów zajmuje się wyłącznie podstawowy zespół Blockly, aby mieć pewność, że wszystko nie trafi się w niewłaściwą stronę.
Rozmiar
Niektóre problemy są krótkie i piękne, a ich rozwiązanie może zająć kilka tygodni. Te etykiety pomagają określić, ile pracy prawdopodobnie zajmie dany problem.
- Dobry pierwszy problem: te problemy przydają się osobom, które dopiero zaczynają korzystać z repozytorium. Powinno to zająć mniej niż pół dnia i wymagać niewielkiej znajomości podstaw kodu. Możesz od razu zająć się tymi problemami bez zgody zespołu.
Jurysdykcja
Praca nad popularnym repozytorium może być procesem wrażliwym, a niektóre problemy mogą być bardziej wrażliwe niż inne. Pomagają one określić, które problemy są otwarte, a których należy unikać.
- Potrzebujemy pomocy: Te problemy są zarezerwowane dla współtwórców. Często są to funkcje, które według podstawowego zespołu mogą być przydatne, ale nie mają czasu, by je wdrożyć. Być może konieczne będzie opracowanie lub wdrożenie, dlatego sprawdź etykietę stanu, aby dowiedzieć się, co jest potrzebne. To świetne miejsce, by znaleźć ciekawe projekty.
- Wewnętrzne: te problemy są zarezerwowane dla członków podstawowego zespołu. Często są to błędy o charakterze wrażliwym lub złożone, które wymagają specjalnej uwagi. Lepiej unikać takich działań, bo otoczenie może szybko się zmienić.
- Żadna: problemów, które nie mają żadnej etykiety, nie mogą być naprawiane przez współtwórców ani członków podstawowego zespołu. Jeśli zauważysz problem bez etykiety, który wydaje Ci się ciekawy, zajmij się nim.
Stan
Zanim niektóre problemy (zwłaszcza prośby o dodanie funkcji) zostaną uznane za „zamknięte”, muszą przejść przez kilka etapów. Etykiety te informują, na jakim etapie jest problem, i wiesz, co trzeba zrobić dalej.
- Dyskusja: te kwestie są obecnie na fazie dyskusji, co oznacza, że przed wdrożeniem trzeba odpowiedzieć jeszcze na pewne pytania. Jeśli chcesz podzielić się z nami swoimi przemyśleniami na ten temat, podziel się nimi z nami. Zawsze szukamy dodatkowych informacji.
- Implementacja: te problemy zostały omówione wystarczająco długo, aby zostały jasno zdefiniowane, i przeszły do fazy wdrażania. Czekają na implementację lub są już zaimplementowane. Jeśli interesuje Cię którąś z nich, przeczytaj cały numer, a następnie napisz komentarz, nad którym chcesz popracować, a potem przejdź dalej.
- Żadna: problemy, które nie mają żadnej z etykiet, mogą mieć przypisany stan w żadnym z tych stanów. Jeśli masz pomysł, jak rozwiązać problem, zostaw komentarz. Jeśli chcesz popracować nad tym problemem, napisz komentarz z pytaniem, czy można już go wdrożyć.
Typ
Różne problemy wymagają różnych odpowiedzi. Niektóre wymagają edycji tylko kilku wierszy kodu, a inne wymagają dużo pracy nad projektem i omówienia. Etykiety te informują o typie działania, które jest potrzebne do rozwiązania problemu.
- Błąd: te problemy dokumentują problem z bazą kodu. Często trzeba przeprowadzić debugowanie, aby znaleźć źródło problemu, ale niektóre z nich można szybko rozwiązać. Jeśli chcesz zagłębić się w procesy, aby poznać działanie kodu, te informacje będą dla Ciebie doskonałym rozwiązaniem. Aby pomóc, możesz poprawić błąd lub przeanalizować problem i wyjaśnić jego przyczynę.
- Prośba o dodanie funkcji: Te problemy dokumentują funkcję, którą użytkownik chce dodać. Może to dotyczyć całego repozytorium lub pojedynczego projektu. Jeśli lubisz dopracowywać pomysły i dodawać nowe funkcje, te materiały mogą okazać się idealne dla Ciebie.
- Pytanie: Te problemy dokumentują pytanie o bazę kodu. Pytania są zwykle przekierowywane na forum dla deweloperów. Jeśli jednak napotkasz pytanie, w którym możesz pomóc, wejdź na forum i odpowiedz.
Kategoria
Repozytorium zawiera kilka różnych rodzajów projektów i kilka różnych grup odbiorców. Jeśli pasjonujesz się samouczkami lub lubisz pracę z wtyczkami, te etykiety pomogą Ci znaleźć interesujące Cię problemy.
- Ćwiczenia z programowania: te problemy odnoszą się do laboratoriów z programowania Blockly, czyli pakietu interaktywnych samouczków.
- Przykład: Problemy te odnoszą się do przykładów Blockly, czyli zestawu niezależnych wersji demonstracyjnych pokazujących, jak włączyć i rozszerzyć Blockly.
- Wtyczka: problemy te odnoszą się do wtyczek Blockly, czyli zbioru rozszerzeń, które dodają funkcje Blockly.
Projektach
Jeśli chcesz uzyskać jeszcze więcej szczegółów, możesz skorzystać z tagów poszczególnych projektów. Są one zazwyczaj tworzone na potrzeby wtyczek, z którymi zwykle wiąże się więcej problemów, ale można je też tworzyć na potrzeby ćwiczeń z programowania i przykładów. Jeśli interesuje Cię konkretny projekt, etykiety te pomogą Ci znaleźć związane z nim problemy.
Pamiętaj też, że często dodajemy nowe projekty, więc ta lista może być nieaktualna. Jeśli nie widzisz pozycji dotyczącej interesującego Cię projektu, sprawdź pełną listę etykiet.
- Narzędzia dla programistów: problemy te odnoszą się do pakietu narzędzi deweloperskich, czyli biblioteki typowych narzędzi do tworzenia rozszerzeń Blockly.
- Data pola: problemy te dotyczą pakietu pola daty, czyli pola selektora daty, które korzysta z selektora daty zamknięcia Google.
Inne
Tak jak w przypadku każdej kolekcji, jest też kilka dziwnych rzeczy, o których warto wiedzieć. Te etykiety mogą nie być tak przydatne, gdy szukasz problemu, nad którym pracujesz, ale mogą zawierać przydatne informacje.
- Test: te problemy nie zostały jeszcze odpowiednio oznaczone przez główny zespół. Problemy z tą etykietą mogą już zawierać inną prostą etykietę, np. błąd lub prośbę o dodanie funkcji, ale wkrótce dodamy więcej etykiet.
- Duplikat: te problemy dokumentują problem, prośbę lub pytanie, które dotyczą już innego problemu. Ta etykieta informuje, że nie należy odpowiadać na ten problem, tylko odpowiedzieć na jego pierwotne zgłoszenie.