Hola!
Como muchos saben, no soy muy amigo de los comentarios en el código. Si bien es cierto que 2 líneas de texto pueden agregar mucho contexto útil, siempre trato de evitarlos.
Veamos el siguiente ejemplo de un comentario en una funci’on que no aporta absolutamente nada
Personalmente los comentarios me quitan “espacio de lectura” dentro del editor de código. El amigo Victor, hace un tiempo me sugería la combinación CTRL+M, CTRL+O para colapsar todos los comentarios de miembros en el editor de código. Es una buena sugerencia, el ejemplo anterior quedaría de la siguiente manera:
Sin embargo, es probable que dentro del código y fuera de los comentarios de la firma de una función, sigan existiendo comentarios que no aporta nada. En esos casos, pues mejor borrarlos. Hoy he encontrado una extensión para Visual Studio 2015 que nos permite eliminar los comentarios de un archivo, sean single line o multiple line. Al estar integrado en el modelo de acciones nuevas del IDE de VS2015, tenemos también la posibilidad de tener un Preview de los cambios en el archivo
Mira, me ha sacado una sonrisa esta extensión hoy .. me he encontrado solo con código y la verdad es que se agradece.
Importante: Cuando debes cumplir normativas de documentación que obligan a tener comentarios, herramientas como GhostDoc suelen ser muy útiles para automatizar esto último. Y por cierto, ya hace más de 8 añazos de este post.
References
– El Bruno, Visual Studio AddIns: GhostDoc http://geeks.ms/blogs/elbruno/archive/2007/03/07/visual-studio-addins-ghostdoc.aspx
– Visual Studio Gallery, Comments Remover https://visualstudiogallery.msdn.microsoft.com/77e5af13-e4b3-4cb9-8c44-e7cd645a0c33
Saludos @ Madrid
/El Bruno
El Bruno 