я описание к процедурам когда ставлю с тройными дефисами, чтобы если мой модуль кто-то будет использовать чтобы по по help можно было получить кратку доку по тому для чего нужна та или иная функция/процедура, которые я пишу...
Я по необходимости пишу инструкции пользователя(для обычных смертных) и инструкции к программисту(для кодеров, кто так же может примерно прикинуть, что к чему, переменные, процедуры, либы и т.п.), и то это было в основном когда диплоные писал...
я даже короткий код пишу с комментариями, чтобы потом легче отлаживать, я не только пишу сво код, но если долго его не корректирую, комментарии не будут лишними
ага, а коментарии ты редактируешь при редактировании кода? или код версии 3.0, а коментарии версии 0.1?)
Я по необходимости пишу инструкции пользователя(для обычных смертных) и инструкции к программисту(для кодеров, кто так же может примерно прикинуть, что к чему, переменные, процедуры, либы и т.п.), и то это было в основном когда диплоные писал...
Просто был такой случай, я использовал инструкции в компании, когда тех поддержка разработчиков, не обновляла долго доки и получалось разбираться только по RFC, когда решали трабл тикиты(кейсы)...
Просто был такой случай, я использовал инструкции в компании, когда тех поддержка разработчиков, не обновляла долго доки и получалось разбираться только по RFC, когда решали трабл тикиты(кейсы)...