Un link simbolico (o symlink) è un tipo di file in Linux che punta a un altro file o a un'altra cartella all'interno del tuo computer. I link simbolici assomigliano alle scorciatoie di Windows.

I link simbolici vengono chiamati da alcuni "link soft", morbidi - un tipo di link nei sistemi Linux/UNIX - in opposizione ai link "hard", duri.

Differenza tra i link soft e i link hard

I link soft sono simili alle scorciatoie, possono puntare a un altro file o a un'altra cartella in qualsiasi file system.

Anche i link hard sono scorciatoie per file o cartelle, ma un link hard non può essere creato puntando a un file o a una cartella in un file system diverso.

Ecco i passi per creare e rimuovere un link simbolico. Vedremo anche cosa sono i link interrotti e come cancellarli.

Come creare un link simbolico

La sintassi per creare un link simbolico è:

ln -s <percorso del file/cartella da collegare> <percorso del link da creare>

ln è il comando. La -s specifica che il link deve essere soft. -s può essere scritto anche -symbolic.

ln è il comando predefinito per creare link hard. L'argomento successivo è il percorso del file (o cartella) che vuoi collegare (cioè il file o la cartella per cui vuoi creare una scorciatoia).

E l'ultimo argomento è il percorso del collegamento (la scorciatoia).

Come creare un link simbolico per un file - esempio

ln -s /home/james/transactions.txt trans.txt

Dopo aver eseguito questo comando, sarai in grado di accedere al file /home/james/transactions.txt con trans.txt. Ogni modifica a trans.txt si rifletterà nel file originale.

Nota che il comando crea il file di collegamento trans.txt nella cartella in cui ti trovi. Allo stesso modo puoi creare un file di collegamento all'interno di una cartella:

ln -s /home/james/transactions.txt my-stuffs/trans.txt

Una cartella chiamata "my-stuffs" deve essere già presente nella cartella in cui ti trovi - altrimenti il comando ti darà un errore.

Come creare un link simbolico per una cartella - esempio

Similmente a quanto visto sopra useremo:

ln -s /home/james james

Questo crea una cartella di collegamento simbolico chiamata "james", che conterrà quel che già si trova in /home/james. Qualsiasi cambiamento alla cartella di collegamento, modificherà anche la cartella originale.

Come rimuovere un link simbolico

Prima di voler rimuovere un symlink, è meglio avere la sicurezza che quel file o quella cartella siano un link simbolico, per evitare di manomettere i file.

Un modo è questo:

ls -l <percorso del probabile link simbolico>

Eseguendo il comando sul tuo terminale, verranno visualizzate le proprietà del file. Nel risultato, se il primo carattere è una lettera L minuscola ("l"), allora il file/cartella è un link simbolico.

Vedrai anche una freccia (->) alla fine, che indica il file/cartella a cui punta il link.

Ci sono due metodi per rimuovere un link simbolico:

Come usare unlink per rimuovere un link simbolico

La sintassi è:

unlink <percorso del link simbolico>

Questo comando cancella il link simbolico, se il processo è valido.

Anche se il link simbolico è una cartella, non aggiungere "/", perché Linux assumerà che sia una cartella e unlink non può cancellare cartelle.

Come usare rm per rimuovere un link simbolico

Come abbiamo visto, un link simbolico è solo un altro file o un'altra cartella che punta a un file originale o a una cartella originale. Per rimuovere questa relazione, puoi rimuovere il file collegato.

Quindi, la sintassi è:

rm <percorso del link simbolico>

Per esempio:

rm trans.txt
rm james

Nota che cercare di eseguire rm james/ darebbe un errore, perché Linux assumerà che "james/" sia una cartella. Ciò richiederebbe altre opzioni, come  r e f. Ma non è quello che vogliamo. Un link simbolico può essere una cartella, ma a noi interessa solo il nome.

Il principale vantaggio di rm su unlink è che permette di rimuovere più link simbolici in una volta, come si può fare coi file.

Come trovare e cancellare i link interrotti

I link simbolici interrotti sono quei link che puntano a un file o a una cartella il cui percorso è stato modificato o cancellato.

Per esempio, se "transactions.txt" si sposta da /home/james a /home/james/personal, il link "trans.txt" viene interrotto. Qualsiasi tentativo di accedere al file dà luogo al messaggio di errore "No such file or directory". Succede perché il link simbolico non ha un proprio contenuto.

