История изменений
Исправление unDEFER, (текущая версия) :
Ещё.. Лучше javadoc хотя бы тем что не только для java. В текущем виде правда не для Perl, но не долго исправить.
И.. знаем мы ваш самодокументируемый код. По моему опыту самая главная проблема хакера начинается тогда когда функция вызывает функцию, та третью и когда уровней становится больше 5 ничего уже не разобрать без глубоких знаний деталей проекта. На мой взгляд детальная документация позволяет очень удобно пояснять код именно в том объёме который необходим для понимания кода. А разбирающемуся удобно по имени детали вспоминать: «ага, эту деталь я уже читал, значит пойму».
Исходная версия unDEFER, :
Ещё.. Лучше javadoc хотя бы тем что не только для java.
И.. знаем мы ваш самодокументируемый код. По моему опыту самая главная проблема хакера начинается тогда когда функция вызывает функцию, та третью и когда уровней становится больше 5 ничего уже не разобрать без глубоких знаний деталей проекта. На мой взгляд детальная документация позволяет очень удобно пояснять код именно в том объёме который необходим для понимания кода. А разбирающемуся удобно по имени детали вспоминать: «ага, эту деталь я уже читал, значит пойму».