Evgeny_CD (07.08.2007 17:01, просмотров: 1) ответил bialix на я не согласен насчет пункта 2.
Если быть совсем точным, Александр говорит о том, что есть правила, но любое правило в гипертровифированном виде начинает противоречить само себе. Кратко - "заставь дурака богу молиться, он и лоб расшибет".
По сути, он говорит о поиске баланса между двумя сущностями:
* (польза от чужого кода) <-> (оверхед для своего кода от его использования)
* (простота понимания кода другими (и собой через большое время)) <-> (дополнительные затраты на достижение такой простоты)
Второе особенно занятно. Грубо, можно извести все силы на накой-то пусть и нетривальный, но не очень важный кусок, тщательно комментируя его. Возможно при повторном использовании это и будет полезно, но в данном проекте это хреново. Если этот кусок будет не сильно понятен, то, в будущем, может его и перепишут нахрен по причине не понимания, но в текущем проекте ресурсы были сэкономлены.
С другой стороны, нетривиальный и важный кусок кода надо тщетельно описать, дабы не изобретать велосипед.
И, как справедливо отмечает Александр, в начале кодинга далеко не очевидно, что именно станет важным. Это чудесная рекомендация - комментировать спустя небольшое время. Когда все в голове уляжется.
Ну а правило насчет недопущения в комментах "позиционно зависимых вещей" - это чудесный "хинт мышления", его просто надо брать на вооружение и юзать по полной!