Bon, mauvais, moche commentaire

Pourquoi avons-nous besoin de commentaires, est-il vrai qu'un bon code peut être lu sans eux, et comment le perfectionnisme ralentit le développement de 4 fois. Pour les débutants, les équipes, les pros.





Le bon, le mauvais, le truand, 1966
Le bon, le mauvais, le truand, 1966

Connaissance intuitive

avec des commentaires, comme dans toute relation, crée des problèmes cachés. De stackoverflow ou de notre créativité, nous formons sans le savoir la manière de commenter. Quelqu'un est trop détaillé, quelqu'un d'humour, et quelqu'un écrit généralement "sans commentaires" et au bout de six mois n'essaye même pas de comprendre comment son code fonctionne.





P.S. Si vous êtes la personne qui a appris les commentaires dans le code du livre, donnez un signe) Si vous avez besoin de réponses tout de suite, elles sont à la fin.





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





, . – , "" , .. , .





, , .





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