дорабатываю функционал в УПП, жаль, что комментариев по коду почти нет
зато увидел вот такой содержательный комментарий в управлении взаиморасчетами в процедуре ПодготовитьТаблицуПоВзаиморасчетам
// Получим документ расчетов с контрагентом
ДокументРасчетовСКонтрагентом = ПолучитьДокументРасчетовСКонтрагентом(СтруктураШапкиДокумента);
Особенно приятно когда в особо тяжелых случаях откроешь справку, а там описано, что и так видно: например, кнопка "Выполнить выполняет". КЭП отдыхает...
Перетензия не к 1С, а к справке в целом в любых программах.
(0) много раз замечал что упп пишут совершенно разные люди. одни делают комментарии, другие нет. в большинстве случаев их нет. Был один случай когда комментарий реально помог.
Чтобы обнаруживать ошибки, программист должен иметь ум, которому доставляет удовольствие находить изъяны там, где, казалось, царят красота и совершенство. Фредерик Брукс-младший