Стратегия должна поддерживать основные элементы эффективного документирования:
1) требования документации охватывают весь жизненный цикл программного обеспечения.
Документация требуется на ранних стадиях проекта и должна быть доступна и сопровождаться на всем протяжении процесса разработки программного обеспечения. После завершения процесса разработки документация необходима для использования, сопровождения, модернизации, преобразования или передачи программного обеспечения;
2) документирование должно быть управляемым.
Управление и контроль требуются для получения и сопровождения документации. Руководители и специалисты по изданиям должны подготовить подробные планы, охватывающие документирование продукции, графиков, обязанностей, ресурсов, обеспечения качества и процедур проверок;
3) документация должна соответствовать ее читательской аудитории.
Читателями могут быть руководители, аналитики, специалисты по экспертным системам, сопровождающие программисты, канцелярский персонал и т. д. В зависимости от выполняемых задач им требуются различные степени детализации и различное представление материала. Специалисты по изданиям должны быть готовы соответствующим образом спроектировать различные типы документации, предназначенные для различных читателей;
4) работы по документированию должны быть объединены в общий процесс разработки программного обеспечения.
Процесс разработки должен быть определен;
5) должны быть определены и использованы стандарты по документированию.
По возможности, должны быть приняты существующие стандарты. Когда подходящие стандарты отсутствуют, должны быть разработаны требуемые стандарты и руководства;
6) должны быть определены средства поддержки.
Должны быть использованы там, где это экономически целесообразно, средства, помогающие разработке и сопровождению программной продукции, включая документацию.
7 ОПРЕДЕЛЕНИЕ СТАНДАРТОВ И РУКОВОДСТВ ПО ДОКУМЕНТИРОВАНИЮ
Внутри организации должны быть приняты стандарты и руководства для:
– модели жизненного цикла программного обеспечения;
– типов и взаимосвязей документов;
– содержания документа;
– качества документа;
– форматов документа;
– обозначения документа.
Данные стандарты и руководства будут определять, как следует выполнять задачи документирования, и будут обеспечивать критерии для оценки полноты, полезности и соответствия программной документации, создаваемой в организации.
По возможности, должны быть приняты действующие международные и национальные стандарты. Если подходящие стандарты отсутствуют, то организация должна разработать собственные.