Значение государственных стандартов в разработке документации
Действительно ли актуальны и востребованы государственные стандарты или ГОСТы, на которые ориентируются, и в соответствии с которыми разрабатывается техническая документация? Почему по прошествии 20 и более лет ГОСТы являются общеупотребимыми в области информационных технологий? Давайте разбираться по порядку.
Если обратиться к истории, то первые стандарты были разработаны в 1925 году Комитетом стандартизации, которые регулировали качество всех производимых товаров: начиная от выпуска продуктов питания и заканчивая производством оборудования. С течением времени стандарты менялись и дополнялись.
Любой продукт, к какой бы экономической сфере он не относился, характеризуется некоторыми требованиями к структуре и содержанию, которые и нашли отражение в соответствующих стандартах.
Стандарты на разработку технической документации появились в конце 80-х — начале 90-х годов. К ним относятся серии стандартов — ГОСТ 34.ХХХ и ГОСТ 19.ХХХ.
ГОСТ представляет собой нормативный документ, который содержит как обязательные, так и рекомендуемые требования к оформлению и содержанию документации на систему или программный продукт.
ГОСТ 34.ХХХ или Комплекс стандартов на автоматизированные системы (КСАС) применим для автоматизированных систем, а ГОСТ 19.ХХХ или Единая система программной документации (ЕСПД) — для программных продуктов. Отличие автоматизированной системы от программного продукта состоит в следующем: автоматизированная система служит для автоматизации определенного вида деятельности, включает персонал, который использует данную систему, содержит технические и программные средства, на которых реализована система. Программный продукт представляет собой программное обеспечение с набором функциональных возможностей.
На сегодняшний день в сфере информационных технологий Российской Федерации ГОСТы являются основным средством стандартизации и унификации проектной документации и содержат требования:
- к этапам разработки автоматизированных систем / программных продуктов;
- к структуре;
- к содержанию основных разделов;
- к обозначению отдельных видов документов;
- к терминологии;
- к стилевому оформлению (ГОСТ 2.105-95).
Именно тот факт, что требования охватывают все «стороны» документа и вписывают документ в процесс разработки программного обеспечения, ставит ГОСТы на особое место.
Существуют разные методологии разработки программного обеспечения (RUP, Agile, MSF и др.), которые говорят об этапности и итеративности процесса. Но государственные стандарты дают представление о содержании этапов разработки и раскрывают номенклатуру и содержание документов каждого этапа. То есть методологию разработки программного обеспечения сопровождает особая методология документирования.
Однако, в отношении ГОСТов не все так однозначно. То, что кажется с одной стороны полнотой описания автоматизированной системы / программного продукта, в ином случае оборачивается избыточностью описания и передачей пользователям ненужной информации. Противники стандартов идут по пути создания собственных методологий документирования, которые включают в себя макеты (требования к содержанию) и шаблоны (требования к оформлению) документов. По непроверенным данным есть инициативные группы технических документаторов, которыми даже предпринимались попытки продвижения в Госстандарт Российской Федерации стандартов, альтернативных ГОСТ 19.ХХХ, 34.ХХХ, 2.105-95 и т. п.
На наш взгляд оба мнения являются верными. Нельзя требовать от всех единого подхода к документированию систем / программных продуктов, но и невозможно отпустить технических документаторов в свободное плавание в части определения содержания документации. Наиболее правильным подходом будет предложение поправок в текст государственных стандартов:
- подчеркивающих рекомендательный характер требований ГОСТов;
- учитывающих существование зарубежных методологий разработки программного обеспечения и позволяющих адаптировать номенклатуру документов по ГОСТ под произвольные последовательности стадий разработки ПО;
- поддерживающих корпоративные инициативы в оформлении и обозначении (инвентаризации) документации.
Внесенные коррективы добавят государственным стандартам гибкости и возможность применения в условиях постоянно меняющихся тенденций в ИТ.