ГОССТАНДАРТ РОССИИ - ИНФОРМАЦИОННАЯ ТЕХНОЛОГИЯ. РУКОВОДСТВО ПО УПРАВЛЕНИЮ ДОКУМЕНТИРОВАНИЕМ ПРОГРАММНОГО ОБЕСПЕЧЕНИЯ

1) документация разработки (см. 7.2.1);

2) документация продукции (см. 7.2.2);

3) документация управления проектом (см. 7.2.3).

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

Разработка документов преследует пять целей;

1) они являются средством связи между всеми вовлеченными в процесс разработки. Они описывают подробности решений, принятых относительно требований к программному обеспечению, проекту, программированию и тестированию;

2) они описывают обязанности группы разработки. Они определяют, кто, что и когда делает, учитывая роль программного обеспечения, предмета работ, документации, персонала, обеспечивающего качество, и каждого вовлеченного в процесс разработки;

3) они выступают как контрольные пункты, которые позволяют руководителям оценивать ход разработки. Если документы разработки отсутствуют, неполны или устарели, руководители теряют важное средство для отслеживания и контроля проекта программного обеспечения;

4) они образуют основу документации сопровождения программного обеспечения, требуемой сопровождающими программистами как часть документации продукции;

5) они описывают историю разработки программного обеспечения.

Типовыми документами разработки являются:

анализы осуществимости и исходные заявки;

спецификации требований;

спецификации функций;

проектные спецификации, включая спецификации программ и данных;

планы разработки;

планы сборки и тестирования программного обеспечения;

планы обеспечения качества, стандарты и графики;

защитная и тестовая информация.

Документация продукции обеспечивает информацию, необходимую для эксплуатации, сопровождения, модернизации, преобразования и передачи программной продукции.

Документация продукции преследует три цели:

1) она обеспечивает учебную и справочную информацию для любого использующего или эксплуатирующего программную продукцию;

2) она облегчает программистам, не разрабатывавшим программное обеспечение, его сопровождение и модернизацию;

3) она помогает продаже или приемке программной продукции.

Документация продукции должна включать в себя материалы для следующих типов читателей:

пользователей, которые вводят данные, восстанавливают информацию и решают задачи с помощью программного обеспечения;

операторов, которые «прогоняют» программное обеспечение на вычислительной системе;

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

Документация продукции может также включать в себя:

руководства и материалы для руководителей,которые следят за использованием программного обеспечения;

вспомогательные материалы,освещающие возможности программной продукции и уточняющие ее функции, условия эксплуатации и т. д.;

общую информацию,описывающую программную продукцию для всех заинтересованных лиц.

Типовые документы продукции включают в себя:

учебные руководства;

справочные руководства и руководства пользователя;

руководства по сопровождению программного обеспечения;

брошюры и информационные листовки, посвященные продукции.

7.2.3 Документация управления проектом

Документы создают на основе информации управления проектом, такой как:

графики для каждой стадии процесса разработки и отчеты обизменениях графиков;

отчеты о согласованных изменениях программного обеспечения;

отчеты о решениях, связанных с разработкой;

распределение обязанностей.

Данная документация обеспечивает информацию, относящуюся, с точки зрения руководства, к долговечности продукции.

Руководители должны выбирать стандарты, распространяющиеся на уровень качества, соответственно различным типам документов и различным типам проектов и должны определять, как это качество будет достигнуто и поддержано.

Понятия качества, применимые к содержанию, структуре и представлению документации:

1) качество содержанияможно измерять в элементах точности, полноты и ясности;

2) качество структурыможно измерять легкостью, с которой читатель имеет возможность определить местоположение информации;

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

Стандартизованные форматы документов важны для контроля качества документов, для читаемости документов и для облегчения их сопровождения.

Информация может быть представлена в различных форматах. Проектные спецификации, например, могут быть записаны на установленных бланках. Обучение пользователя можно осуществить посредством учебных программ в классах или учебных конспектов и консультаций.

Форматы документов могут различаться от проекта к проекту. Они зависят от таких факторов, как объем проекта, аудитория, для которой предназначены документы, количество установленных стадий и бюджет документирования.

В проектируемых форматах должны быть учтены соображения о том, будут ли документы переводить для международного распространения.

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

Стандартные обозначения документов необходимы для эффективного контроля документации. Обозначающая информация может включать в себя:

заглавие документа;

ссылочный номер документа;

номер версии документа;

дату выпуска и пересмотра;

реквизиты автора;

реквизиты утвердившего лица;

обозначение защищенности (авторских прав);

обозначение организации.

Если документы выпускают в виде разрозненных листов, каждая страница должна иметь индивидуальное обозначение (например, со ссылочным номером документа, номером страницы и номером издания).