Comentando nuestro código

Es importante conocer lo útil que es realizar comentarios en los códigos, algo especialmente práctico, en especial cuando tenemos que retomar o revisar un código después de haberlo escrito un par de meses atrás.

Miguel Matas en su blog, realiza un post sobre La importancia de los comentarios.

Interesante el artículo de Variable not found donde nos daba 13 consejos para comentar nuestro código.

Son todos consejos muy buenos y me gusta sobre todo que van más allá de la implementación concreta en un lenguaje concreto y en lugar de eso se centra en cual debe ser el espíritu de los comentarios: No comentar lo evidente, escribir código que estéautocomentado, comentar como parte del proceso de programación, no después, etc.

Este otro árticulo habla del código comentado en programación web, aunque todavía no hemos profundizado bastante sobre esto, nos dice algo así como que hagamos los comentarios dentro del código PHP embebido y no dejemos expuestos nuestros comentarios internos.