Quando scopri link interrotti, puoi facilmente cancellare il file. Un modo semplice di trovare i link simbolici interrotti è:

find /home/james -xtype l

Questo comando darà l'elenco di tutti i link simbolici interrotti nella cartella james – dai file alle cartelle alle sottocartelle.

Passando l'opzione -delete li cancellerai:

find /home/james -xtype l -delete

In conclusione

I link simbolici sono una caratteristica interessante dei sistemi Linux e UNIX.

Puoi creare dei link simbolici facilmente accessibili per rinviare a file o cartelle che altrimenti non sarebbe comodo raggiungere. Con un po' di allenamento, capirai intuitivamente come funzionano, e renderanno la gestione dei tuoi file molto più efficiente.

Hai creato il tuo database e le tue tabelle e dopo tutto questo lavoro ti accorgi che hai bisogno  di aggiungere o rinominare una colonna. Bene, per farlo puoi usare l'istruzione ALTER TABLE.

Ma tieni a mente che nel farlo devi essere molto prudente. Se la tua tabella ha molte righe, può causare problemi di prestazioni al database.

Nota: se la sintassi presentata qui non funziona, controlla nella documentazione relativa all'implementazione di SQL che stai usando. Le cose funzionano per lo più allo stesso modo, ma ci sono delle differenze.  

Come aggiungere una nuova colonna con ALTER TABLE

Per aggiungere una nuova colonna, devi prima selezionare la tabella, con ALTER TABLE nome_tabella, poi scrivere il nome della nuova colonna e il tipo di dato che deve aspettarsi, con ADD nome_colonna tipo_dato. Il codice, messo insieme, è così:

ALTER TABLE nome_tabella
ADD nome_colonna tipo_dato;

Esempio: ALTER TABLE per aggiungere una colonna

Abbiamo un database di utenti come segue:

Abbiamo raggiunto un punto in cui occorre conservare il numero del documento d'identità dei nostri utenti, quindi abbiamo bisogno di aggiungere una nuova colonna.

Per aggiungere una nuova colonna alla nostra tabella users, dobbiamo selezionare la tabella con ALTER TABLE users e specificare il nome della nuova colonna e il suo tipo di dato con ADD id_number TEXT. Tutto insieme risulta così:

ALTER TABLE users
ADD id_number TEXT;

La tabella con la nuova colonna sarà come quella qui sotto:

Dovrai usare un'istruzione UPDATE per aggiungere l'informazione mancante relativa all'utente esistente, una volta che verrà fornita.

Come creare una nuova colonna con un valore predefinito invece di NULL

Puoi anche creare una colonna con un valore predefinito usando la parola chiave default seguita dal valore che vuoi assegnare. Gli utenti vedranno allora il valore di default invece di un valore mancante compilato con NULL.

Diciamo che avremo presto utenti internazionali e che vogliamo aggiungere una colonna country. Tutti i nostri utenti già inseriti vengono dagli Stati Uniti, allora potremmo usare questo valore come valore predefinito.

ALTER TABLE users
ADD country TEXT default "United States";

La tabella poi risulterà così:

Sii prudente quando aggiungi nuove colonne alle tabelle

Se la tua tabella ha già molte righe - come quando hai molti utenti o molti dati in memoria - aggiungere una nuova colonna può essere dispendioso in termini di risorse. Quindi assicurati di svolgere questa operazione con attenzione.

Come rinominare una colonna con ALTER TABLE

Puoi rinominare una colonna con il codice qui sotto. Seleziona la tabella con ALTER TABLE nome_tabella e poi scrivi la colonna da rinominare e con quale nome: RENAME COLUMN vecchio_nome TO nuovo_nome.

ALTER TABLE nome_tabella
RENAME COLUMN vecchio_nome TO nuovo_nome;

Esempio di come rinominare una colonna

Consideriamo la stessa tabella che abbiamo usato nell'esempio precedente:

Per evitare confusione tra le colonne id e id_number, rinominiamo la prima in user_id.

Prima selezioniamo la tabella con ALTER TABLE users e poi dichiariamo il nome della colonna in modo che venga modificato come vogliamo con RENAME COLUMN id TO user_id.

