Цитата:
Сообщение от
Bergman
Потом попадаешь на такой проект с огромным количеством незадокументированных модификаций, причем со многими из них даже пользователи не знакомы
Как это возможно, если пользователи работают в системе минимум половину длительности проекта? И каждый этап завершается демонстрацией и приемкой работающего решения?
Документация это точно такая же задача как и разработка. Если пользователю нужны детальные инструкции, он их заказывает, если и так все ясно, незачем и время тратить. А бывает что инструкции должны доходить до уровня букваря по предметной области. И доподлинно выяснить, какой уровень документации нужен, можно только когда новые пользователи начнут в систему лезть.
Что касается проектной документации, то функциональные требования фиксируются в виде историй перед началом каждого этапа. Более того, до начала работы они причесываются до состояния когда всем понятно о чем речь идет. А дизайн на совести команды разработчиков. Опять таки, если разработчики квалифицированные, то заморачиваться смысла нет, и так понятно какие патерны применяются к схеме данных и коду. Хватит и комментов в коде. Если же команда брызжет оригинальными решениями банальных задач, тогда стоит требовать детального описания того, что ваяется, чтобы потом можно было разобраться что к чему. Но решение, опять таки, принимается по мере возникновения проблем. Если через пару спринтов возникли вопросы "что это долдон тут наклепал?" тогда документирование более строгое, если же с использование чужого кода ни у кого проблем нет, то и заморачиваться незачем.
Базовый принцип очень простой: "Очень много шансов что это все равно придется выбросить на помойку, поэтому делай как можно проще, быстрее и дешевле"