Как инженер-программист с 20-летним стажем, в основном работающий над вопросами безопасности (SF-PD), я должен сказать, что ваш начальник может не быть тем, кем вы хотите быть вашим примером. Отсутствие комментариев является признаком либо самоучки-программиста-любителя, который так и не научился правильно выполнять работу, либо неопытного инженера. Или, может быть, инженер, у которого просто нет времени - сроки и целесообразность могут сделать ужасные вещи с вашим кодом! ;) Это определенно антишаблон для каждого компетентного инженера-программиста.
Ваш босс может быть очень хорошим программистом, но, похоже, он не хороший инженер-программист. Инженер использует опыт коллективной группы, чтобы избежать ловушек, в которые уже попали другие люди. Эффективное комментирование является частью коллективного группового опыта для программного обеспечения, так же как анализ напряжений является частью коллективного группового опыта для машиностроения. То, что считается эффективным комментированием, является более плавным, и это определенно то, что вы получаете из опыта.
Самое основное, что в комментариях не должно быть сказано, что делает строка кода. Иногда комментарии о том, что делает функция, тоже излишни (особенно в C #). Чрезмерное комментирование может быть столь же неэффективным (и указатель на недостаток опыта), потому что вы не можете найти важные вещи в шлаке. Как новичок, вы, возможно, все еще работаете над выяснением «что» в коде, и для этого вам просто нужно прочитать и понять, что он сделал.
Однако для комментариев важно, что они говорят, ПОЧЕМУ строка кода или функция делает то, что делает, где это может быть неочевидно. Вам нужно настроить модуль X перед модулем Y? Важно ли проверять код возврата, чтобы увидеть, был ли файл уже открыт, или мы сознательно игнорируем код возврата, потому что он был проверен где-то еще? «Почему» в коде будет иметь отношение ко всем, независимо от опыта, и это будет актуально и для него через 6 месяцев, когда он забудет о веской причине для того, чтобы сделать что-то определенным образом. Комментировать не только для других людей, но и для того, чтобы помочь вам в будущем.
Если вы хотите избежать раздражения своего босса, задавайте умные вопросы. Сосредоточьтесь на том, чтобы спросить «почему», и попытайтесь решить «что» сами (если это действительно неясно). Ни один хороший начальник не возражает против того, чтобы его задавали, если это не те вещи, которые вы могли бы найти в R-ing TFM. И ни один хороший инженер не будет возражать против того, чтобы его попросили сделать что-то, что значительно облегчит жизнь другому инженеру и при этом не потребует больших затрат. (Только не просите его засыпать комментарии на всей базе кода!;)