|
Мое мнение таково: комментирование модификаций стандартного функционала просто необходимо, так как в отличие от технической документации, комментарии хранятся непосредственно в коде, не "утежеляя" его. Также комментирование кода является показателем профессионализма разработчика, наличие понятия и знания оформления программного кода, согласно ГОСТам. Такой подход способствует структуризации кода, повышает его читабильность и быстроту разбора "полетов". Вообще, уважаемые, не скупитись хотя-бы на комментарии для самих себя (пройдет пара лет и даже автору будет сложно без технической документации вспомнить то, что он когда-то реализовывал). А так осталяйте комментарии как наследие своим приемникам, таким образом Вы способствуете поддержке и развитию Ваших-же разработок. Умение и способность делиться знаниями - высший уровень мастерства и благоразумия. По себе знаю, что техническая документация емеет свойство теряться. Если нет специально выделенного человека ведущего учет всех модификаций и ТЗ на них, все версии и доработки модификаций, тогда надежда на Вас самих. Представьте, как сложно будет перенести модифицированную функциональность, к примеру, при переходе на новую версию MS AX, если ее практически не выявить, не имея на нее описания или ТЗ, не находя в коде комментариев и меток. А потом как замечательно, когда с течением времени Вы благодаря оставленным комментариям решаетесь усовершенствовать или перекписать прошлую реализацию функионала с преминением Ваших новых знаний.
|