Ho discusso con un amico sulla necessità di commenti e sull'efficienza dei diversi stili di commento. L'argomentazione si è conclusa abbastanza velocemente, in quanto non è stato possibile trovare alcuna ricerca - o saggio - a supporto di entrambe le affermazioni.
Sono state condotte serie ricerche sull'efficienza dei diversi stili di commento? Se sì, cosa ha mostrato? Sono principalmente interessato a:
- Lunghezza (penso che i commenti più lunghi di un tweet non vengano mai letti)
- Tipo (Sono strongmente favorevole ai commenti che sono esempi di codice effettivi, che spiegano come chiamare un metodo)
- Posizione (come una linea separata? alla fine della linea?)