Учебник по программированию/Как хорошо комментировать?: различия между версиями

 

Добавлять комментарии правильнее в конце каждой строки. То есть так:

Хотя так делать правильно, но есть и нюансы по добавлению комментариев в конец строк.

=== <span style="color:green">'''Нюансы комментирования'''</span> ===

Добавлять комментарии в конец каждой строки - это удобно, но нужно знать некоторые правила по комментированию. Например не надо употреблять много научных терминов по [[Учебник по программированию/Понятия информатики|информатике]]. Эти комментарии тогда просто не принесут пользы новичкам, а тем более Вам. Потому, что они не поймут и в конце концов все кончится бесконечными вопросами. Во-вторых не надо писать например на русском языке комментарии, если Вы находитесь в Англии. Это неуместно лишь по одной причине: "Никто Вас не поймет (почти никто)."