Что отличает функциональную спецификацию?

Question

Какие качества сделали его настолько отличным, и что отличает его от не очень больших характеристик, с которыми вам приходилось иметь дело? Или, если вы никогда раньше не работали с хорошей функциональной спецификацией, какие вещи вы ожидали бы в отличной спецификации?

Извините, это явно субъективно, но я создаю функциональную спецификацию (не мою первую), и мне просто пришло в голову, что я могу получить хорошие идеи от ярких людей на SO!

Answer 1

Спецификации от Joel on Software - лучшее, с чем я столкнулся до сих пор. Каждый экран определяется очень хорошо, с картинками. Описаны основные функции программного обеспечения, а также некоторые технические детали.

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

• Персонажи
• Оружие & Броня
• Уровни
• Карта
• Physics

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

Я также настоятельно рекомендую прочитать Painless Functional Specs Series от Joel on Software для всех, кто интересуется написанием лучших спецификаций.

Answer 2

Очевидно, что спецификация должна быть полной, последовательной и понятной. ИМО также должна быть хорошо организована, поскольку она сохраняет все требования к определенной части продукта вместе. Я не раз читал спецификации, где требования к некоторому модулю были разбросаны по всему документу, например. общее описание приведено в главе 4, но дополнительные требования могут быть найдены в статьях в главах 2, 5, 7 и приложении B. Чтобы работать с такой спецификацией, мне сначала нужно создать карту перекрестных ссылок требований к модулям.

Answer 3

IMHO, ключевое качество должно состоять в том, что функциональная спецификация специфицирует «что» в мельчайших подробностях, но не «как». Таким образом, запросчик (маркетинг?) Получает вид & чувств и набор функций, которые они хотят, но реализация предоставляется тем, кто знает это лучше всего - разработчикам.

Answer 4

Хорошая спецификация должна указывать, что должно делать приложение в ясной форме.

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