Кстати, у меня все скрипты и конфиги с комментариями. Так что, если вместо меня придёшь администрировать мои сервера, тебе достанется хорошее наследство.
Оставь надежду Дися.
Но вот такой, например, пример (извиняюсь за тавтологию)...
Настройка брандмауэра. В винде это делается штатной утилитой из панели управления. И вставить свои комментарии там нет никакой возможности.
И не надо. Достаточно описания ключевых настроек отдельным файлом. Это гораздо правильнее.
В Линуксе брандмауэр настраивается через скрипт, который каждый админ составляет под свои конкретные цели. Вот, например, мой.
Каждое правило имеет комментарий.
Где общее описание скрипта?
Но что нового почерпнёт для себя из них специалист моего уровня?
Он не должен подчерпывать. Он должен иметь представление, что происходит в скрипте.
В какой момент применяется тот или иной.
То же про конфиги разных служб. Конфиги редко пишут с нуля. Как правило, берут заготовку и уже её подгоняют под нужный сервер. Если я хорошо знаю данный продукт, то что я буду делать сначала с этой заготовкой? Мочить комментарии, ибо они мне не нужны, а на читаемость и восприятие конфига сказываются крайне отрицательно, ибо символьный мусор. Что сделает специалист моего уровня? Откроет конфиг, и изучит его. И комментарии ему тоже не будут нужны, в крайнем случае их значение он посмотрит в доках. Так что комментарии и документирование стандартных манипуляций с серверами нужны не специалистам "моего уровня", а тем, у кого этот уровень значительно ниже.
Нет, если ты начинаешь мочить комментарии, потому что они тебе якобы мешают - ты специалист низкого уровня, потому что думаешь только о себе. Ты не работал в большой комманде и не имеешь навыков этой работы. Администрировать одному - это лишь один из навыков.