5) они описывают историю разработки программного обеспечения.
Типовыми документами разработки являются:
анализы осуществимости и исходные заявки;
спецификации требований;
спецификации функций;
проектные спецификации, включая спецификации программ и данных;
планы разработки;
планы сборки и тестирования программного обеспечения;
планы обеспечения качества, стандарты и графики;
защитная и тестовая информация.
7.2.2 Документация продукции
Документация продукции обеспечивает информацию, необходимую для эксплуатации, сопровождения, модернизации, преобразования и передачи программной продукции.
Документация продукции преследует три цели:
1) она обеспечивает учебную и справочную информацию для любого использующего или эксплуатирующего программную продукцию;
2) она облегчает программистам, не разрабатывавшим программное обеспечение, его сопровождение и модернизацию;
3) она помогает продаже или приемке программной продукции.
Документация продукции должна включать в себя материалы для следующих типов читателей:
пользователей, которые вводят данные, восстанавливают информацию и решают задачи с помощью программного обеспечения;
операторов, которые «прогоняют» программное обеспечение на вычислительной системе;
сопровождающих программистов, которые сопровождают, модернизируют или изменяют программное обеспечение.
Документация продукции может также включать в себя:
руководства и материалы для руководителей, которые следят за использованием программного обеспечения;
вспомогательные материалы, освещающие возможности программной продукции и уточняющие ее функции, условия эксплуатации и т. д.;
общую информацию, описывающую программную продукцию для всех заинтересованных лиц.
Типовые документы продукции включают в себя:
учебные руководства;
справочные руководства и руководства пользователя;
руководства по сопровождению программного обеспечения;
брошюры и информационные листовки, посвященные продукции.
7.2.3 Документация управления проектом
Документы создают на основе информации управления проектом, такой как:
графики для каждой стадии процесса разработки и отчеты об изменениях графиков;
отчеты о согласованных изменениях программного обеспечения;
отчеты о решениях, связанных с разработкой;
распределение обязанностей.
Данная документация обеспечивает информацию, относящуюся, с точки зрения руководства, к долговечности продукции.
7.3 Определение качества документов
Руководители должны выбирать стандарты, распространяющиеся на уровень качества, соответственно различным типам документов и различным типам проектов и должны определять, как это качество будет достигнуто и поддержано.
Понятия качества, применимые к содержанию, структуре и представлению документации:
1) качество содержания можно измерять в элементах точности, полноты и ясности;
2) качество структуры можно измерять легкостью, с которой читатель имеет возможность определить местоположение информации;
3) качество представления должно соответствовать типу проекта. Например, руководство пользователя может иметь форму набора машинописных страниц, скрепленных вместе, или может быть типографской книгой с обширными иллюстрациями, созданной специалистом по графике.
7.4 Определение форматов документов
Стандартизованные форматы документов важны для контроля качества документов, для читаемости документов и для облегчения их сопровождения.
Информация может быть представлена в различных форматах. Проектные спецификации, например, могут быть записаны на установленных бланках. Обучение пользователя можно осуществить посредством учебных программ в классах или учебных конспектов и консультаций.
Форматы документов могут различаться от проекта к проекту. Они зависят от таких факторов, как объем проекта, аудитория, для которой предназначены документы, количество установленных стадий и бюджет документирования.
В проектируемых форматах должны быть учтены соображения о том, будут ли документы переводить для международного распространения.
Стандарты и руководства данной организации, распространяющиеся на форматы документов, должны быть установлены таким образом, чтобы допускать гибкость для руководителей в выборе форматов, подходящих для их проектов.
7.5. Определение системы обозначения документов
Стандартные обозначения документов необходимы для эффективного контроля документации. Обозначающая информация может включать в себя:
заглавие документа;
ссылочный номер документа;
номер версии документа;
дату выпуска и пересмотра;
реквизиты автора;
реквизиты утвердившего лица;
обозначение защищенности (авторских прав);
обозначение организации.
Если документы выпускают в виде разрозненных листов, каждая страница должна иметь индивидуальное обозначение (например, со ссылочным номером документа, номером страницы и номером издания).
8 УСТАНОВЛЕНИЕ ПРОЦЕДУР ДОКУМЕНТИРОВАНИЯ
Должны быть установлены процедуры для применяемых в организациях стратегий документирования.
Процедуры определяют последовательность документирования: планирование; подготовка;
конфигурационное управление; проверка; утверждение; производство; хранение; дублирование;
распространение и модернизация; продажа.
Процедуры также должны определять контрольные пункты и методы обеспечения качества.
9 РАСПРЕДЕЛЕНИЕ РЕСУРСОВ ДЛЯ ДОКУМЕНТИРОВАНИЯ
Основными ресурсами, требуемыми для документирования, являются следующие:
персонал (см. 9.1);
средства (см. 9.2);
финансирование (см. 9.3).
9.1 Персонал
Для процесса разработки программного обеспечения необходимы люди со знанием:
программирования - для разработки программного обеспечения;
сути предмета - для представления информации о применениях программного обеспечения;
документирования - для разработки документации продукции,
Важно, чтобы штат был полностью обучен методам документирования и чтобы каждая группа полностью понимала и выполняла свою роль в документировании;
проектировщики программного обеспечения и программисты создают документацию разработки, которая описывает продукцию или ее задачи; они также обеспечивают документацию сопровождения программной продукции;
специалисты в предметной области обеспечивают информацию для (и могут разрабатывать) части стадий изучения, спецификаций требований, планов тестирования и обеспечения качества, планов сборки программного обеспечения в условиях эксплуатации и многих типов графиков;
специалисты по изданию обычно подготовляют документацию по обучению пользователя, а также справочную, информационную о продукции и посредническую.
9.2 Средства
Важно предусмотреть обеспечение задач документирования соответствующими и подходящими средствами.