Le altre risposte sono gli standard legali di disclaimer open source che vedi ovunque.
Ne hai bisogno.
Ma non è tutto. Fare solo le cose legali è ciò che mi fa impazzire con così tanto sviluppo open source.
Inserisci anche nella HEADER IN ALTO DEL FILE una descrizione:
- Che cosa è questa (un nome breve)
- Il suo scopo (una lunga descrizione, i come e perché del perché questa cosa esiste, fai finta di spiegare ai bambini di 6 anni.)
Senza queste 2 cose chiunque la guarda deve leggere la tua mente per capire che cos'è questa roba, e se è interessata a questo.
SUCCESSIVO, chiedi dei commenti.
In realtà dovresti commentare come lo hai scritto, non post-ripararlo dopo l'evento.
Tuttavia, i commenti a livello micro servono solo a sprecare tempo e ad infuriare.
fred = fred + 1; // increment fred
Quindi, non farlo.
Metti invece un commento della sostanza prima di un pezzo di codice (non al suo interno!), definendo quale sarà la prossima cosa, essendo generale o specifico come devi essere:
//
// This implements the fast integer line drawing algorithm originally by
// Fred Nurke (see http://www.nurkesoft.com/fild), with the following
// modifications for speed:
// - Frangle the nurgulator before decrementing the frobber;
// - Update the decrementer pointer once only.
//
// Having done that, dispatch it to the ice-age thread where it can sit and
// grow moss for a couple of decades.
//
<neat code comes here for perhaps 10 - 20 lines>
Come generalizzazione ROUGH, un grumo di codice in esecuzione per più di circa 20-30 linee sta diventando un po 'troppo grande - quindi questa è la dimensione approssimativa per un chunk che ha bisogno di un commento esplicativo. Quasi tutto il codice avrà blocchi che sono circa 5 - 30 linee in un blocco con un commento adatto per quel blocco. (Quel blocco svolge qualche funzione o ha qualche scopo che puoi descrivere.)
E infine, i commenti dovrebbero essere ben disposti, non dovrebbero usare acronimi eccessivi o oscuri, dovrebbero leggere come inglese normale, dovrebbero essere grammaticalmente corretti e opportunamente punteggiati.