Le etichette sono una funzionalità interessante di GitHub che ti consente di filtrare i problemi e le richieste di pull. Ti aiutano a trovare qualcosa di divertente su cui lavorare in base 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 assicurarsi che le cose non finiscano nel posto sbagliato.
Dimensioni
Alcuni problemi sono piccoli e belli, mentre altri potrebbero richiedere settimane per essere risolti. Queste etichette ti aiutano a capire quanto lavoro richiederà probabilmente un problema.
- Good first issue: Questi problemi sono ideali per le persone che non hanno familiarità con il repository. Dovrebbero richiedere meno di mezza giornata di lavoro e una familiarità limitata con la base di codice. Puoi iniziare a lavorare su questi problemi immediatamente, senza l'approvazione del team.
Giurisdizione
Lavorare su un repository ampiamente utilizzato può essere un processo delicato e alcuni problemi possono essere più sensibili di altri. Queste etichette ti aiutano a capire quali problemi sono aperti per il contributo e quali problemi evitare.
- Aiuto richiesto: Questi problemi sono riservati ai collaboratori. Spesso si tratta di funzionalità che il team principale ritiene utili, ma che non ha tempo di implementare. Potrebbero richiedere una discussione o un'implementazione, quindi controlla l'etichetta di stato per vedere di cosa si tratta. È un buon posto per trovare progetti creativi divertenti.
- Interno: Questi problemi sono riservati ai membri del team principale. Spesso si tratta di bug sensibili o complessi che richiedono una discussione speciale. È meglio evitarli perché la situazione potrebbe cambiare rapidamente.
- Nessuno: I problemi che non hanno nessuna etichetta possono essere risolti dai collaboratori e dai membri del team principale. Se vedi un problema senza etichetta che ti sembra interessante, procedi pure!
Stato
Alcuni problemi (in particolare le richieste di funzionalità) passano attraverso diverse fasi prima di poter essere considerati "chiusi". Queste etichette indicano in quale fase si trova attualmente un problema, in modo da sapere cosa deve essere fatto successivamente.
- Discussione: Questi problemi si trovano nella fase di discussione, il che significa che ci sono ancora domande a cui rispondere prima dell'implementazione. Se hai opinioni in merito a questo problema, non esitare a lasciare un commento. Siamo sempre alla ricerca di ulteriori input.
- Implementazione: Questi problemi sono stati discussi a sufficienza da essere definiti chiaramente 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 problemi, leggi l'intero problema e poi lascia un commento indicando la parte su cui vuoi lavorare. A questo punto, puoi iniziare a lavorare.
- Nessuno: I problemi che non hanno nessuna etichetta possono trovarsi in entrambi gli stati. Se hai un'opinione su come dovrebbe essere implementato il problema, lascia un commento. In alternativa, se ti interessa lavorare al problema, è meglio lasciare un commento per chiedere se è pronto per essere implementato.
Tipo
Problemi diversi richiedono risposte diverse. Alcuni richiedono solo la modifica di poche righe di codice, mentre altri necessitano di molta progettazione e discussione. Queste etichette indicano il tipo di azione che dovrà essere eseguita per risolvere un problema.
- Bug: Questi problemi documentano un problema con la base di codice. Spesso richiedono un po' di debug per diagnosticare la causa del problema, ma alcuni possono essere risolti in un batter d'occhio. Se ti piace approfondire il funzionamento del codice, questi saranno problemi perfetti per te. Puoi contribuire correggendo il bug o analizzando il problema e scrivendo una spiegazione chiara della causa principale.
- Richiesta di funzionalità: Questi problemi documentano una funzionalità che qualcuno vorrebbe aggiungere. Questo può essere applicato all'intero repository o a un singolo progetto. Se ti piace sviluppare 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 codice sorgente. In genere queste domande vengono reindirizzate al forum degli sviluppatori, ma se vedi una domanda a cui pensi di poter rispondere, non esitare a intervenire.
Categoria
Questo repository contiene diversi tipi di progetti, con diversi tipi di pubblico di destinazione. Se ti appassionano i tutorial o ti piace lavorare sui plug-in, queste etichette possono aiutarti a trovare 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 autonome che mostrano come includere ed estendere Blockly.
- Plug-in: Questi problemi riguardano i plug-in> Blockly, una raccolta di estensioni che aggiungono funzionalità a Blockly.
Progetto
Se vuoi un controllo ancora più granulare, sono disponibili anche tag per i singoli progetti. Questi vengono in genere creati per i plug-in, che tendono ad avere più problemi correlati, ma possono essere creati anche per i codelab e gli esempi. Se hai un progetto specifico che ti interessa, queste etichette possono aiutarti a trovare i problemi correlati.
Per vedere se esiste un'etichetta per il progetto che ti interessa, consulta l'elenco completo delle etichette:
Altro
Come per qualsiasi raccolta di oggetti, ci sono alcune eccezioni che dovresti conoscere. Queste etichette potrebbero non essere utili quando cerchi un problema su cui lavorare, ma possono comunque essere informative.
- Triage: questi problemi devono ancora essere etichettati correttamente dal team principale. I problemi relativi a questa etichetta potrebbero già includere un'altra etichetta semplice come bug o richiesta di funzionalità, ma è probabile che a breve verranno aggiunte altre etichette.
- Duplicato: Questi problemi documentano un problema, una richiesta o una domanda già trattati in un altro problema. Questa etichetta indica che non devi rispondere a questo problema, ma a quello originale.