Sono uno sviluppatore dilettante e tutti i miei programmi fino ad ora erano abbastanza semplici da essere documentati all'interno del codice. Durante la lettura del codice era chiaro cosa stavo facendo una tale azione (il mio test standard era guardare il codice 6 mesi dopo e capire tutto alla prima lettura - e ho una breve durata della memoria).
Ora mi trovo di fronte a un programma che sta superando le mie capacità per ricordare le varie interazioni tra
- il codice stesso
- gli indici nel database
- le interazioni tra i vari moduli (codice principale "lavoratore" e "libreria")
La mia documentazione attuale è una lavagna in cui ho tutti i tipi di caselle e frecce che puntano al codice, agli indici del database, alle azioni eseguite, al cambio di stato ecc. Solo per riferimento, un frammento del pasticcio:
Lamiadomandaèseesisteunaseriestandardodenominatadibestpractice(denominatanelsensochesitrattadiuninsiemedipraticheraggruppatesottounnomespecifico)perladocumentazionediprodottipiùcomplessi.
Qualisonoleparolechiavechedovreicercare(itentativigeneralidi"standard di architettura del software per i documenti" e simili variazioni di solito portano a software per i flussi di lavoro o alla costruzione di sistemi CAD di architettura).
Mi aspetto anche che non ci possano essere best practice generali per le descrizioni di alto livello e che ognuno costruisca una propria filosofia.