Siempre he odiado los comentarios que llenan la mitad de la pantalla con asteriscos solo para decirte que la función devuelve una cadena, nunca he leído esos comentarios.Buenos casos de uso de comentarios
Sin embargo, leo comentarios que describen por qué se hace algo y cómo se hace (generalmente los comentarios de una sola línea en el código); estos son realmente útiles cuando se trata de entender el código de otra persona.
Pero cuando se trata de escribir comentarios, no escribo eso, sino que utilizo comentarios solo cuando escribo algoritmos en concursos de programación, pienso en cómo el algoritmo hará lo que hace y luego escribiría cada uno en un comentario, luego escribe el código que corresponde a ese comentario.
Un ejemplo sería:
//loop though all the names from n to j - 1
Aparte de eso no puedo imaginar por qué alguien podría perder un tiempo valioso escribir comentarios cuando podría estar escribiendo código.
¿Estoy bien o mal? ¿Me estoy perdiendo de algo? ¿Qué otros buenos casos de uso de comentarios no conozco?
duplicado unas cuantas veces, reformulado en diversas formas leves: http://stackoverflow.com/questions/tagged?tagnames=comments&sort=votes –