Cosa ti viene in mente quando senti il termine Open Source? Nel mondo della programmazione, open source è un termine generico per indicare un software open source (OSS). Un software open source è costruito su un codice sorgente accessibile a tutti che può essere visualizzato, modificato, ampliato e distribuito.

In questo articolo approfondiremo molti aspetti del software open source e del suo ecosistema. Parleremo di cosa ti serve per iniziare a contribuire all'open source, delle competenze necessarie, di come mantenere i progetti open-source, delle sfide, delle risorse e di alcuni progetti interessanti per iniziare.

Prima di iniziare, ecco qualche parola su di me e sul mio interesse per il mondo open-source.

Utilizzo quotidianamente progetti, prodotti e servizi open source e contribuisco ad alcuni di essi per migliorarli. Mi occupo anche di molti progetti open source per educare i principianti alla programmazione web.

Puoi consultare i progetti open-source che gestisco sul mio profilo GitHub.

Questo articolo intende condividere con te la mia esperienza per aiutarti a iniziare a lavorare con l'open source, se non stai già contribuendo.

Come funziona l'Open Source?

I progetti open-source sono composti dalle seguenti persone ed elementi:

Manutentori del progetto: i manutentori sono una o più persone che avviano il progetto open-source, lo gestiscono, prendono decisioni, fanno brainstorming di idee e lavorano a stretto contatto con i collaboratori, gli utenti e le piattaforme di marketing.

I manutentori del progetto avranno diritti di accesso e privilegi aggiuntivi per controllare vari aspetti del progetto.

Contributori del progetto: quando i manutentori avviano un progetto open-source, sono i primi a contribuire. Man mano che il progetto cresce e più persone lo conoscono, cresce la volontà di contribuirvi.

Man mano che cresce, il progetto ottiene più collaboratori. Chiunque può esaminare il codice del progetto, modificarlo, richiedere una revisione e inserire le modifiche nel progetto.

Repository del codice sorgente e della documentazione: il manutentore conserva il codice sorgente del progetto in un repository di codice sorgente centralizzato (ad esempio, GitHub). Questo aiuta tutti i collaboratori ad avere l'accesso necessario al codice per contribuire.

Licenza del progetto: ogni progetto open source deve specificare una licenza di distribuzione per renderla chiara agli utenti/consumatori.

Esistono vari tipi di licenza e il manutentore può sceglierne una in base alle esigenze del progetto. Alcune licenze di distribuzione molto diffuse sono MIT, Apache License 2.0, GNU General Public License (GPL) 3.0 ecc.

Guida alla contribuzione: un manutentore del progetto OSS crea una guida alla contribuzione per aiutare i collaboratori a comprendere il processo di pull request, gli standard, l'ambito e così via.

Guida al codice di condotta: la guida al codice di condotta illustra le varie linee guida, la collaborazione, le aspettative di comportamento dei collaboratori e come approcciare e risolvere i problemi.

Cultura del progetto: la cultura del progetto si evolve con la comunità del progetto. Sebbene i manutentori abbiano un ruolo importante, i collaboratori sono ugualmente responsabili del mantenimento di una sana cultura di apprendimento, condivisione e crescita.

Community: man mano che il progetto cresce, la community si sviluppa intorno ad esso. Strumenti come GitHub Discussions e Discord sono famosi per organizzare interazioni basate sulla community.

Distribuzione: un progetto open-source deve avere un modo per raggiungere gli utenti finali e i consumatori. Dovrebbe esserci un modello di distribuzione che aiuti il codice a tradursi in un prodotto finale da consegnare.

Utenti/Clienti: gli utenti o i clienti sono i consumatori del prodotto che il team open-source costruisce utilizzando il codice sorgente.

Ora diamo un'occhiata all'immagine sottostante. Qui vediamo la community di un progetto open-source che comprende manutentori e collaboratori.

Il codice sorgente si trova nel repository centralizzato. I collaboratori fanno il fork (un termine che impareremo a breve) del repository upstream e contribuiscono. Una volta terminato il contributo, il manutentore del progetto lo integra al branch principale.

Non preoccupatevi se non conoscete termini come fork, branch, merge, ecc. Li impareremo presto in questo articolo. Continuate a leggere.

Ora cerchiamo di capire come il software open-source viene consegnato agli utenti/clienti.

L'immagine seguente mostra una delle tante possibilità ad alto livello. Un progetto open-source dovrebbe avere un meccanismo di build-package-deploy che utilizza il processo di Continuous Integration e Continuous Deployment (CI/CD).

Ogni volta che vengono apportate modifiche al codice nel branch principale (main), il flusso di lavoro CI/CD si avvia automaticamente. Costruisce il codice sorgente, lo impacchetta e lo distribuisce per renderlo accessibile agli utenti finali e ai clienti target.

