🧶 Неоднозначные термины, слова-ловушки 🧵

Недвусмысленность и проверяемость — важные критерии качества требований. Ниже приведены "опасные" для употребления термины и способы борьбы с ними. Рекомендуется включить в чек-лист ревью артефакта и пробегать их ctrl+F'ом. Основано на списке от Карла Вигерса.

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

🎄Быстрый, мгновенный, моментальный || Задать конкретные значения скорости и быстродействия

🌲Дружественный, простой, лёгкий || Описать системные характеристики, закрывающие потребности пользователей по лёгкости, простоте и пр.

🌳Улучшенный, более быстрый, превосходный || Задать значение дельты изменения, либо итоговую величину

🌴Поддерживает, позволяет || Определить, действия системы, поддерживающие конкретную возможность

🌱Включает, такой как || Привести полный список элементов

🌿По меньшей мере, как минимум, не более чем, не должно превышать, между, несколько, максимизируйте, минимизируйте, оптимизируйте || Задать явно границы: 0 < N < 10

☘️Обычно, в идеале, устойчивый к сбоям || Описать исключения и отклик системы при нештатных условиях

🍀Гибкий, А зависит от Б, разумный, при необходимости, при соответствующих условиях || Переформулировать в "если <условие>, то <действие>"

🪴Необязательно, опционально || Указать, кто делает выбор: система, пользователь или разработчик

🍃Не следует, не должен, не <глагол> || Формулировать только в утвердительной форме (без НЕ), описывая ДЕЙСТВИЯ, а не бездействие системы, т.к. второе не нуждается в реализации.
Вместо "Без ID система не должна обработать запрос" писать "Система должна обработать запрос только при наличии ID"

#лайфхаки | Analyst Boost