Recomendados
Más contenido relacionado
La actualidad más candente
Clean code capitulo 4("Comments ")
- 2. comentarios • Nada puede ser tan útil como un comentario bien colocado. • Nada puede ser tan perjudicial como un viejo comentario • los comentarios son, como mucho, un mal necesario
- 3. • El uso adecuado de los comentarios es compensar nuestra incapacidad para expresarse en el código. • Mas exprecion en codigo es menos comentarios
- 4. • La verdad solo esta en el codigo • El codigo malo genera comentarios
- 5. Buenos comentarios • El mejor comentario es el que no se escribe • Usarlos para describir el return de un metodo • Explicar la intencion • Advertencias • Todo comments
- 6. Malos comentarios • Por lo general son excusas para tener codigo malo • dificil de entender • Comentarios redundantes
- 7. • comentarios engañosos • Comentarios por mandatos(cada variable ) • Journal Comments
- 8. • Comentarios de ruido • Marcador de poscicion • Attributions and Bylines • Commented-Out Code • De informacion
Notas del editor
- Los comentarios viejos pierden la relacion con el codigo
- los programadores deben ser disciplinados suficiente para mantener a los comentarios en un alto estado de conservación, la relevancia y exactitud. la fabricación de un código tan claro y expresivo, que no necesita de los comentarios en el primer lugar. En lugar de gastar su tiempo a escribir los comentarios que explican el lío que has hecho, lo gastan limpiar ese desastre.
- Commented-Out Code Es codigo que esta comentado por personas que no son capaces de borrarlo porque creen que tendra alguna importancia Ademas que pueden confundir a los que lean el codigo Informacion mucha, en el lugar incorrecto , no es ovio lo que se quiere decir