Nota bene: il CI/CD o qualsiasi altro meccanismo di distribuzione non sono parte integrante dello sviluppo di software open source. Tuttavia, conoscerli aiuta a comprendere il modello di lavoro OSS da cima a fondo.

Cosa significa contribuire all'Open Source?

Contribuire all'Open Source significa migliorare il progetto open source in qualsiasi modo. Una delle idee sbagliate che si possono avere sul contributo è che bisogna contribuire solo al codice sorgente. Ebbene, non è tutto qui.

Contribuire al codice sorgente di un progetto open source è solo un tipo di contributo che si può dare. Tuttavia, è possibile contribuire ad altre aree come:

• La documentazione del progetto. Migliorarla in modo che più collaboratori e utenti la trovino facile da gestire.
• Testare l'applicazione, trovare i problemi e creare issue nel sistema di gestione dei problemi.
• Partecipare alle revisioni del codice per aiutare il progetto a migliorare gli standard di codifica.
• Scrivere unit test, test end-to-end e migliorare la qualità dell'applicazione.
• Creare contenuti come articoli e video per diffondere la conoscenza del progetto.
• Contribuire a costruire la community di persone interessate.

Tutti questi elementi sono contributi cruciali per i progetti open source.

I vantaggi dei contributi Open Source

I contributi Open Source comportano una serie di vantaggi per gli sviluppatori. Alcuni vantaggi chiave sono:

• Ottenere la possibilità di migliorare le proprie skill.
• Migliorare il software/l'applicazione con il codice e la documentazione.
• Incontrare persone che la pensano allo stesso modo, creando network e community.
• Comprendere i cicli di sviluppo e manutenzione delle applicazioni.
• Imparare dai feedback delle pull request.
• Imparare a gestire il proprio codice come open source.

Miti sull'Open Source

Ora conosciamo il modello Open Source e i suoi vantaggi. La prossima cosa che vogliamo imparare è come iniziare a contribuire all'Open Source, sia come manutentori del progetto che come collaboratori.

Prima di farlo, chiariamo alcuni miti sull'Open Source.

❌ Mito: Non so programmare. L'Open Source non fa per me.

✅ Realtà: l'Open Source non riguarda solo la programmazione! Hai molte opportunità di contribuire al miglioramento della documentazione, ai test, alla creazione di media, alla creazione di contenuti e molto altro ancora. Quindi, non restare indietro pensando che la mancanza di competenze di programmazione possa impedirti a contribuire all'OSS.

❌ Mito: So programmare ma non conosco la tecnologia utilizzata in questo progetto Open Source. Non posso contribuire.

✅ Realtà: Al contrario, è un'ottima opportunità per imparare qualcosa che non si conosce già! L'ecosistema Open Source è abbastanza paziente da fornirvi il tempo necessario per imparare e contribuire.

❌ Mito: L'Open Source non mantiene uno standard di livello aziendale.

✅ Realtà: non è affatto vero. Infatti, oggi molti software aziendali sono alimentati da software Open Source. Non è corretto pensare che i progetti Open Source non si preoccupino della qualità e degli standard.

❌ Mito: I progetti Open Source non sono facili da mantenere.

✅ Realtà: Un progetto Open Source è sostenuto dai collaboratori. Un aspetto essenziale per un manutentore è stabilire le basi, creare una tabella di marcia, costruire la community e mantenere alta la motivazione.

Per molti progetti Open Source, i manutentori non devono nemmeno scrivere il codice. I collaboratori possono gestire lo sviluppo, a condizione che il manutentore fornisca il supporto necessario.

❌ Mito: Il software open source è sempre libero.

✅ Realtà: La maggior parte lo è, ma non tutto l'OSS è libero. Ciò dipende dal tipo di licenza utilizzata dal progetto. Alcune licenze sono restrittive per dare libero accesso all'uso e alla distribuzione del codice in qualsiasi modo. È necessario prestare particolare attenzione alle informazioni sulla licenza di un progetto per capire "quanto" l'OSS sarà libero.

❌ Mito: L'Open Source è per i principianti.

✅ Realtà: Molti sviluppatori pensano che l'OSS sia per i principianti e gli studenti. In realtà, tutti possono contribuire. Ha senso che un esperto in materia arricchisca un progetto Open Source con le proprie conoscenze ed esperienze.

Cosa sapere per iniziare a contribuire all'open source

Gli sviluppatori devono conoscere poche cose fondamentali per iniziare rapidamente a lavorare con i progetti Open Source. Si tratta di prerequisiti facoltativi, ma se ne sarai a conoscenza, ti piacerà ancora di più contribuire all'Open Source.

Conoscere le basi di Git

Se sei già a conoscenza del significato di Git e del suo utilizzo principale, hai già fatto un bel po' di chilometri. Git è onnipresente nel mondo Open Source e non puoi ignorarlo.

