Написание спецификации программного обеспечения


15

У меня есть несколько вопросов о написании спецификации, и они:

  1. Когда мы пишем спецификацию программного обеспечения, в разделе «Определение требований пользователя» мы должны указать только «Функции» и «Ограничения»?

  2. «Интерфейс пользователя» попадает в «функции» или «ограничения»?

  3. На какие основные ключевые области (требования) можно разбить программное обеспечение (например, пользовательский интерфейс)?


Эта статья может быть полезна: 10 типичных ошибок в спецификациях
yegor256

Ответы:


16

Хотя я не большой поклонник детального сбора всех требований (поскольку они претерпевают значительные изменения в ходе нетривиального проекта), если вы пишете документы с требованиями, шаблон спецификации требований Volere является отличным руководством. ,

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

Вот ссылка на дополнительную информацию о шаблоне:

http://www.volere.co.uk/template.htm

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

Вот резюме разделов в нем (цитируется по ссылке выше):

  1. Цель проекта

  2. Заинтересованные стороны

  3. Обязательные ограничения

  4. Соглашения об именах и определения

  5. Соответствующие факты и предположения

  6. Объем работ

  7. Модель бизнес-данных и словарь данных

  8. Сфера применения продукта

  9. Функциональные требования и требования к данным

  10. Требования к внешнему виду

  11. Требования юзабилити и гуманности

  12. Требования к производительности

  13. Эксплуатационные и экологические требования

  14. Требования к техническому обслуживанию и поддержке

  15. Требования безопасности

  16. Культурно-политические требования

  17. Правовые требования

  18. Открытые вопросы

  19. Готовые решения

  20. Новые проблемы

  21. Задания

  22. Миграция на новый продукт

  23. риски

  24. Расходы

  25. Пользовательская документация и обучение

  26. Зал ожидания

  27. Идеи для решений


10

Я рекомендую прочитать Джоэл о программном обеспечении. Я не уверен, отвечает ли он на ваши конкретные вопросы, но у него есть отличный обзор того, что значит писать функциональные спецификации :

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

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

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

Когда у вас нет спецификации, все это общение все еще происходит, потому что оно должно , но это происходит на разовой основе . Сотрудники QA дурачатся с программой вольно-невольно, и когда что-то выглядит странно, они снова и снова прерывают программистов, чтобы задать им еще один глупый вопрос о том, как это должно работать ...

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


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

подумайте над тем, чтобы прочитать ваш ответ в другом замке: когда ответ не является ответом? «Позвольте мне быть ясным: этот вид ответа не является ответом . Если вы видите это, пометьте его. Модераторы, если вы видите его помеченным, удалите его »
gnat

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

6

Когда мы пишем спецификацию программного обеспечения, в разделе «Определение требований пользователя» мы должны указать только «Функции» и «Ограничения»?

Требование - это сочетание двух вещей ...

  1. Что делает вещь Функциональное требование.
  2. Как хорошо это делает. Нефункциональное требование или «Ограничение»

«Интерфейс пользователя» попадает в «функции» или «ограничения»?

Я бы сказал, что «Пользовательский интерфейс» будет категорией требований, как вы определили в своем последнем вопросе.

На какие основные ключевые области (требования) можно разбить программное обеспечение (например, пользовательский интерфейс)?

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

Конечно, все это является вторичным по отношению к вашей реальной цели, которая заключается в определении четкого, однозначного и проверяемого описания системы программного обеспечения.


4

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

Я никогда не видел документ с требованиями, ограниченный только функциями и ограничениями, но я вижу некоторую ценность в том, чтобы иметь такую ​​структуру - это вынуждает автора классифицировать требования на «вещи, которые должны делать программы», и «управляет Программное обеспечение должно следовать. "

Я думаю, что пользовательский интерфейс имеет требования в обеих категориях

Ограничения:

  • «на экране запуска должны отображаться две кнопки:« Пуск »и« Стоп »
  • «Шрифт дисплея должен быть не меньше 10 точек».

Функции:

  • «Когда Startклавиша нажата, программное обеспечение должно установить соединение TCP / IP с WOPR »

Ваши примеры - это не требования, а дизайн. Специфика того, как требование должно быть выполнено, является проектным решением, а не требованием. Таким образом, «две кнопки» - это дизайнерское решение. Это становится очевидным, когда вы понимаете, что есть много других действенных способов достижения той же цели (запустить или остановить что-то). Таким образом, чтобы сделать это более требовательным, вы должны сказать: «Интерфейс должен обеспечивать средства для запуска и остановки чего-либо». Но я бы пошел дальше, потому что использование пользовательского интерфейса также является дизайнерским решением. Таким образом, для системного требования это должно быть «Система должна обеспечивать средства для запуска и остановки чего-либо»
Данк
Используя наш сайт, вы подтверждаете, что прочитали и поняли нашу Политику в отношении файлов cookie и Политику конфиденциальности.
Licensed under cc by-sa 3.0 with attribution required.