Какие правила формулировки требований к программному обеспечению являются верными?
Подробное объяснение
При формулировке требований следует отдавать предпочтение активному залогу, так как он делает требования более короткими и однозначными, четко указывая, кто выполняет действие. Также необходимо избегать формулировок в стиле «пользователь должен», поскольку требования должны описывать поведение системы, а не обязанности пользователя. Вместо этого следует использовать конструкции, описывающие возможности системы или интерфейса.
Часто задаваемые вопросы (FAQ)
1
Почему активный залог предпочтительнее в требованиях?
Активный залог делает требования короче и однозначнее: понятно, кто выполняет действие (система, модуль, сервис) и что именно должно быть сделано.
2
Почему следует избегать требований вида «пользователь должен…»?
Требования должны описывать поведение системы, а не обязанности пользователя. Корректнее формулировать через возможности системы, например: «Система должна предоставлять пользователю возможность…».
3
Почему недопустимо использовать субъективные прилагательные в требованиях?
Прилагательные вроде «простой», «быстрый», «удобный» неизмеримы и субъективны, что делает требование непроверяемым. Их следует заменять измеримыми критериями (время отклика, число шагов и т.д.).
Типичные ошибки
1
Использование субъективных прилагательных (простой, быстрый, удобный)
Такие прилагательные субъективны и неизмеримы, что делает требование непроверяемым. Нужно указывать конкретные метрики.
2
Формулировка требований от лица пользователя («пользователь должен нажать кнопку»)
Требования должны описывать поведение системы, а не действия пользователя. Правильно: «Система должна предоставлять кнопку для…».
3
Использование синонимов для разнообразия текста
В технической документации важнее единообразие терминов, чтобы избежать неоднозначности и разных трактовок.