È necessario conoscere almeno questi argomenti,

• Cos'è Git e come funziona?
• Che cos'è un repository?
• Come clonare un repository?
• Come si fa a mettere in pratica le modifiche?
• Come fare il commit delle modifiche?
• Come scrivere messaggi di commit migliori?
• Come risolvere i conflitti di merge?
• Come eseguire il push delle modifiche a un repository remoto?
• Come fare il pull delle modifiche dal repository remoto?

Se sei alle prime armi con Git, ti consiglio questo video che ti aiuterà a imparare i concetti di Git e tutti gli usi sopra menzionati: Demystifying Git for Beginners.

Acquisire familiarità con GitHub

Su GitHub ci sono oltre 128 milioni di repository pubblici. Una parte significativa di questi repository sono progetti Open Source. Il progetto Open Source a cui si vuole contribuire potrebbe essere presente anche su GitHub. Pertanto, è necessario imparare a gestire le cose su GitHub.

Come collaboratore di un progetto Open Source, devi sapere:

• Come fare il fork di un repository?
• Come si trova l'URL per clonare il repository?
• Come creare una Pull Request?
• Come revisionare una "Pull Request"?

In qualità di manutentore del progetto, è necessario conoscere:

• Come creare un repository?
• Come aggiungere informazioni sulla licenza al progetto?
• Come creare una guida alla contribuzione e una guida al codice di condotta?
• Come impostare uno standard per la creazione delle issue e delle pull request?
• Come fare il merge delle pull request?

Puoi seguire la discussione su Twitter qui sotto. Ti spiega tutto passo per passo:

Imparare a fare il fork di un repository

Il fork è un altro concetto cruciale da comprendere. La maggior parte dei progetti Open Source non consente a un collaboratore di creare branch direttamente su un repository. Al contrario, il flusso di lavoro dei contributi può svolgersi in questo modo:

• Fare il fork del repository.
• Clonare il repository
• Eseguire le modifiche.
• Ottenere le modifiche dall'UPSTREAM.
• Creare una pull request dal repository modificato al repository principale.

Nella mia esperienza di lavoro con molti collaboratori, la maggior parte di loro trova il concetto di forking un po' impegnativo.

Per imparare a fare il fork di un repository GitHub, è possibile consultare questo video tutorial: How to Fork a GitHub Repository. Inoltre, è possibile trovare questo repository GitHub per esercitarsi nel forking. È per principianti assoluti, per acquisire sicurezza nel fare il fork di un repository.

Imparare a risolvere i conflitti di Merge

Chiedete a qualsiasi sviluppatore cosa ne pensa della risoluzione dei conflitti di merge. Non è molto semplice, ma più li si affronta e più si impara. Capire il processo di risoluzione dei conflitti di merge, come ragionare e come risolvere un conflitto di merge.

Ecco una guida pratica con esempi per imparare a risolvere i conflitti di merge. Dai un'occhiata.

Imparare la sintassi di Markdown

La documentazione è una delle esigenze principali di qualsiasi progetto Open Source. Un file Readme.md spiega il progetto, come configurarlo, eseguirlo, distribuirlo e così via.

Il file Contributing.md spiega come contribuire al progetto.

Il file CODE_OF_CONDUCT.md descrive cosa aspettarsi dal comportamento e dall'impegno di un collaboratore. Naturalmente, è possibile scrivere molti altri file .md in base alle esigenze del progetto.

L'acronimo md sta per markdown. È la sintassi usata per la documentazione in GitHub. È meglio imparare la sintassi di base per poter partecipare alla documentazione senza problemi.

Ecco un progetto open source che fornisce la sintassi di mark down da copiare e utilizzare. Ti consiglio di darci un'occhiata.

GitHub - atapas/markdown-cheatsheet: A single place for all the markdown syntaxes I have learned so far.

A single place for all the markdown syntaxes I have learned so far. - GitHub - atapas/markdown-cheatsheet: A single place for all the markdown syntaxes I have learned so far.

atapasGitHub

Coltiva le tue soft skill

L'Open Source è un campo fertile per molti sviluppatori che possono lavorare, imparare e costruire assieme. Come contributore, le tue competenze tecniche potrebbero non essere sufficienti per godere appieno dell'esperienza open source.

Parliamo di alcune soft skill indispensabili per gli sviluppatori.

