Corso sugli script bash parte 02 - i commenti
Channel: Nicola Jelmorini
Date: 02/03/2013

Commentare il codice è importante:
* per noi stessi se a distanza di tempo vogliamo capire facilmente cosa abbiamo fatto. Infatti non è per niente scontato che ciò che è chiaro ora a mente fresca mentre lo facciamo, lo sia ancora altrettanto a distanza di tempo.
* per gli altri se abbiamo intenzione di distribuire il nostro codice. Un vecchio adagio dice: 100 programmatori, 100 soluzioni diverse. Quindi è molto importante commentare il proprio codice in modo da facilitarne la comprensione ad altri che non necessariamente vedono e risolvono le cose come noi.
* per le istruzioni d'uso. Dove meglio indicare come usare uno script se non nel commento iniziale? Aprendo lo script è quello ciò che vediamo per primo
* per segnalare la licenza. Se intendiamo distribuire il nostro lavoro con tutte le caratteristiche del software open source, è buona cosa mettere nel commento iniziale sotto quale licenza è rilasciato.