Никто не читает требования

Раньше я писал требования по Коберну с Вигерсом. Действующие лица, основной сценарий, альтернативные, глоссарий, развесистая структура спецификации, вот это всё.

Отличные требования. Одна проблема с ними — никто не читает. Это странно, у нас же типа инженерная профессия, должны люди внимательно читать спецификации. Но вот не читают. Гады.

Потом мне как-то прислали такую же чужую спеку на ознакомление, я прочёл и понял, что не понял. И не хочу понимать (хотя пришлось себя заставить, да).

С тех пор стараюсь писать спецификации как статьи: с примерами из жизни, иллюстрациями, внутренней логикой повествования и кровавой развязкой (над последним ещё надо поработать).

Фрагмент требований «Дадаты»
Пример из требований к «Дадате». Естественно, там дальше есть и кровавые подробности, как должно работать «под капотом». Но их тоже стараюсь излагать человеческим языком.

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