Шаблон спецификации требований к ПО

Каждая организация, специализирующаяся на разработке ПО, должна принять один или несколько стандартных шаблонов спецификации требований к ПО для использования в проектах. Доступны различные шаблоны спецификации (например: ISO/IEC/IEEE 2011; Robertson и Robertson, 2013).

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

На рис. 10-2 показан шаблон спецификации требований, который подходит для многих проектов. Некоторые люди форматируют инструкции как скрытый текст в Microsoft Word. Это позволяет оставить подсказки в документе. Чтобы увидеть эти инструкции, нужно включить режим отображения непечатных символов.

Рис. 10-2. Предлагаемый шаблон для спецификации требований к ПО

Иногда фрагмент информации логически подходит для нескольких разделов шаблона. Выберите один раздел и используйте именно его для информации такого типа в своем проекте. Не дублируйте информацию в нескольких разделах, даже если логически она ложится в эти разделы (Wiegers, 2006). Используйте перекрестные ссылки и гиперссылки, чтобы облегчить читателям поиск нужной информации.

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

Внимание! Вы можете внедрять материал с помощью ссылки в другие документы, а не дублировать его в спецификации требований к ПО. Для этого можно использовать гиперссылки в качестве ссылок для отслеживания связей, определенных в средстве управления требованиями. С гиперссылками связан тот риск, что они могут «ломаться» при изменении иерархии папок, где хранятся документы.