Команда > Авторские публикации > 2013 год > Значение государственных стандартов в разработке документации

Значение государственных стандартов в разработке документации

Действительно ли актуальны и востребованы государственные стандарты или ГОСТы, на которые ориентируются, и в соответствии с которыми разрабатывается техническая документация? Почему по прошествии 20 и более лет ГОСТы являются общеупотребимыми в области информационных технологий? Давайте разбираться по порядку.

Если обратиться к истории, то первые стандарты были разработаны в 1925 году Комитетом стандартизации, которые регулировали качество всех производимых товаров: начиная от выпуска продуктов питания и заканчивая производством оборудования. С течением времени стандарты менялись и дополнялись.

Любой продукт, к какой бы экономической сфере он не относился, характеризуется некоторыми требованиями к структуре и содержанию, которые и нашли отражение в соответствующих стандартах.

Стандарты на разработку технической документации появились в конце 80-х — начале 90-х годов. К ним относятся серии стандартов — ГОСТ 34.ХХХ и ГОСТ 19.ХХХ.

ГОСТ представляет собой нормативный документ, который содержит как обязательные, так и рекомендуемые требования к оформлению и содержанию документации на систему или программный продукт.

ГОСТ 34.ХХХ или Комплекс стандартов на автоматизированные системы (КСАС) применим для автоматизированных систем, а ГОСТ 19.ХХХ или Единая система программной документации (ЕСПД) — для программных продуктов. Отличие автоматизированной системы от программного продукта состоит в следующем: автоматизированная система служит для автоматизации определенного вида деятельности, включает персонал, который использует данную систему, содержит технические и программные средства, на которых реализована система. Программный продукт представляет собой программное обеспечение с набором функциональных возможностей.

На сегодняшний день в сфере информационных технологий Российской Федерации ГОСТы являются основным средством стандартизации и унификации проектной документации и содержат требования:

  • к этапам разработки автоматизированных систем / программных продуктов;
  • к структуре;
  • к содержанию основных разделов;
  • к обозначению отдельных видов документов;
  • к терминологии;
  • к стилевому оформлению (ГОСТ 2.105-95).

Именно тот факт, что требования охватывают все «стороны» документа и вписывают документ в процесс разработки программного обеспечения, ставит ГОСТы на особое место.

Существуют разные методологии разработки программного обеспечения (RUP, Agile, MSF и др.), которые говорят об этапности и итеративности процесса. Но государственные стандарты дают представление о содержании этапов разработки и раскрывают номенклатуру и содержание документов каждого этапа. То есть методологию разработки программного обеспечения сопровождает особая методология документирования.

Однако, в отношении ГОСТов не все так однозначно. То, что кажется с одной стороны полнотой описания автоматизированной системы / программного продукта, в ином случае оборачивается избыточностью описания и передачей пользователям ненужной информации. Противники стандартов идут по пути создания собственных методологий документирования, которые включают в себя макеты (требования к содержанию) и шаблоны (требования к оформлению) документов. По непроверенным данным есть инициативные группы технических документаторов, которыми даже предпринимались попытки продвижения в Госстандарт Российской Федерации стандартов, альтернативных ГОСТ 19.ХХХ, 34.ХХХ, 2.105-95 и т. п.

На наш взгляд оба мнения являются верными. Нельзя требовать от всех единого подхода к документированию систем / программных продуктов, но и невозможно отпустить технических документаторов в свободное плавание в части определения содержания документации. Наиболее правильным подходом будет предложение поправок в текст государственных стандартов:

  • подчеркивающих рекомендательный характер требований ГОСТов;
  • учитывающих существование зарубежных методологий разработки программного обеспечения и позволяющих адаптировать номенклатуру документов по ГОСТ под произвольные последовательности стадий разработки ПО;
  • поддерживающих корпоративные инициативы в оформлении и обозначении (инвентаризации) документации.

Внесенные коррективы добавят государственным стандартам гибкости и возможность применения в условиях постоянно меняющихся тенденций в ИТ.

 

Екатерина Зорина, Евгения Григорьева