Comentario bueno, malo, feo

¿Por qué necesitamos comentarios? ¿Es cierto que un buen código se puede leer sin ellos y cómo el perfeccionismo ralentiza el desarrollo 4 veces? Para principiantes, equipos, profesionales.





El bueno, el feo y el malo, 1966
El bueno, el feo y el malo, 1966

Conocimiento intuitivo

con comentarios, como en cualquier relación, crea problemas ocultos. Desde stackoverflow o desde nuestra creatividad, sin saberlo, formamos la forma de comentar. Alguien es demasiado detallado, alguien con humor, y alguien generalmente escribe "sin comentarios" y después de medio año ni siquiera intenta entender cómo funciona su código.





PD Si usted es la persona que se enteró de los comentarios en el código del libro, dé una señal) Si necesita respuestas de inmediato, están al final.





- - , "" , . , ... , , .





, . – , "" , .. , .





, , .





https://shoot-photo.com/desktop-wallpaper-zen.html
https://shoot-photo.com/desktop-wallpaper-zen.html

*. 950 , : " ". : " ", " , ".





, – . ? , , 20 . – -, , . , , " " .





20% , -, 5.





– , . , .





, 20% 80% – , , , . . , 100% "" / " " ( ). == .





, Win – , , , " " , , , . – .





– . , , .





*Code Complete, , 1993. " " " ". – , , "" , , .





.. , , – .





  1. "" .





    1. " " – /. . , (). : .





    2. – , , . , , .





    3. – , , , / , TODO (), FIX () .. , , . : , – .





  2. . 10 000 , 3 . – , "", . ( ), .





  3. – , . . .





  4. – , , .





  5. – . - . , , ", ". , , , ... , .





, !





.. ... .








All Articles