Ho letto domande come questa: I test unitari sono realmente utilizzati come documentazione?
Riguardo ai commenti al codice; la mia ricerca finora mi sta dicendo:
1) Alcuni sviluppatori non gradiscono alcun commento sul codice e preferiscono leggere i nomi dei metodi del codice del test unitario per capire il codice.
2) Alcuni sviluppatori preferiscono i commenti al codice e i nomi dei metodi di test unitario per comprendere il codice
Ho usato lo strumento di documentazione di Sandcastle per documentare la mia API di progetto. Sto discutendo se usare Sandcastle per generare file .HTML per il mio progetto di unit test in modo che qualcun altro che li legge li capisca più rapidamente. È necessario o completo? Il mio istinto mi sta dicendo: documenta l'API con i commenti del codice, ma non documenta il progetto di test vero e proprio.
Il motivo per cui lo chiedo è perché ho letto ieri una domanda in cui un utente stava parlando di documentare il progetto di test spiegando che cosa fa ogni test in modo più dettagliato con Sandcastle.