Показать сообщение отдельно
  #19 (permalink)  
Старый 11.01.2012, 21:45
Аватар для nerv_
junior
Отправить личное сообщение для nerv_ Посмотреть профиль Найти все сообщения от nerv_
 
Регистрация: 29.11.2011
Сообщений: 3,924

Сообщение от Kolyaj
Главное, чтобы также легко такой код читался вами же через год. Только через год он почему-то не хочет легко читаться.
Я последнее время упор на комменты делаю. Пытаюсь расписать все от логики до тонкостей.
В vba, и не только, новичкам рекомендуют начинать объявление переменной с префикса типа данных. Честно, следовал этому правилу достаточно долго, но записи вида lСounter (счетчик типа Long) или dCurrentDate (d - Date, текущая дата) просто убивают. На данный момент предпочитаю делать примерно так:

/*
	Функция noName служит для того, чтобы...
	Передается:
		x - то-то
		z - то-то
	Возвращается:
*/
function noName(x, z) {
	// код функции с подробными (не тупыми) комментариями
}


Зачастую, комменты дольше пишу, чем код, чтобы мысль сформулировать предельно ясно В идеале - прочитал комментарии, и сразу все вспомнил, понял логику и механизм работы.
Кто знает, быть может со временем я изменю свою точку зрения...
__________________
Чебурашка стал символом олимпийских игр. А чего достиг ты?
Тишина - самый громкий звук

Последний раз редактировалось nerv_, 11.01.2012 в 21:49.
Ответить с цитированием