Какова точка рассмотрения проектной документации после написания кода? Разве лошадь уже не покинула сарай? Мне кажется, что обзор дизайна должен быть пропущен и больше времени на проверку кода.Являются ли обзоры дизайна полезными после завершения кода?
ответ
В идеале документы должны отражать код. Если все закодировано, то это хорошо. Если вы делаете итеративную разработку, вам нужно будет переоценить проект и изменить документы.
После того, как документы будут изменены, вы измените код в соответствии с новыми требованиями.
Преимущество живого проектного документа заключается в том, что не программисты могут помочь в разработке, а также являются ориентиром для кода. Обзор дизайна может произойти в любое время, когда требования необходимо изменить для удовлетворения потребностей бизнеса.
Изменения должны всегда учитываться в любом рабочем потоке, если вы говорите, что вещи не могут измениться, тогда вы не реагируете на ваши бизнес-цели и, в свою очередь, своих клиентов.
Зависит от вашего SDLC, если используется водопад, то да, обзор дизайна абсолютно необходим; так как существует гораздо более предварительный дизайн/обзор, чем более гибкие подходы.
Согласен. Единственный встречный аргумент, который я вижу, заключается в том, что проектный документ представляет собой форму документа высокого уровня. Если код самодокументируется достаточно хорошо и будет доступен всем, кто нуждается в техническом понимании, тогда проектный документ может быть спорным.
Полезно, если вы хотите сделать выводы для будущих проектов. Кроме того, если он будет использоваться в качестве ссылки для документирования системы (подумайте о будущих изменениях приложения).
Да, это может быть источник ссылок для будущих подобных проектов.
Я просто не вижу цели этого. Если код уже был написан и протестирован ... похоже, что внесение изменений в документ напрасно тратит время, которое может быть использовано на таких вещах, как дополнительные модульные тесты или работа над проблемами интеграции.
Цель проектных документов и обзоров - диктовать структуру кода и то, как он должен выглядеть. Это определение книги лошади, покидающей сарай
Рецензии на дизайн полезны независимо от того, какой «шаблон жизненного цикла» следует (или был), даже если они являются фактами. Самое большое различие заключается в том, что обзор «после факта» (также называемый посмертным обзором) используется для изучения того, что работало и не работало в проекте, что было бы изменено и т. Д.