Por que precisamos de comentários, é verdade que um bom código pode ser lido sem eles e como o perfeccionismo retarda o desenvolvimento em 4 vezes. Para iniciantes, equipes, profissionais.
Conhecimento intuitivo
com comentários, como em qualquer relacionamento, cria problemas ocultos. De stackoverflow ou de nossa criatividade, inadvertidamente formamos a maneira de comentar. Alguém é muito detalhado, alguém com humor, e geralmente alguém escreve "sem comentários" e depois de meio ano nem tenta entender como seu código funciona.
P.S. Se você é a pessoa que aprendeu sobre os comentários no código do livro, dê um sinal) Se você precisar de respostas imediatamente, elas estão no final.
- - , "" , . , ... , , .
, . – , "" , .. , .
, , .
–
*. 950 , : " ". : " ", " , ".
, – . ? , , 20 . – -, , . , , " " .
20% , -, 5.
– , . , .
, 20% 80% – , , , . . , 100% "" / " " ( ). == .
, Win – , , , " " , , , . – .
– . , , .
*Code Complete, , 1993. " " " ". – , , "" , , .
.. , , – .
"" .
" " – /. . , (). : .
– , , . , , .
– , , , / , TODO (), FIX () .. , , . : , – .
. 10 000 , 3 . – , "", . ( ), .
– , . . .
– , , .
– . - . , , ", ". , , , ... , .
, !
.. ... .