Identificare i progetti a cui poter contribuire

  • 5 minuti

In questa unità verrà illustrato come iniziare ad apportare contributi open source. Verranno anche usati i problemi e i tag per trovare le attività a cui contribuire.

Il software open source può essere liberamente usato, modificato e condiviso da chiunque. Usando software open source, chiunque può visualizzare, modificare e distribuire un progetto per qualsiasi scopo. L'idea alla base del software open source è che la condivisione del codice porta a un software migliore e più affidabile.

È possibile contribuire ai progetti open source in molti modi. La creazione del primo contributo può spesso intimorire, ma è un’esperienza relativamente semplice. L'open source è aperto a tutti ed è possibile creare contributi a tutti i livelli.

Trovare un progetto open source per cui sono necessari contributi

Per iniziare, è possibile prendere in considerazione i progetti già usati o che si vogliono usare. Contribuire è più facile se si ha già familiarità con il progetto e la community.

Leggendo il file README di un progetto è possibile trovare un collegamento interrotto o alcuni errori di digitazione. Si potrebbe notare che qualcosa non funziona come previsto o che la documentazione non è aggiornata. Sono tutte ottime opportunità per essere d'aiuto e contribuire al progetto.

Suggerimento

Un suggerimento importante: tutti i tipi di contributi sono preziosi. Il livello di esperienza o la conoscenza del progetto non è rilevante. Tutti possono dare un contributo. Ciò che conta in questo caso è la volontà di essere d'aiuto, senza alcun timore.

Per esplorare gli argomenti e i progetti correlati, è anche possibile usare la ricerca di GitHub. Passare alla ricerca in GitHub e immettere la parola dell'argomento.

Si supponga di essere interessati a Machine Learning.

Screenshot che mostra gli argomenti di ricerca di GitHub.

È quindi possibile restringere la ricerca selezionando Argomenti nella barra laterale sinistra.

Screenshot che mostra i risultati di una ricerca ridotta di GitHub.

In questa pagina è possibile trovare i repository rilevanti per la parola chiave di ricerca e i repository curati dai membri della community.

Acquisire familiarità con un progetto open source

È importante tenere presente che ogni community open source è diversa. Dopo aver trovato un progetto, sarà necessario acquisire familiarità con il progetto e le linee guida sulla partecipazione.

Per la maggior parte dei progetti questi documenti sono inclusi nel livello superiore del repository:

  • LICENZA: Il progetto deve contenere una licenza open source. Se il progetto non ha una licenza, non è open source.
  • README: Il file README funge in genere da pagina iniziale per il progetto. Fornisce in genere informazioni su come iniziare a usare il progetto. Di norma contiene anche informazioni su come partecipare alla community.
  • CONTRIBUIRE: Come suggerisce il nome, questo documento fornisce indicazioni su come contribuire al progetto. Descrive in genere il processo di creazione dei contributi e include informazioni dettagliate su come configurare l'ambiente di sviluppo.
  • CODE_OF_CONDUCT: Il codice di comportamento imposta le regole di base per i membri della community. Grazie a queste regole, la community è un ambiente sicuro e accogliente per tutti.

Anche se non tutti i progetti includono i documenti CONTRIBUTING o CODE OF CONDUCT, la presenza di questi documenti indica che probabilmente l'esperienza con il progetto sarà semplice e positiva.

I collaboratori e i gestori dei progetti open source provengono da tutto il mondo. I progetti hanno in genere più canali di comunicazione per organizzare le discussioni e richiedere assistenza. Per acquisire familiarità con la community, è possibile esaminare alcuni di questi canali di comunicazione:

  • Strumento di rilevamento dei problemi: Dove le persone discutono di problemi e attività correlate al progetto. Per trovare i problemi in GitHub, è possibile passare alla pagina principale del repository in GitHub e aggiungere /issues alla fine dell'URL, ad esempio https://github.com/jupyter/notebook/issues.
  • Pull request: Dove le persone discutono e revisionano le modifiche apportate al progetto. Per trovarlo in GitHub, aggiungere pulls all'URL del progetto, ad esempio https://github.com/jupyter/notebook/pulls.
  • Canali di chat e forum: Alcuni progetti usano canali di chat, ad esempio Slack, Gitter e IRC, o forum come Il discorso per conversazioni e discussioni.

Identificare le attività a cui lavorare

Dopo aver trovato un progetto e aver letto le linee guida per i contributi, si è pronti per contribuire.

Forse si è già individuato qualcosa a cui lavorare, ad esempio correggere alcuni collegamenti interrotti o aggiornare la documentazione. Un modo efficace per trovare problemi alla portata dei principianti consiste nel visitare l'URL /contribute del progetto, ad esempio, https://github.com/jupyter/notebook/contribute.

Screenshot che mostra la sezione Contribuire a un progetto in GitHub.

Si noterà che la maggior parte dei problemi visualizzati nell'URL contribute ha etichette come good-first-issue, help wanted, beginner-friendly e così via. Le etichette vengono spesso usate per fornire informazioni generali sul problema e sul tipo di intervento necessario.

È possibile passare alla pagina delle etichette, ad esempio https://github.com/jupyter/notebook/labels, quindi selezionare i problemi con le etichette come help wanted, discussion o altre etichette rilevanti per il tipo di contributo a cui si è interessati.

Mentre si esaminano i problemi, si potrebbe notare che ad alcuni sono collegati altri problemi o richieste pull.

Screenshot che mostra una richiesta pull collegata a un problema.

È possibile contribuire all'open source in molti modi. È possibile supportare finanziariamente le persone che creano e gestiscono l'ecosistema open source attraverso attività di creazione di codice, leadership, tutoraggio, progettazione e altre ancora.

L'open source dipende in gran parte dal volontariato. Gli sponsor di GitHub consentono di finanziare progetti e singole persone supportando il loro lavoro open source e dando loro il riconoscimento che meritano.

Se un progetto è idoneo per la sponsorizzazione tramite Gli sponsor GitHub, nella pagina principale del progetto è presente un pulsante Sponsor .

Screenshot che mostra la casella di sponsoring in una pagina del progetto GitHub.

È possibile selezionare il livello di sponsorizzazione e specificare se si vuole rendere pubblico il proprio contributo.

Screenshot che mostra i livelli di sponsorizzazione.

Riepilogo dell'unità

In questa unità è stato illustrato come è possibile iniziare ad apportare contributi open source, scegliendo un progetto a cui lavorare e usando i problemi e le etichette di GitHub per identificare le attività a cui lavorare.

Ecco un utile elenco di controllo da usare quando si interagisce con un progetto per la prima volta:

  • Ha una licenza?
  • I problemi e le discussioni sulle richieste pull vengono usati attivamente dai gestori e dai collaboratori?
  • Il progetto usa etichette come help wanted o good first issue per gli utenti meno esperti?
  • Il progetto ha un codice di comportamento?
  • Il progetto ha linee guida chiare sui contributi?

Si ricordi infine che ogni contributo è prezioso e che le idee e la partecipazione di tutti sono estremamente utili per l'ecosistema open source. È possibile contribuire all'open source in molti modi, ad esempio inviando codice, partecipando alle discussioni sui progetti o sponsorizzando i progetti attraverso gli sponsor di GitHub.