я даже короткий код пишу с комментариями, чтобы потом легче отлаживать, я не только пишу сво код, но если долго его не корректирую, комментарии не будут лишними
я описание к процедурам когда ставлю с тройными дефисами, чтобы если мой модуль кто-то будет использовать чтобы по по help можно было получить кратку доку по тому для чего нужна та или иная функция/процедура, которые я пишу...