Le etichette sono una funzionalità interessante di GitHub che ti consente di filtrare i problemi e di eseguire il pull delle richieste. Ti aiutano a trovare qualcosa di divertente su cui lavorare che sia adatto al tuo livello di esperienza.
Per i nostri repository, l'aggiunta di nuove etichette ai problemi viene gestita esclusivamente dal team principale di Blockly, per evitare che finiscano nel posto sbagliato.
Dimensioni
Alcuni problemi sono in pillole e bellissimi, mentre altri potrebbero richiedere settimane per essere sconfitti. Queste etichette ti aiutano a stabilire quanto lavoro richiederà probabilmente un problema.
- Primo problema positivo: questi problemi sono utili per chi non ha familiarità con il repository. Dovrebbero impiegare meno di mezza giornata di lavoro e avere familiarità con il codebase. Puoi iniziare a lavorare su questi problemi immediatamente, senza l'approvazione del team.
Giurisdizione
Lavorare su un repository di uso comune può essere un processo sensibile e alcuni problemi possono essere più sensibili di altri. Queste etichette ti aiutano a capire quali problemi possono essere contribuiti e quali evitare.
- Richiesta di assistenza: Questi problemi sono riservati ai collaboratori. Spesso si tratta di funzionalità che il team principale pensa essere utili, ma non ha tempo di implementarle. Potrebbero essere necessarie un discussione o un'implementazione, quindi controlla l'etichetta dello stato per capire di cosa si tratta. Qui puoi trovare progetti creativi divertenti.
- Interno: questi problemi sono riservati ai membri del team principale. Spesso si tratta di bug sensibili o complessi che richiedono un'analisi speciale. È meglio evitarli perché la situazione potrebbe cambiare rapidamente.
- Nessuna delle due: i problemi che non hanno alcuna etichetta possono essere risolti dai collaboratori e dai membri del team principale. Se noti un problema senza etichetta che ti sembra interessante, procedi pure.
Stato
Alcuni problemi (in particolare le richieste di funzionalità) passano attraverso alcune fasi diverse prima di poter essere considerati "chiusi". Queste etichette indicano in quale fase si trova al momento un problema, così puoi sapere come procedere.
- Discussione: questi problemi sono in fase di discussione, il che significa che ci sono ancora domande a cui è necessario rispondere prima dell'implementazione. Se hai domande in merito a questo problema, non esitare a lasciare un commento. Siamo sempre alla ricerca di nuovi input.
- Implementazione: questi problemi sono stati discussi sufficientemente da essere stati definiti in modo chiaro e sono passati alla fase di implementazione. Sono in attesa di implementazione o sono già in fase di implementazione. Se ti interessa lavorare su uno di questi, leggi l'intero numero e lascia un commento per indicare su quale parte vuoi lavorare, poi inizia a lavorare.
- Nessuna delle due: i problemi che non hanno alcuna etichetta potrebbero trovarsi in uno dei due stati. Se hai un'opinione su come implementare il problema, lascia un commento. In alternativa, se vuoi lavorare sul problema, ti consigliamo di lasciare un commento per chiedere se è pronto per l'implementazione.
Tipo
Per problemi diversi occorrono risposte diverse. Alcune richiedono solo la modifica di poche righe di codice, mentre altre richiedono molta progettazione e discussione. Queste etichette indicano il tipo di azione necessario per risolvere un problema.
- Bug: questi problemi documentano un problema con il codebase. Spesso è necessario eseguire un po' di debug per diagnosticare la causa del problema, ma alcune possono essere risolte con un occhiolino. Se ti piace approfondire per scoprire come funziona il codice, questi saranno problemi gravi per te. Puoi contribuire correggendo il bug o cercando informazioni per comprendere il problema e scrivendo una spiegazione chiara della causa principale.
- Richiesta di funzionalità: questi problemi documentano una funzionalità che qualcuno vorrebbe aggiungere. Questa opzione può essere applicata al repository nel suo complesso o a un singolo progetto. Se ti piace arricchire le idee di design e aggiungere nuove funzionalità, questi potrebbero essere i problemi perfetti per te.
- Domanda: Questi problemi documentano una domanda che qualcuno ha sul codebase. In genere queste domande vengono reindirizzate al forum per gli sviluppatori, ma se trovi una domanda per cui ritieni di poterti aiutare, non esitare a rispondere e a rispondere.
Categoria
Questo repository contiene diversi tipi di progetti, con alcuni diversi tipi di pubblico di destinazione. Se ti piacciono i tutorial o ti piacciono i plug-in, queste etichette possono aiutarti a individuare i problemi che ti interessano.
- Codelab: questi problemi riguardano i codelab di Blockly, una suite di tutorial interattivi.
- Esempio: questi problemi riguardano gli esempi di Blockly, un insieme di demo indipendenti che mostrano come includere ed estendere Blockly.
- Plugin: questi problemi riguardano i plug-in Blockly, una raccolta di estensioni che aggiungono funzionalità Blockly.
progetto
Per un'analisi ancora più dettagliata, esistono anche tag per i singoli progetti. In genere vengono creati per i plug-in, che tendenzialmente presentano più problemi, ma possono essere creati anche per codelab ed esempi. Se ti interessa un progetto in particolare, queste etichette possono aiutarti a individuare i problemi relativi a quel progetto.
Tieni inoltre presente che vengono aggiunti spesso nuovi progetti, pertanto l'elenco potrebbe diventare obsoleto. Controlla l'elenco completo delle etichette se non visualizzi una voce per il progetto che ti interessa.
- Strumenti di sviluppo: questi problemi riguardano il pacchetto strumenti per sviluppatori, una libreria di utilità comuni per lo sviluppo dell'estensione Blockly.
- Data del campo: questi problemi riguardano il pacchetto campo data, un campo di selezione della data che utilizza il selettore della data di chiusura di Google.
Altro
Come per qualsiasi raccolta di cose, ci sono alcune cose strane che dovresti conoscere. Queste etichette potrebbero non essere così utili quando stai cercando un problema su cui lavorare, ma possono comunque essere informative.
- Triage: questi problemi non sono ancora stati adeguatamente etichettati dal team principale. I problemi con questa etichetta potrebbero includere già un'altra etichetta semplice come bug o richiesta di funzionalità, ma è probabile che a breve vengano aggiunte altre etichette.
- Duplica: questi problemi documentano un problema, una richiesta o una domanda già trattati da un altro problema. Questa etichetta ti informa che non devi rispondere al problema, ma rispondere al problema originale.