ALTER TABLE users
RENAME COLUMN id TO user_id;

Dopo questa query, la tabella apparirà così:

Sii prudente quando rinomini una colonna in una tabella

Quando rinomini delle colonne usando ALTER TABLE, rischi di rompere delle dipendenze all'interno del database.

Se invece di usare ALTER TABLE, per modificare il nome della colonna, utilizzi uno strumento di refactoring, questo aggiornerà il nome e saprà anche gestire tutte le dipendenze.

Se hai un piccolo database non hai bisogno di preoccuparti, ma è importante tenerlo a mente.

Conclusione

In questo articolo hai imparato a usare ALTER TABLE per aggiungere una colonna e rinominare una colonna in una tabella.

Ricorda solo che entrambe le operazioni comportano dei rischi che è importante conoscere. Come ha detto qualcuno, da un grande potere deriva una grande responsabilità – e ALTER TABLE è un grande potere, perciò usalo con cautela!

L'elemento HTML division, chiamato in breve "div", è un elemento speciale che ti permette di raggruppare su una pagina degli elementi simili per contenuto. Puoi usarlo come un generico contenitore per associare contenuti dello stesso tipo.

L'elemento <div> è uno dei più usati e non sembra voler scomparire, nonostante l'introduzione degli elementi semantici (molti di questi elementi possono essere usati come contenitori).

In questo tutorial, ti mostrerò varie cose che puoi fare con un div, come usarne diversi nello stesso file HTML senza confonderti, e come definirne lo stile.

Quando usare l'elemento div

L'elemento div è multiuso – puoi usarlo per fare varie cose in una pagina web. Lo userai per lo più per definire la disposizione e lo stile in CSS, ma è molto flessibile.

In definitiva, lo userai quasi sempre per dare stile a quel che contiene o manipolarne il contenuto con JavaScript.

1. div per il layout

L'uso primario che farai dell'elemento div sarà raggruppare contenuti simili per dare loro uno stile facilmente. Un buon esempio è usare un div per riunire diverse sezioni di una pagina. Puoi mettere insieme intestazione, barra di navigazione, sezioni e piè di pagina in uno stesso div per poter impostare per tutti lo stesso stile.

Più avanti in questo tutorial, ti accompagnerò nella costruzione di un layout con diversi div senza fare confusione.

L'elemento div da solo non ha un effetto diretto sulla presentazione del contenuto se non si definisce uno stile.

2. div per CSS

Con l'elemento div puoi fare diverse forme e disegnare qualsiasi cosa, perché è facile definirne lo stile.

• Come fare un quadrato con l'elemento div

Per fare un quadrato con l'elemento div, per prima cosa bisogna definire nel file HTML un div vuoto e attribuirgli una classe. Nel CSS si seleziona il div attraverso la classe, per poi impostare altezza e larghezza.

<div class="square"></div>

 body {
      display: flex;
      align-items: center;
      justify-content: center;
      margin: 0 auto;
      height: 100vh;
      background-color: #f1f1f1;
    }
.square {
      background-color: #2ecc71;
      width: 200px;
      height: 200px;
    }

• Come fare un cerchio con l'elemento div

Puoi fare un cerchio definendo un div vuoto, dandogli un'altezza uguale alla larghezza nel file CSS, e poi un border-radius del 50%.

<div class="circle"></div>

  body {
      display: flex;
      align-items: center;
      justify-content: center;
      margin: 0 auto;
      height: 100vh;
      background-color: #f1f1f1;
    }

    .circle {
      background-color: #2ecc71;
      width: 200px;
      height: 200px;
      border-radius: 50%;
    }

• Come fare la bandiera della Nigeria in CSS

Fare la bandiera della Nigeria con l'elemento div non è tanto difficile. La bandiera è di forma rettangolare e di colore verde, bianco e di nuovo verde.

Per farla, definiamo tre div, ciascuno con una sua classe, poi impostiamo adeguatamente lo stile nel file CSS.

<div class="naija-flag">
    <div class="first-green"></div>
    <div class="white"></div>
    <div class="second-green"></div>
</div>

.naija-flag {
  display: flex;
}
.first-green {
  height: 100px;
  width: 60px;
  background-color: green;
}
.white {
  height: 100px;
  width: 60px;
  background-color: white;
}
.second-green {
  height: 100px;
  width: 60px;
  background-color: green;
}

