Rendere visibile il repository
Mantieni il repository pubblico, attivo e valutabile da GitHub senza contesto privato.
Per maintainer
Per maintainer
Aiuta Good First Issue a scoprire, valutare e mantenere utile il lavoro adatto ai nuovi contributor nel tuo repository.
Scoperta
Far indicizzare il tuo repository
Good First Issue attualmente indicizza repository GitHub pubblici e issue GitHub aperte. I maintainer possono inviare direttamente un repository pubblico dopo l'accesso; il crawler delle issue lo elaborerà dopo la creazione del record repository.
Documentare le basi del progetto
Mantieni README, guida CONTRIBUTING, licenza, setup locale e istruzioni di test abbastanza chiari per un nuovo contributor.
Inviare il repository
Invia il repository pubblico dopo l'accesso. Dopo la creazione del record, il crawler continuerà a elaborare le issue aperte.
Label issue
Etichettare issue adatte ai principianti
Il task di fetch attuale cerca su GitHub issue aperte con label good first issue e help wanted. Queste label rendono il tuo lavoro più facile da scoprire, ma la issue deve ancora avere abbastanza contesto perché un first-time contributor possa agire in sicurezza.
Includi abbastanza contesto per rendere reviewable la prima pull request
- Contesto sul perché la issue conta.
- Risultato atteso espresso in termini concreti.
- File, package o aree prodotto da controllare per prime.
- Comandi di test o passaggi di verifica manuale.
- Se i contributor devono confermare lo scope prima di scrivere codice.
Raccomandazioni
Migliorare la qualità delle raccomandazioni
Le raccomandazioni funzionano meglio quando il repository mostra manutenzione attiva e la issue è abbastanza piccola perché un nuovo contributor possa completarla senza indovinare la direzione del progetto.
Manutenzione recente
Commit, risposte e attività di triage recenti aiutano i contributor a fidarsi che una review sia ancora possibile.
Descrizione chiara
Issue con contesto, criteri di accettazione e note di setup sono più facili da abbinare a nuovi contributor.
Scope piccolo e reviewable
Documentazione, test, polish UI e piccole correzioni di bug sono più facili da raccomandare rispetto a grandi lavori di design.
Loop contributor sano
Test eseguibili e feedback reattivo riducono pull request abbandonate e mantengono utili le raccomandazioni.
Evita issue che sembrano accessibili ma sono difficili da finire
- Issue vecchie che nessun maintainer ha confermato di recente.
- Grandi funzionalità con ownership o direzione prodotto poco chiare.
- Task che richiedono contesto privato, credenziali o accesso alle release.
- Issue senza note di riproduzione, guida al setup o comportamento atteso.
Pronto ad aggiungere un repository?
Invia un repository GitHub pubblico da questa pagina, poi usa issue indicizzate e canali di feedback per controllare come appare il tuo lavoro adatto ai principianti.