Сообщение от Kolyaj
|
Главное, чтобы также легко такой код читался вами же через год. Только через год он почему-то не хочет легко читаться.
|
Я последнее время упор на комменты делаю. Пытаюсь расписать все от логики до тонкостей.
В vba, и не только, новичкам рекомендуют начинать объявление переменной с префикса типа данных. Честно, следовал этому правилу достаточно долго, но записи вида lСounter (счетчик типа Long) или dCurrentDate (d - Date, текущая дата) просто убивают. На данный момент предпочитаю делать примерно так:
/*
Функция noName служит для того, чтобы...
Передается:
x - то-то
z - то-то
Возвращается:
*/
function noName(x, z) {
// код функции с подробными (не тупыми) комментариями
}
Зачастую, комменты дольше пишу, чем код, чтобы мысль сформулировать предельно ясно
В идеале - прочитал комментарии, и сразу все вспомнил, понял логику и механизм работы.
Кто знает, быть может со временем я изменю свою точку зрения...