2009-06-17 5 views
1

Какова точка рассмотрения проектной документации после написания кода? Разве лошадь уже не покинула сарай? Мне кажется, что обзор дизайна должен быть пропущен и больше времени на проверку кода.Являются ли обзоры дизайна полезными после завершения кода?

ответ

1

В идеале документы должны отражать код. Если все закодировано, то это хорошо. Если вы делаете итеративную разработку, вам нужно будет переоценить проект и изменить документы.

После того, как документы будут изменены, вы измените код в соответствии с новыми требованиями.

Преимущество живого проектного документа заключается в том, что не программисты могут помочь в разработке, а также являются ориентиром для кода. Обзор дизайна может произойти в любое время, когда требования необходимо изменить для удовлетворения потребностей бизнеса.

Изменения должны всегда учитываться в любом рабочем потоке, если вы говорите, что вещи не могут измениться, тогда вы не реагируете на ваши бизнес-цели и, в свою очередь, своих клиентов.

0

Зависит от вашего SDLC, если используется водопад, то да, обзор дизайна абсолютно необходим; так как существует гораздо более предварительный дизайн/обзор, чем более гибкие подходы.

0

Согласен. Единственный встречный аргумент, который я вижу, заключается в том, что проектный документ представляет собой форму документа высокого уровня. Если код самодокументируется достаточно хорошо и будет доступен всем, кто нуждается в техническом понимании, тогда проектный документ может быть спорным.

1

Полезно, если вы хотите сделать выводы для будущих проектов. Кроме того, если он будет использоваться в качестве ссылки для документирования системы (подумайте о будущих изменениях приложения).

0

Да, это может быть источник ссылок для будущих подобных проектов.

0

Я просто не вижу цели этого. Если код уже был написан и протестирован ... похоже, что внесение изменений в документ напрасно тратит время, которое может быть использовано на таких вещах, как дополнительные модульные тесты или работа над проблемами интеграции.

Цель проектных документов и обзоров - диктовать структуру кода и то, как он должен выглядеть. Это определение книги лошади, покидающей сарай

1

Рецензии на дизайн полезны независимо от того, какой «шаблон жизненного цикла» следует (или был), даже если они являются фактами. Самое большое различие заключается в том, что обзор «после факта» (также называемый посмертным обзором) используется для изучения того, что работало и не работало в проекте, что было бы изменено и т. Д.