- Уникально обозначенный блок информации для использования человеком, такой как отчет, спецификация, руководство или книга.
3.2 документация - Набор из одного или более связанных документов.
3.3 программная продукция - Результат процесса разработки программного обеспечения, т. е. программное обеспечение, выпускаемое для использования.
Руководители принимают на себя организацию работ по документированию и осуществляют поддержку этих работ в стратегиях, стандартах, процедурах, распределении ресурсов и планах, которыми они определяются.
Эффективность выполнения руководящей роли можно рассматривать как основанную на трех элементах:
1) руководящая обязанность по документированию.
Данная обязанность требует признания того, что программная документация важна и что ее следует планировать, описывать, проверять, утверждать, выпускать, распространять и сопровождать;
2) руководящая поддержка обязанностей персонала по документированию.
Для этого требуется руководство и стимулирование персонала при проведении требуемого документирования и обеспечение его ресурсами для содействия в данной работе;
3) признаки руководящих обязанностей и поддержки.
Для этого требуется обеспечить:
а) опубликованные официальные отчеты о стратегии документирования;
б) стандарты и руководства, определяющие все аспекты документирования программного обеспечения;
в) опубликованные процедуры документирования;
г) выделение соответствующих ресурсов для документирования;
д) планирование документирования, осуществляемое как неотъемлемая часть процесса разработки программного обеспечения;
е) постоянную проверку, осуществляемую для обеспечение соответствия со стратегией, стандартами, процедурами и планами по документированию.
5 ФУНКЦИИ ПРОГРАММНОЙ ДОКУМЕНТАЦИИ
Для эффективного управления документированием программного обеспечения, важно осознавать различные функции, выполняемые документацией.
Программную документацию можно рассматривать как имеющую шесть основных функций:
1) информация для управления (см. 5.1);
2) связь между задачами (см. 5.2);
3) обеспечение качества (см. 5.3);
4) инструкции и справки (см. 5.4);
5) сопровождение программного обеспечения (см. 5.5);
6) исторические справки (см. 5.6).
5.1 Информация для управления
Во время разработки программного обеспечения администрации необходимо оценивать ход работы, возникающие проблемы и вероятности развития процесса. Периодические отчеты, согласно которым проверяют ход работ по графику и представляют планы на следующий период, обеспечивают контрольные механизмы и обзор проекта.