AN
Но в приватном кода и методы как бы приватные
Size: a a a
2020 January 02
AN
не в том смысле, что они private, а в том, что они не публичные
MM
если это внутренние либы или часть приложения, то какой смысл?
вы у себя с комментами как поступаете?
SZ
у нас их нет)
MM
совсем?)
SZ
9 штук нашел
k
Если у кода строго один пользователь, то не обязательно
мне время от времени приходится заглядывать в код написанный мною лет 5 назад, и часто такое впечатление что кто то другой писал)) хоть я точно знаю что это я писал - и если бы не было подробных комментов для методов - то было бы сложнее понять что я там нафигачил давным давно))
SZ
но там больше описание поведения
AM
если это внутренние либы или часть приложения, то какой смысл?
Удачно отделённый модуль, если это не набор реализаций очередных View, Presenter и прочих, вполне себе можно покрыть комментами. Не могу сказать, что от них нет пользы — люди меняются, намёк на техническую документацию остаётся.
MM
в самодокументируемый код я тоже особо не верю) 9 штук на проект, звучит оч сомнительно)
хорошо, что меня не взяли))
хорошо, что меня не взяли))
AM
Может я конечно попутал...
Не нашёл кнопку в настройках. Но там же панель управления космолётом, потому, возможно, просто не нашёл)
SZ
в самодокументируемый код я тоже особо не верю) 9 штук на проект, звучит оч сомнительно)
хорошо, что меня не взяли))
хорошо, что меня не взяли))
в тесты у меня больше веры
AN
Не нашёл кнопку в настройках. Но там же панель управления космолётом, потому, возможно, просто не нашёл)
Я тоже не нашел. Значит действительно сделали, чтобы не генерили мусор
MM
в тесты у меня больше веры
это работает, когда ты полностью погружён и в курсе каждого сделанного костыля
MM
а если ты с улицы пришёл, то скок времени будешь тесты парсить при выполнении задачи?
AN
Я как-то мавеновским генератором нагенерил этого на проект, потом дооолго чистил
AN
а если ты с улицы пришёл, то скок времени будешь тесты парсить при выполнении задачи?
Да, многие товарищи предлагают идти читать тесты, меня это напрягает.
MM
Да, многие товарищи предлагают идти читать тесты, меня это напрягает.
ну, таким товарищам тоже хочется посоветовать пойти)
понятное дело, что актуальность у теста в большинстве случаев выше, чем у докблока, но...
понятное дело, что актуальность у теста в большинстве случаев выше, чем у докблока, но...
SZ
докблоки в духе
а дока быстро потеряет актуальность, либо там какая-то чушь будет написана. мне проще по коду пробежаться почитать что происходит
и на весь проект/сервис/компонент иметь сгенеренный mkdoc какой-нибудь с общим описанием о чем оно
@param/@return с дублированием типа + имени особой смысловой нагрузки тоже не будут нестиа дока быстро потеряет актуальность, либо там какая-то чушь будет написана. мне проще по коду пробежаться почитать что происходит
и на весь проект/сервис/компонент иметь сгенеренный mkdoc какой-нибудь с общим описанием о чем оно
MM
ну с param\return, и уж тем более в колине, согласен.
а вот всякие поведенческие моменты в кол-ве 9 штук - ну такое
а вот всякие поведенческие моменты в кол-ве 9 штук - ну такое