Comments 16
Я что гораздо важнее продуманная архитектура приложения
+1
Чем вам волшебство не нравится? Кастую файербол 10го левела!
+1
> документирование методов и функций
У Вас есть много времени? У меня — нет.
У Вас есть много времени? У меня — нет.
-4
UFO just landed and posted this here
Вы когда-нибудь работали с чужим кодом?
+2
У вас его будет еще меньше, когда через месяцок-другой вы будете тратить время на разбор недокументированного кода. А с ростом числа возвратов Х к нему прямо пропорционально будут расти и потери.
+1
Согласен, но тут главное без фанатизма
//метод getId вовращает ид текущего объекта
public function getId(){//начало метода getId()
return $this->id;//возвращаем текущий ид
}// конец метода getId()
Вот такие комменты никаму не нужны
Я за коментирование сложной логики и принципиальных моментов
//метод getId вовращает ид текущего объекта
public function getId(){//начало метода getId()
return $this->id;//возвращаем текущий ид
}// конец метода getId()
Вот такие комменты никаму не нужны
Я за коментирование сложной логики и принципиальных моментов
+1
Мы не настолько богаты, чтобы покупать дешёвые вещи.
Из той же оперы.
Из той же оперы.
0
Чем понятнее и структурированее код, тем меньше его надо документировать.
0
Замечание справедливое, но как уже было замечено, хороший код не означает хорошее приложение (с точки зрения архитектуры).
Определил для себя следующую политику комментирования. Если функция/класс будет доступно как публичное API, то методы комментирую обязательно (чтобы потом можно не парясь составить API). Если нет, то просто стараюсь писать структурировано и давать понятные имена методов и переменных, комментирую сложные места кода + @todo, где что-то надо доделать.
Определил для себя следующую политику комментирования. Если функция/класс будет доступно как публичное API, то методы комментирую обязательно (чтобы потом можно не парясь составить API). Если нет, то просто стараюсь писать структурировано и давать понятные имена методов и переменных, комментирую сложные места кода + @todo, где что-то надо доделать.
0
Sign up to leave a comment.
PHP: Шаг к качественному коду и ZendStudio ( Code Assist )