Ho un piccolo progetto scritto principalmente in C ++ che è documentato con Doxygen e testato con un framework di test unitario (Google Test nel mio caso, ma non importa). Ho scritto diversi casi di test per ogni metodo di ogni classe per testare il comportamento del metodo in varie condizioni, e voglio lasciare alcuni commenti per le suite di test. La documentazione di Doxygen è progettata per l'utente di projet, che molto probabilmente non vuole vedere i documenti per i dettagli e i test di implementazione dei progetti.
Voglio sapere qual è la strategia comune della documentazione del test unitario? Non commentarli affatto e considerare i test come documentazione?
O forse lasciare commenti non-doxygen nei file di test? Oppure utilizzare l'opzione doxygen ENABLED_SECTIONS
per compilare la documentazione di test in modo condizionale?