Как можно оценить качество комментов? У вас есть какие-то метрики?

Question

SAP ABAP

Acid Firewood

Как можно оценить качество комментов? У вас есть какие-то метрики?

#abap #english #programming

0

30.12.2021

4 ответов

13 просмотров

Acid Firewood Автор вопроса

Alexander Nosov
В книги Боба Мартина "Чистый код" есть целая глава...

Есть разные подходы. Одни гуру говорят, что комменты необходимы, другие - что код должен быть настолько простым, что не требуется комментов, т.е. самодокументируемым. Так что, тут стандартов нет. Плюс, вы поймите, что у САПа есть куча дырок, в виде всяких User-Exit'ов, Badi (old|new), неявные расширения. Все эти расширения могут стрельнуть в куче мест. И вы хотите, чтобы САП вам на всё это волшебную таблетку давал? )))))\

0

30.12.2021

Dmitry B

Формальных критериев и метрик нет конечно же. Но главным неформальным критерием, как бы по-индусски это не звучало - является кол-во строк. Скудный коммент может понравиться QA, а может не понравиться ("не понятно"), а развернутого коммента со своим видением вопроса - вполне достаточно, не припомню придирок к стилю изложения. Бывает везет и можно скопипастить формулировку от консультанта по соотв. запросу

0

30.12.2021

Acid Firewood Автор вопроса

Dmitry B
Формальных критериев и метрик нет конечно же. Но г...

Печальная метрика. Если сроки горят, то там м.б. полный bullshit. На первом месте работы, когда только осваивал ABAP, довелось мне принимать документации от одной, достаточно известной фирмы, которая нам тогда внедряла САП. Ребята. То, что они нам прислали, кроме как "насрали", не назовёшь. И комментарии в коде были крайне печальные. Если вообще были. И поддержки от них потом никакой не было.

0

30.12.2021

Alexander Nosov · Accepted Answer

Alexander Nosov

В книги Боба Мартина "Чистый код" есть целая глава на этот счет

0

30.12.2021

169 похожих чатов

Как можно оценить качество комментов? У вас есть какие-то метрики?

4 ответов

Похожие вопросы