V
Так не было интереса у пишущих писать нормально
Size: a a a
2021 April 11
V
Как можно сделать так, чтоб был интерес?
ЕК
Вот да, не понимают что ли что им, ленивым, потом придется жопы напрягать что бы с кодом работать?)
Ms
Документировать то, что редко меняется
V
Люди не должны понимать, люди должны ощущать
ЕК
Ощущать что?) Хочу убедиться что правильно понял
V
Ну смотри, вот модель:
Человек пишет документ чтобы по нему рассказать кому-то что-то
Человек пишет документ чтобы по нему рассказать кому-то что-то
w
Ну, например, у нас документация к сервису - это список ссылок к логам, метрикам, коду, к ридми где написано как локально запускать и список всех RFC и PRDs. как таковая документация кода не входит в definion of done. Но вполне могу представить команды где просят документирвать, так как кому-то может проще читать документ чем код.
V
Очевидно, он напишет так, чтоб объяснить проще было
V
И не будет писать на отьебись
V
Интерес писать хорошо появится в ощущениях у человека
ЕК
А, ощущать на своей шкуре боль? Ну опять таки, действие->последствия не всегда сразу связка срабатывает.
ЕК
Но это конечно предпочтительный вариант что бы так работало)
V
Ну вот да
Написал плохую доку
Видит, как трудно по ней объяснять
Видит, сколько тратит времени на повторение словами
Написал плохую доку
Видит, как трудно по ней объяснять
Видит, сколько тратит времени на повторение словами
V
Натурально хочет потом доку получше сделать
w
а кстати, я всегда читаю интеграционные тесты - это дает самое лучшее понимание какая последовательность вызовов в апи. Так что без документации жить можно.
П
У меня ситуация, что человек старался и писал от чистого сердца, но получилось непонятно. Когда я пытаюсь донести мысль что непонятно - обижается и начинает защищаться.
ЕК
У меня девушка такая же. Была)
V
Так зачем ты ему это объясняешь?
П
Чтобы он внес правки облегчающие понимание