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

Перейти к навигации Перейти к поиску
оформление
Метка: possible spambot (testing)
(оформление)
Метка: possible spambot (testing)
 
Добавлять комментарии правильнее в конце каждой строки. То есть так:
код сайта <nowiki><!--</nowiki<>комментарий<nowiki>--></nowiki>
Хотя так делать правильно, но есть и нюансы по добавлению комментариев в конец строк.
 
=== <span style="color:green">'''Нюансы комментирования'''</span> ===
Добавлять комментарии в конец каждой строки - это удобно, но нужно знать некоторые правила по комментированию. Например не надо употреблять много научных терминов по [[Учебник по программированию/Понятия информатики|информатике]]. Эти комментарии тогда просто не принесут пользы новичкам, а тем более Вам. Потому, что они не поймут и в конце концов все кончится бесконечными вопросами. Во-вторых не надо писать например на русском языке комментарии, если Вы находитесь в Англии. Это неуместно лишь по одной причине: "Никто Вас не поймет (почти никто)."
Анонимный участник

Навигация