• Pazienza: la pazienza  è una qualità indispensabile per gli sviluppatori. È necessaria quando si impara qualcosa di nuovo, si esegue il debug di un problema complesso, si lavora con altri, si negozia con qualcuno e si riceve/dà un feedback. A volte le cose non vanno al ritmo che ci si aspetta, quindi bisogna avere pazienza e valutare la situazione.
• Curiosità: una mente curiosa fa molta strada. Quando si contribuisce all'open source, le possibilità sono immense. È necessario essere curiosi per capire le cose. Questo non si applica solo alle sfide tecniche, ma anche al lavoro con le persone.
• Essere reattivi: nell'ecosistema Open Source, è possibile non incontrare e parlare con le persone quotidianamente, ma il lavoro deve andare avanti. È necessario essere reattivi alle domande, ai compiti, alle richieste e a tutto ciò di cui si è responsabili. Molte grandi iniziative muoiono solo a causa della mancanza di reattività da parte delle persone.
• Essere umili: l'umiltà è la chiave del successo. Chi è preparato ma non è umile spesso non riesce a lavorare in squadra.

Come iniziare a contribuire ai progetti Open Source

Vediamo ora come iniziare con la contribuzione all'open source. L'elenco che segue fornisce i link e le risorse per iniziare subito a contribuire ad un progetto open source.

GitHub Explore

GitHub Explore mostra i repository in base ai propri interessi. È possibile impostare le notifiche per essere informati su un progetto.

Inoltre, è possibile cercare i repository per argomenti e tendenze. Usa GitHub explore per scoprire i progetti più pertinenti alle tue competenze, esigenze e aspirazioni. Puoi trovarlo qui: https://github.com/explore/

Come contribuire all'Open Source di freeCodeCamp

Questo repository di freeCodeCamp è un gioiello in tutto e per tutto. Fornisce molte risorse e indicazioni per iniziare a lavorare con l'open source. Puoi trovarlo qui: https://github.com/freeCodeCamp/how-to-contribute-to-open-source

Contributor Ninja

Questo sito ti aiuta con un elenco di linguaggi di programmazione tra cui scegliere: JavaScript, HTML, Rust, Go e molti altri. Si ottengono schede di repository da selezionare. È un luogo semplice per iniziare. Puoi trovarlo qui: https://contributor.ninja/

First Contributions

Si tratta di un elenco enorme di progetti open source da cui cercare e filtrare. Dispone anche di una documentazione ben guidata per iniziare. Puoi trovarlo qui: https://firstcontributions.github.io/

CodeTriage

CodeTriage è un enorme elenco di progetti con issue aperte. Mostra una separazione dei problemi e dei documenti da sottoporre a triage. Il sito web è molto utile. Puoi trovarlo qui: https://www.codetriage.com/

Up For Grabs

Questo è un elenco completo di progetti Open Source da cui scegliere in base ai propri interessi. Puoi trovarlo qui: https://up-for-grabs.net/#/

First Timers Only

Se non hai mai contribuito a un progetto open source prima d'ora e stai iniziando, considera la lettura di questa pagina.

Si possono vedere molte delle fonti di cui abbiamo già parlato, ma la pagina è piena di motivazioni. Puoi trovarlo qui: https://www.firsttimersonly.com/

Open Source Friday

Cosa farai questo venerdì o il prossimo? Che ne dici di investire qualche ora per contribuire al software che usi e ami? Dai un'occhiata a questo sito e registrati. Puoi trovarlo qui: https://opensourcefriday.com/

Spero che le risorse siano state utili. Inoltre, puoi esplorare le discussioni su Twitter, potresti trovare altre informazioni al riguardo.

Manutentori di progetti Open Source

Finora abbiamo visto il lato dei collaboratori open source. Questo articolo sarebbe incompleto se non toccassimo anche il lato dei manutentori dei progetti open source.

In qualità di manutentore del progetto, è necessario seguire determinati standard affinché gli altri possano conoscere e contribuire al repository del progetto.

• Fornire un nome chiaro e una descrizione del progetto. Inoltre, è necessario aggiungere gli argomenti che sono correlati al progetto.
• Aggiungere un file Readme.md chiaro per spiegare gli obiettivi del progetto, come usarlo, come configurarlo e così via. Se il codice sorgente è il cuore di un repository, il file README ne è la faccia.
• Creare un profilo della community. Aiuta i manutentori dei repository open-source a esaminare il lavoro e a capire come aiutarlo a crescere.
• Stabilire un Codice di Condotta.
• Creare una Guida per i Collaboratori.
• Decidere i template delle Issue.
• Creare un template per le Pull Request (PR).
• Attivare GitHub Sponsors.

Per conoscere questi standard in modo più dettagliato, è possibile consultare questo articolo.

Prima di concludere...

Questo è tutto! Siamo giunti alla fine di questo articolo. Spero che tu l'abbia trovato utile e che ti abbia dato una motivazione sufficiente per iniziare a contribuire all'open source.

Prima di concludere, vorrei citare alcuni progetti e repository open source da consultare.

• EddieHub
• ReactPlay
• Hacktoberfest
• First Contributions
• The Hive

