V
Правда не знаю
Можете рассказать как боретесь с двумя проблемами:
- устаревание описаний
- программисты часто выдают сложночитаемые документы, например с кучей деталей осложняющих понимание и повторяющих код
Size: a a a
2021 April 11
П
П
?
V
Могу я, как делаю у себя
Не борюсь с этими проблемами, документация используется для обучения
Обучающий сам заинтересован в обновлении
Не борюсь с этими проблемами, документация используется для обучения
Обучающий сам заинтересован в обновлении
V
Заставлять писать доки смысла нет, кмк
А вот побуждать написать для себя — удобно
А вот побуждать написать для себя — удобно
w
повторяющих код - это надо чтобы и документацию и код кто-то ревьювил. Вообще не должно быть проблемой.
V
А зачем он повторяющийся появляется?
V
Ревьюить — это уже решать проблему появления
АВ
Удивительно просто что про ген религиозности я не первый раз слышу, его можно обсуждать. А гены гомосексуальности / гетеросексуальности нельзя. Это другое, тут понимать надо.
V
Все так)))
ЕК
Что бы не заниматься перфекционизмом и не усложнять порой) В разумной мере иногда хорошее решение.
ЕК
Зависит от задачи
w
ну типа программист ленивый, не хочет дополнительно напрягаться, пишет на отъебись какой-то документ. И на ревью его просят поправить. после нескольких таких просьб/реджектов будет чуть получше делать. обратная связь
ЕК
Как минимум я против 100500 утилит во имя отсутствия повторяющегося кода
V
Так почему он на отьебись-то пишет?
c
Тогда зачем нанимали ленивого? :)
w
Ленивые - самые топ же. не тратят время понапрасну.
V
Я к тому, что вы сделали систему, где они пишут на отьебись, видимо, потому как им выгоды от написания не на отьебись нет
П
Я просто сталкивался с тем, что прочитав страничку в жире огорчался и просто уходил читать код. Часто от такой документации пользы минимум, а иногда и вред(
Ms
Вустан не допускает ошибок найма