Серьезно? Если, честно, я поражен.
Совершенно серьёзно.
Летом я проводил эксперимент по написанию спецификации требований. Исполнителем был начинающий аналитик, я выступал в роли консультанта. Документ выглядел примерно так: все требования были выстроены в некоторую иерархическую струкутуру, каждое требование пронумеровано, описание каждого требования выполнялось по определенному шаблону для унификации поиска. Во многом он был похож на пример из книги Вигерса.
Документ был забракован отделом проектирования с резолюцией НЕПОНЯТНО.
Это не обязательно означает, что на самом деле было непонятно. Ты с человеком, который эту резолюцию наложил, общался? Он тебе показал непонятные места?
Потому хотелось бы увидеть как например ты бы описал, то что я написал, в виде ГОСТ. Понятно, что большая часть разделов нужно игнорировать...
Да я сам ничего по ГОСТу не разрабатывал, а работал уже с готовыми документами. Да и ГОСТ в те времена был, по-моему, другой.
И относился я к этому тогда, надо сказать, не особо внимательно. В те времена у меня не было цели стать экспертом по ТЗ и ГОСТам. Это только в последние несколько лет, когда сам столкнулся с необходимостью разработки документации, стал вспоминать, как оно было.
Могу рассказать, как работаю сейчас.
ГОСТ почитываю иногда, но прямо по нему не работаю. Нет необходимости: заказчик этого не требует. А почитываю, скорее, чтобы определить для себе темы, о которых нужно не забыть (а также темы, в которых я не компетентен).
В ГОСТах используется своя терминология, во многом советских времён, которой в коммерческих организациях не владеют (АС, ЭВМ, пункты управления, шифр темы, временной регламент и т. п. - для многих сейчас это уже терминологический мусор). А если заказчик этих слов не знает, зачем мне их использовать?
В ГОСТах обычно обнаруживается множество ссылок на другие ГОСТы. Если этим ссылкам следовать, объём необходимой информации для работы "по ГОСТу" растёт экспоненциально. Пункты вроде следующего просто игнорирую, как баннерную рекламу:
2.10. В разделе «Требования к документированию» приводят:
...
2) требования по документированию комплектующих элементов межотраслевого применения в соответствии с требованиями ЕСКД и ЕСПД;
От нумерации абзацев мы тоже отказались: такие документы очень трудно сопровождать. Если нужно дать точную ссылку на какой-то абзац, пишем "приложение такое-то (название), раздел такой-то (снова название), пункт такой-то (и опять название). Можно ещё указать номер страницы, но это если договором была зафиксирована какая-то версия документа, переданная бумажном виде, и на которую мы ссылаемся.
На моей памяти, такие ссылки за последние пять лет нужно было приводить раза два. Заказчик был в кризисе, год молчал, у него полностью сменился персонал, а сейчас ожил и решил реанимировать старый проект. Причём начал с тестирования и сразу выкатил претензию. Пришлось искать согласованную версию ТЗ и давать ссылку на утверждённое предыдущим директором требование. Ну и дал бы я ему номер абзаца вместо текста, что это изменило бы? Разве что ссылка была бы красивой, вроде: "RTFM ТЗ пункт 1.2.3.4".
В общем, я понял, что пытаюсь тебя отговорить от "правильного" оформления документов по ГОСТ.
Если потребители твоего документа не предъявляют никаких требований, кроме понятности и здравого смысла, этому только радоваться надо. А ГОСТ использовать только как справочник по возможным разделам.