Come impostare lo stile di un elemento div

Come detto sopra, è molto semplice impostare lo stile di un elemento div. Questo è uno dei motivi per cui gli sviluppatori lo usano per raggruppare contenuti simili.

L'elemento div accetta quasi tutte le proprietà CSS senza problemi. Vediamo alcuni esempi.

1. Come aggiungere proprietà al carattere di un div

Puoi applicare proprietà CSS come font-size, font-family, font-weight e font-style a contenuti raggruppati insieme in un elemento <div>:

<div class="font-properties">
      <p>
        Lorem ipsum dolor sit amet consectetur adipisicing elit. Voluptate quo
        ullam modi alias assumenda, itaque libero? Quas quidem sint illo.
      </p>
      <p>
        Lorem ipsum dolor sit, amet consectetur adipisicing elit. Necessitatibus
        ipsam eaque rem dicta, quos quas ipsum.
      </p>
</div>

body {
      max-width: 900px;
      display: flex;
      align-items: center;
      justify-content: center;
      margin: 0 auto;
      height: 100vh;
      background-color: #f1f1f1;
    }

.font-properties {
      font-family: cursive, sans-serif;
      font-size: 1.3rem;
      font-weight: bolder;
      font-style: italic;
    }

2. Come applicare un colore con un div

Puoi applicare proprietà CSS come color e background-color a contenuti raggruppati in un elemento div:

<div class="color-properties">
  <p>
    Lorem ipsum dolor sit amet consectetur adipisicing elit. Voluptate quo
    ullam modi alias assumenda, itaque libero? Quas quidem sint illo.
  </p>
  <p>
    Lorem ipsum dolor sit, amet consectetur adipisicing elit. Necessitatibus
    ipsam eaque rem dicta, quos quas ipsum.
  </p>
</div>

.color-properties {
  color: white;
  background-color: #2ecc71;
}

3. Come definire lo stile del testo con div

Puoi applicare proprietà CSS come text-transform e text-decoration a un elemento div in questo modo:

<div class="text-properties">
  <p>
    Lorem ipsum dolor sit amet consectetur adipisicing elit. Voluptate quo
    ullam modi alias assumenda, itaque libero? Quas quidem sint illo.
  </p>
  <p>
    Lorem ipsum dolor sit, amet consectetur adipisicing elit. Necessitatibus
    ipsam eaque rem dicta, quos quas ipsum.
   </p>
</div>

.text-properties {
    text-transform: uppercase;
    text-decoration: underline;
  }

4. Come creare un effetto ombra con un div

Puoi aggiungere un effetto ombra a un elemento div attraverso la proprietà box-shadow:

<div class="box-shadow">
      <p>
        Before paying to learn programming, checkout freeCodeCamp.org
        <br />
        The HTML, CSS, and JavaScript curricula would take you from zero to hero
        in web development.
      </p>
      <p>
        There is a Python curriculum that will get you a considerable knowledge
        in Python <br />
        And an upcoming Data Science curriculum.
      </p>
</div>

.box-shadow {
      font-family: cursive, sans-serif;
      background-color: #2ecc71;
      color: white;
      padding: 10px;
      border-radius: 4px;
      box-shadow: 2px 2px 20px 23px #7fecad;
    }

Cosa succede nel CSS qui sopra?

Sono riuscito a creare un effetto ombra con la proprietà CSS box-shadow.

