Разработка документов преследует пять целей;
1) они являются средством связи между всеми вовлеченными в процесс разработки. Они описывают подробности решений, принятых относительно требований к программному обеспечению, проекту, программированию и тестированию;
2) они описывают обязанности группы разработки. Они определяют, кто, что и когда делает, учитывая роль программного обеспечения, предмета работ, документации, персонала, обеспечивающего качество, и каждого вовлеченного в процесс разработки;
3) они выступают как контрольные пункты, которые позволяют руководителям оценивать ход разработки. Если документы разработки отсутствуют, неполны или устарели, руководители теряют важное средство для отслеживания и контроля проекта программного обеспечения;
4) они образуют основу документации сопровождения программного обеспечения, требуемой сопровождающими программистами как часть документации продукции;
5) они описывают историю разработки программного обеспечения.
Типовыми документами разработки являются:
анализы осуществимости и исходные заявки;
спецификации требований;
спецификации функций;
проектные спецификации, включая спецификации программ и данных;
планы разработки;
планы сборки и тестирования программного обеспечения;
планы обеспечения качества, стандарты и графики;
защитная и тестовая информация.
7.2.2 Документация продукции
Документация продукции обеспечивает информацию, необходимую для эксплуатации, сопровождения, модернизации, преобразования и передачи программной продукции.
Документация продукции преследует три цели:
1) она обеспечивает учебную и справочную информацию для любого использующего или эксплуатирующего программную продукцию;
2) она облегчает программистам, не разрабатывавшим программное обеспечение, его сопровождение и модернизацию;
3) она помогает продаже или приемке программной продукции.
Документация продукции должна включать в себя материалы для следующих типов читателей:
пользователей, которые вводят данные, восстанавливают информацию и решают задачи с помощью программного обеспечения;
операторов, которые «прогоняют» программное обеспечение на вычислительной системе;
сопровождающих программистов, которые сопровождают, модернизируют или изменяют программное обеспечение.
Документация продукции может также включать в себя:
руководства и материалы для руководителей, которые следят за использованием программного обеспечения;
вспомогательные материалы, освещающие возможности программной продукции и уточняющие ее функции, условия эксплуатации и т. д.;
общую информацию,