L'elenco potrebbe continuare a crescere, ma mi fermo qui. Se ti è piaciuto leggere questo articolo e/o hai delle domande, vuoi metterti in contatto con me, puoi trovarmi in questi posti:

• Seguimi su Twitter
• Connettiti su LinkedIn
• Scopri il mio lavoro su GitHub
• Iscriviti al mio canale YouTube

Siccome continuiamo a progredire tecnologicamente, sempre più prodotti e servizi si stanno trasformando in servizi software pronti per l'uso. Molti di questi sono open source.

La maggior parte delle aziende e degli sviluppatori dipende da software e strumenti open source, che fanno funzionare i loro prodotti. Concorderai con me sul fatto che ultimamente il numero di contributi all'open source sia davvero cresciuto - non solo da singoli sviluppatori ma anche da parte delle aziende.

Il mio primo contributo alla comunità open source risale al 2020 durante l'annuale Hacktoberfest. In quanto principiante partecipai a progetti adatti ai principianti, che condividerò più avanti per aiutarti.

Se stai leggendo questo articolo è perché vuoi essere parte della grandiosa comunità open source - ma forse non sai da dove cominciare? Bene, sei nel posto giusto.

In questa guida tratteremo:

• Cosa si intende esattamente con open source?
• Come puoi iniziare a contribuire?
• Cosa dovresti aspettarti?

Ecco, in questo articolo ci occuperemo di tutto questo e anche di più.

Andiamo!

Cosa vuol dire open source?

In poche parole, possiamo descrivere un progetto open source (OS) come del codice sorgente accessibile pubblicamente; si può vedere, usare, modificare e distribuire sotto licenza.

Come esempio, prendiamo una classe. Un insegnante può condividere un documento attraverso una piattaforma come Google Docs. Su questa piattaforma gli studenti possono modificare il documento e anche farne una copia per sé. Ma in qualsiasi momento apportano modifiche, queste devono essere approvate dall'insegnante prima di riflettersi nel documento.

L'open source funziona allo stesso modo: una volta che il codice è reso pubblico, se vuoi aggiungere funzionalità o fare cambiamenti, il proprietario deve approvare e pubblicare i cambiamenti per permettere agli altri di vederli.

La maggior parte dei progetti open source è il risultato di contributi di persone con diversi livelli di competenze - e non solo nel campo della programmazione, ma anche in altri, come la scrittura, le lingue e via dicendo.

Ogni volta che qualcuno corregge un refuso, aggiunge un messaggio di notifica per un possibile avviso del compilatore, sistema un bug, oppure aggiunge una documentazione dettagliata a un progetto, viene fatto un passo avanti. Se prendiamo tutti questi piccoli contributi da parte di persone diverse con abilità diverse e li mettiamo insieme, possono succedere grandi cose.

Come disse Vincent van Gogh:

Le grandi cose sono fatte da una serie di piccole cose messe insieme.

Perché dovresti contribuire all'open source

Contribuire a progetti open source può essere un modo gratificante di imparare, insegnare, condividere e fare esperienza.

Ci sono un sacco di ragioni per le quali dovresti contribuire a un progetto open source, per esempio:

• Migliorare il software al quale ti affidi tutti i giorni.
• Trovare un mentore se ne hai bisogno.
• Apprendere nuove abilità o migliorare quelle che già hai.
• Condividere le tue capacità.
• Ottenere una conoscenza molto più approfondita del software che stai usando.
• Costruirti una reputazione e sostenere la crescita della tua carriera.
• In più, è divertente e dà soddisfazione e poi, ehi, non puoi sapere chi sta guardando, magari il tuo prossimo datore di lavoro o compagno d'affari 🙂.

Guida passo passo su come contribuire all'Open Source

Quando si parla di contribuire all'open source, non si intende necessariamente che devi saper programmare. Ci sono molti modi nei quali puoi contribuire anche se non sei un programmatore - ma avere questa competenza aiuta molto (sia te stesso che i progetti).

Tra i contributi più frequenti ci sono:

