Какие качества сделали его таким замечательным и что отличало его от не очень хороших характеристик, с которыми вам приходилось иметь дело? Или, если вы никогда раньше не работали с хорошей функциональной спецификацией, какие вещи вы ожидаете от отличной спецификации?
Извините, это, очевидно, субъективно, но я создаю функциональную спецификацию (не первую), и мне пришло в голову, что я могу получить несколько хороших идей от умных людей на SO!
проект Aardvark спецификации от Joel on Software — лучшее, что я когда-либо встречал. Каждый экран определяется очень хорошо, с картинками. Описаны основные возможности программного обеспечения, а также некоторые технические детали.
К сожалению, характеристики, которые я получил лично, не такие блестящие. Обычно это просто маркированный список функций, которые они ожидают от каждого раздела системы, и они ожидают, что вы проработаете все детали. Что хорошо, я думаю. Тем не менее, я пишу документ по дизайну игры для ролевой игры, над которой работаю как над личным проектом, и я думаю, что спецификации, которые я пишу, написаны очень хорошо. Я разделил игру на такие разделы, как
и так далее, и описал каждый раздел с точки зрения игрового процесса, а также некоторых технических деталей. Его очень легко проработать.
Я также настоятельно рекомендую прочитать Серию безболезненных функциональных спецификаций от Джоэла о программном обеспечении всем, кто интересуется писать лучшие спецификации.
ИМХО, ключевым качеством должно быть то, что в функциональной спецификации очень подробно указывается «что», а не «как». Таким образом, заказчик (маркетинг?) получает внешний вид и набор функций, которые ему нужны, но реализация остается за теми, кто знает это лучше всего — разработчиками.
Очевидно, что спецификация должна быть полной, последовательной и понятной. ИМО, он также должен быть хорошо организован, поскольку он объединяет все требования к конкретной части продукта. Я не раз читал спецификации, где требования к какому-то модулю были разбросаны по всему документу, например. общее описание находится в главе 4, а дополнительные требования можно найти в пунктах глав 2, 5, 7 и приложении Б. Для работы с такой спецификацией мне сначала нужно создать карту перекрестных ссылок требований к модулям.
В хорошей спецификации должно быть четко указано, что приложение должно делать.
Это кажется очевидным, но то, что я обычно получаю, часто очень расплывчато. Очевидно, людям не очень легко выразить то, что они хотят, на бумаге, ЕСЛИ они вообще знают, чего хотят.
