Меня давно интересует тема комментирования кода. Этот пост подвиг меня формализовать свою идеологию документирования кода.
С одной стороны комментарии это типа правильно, с другой я не вижу в них особого смысла. Более того, те книжки по программированию которые я читал, как-то опускают этот момент или по крайней мере не придают комментариям большого значения. Я хочу изложить свои соображения, почему нет смыла описывать все описания параметров функций, методов и свойств классов и т.д.
Слова «описывать все описания » я написал неслучайно, ведь это почти то же что и
С одной стороны комментарии это типа правильно, с другой я не вижу в них особого смысла. Более того, те книжки по программированию которые я читал, как-то опускают этот момент или по крайней мере не придают комментариям большого значения. Я хочу изложить свои соображения, почему нет смыла описывать все описания параметров функций, методов и свойств классов и т.д.
Слова «описывать все описания » я написал неслучайно, ведь это почти то же что и
std::map<std::string, Person*>mapPPersonsNames //map person pointers by names