• Il primo valore (2px) rappresenta lo sfalsamento rispetto all'asse x (offset-x).
• Il secondo valore (un altro 2px) rappresenta lo sfalsamento rispetto all'asse y (offset-y).
• Il successivo 20px è il grado di sfocatura, cioè quanto vuoi che sia sfocata l'ombra.
• Il valore 23px è il grado di diffusione (quanto vuoi che si propaghi l'ombra).
• L'ultimo valore è il colore dell'ombra - in questo caso #7fecad.

Il risultato è questo:

Come usare più di un elemento div senza confonderti

L'elemento div è molto usato per tenere insieme contenuti simili. Troverai i div un po' dappertutto, nelle pagine web vecchie ma anche in quelle più recenti, nonostante i tag semantici siano raccomandati per SEO e accessibilità.

Dato che l'elemento div è ancora molto usato, ti consiglio di applicargli classe e id per poterlo maneggiare individualmente attraverso questi attributi.

Ti mostrerò come, costruendo un semplice layout.

La prima sezione che creeremo è l'intestazione, che contiene il logo e una barra di navigazione.

 <div class="header">
      <h2 class="logo">freeCodeCamp</h2>

      <ul class="nav">
        <li><a href="">Home</a></li>
        <li><a href="">About</a></li>
        <li><a href="">Serices</a></li>
        <li><a href="">Contact</a></li>
      </ul>
</div>

Prima di definire lo stile della barra di navigazione, ho fatto un po' di reset in CSS per allineare tutto correttamente e far sì che gli elementi vengano resi in modo gradevole:

* {
   margin: 0;
   padding: 0;
   box-sizing: border-box;
 }

.hero,
.about,
.services,
.contact {
  max-width: 1000px;
  margin: 0 auto;
  margin-bottom: 20px;
}

Nello snippet qui sopra:

• Ho rimosso margine e padding preimpostati.
• Ho impostato una lunghezza massima per le sezioni principali, in modo che non si incrocino, per migliorare l'esperienza dell'utente.
• Ho stabilito un margine inferiore per ogni sezione per lasciare più spazio.
• Ho impostato un margine superiore e inferiore di 0, automatico destro e sinistro per centrare il tutto.

Per impostare in modo adeguato lo stile della barra di navigazione, prenderò il contenitore div col suo attributo di classe header. Userò la proprietà flex, insieme ad altre, per dargli un aspetto gradevole. Prenderò anche il div che contiene la barra (l'elemento ul) con la sua classe e lo disporrò con Flexbox.

.header {
      padding: 0 70px;
      display: flex;
      align-content: center;
      justify-content: space-between;
      margin-top: 20px;
      margin-bottom: 20px;
    }

.nav {
      display: flex;
      align-content: center;
      justify-content: center;
      gap: 60px;
      list-style-type: none;
    }

.nav li a {
      text-decoration: none;
      color: black;
      font-size: 1.2rem;
    }

Per le altre sezioni, ad eccezione del piè di pagina, HTML e stile sono generici:

<div class="hero">
      <h1>Hero Section</h1>
</div>
<div class="about">
      <h1>About Us</h1>
</div>
<div class="services">
      <h1>Our Services</h1>
</div>
<div class="contact">
      <h1>Contact Us</h1>
</div>
<div class="footer">
      <p>&copy; 2021 All Rights Reserved</p>
</div>

.hero {
      background-color: #eee;
      height: 200px;
    }

.hero h1 {
      display: flex;
      align-items: center;
      justify-content: center;
      line-height: 6;
    }

.about {
      background-color: #eee;
      height: 200px;
    }

.about h1 {
      display: flex;
      align-items: center;
      justify-content: center;
      line-height: 6;
    }

.services {
      background-color: #eee;
      height: 200px;
    }

.services h1 {
      display: flex;
      align-items: center;
      justify-content: center;
      line-height: 6;
    }

.contact {
      background-color: #eee;
      height: 200px;
    }

.contact h1 {
      display: flex;
      align-items: center;
      justify-content: center;
      line-height: 6;
    }

.footer {
      background-color: #777;
      height: 40px;
    }

.footer p {
      margin: 0 auto;
      line-height: 1.7;
    }

Ho impostato individualmente alle sezioni un colore di sfondo grigio e un altezza di 200px. Ho posizionato l'elemento h1 al centro con Flexbox e applicato un'interlinea di 1.5.

Infine, ho aggiunto al piè di pagina un colore di sfondo più scuro, per distinguerlo, e centrato il contenuto con un'interlinea di 1.7.

Il risultato è questo:

Conclusione

L'elemento HTML div è ampiamente usato dagli sviluppatori praticamente ovunque.

Tieni ben presente che dovresti usare un HTML semantico al posto dei div, a meno che nessuno (dei tag semantici) si accordi al contenuto che raggruppa. La ragione è che gli elementi semantici sono molto meglio in un'ottica di accessibilità e SEO.

In breve, il div rimane utile e non ci lascerà molto presto, quindi sentiti libero di usarlo ogni volta che ti è necessario.

Grazie della lettura e buon divertimento.

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 ❤