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