Uno dei motivi per il quale la mia pigrizia senile mi tiene lontano da Git, è proprio che non risco a scrivere codice fuori di un file documentato.
In realtà non è difficile scrivere al documentazione d’uso; si tratta di un normale documento che scrivi come ti pare con la classe che vuoi, con i font che vuoi, sapendo che devi usare spesso il font teletype e i comandi \verb, \verb*, e gli ambienti verbatim e verbatim*, quidni con problemi di giustificazione visto che normalmente il font teletype non consente la divisione in sillabe in fin di riga. Scrivendo in italiano puoi sempre esguire correzioni via via che scrivi inserendo un semplice doppio apice (“) nelle parole scritte in teletype che escono dai margini.
Scrivere direttamente il codice commentato è più difficile; ma certamente più utile; nella guida tematica relativa alla creazione di nuove classi ci sono alcuni esempi e comunque ci sono i riferimenti utili per scrivere i file documentati, quelli con estensione dtx; c’è scritto anche come renderli auto estraenti; nel senso che una passata del file .dtx a pdflatex permette di comporre tutta la documentazione commentata in un file pdf, e contemporaneamente un file di classe.cls e/o uno o più file di stensione .sty, e/o uno o più file di servizio con le estensioni più varie.
Forse si può fare anche su Git, ma non ho scoperto come e sono troppo pigro per cercare di documentarmi; sono anche un po’ cretino, perché così mi precludo la possibilità di partecipare a progetti di lavoro cooperativi fra diverse persone che collaborano assieme.