• Aggiungere una descrizione alla documentazione di un progetto per approfondirne un certo aspetto, di solito ci si riferisce al file README (dai un'occhiata a questa guida su come scrivere dei file README validi).
• Dare indicazione su uno specifico progetto e su come usarlo.
• Aggiungere esempi di output per mostrare come funziona il codice.
• Scrivere tutorial di approfondimento per un progetto.
• Partecipare alla traduzione di un progetto - un buon posto in cui iniziare potrebbe essere il programma di traduzione di freeCodeCamp.
• Rispondere a delle domande (come su Stack Overflow o Reddit).
• Puoi offrirti come mentore di altri collaboratori.
• Puoi correggere refusi e sistemare adeguatamente la cartella di lavoro del progetto.

Tutto questo e molto altro conta come contributo. Ora, cosa dovresti sapere esattamente prima di iniziare a contribuire a un progetto OS?

Cose da sapere prima di contribuire a progetti OS

Ci aspettiamo che ogni prodotto open source sia differente dagli altri, lo stesso vale per le comunità. Ogni comunità ha le sue regole e avrà diverse linee guida e funzioni e, se sei fortunato, alcune ti offrono anche una ricompensa in seguito al tuo contributo.

A discapito di tutto ciò, ci sono alcune caratteristiche comuni che valgono per tutti i progetti OS, ed è di queste che andremo a discutere.

Ruoli in un tipico progetto OS

In un tipico progetto OS incontriamo le seguenti persone:

• Autore - La persona che ha creato il progetto. Gli autori hanno il potere di assegnare nuovi ruoli agli altri membri perché collaborino nel mantenimento del progetto.
• Proprietario - Al proprietario è assegnata la proprietà amministrativa del progetto (l'autore stesso può essere anche proprietario).
• Manutentori - Queste persone hanno la responsabilità di guidare la vision e gli obiettivi del progetto. Si sentono di solito responsabili della direzione del progetto e si impegnano per il suo miglioramento.
• Collaboratori - Contribuiscono al progetto in un modo o in un altro. Seguono lo stesso processo di revisione del codice, sono soggetti agli stessi requisiti di stile, e così via.
• Comunità di membri/utenti - I preziosi membri della comunità possono fornire riscontri sulle funzionalità, segnalare dei bug, e altro ancora.

I "must" di un progetto OS

Parlando di progetti OS, va detto che sono classificati in molti modi in base alla struttura, al tipo di piattaforma del prodotto, al linguaggio di programmazione usato, al suo essere indipendente o sponsorizzato e altro ancora.

Linee guida e altri tipi di informazioni aiutano a mettere in evidenza tutto ciò:

• Licenza
  Se un progetto non ha una licenza open source, allora non è open source. La licenza protegge i collaboratori e gli utenti. Di solito aziende e sviluppatori assennati non toccano un progetto senza questa tutela. Se ti stai chiedendo come ottenerla e come scegliere quella più adatta al tuo progetto, consulta il sito ufficiale della licenza OS: https://choosealicense.com/.
• File README
  Si tratta di un prontuario che spiega come iniziare. Elenca i requisiti per poter contribuire al progetto, i passi da fare per collaborare e così via. Un buon README contiene tutto quello che un potenziale collaboratore dovrebbe sapere sul progetto. Se hai già un progetto e stai cercando di scrivere un file README file, questa guida ti tornerà utile:  Come scrivere un buon file README.
• Linee guida per la contribuzione
  Sono linee guida che aiutano le persone che vogliono contribuire al progetto a capire cosa ci si aspetta esattamente da loro. E sebbene non siano obbligatorie, è sempre una buona pratica aggiungerle. Se hai bisogno di aiuto per scriverle o vuoi sapere bene cosa contengono, sul sito ufficiale OS c'è un template che può esserti d'aiuto: template per le linee guida.
• Codice di condotta
  Un codice di condotta è un documento che stabilisce le aspettative sul comportamento dei tuoi collaboratori e partecipanti. Adottare e far valere un codice di condotta può essere utile a creare un ambiente positivo e accogliente per la tua comunità. La guida OS spiega meglio ciò che contiene il codice: https://opensource.guide/code-of-conduct/.

Nella gestione di un progetto open source, sia individuale che da parte di un'organizzazione, tutto riguarda la creazione di una comunità dove le persone possono crescere insieme. Ciò significa che dovrai sviluppare un ambiente socievole dove le persone condivideranno idee, si impegneranno in sfide, e a un certo punto inizieranno casualmente a chiacchierare.

Qui ci sono alcune opzioni, e puoi usare strumenti come:

• Issue Tracker
  È dove tieni traccia del tuo lavoro su GitHub e di come avviene lo sviluppo. Nel caso in cui ci siano problemi un collaboratore può creare una issue e collegarla a una pull request, gli altri colleghi possono così scegliere di risolvere quel problema. La issue viene chiusa una volta che il problema viene risolto.
• Pull Request
  Permettono di far sapere agli altri dei cambiamenti che hai apportato a un branch in un repository su GitHub. Una volta aperta una pull request, puoi discutere con gli altri collaboratori dei possibili cambiamenti, revisionare, e procedere con nuovi commit prima che questi siano integrati nel branch principale.
• Chat Channel
  Sebbene non sia obbligatorio, puoi considerare una buona pratica l'essere parte di un canale di comunità OS. È ideato specificatamente per condividere idee e intrattenere conversazioni. A questo scopo, tra i mezzi di comunicazione più comuni ci sono Slack e Discord.

Dunque, adesso hai un'idea di che cos'è un progetto OS e di cosa ti aspetta quando contribuisci. Ma arriviamo alla parte importante, come sapere a quale progetto partecipare?

Come trovare un progetto OS al quale contribuire

Non c'è bisogno di pensare troppo a come farlo, contribuire è possibile a tutti i livelli. Piuttosto pensa ad alcuni dei progetti che già conosci, che usi, e a quali cambiamenti o miglioramenti puoi fare.

Ricerche mostrano che circa il 30% dei contributi occasionali riguardano documentazione, correzioni di refusi, o anche traduzioni.

All'inizio ho promesso che avrei condiviso alcuni dei progetti che mi aiutarono durante le mie prime collaborazioni. Per tua fortuna, se sei alla tua prima volta - tutti lo sono a un certo punto -  qui ci sono alcuni link che ti aiuteranno a cominciare nel mondo dell'OS:

• first-timers only
• first contribution
• contributor ninja
• open-source friday
• 24 pull requests
• python project scripts
• habitica
• code triage

Un suggerimento rapido: nel mondo dell'open source, le issue vengono aperte e risolte abbastanza velocemente. Perciò, un modo per iniziare bene è scegliere una issue con la sicurezza di poterci lavorare su tempestivamente.

Come scegliere un progetto OS

Dopo aver trovato il progetto al quale vuoi contribuire, è tempo di fare un piccolo controllo. Assicurati che rientri nei seguenti criteri, così saprai se è un buon progetto al quale lavorare:

1. Controlla se ha un file di licenza.
2. Guarda a quando risale l'ultimo commit. Questo ti farà capire se i collaboratori sono attivi e ti darà un'idea di quanto ci impiegheranno per replicare al tuo contributo.
3. Controlla il numero di collaboratori.
4. Guarda ogni quanto si fanno commit. Se vedi molte attività recenti è un buon segno - vuol dire che la comunità è attiva, così come i manutentori.

Ora, se il primo controllo è superato, procedi con i seguenti:

1. Ha delle issue aperte? Se sì. può essere un buon segno, hai un posto in cui iniziare.
2. Quanto tempo impiegano a rispondere? Questo dipende da quanto spesso vengono chiuse le issue e le pull request integrate.
3. Sulle issue ci sono discussioni attive?
4. Vengono chiuse regolarmente?
5. Quante pull request aperte ci sono?
6. Quando è stata l'ultima volta che è stato fatto il merge di una pull request?
7. I manutentori ringraziano chi contribuisce?

Se anche l'ultimo controllo è stato superato, allora sei pronto per cominciare.

Cose da considerare prima di entrare nell'OS

So che sei entusiasta e pronto a scatenarti nel mondo OS, ma sai cosa cercare in un progetto?

Come detto sopra, ci sono modi diversi coi quali puoi contribuire. Ma prima di dare il tuo primo contributo, è bene prendere nota di alcune cose riguardanti il progetto che andrai a scegliere, per esempio:

• Quale linguaggio di programmazione usa?
  La tecnologia fondamentale che sta dietro ogni applicazione è il linguaggio di programmazione che viene usato. Alcuni dei più popolari su GitHub sono JavaScript, Python, Java, Ruby, and PHP - ma ce ne sono altri. Ci sono moltissimi progetti che potrebbero addirsi ai tuoi interessi e capacità. Trovane uno al quale ti farebbe piacere lavorare.
• Tipo di progetto
  Dopo che hai scelto il linguaggio col quale vuoi lavorare, devi scegliere anche il tipo di progetto che preferisci. Dai un'occhiata in giro e scegli un argomento che risponde ai tuoi interessi.

Una volta trovato il progetto, vorrai contribuire davvero. E lo farai attraverso le pull request. Vediamo di cosa si tratta.

Cos'è una Pull Request?

Ti ricordi l'esempio di Google Docs? Bene, una pull request è simile, ma si tratta di codice.

Possiamo descrivere una pull request come un collaboratore che propone un cambiamento - sia codice sia documentazione o altro - e chiede a un manutentore di controllare, assicurarsi che sia tutto a posto, poi integrarlo nel progetto.

Quindi, come si fa?

Come inviare una Pull Request

Se sei a questo punto, vuol dire che hai trovato un progetto e sei pronto per contribuire. Vediamo allora come si fa effettivamente una pull request.

Passaggi per inviare una PR

• Esegui il fork del repository
  Nell'angolo in alto a destra, vedrai il termine "fork". Tutto ciò che devi di fare è cliccarlo per creare una copia del progetto nel tuo profilo.

Dopo questa operazione l'URL del progetto cambierà in:

https://github.com/<IlTuoUsername>/nomeprogetto

• Clona il progetto sulla tua macchina
  Per fare questo passaggio, devi avere installato Git localmente sulla tua macchina. Se non ce l'hai, fai riferimento alla documentazione ufficiale Git per scoprire come fare.

Copia l'URL del fork del progetto e procedi aprendo la tua riga di comando o git bash e inserendo il seguente comando:

git clone https://github.com/<IlTuoUsername>/<nomeprogetto>

Questo creerà una copia del progetto sulla tua macchina, in locale. Ora che hai clonato il repo bisogna fare due cose.

La prima è fare i cambiamenti/apporti necessari e poi eseguire un'azione di commit con le modifiche. Dopo aver fatto i cambiamenti e aver aggiunto i file, è tempo di aggiungere questi cambiamenti in un branch separato, prima di fare un push remote.

Ma prima creiamo un branch. Dalla riga di comando, cambia il percorso in modo che punti alla cartella del tuo repo. Per farlo, usa questo comando:

cd nome-cartella-progetto

Ora, per creare un branch useremo questo comando: git checkout

git checkout -b nome-branch

Per esempio:

git checkout -b lary-mak

Aggiungiamo le modifiche al branch creato. Per vedere quelle che hai fatto, useremo il comando git status:

git status

Il comando elencherà tutti i cambiamenti che hai apportato. Per aggiungerli useremo git add *, che aggiungerà i file al nostro branch.

git add *

Scriviamo un messaggio di commit, che spieghi brevemente quel che abbiamo aggiunto:

git commit -m "<messaggio di commit>"

• Invia le modifiche al remoto
  Adesso che tutto è pronto, è tempo di far sapere al nostro manutentore cosa abbiamo aggiunto. Ciò è possibile con questo comando:

git push origin <nome-branch>

sostituendo <nome-branch> con il nome del branch che hai creato prima, nel mio caso sarà git push origin lary-mak.

• Proponi le modifiche
  Se vai sul tuo repo su GitHub e ricarichi la pagina, vedrai un pulsante "Compare and pull request". Cliccaci su.

Presto il manutentore integrerà le tue modifiche nel branch principale del progetto (a meno che non ti richiedano di fare dei cambiamenti). Riceverai una email di notifica quando accadrà.

Creare una pull request ha alcuni vantaggi, ad esempio:

• Ti permette di contribuire a un altro repo senza il bisogno di privilegi amministrativi nel caso di modifiche.
• Permette agli altri di revisionare le tue modifiche e suggerire correzioni, cambiamenti, aggiunte e così via.
• Lascia agli amministratori del repo il controllo su quello che viene aggiunto nel repo del progetto.

Congratulazioni 🥳🎉,
hai appena completato il flusso standard fork -> clone -> edit -> pull request il cui risultato è tuo primo contributo. Lo userai spesso! Dunque, cos'altro?

Cosa viene dopo la tua prima Pull Request?

Non è mica finita! Ora, trova più progetti e continua a partecipare. Assicurati anche di riuscire a prestare attenzione al mese dedicato all'OS, viene gestito ogni anno da Digital Ocean e c'è la possibilità di vincere fantastici premi.

Una cosa ancora della quale parlare un po' di più prima di concludere: perché contribuire a progetti OS è appagante.

I benefici di contribuire all'OS

• Le persone che contribuiscono a progetti OS arrivano a conoscere la tecnologia in modo molto più approfondito rispetto a chi la usa soltanto.
• Puoi concentrare i tuoi sforzi sull'aggiungere e sfruttare funzionalità che saranno utili alle aziende in base all'esperienza di cosa funziona e cosa non funziona nel modo reale.
• Ti dà coraggio e costruisce la tua reputazione. Chi contribuisce a progetti OS ha accesso all'esperienza e alla prospettiva dei membri di altre comunità.
• Contribuire all'OS offre una chiara visione nel futuro di un progetto.
• Se sei su GitHub, una gran parte delle cose che fai su quella piattaforma è pubblica. Usala a tuo vantaggio per fare sempre del tuo meglio quando partecipi e quando comunichi con altri collaboratori.

Perché dovresti contribuire all'OS come sviluppatore

• Ti aiuterà ad affinare le tue competenza di programmazione e a migliorare nello scrivere un codice pulito.
• Ti farà conoscere nella comunità e tra i tuoi pari. Questa notorietà può offrirti molte opportunità nella tua carriera.
• Ti permetterà di imparare molto sulla gestione di un progetto e potrebbe essere di ispirazione per iniziare un progetto tutto tuo.

Concludiamo!

Come ho detto, l'OS è aperto alla partecipazione di tutti. Ci sono molte opportunità delle quale puoi approfittare e imparare qualcosa di nuovo. Tutto ciò di cui hai bisogno è decidere di iniziare e partire.

L'OPEN SOURCE TI ASPETTA

Se hai letto fin qui, lo apprezzo molto.

Fammi sapere cosa ne pensi, un'opinione sincera fa sempre piacere!

Collegati con me su Twitter | YouTube | LinkedIn | GitHub

Buona programmazione ❤