Lavoro come tecnico di supporto, avendo accesso al codice sorgente, e mi piacerebbe usare questa opportunità per documentare il codice sorgente, ma inciampo su una prima domanda: come posso iniziare?
Per le applicazioni a thread singolo, questo è semplice: l'utilizzo di una struttura ad albero (la funzione main()
chiama alcune funzioni secondarie, chiamando le funzioni subsubili, ...) può essere eseguita in modo abbastanza semplice usando diagrammi UML standard.
Per le applicazioni multi-thread, questo diventa più difficile: potrei creare una struttura ad albero per i thread e una struttura ad albero per le chiamate di funzione, ma temo che il collegamento tra entrambi gli alberi possa creare un documento molto disordinato (mentre l'intera idea di documentazione è di chiarire).
Esiste un modo standard per documentare il codice sorgente per le applicazioni con multithread?
Ho dato un'occhiata a UML Diagrams of Multi-Threaded Applications ma non mi piacciono i diagrammi di sequenza per l'elaborazione di sottofunzioni, chiamate sottofunzioni, ...