ВТ. Эксплуатационные документы
Стандарт распространяется на изделия ВТ и устанавливает требования к их эксплуатационным документам, разрабатываемым на электронных и бумажных носителях, применяется совместно с ГОСТ Р 2.601-2019.
= Изучаемый документ =
ГОСТ РВ 0002-601-2008
Стандарт распространяется на изделия ВТ и устанавливает требования к их эксплуатационным документам, разрабатываемым на электронных и бумажных носителях, применяется совместно с ГОСТ Р 2.601-2019.
= Изучаемый документ =
ГОСТ РВ 0002-601-2008
Порядок оформления ПД
Основные надписи по ГОСТ 19.104
Общие требования к ПД по ГОСТ 19.105
Требования к ПД, выполненным печатным способом по ГОСТ 19.106
ПД состоит из следующих условных частей:
- Титульная часть:
— Лист утверждения
— Титульный лист
- Информационная часть:
— Аннотация
— Содержание
- Основная часть:
— Текст документа
— Приложения
— Перечень терминов
— Перечень сокращений
— Перечень рисунков
— Перечень таблиц
— Предметный указатель
— Перечень ссылочных документов
— Перечень символов и числовых коэффициентов
- Часть регистрации изменений:
— Лист регистрации изменений
= Изучаемые документы =
ГОСТ 19.104, ГОСТ 19.105, ГОСТ 19.106
Основные надписи по ГОСТ 19.104
Общие требования к ПД по ГОСТ 19.105
Требования к ПД, выполненным печатным способом по ГОСТ 19.106
ПД состоит из следующих условных частей:
- Титульная часть:
— Лист утверждения
— Титульный лист
- Информационная часть:
— Аннотация
— Содержание
- Основная часть:
— Текст документа
— Приложения
— Перечень терминов
— Перечень сокращений
— Перечень рисунков
— Перечень таблиц
— Предметный указатель
— Перечень ссылочных документов
— Перечень символов и числовых коэффициентов
- Часть регистрации изменений:
— Лист регистрации изменений
= Изучаемые документы =
ГОСТ 19.104, ГОСТ 19.105, ГОСТ 19.106
ТЗ на разработку программы или программного изделия
ТЗ по ГОСТ 19.201 должно содержать следующие разделы:
- введение;
- основания для разработки;
- назначение разработки;
- требования к программе или программному изделию;
- требования к программной документации;
- технико-экономические показатели;
- стадии и этапы разработки;
- порядок контроля и приемки.
в ТЗ допускается:
- включать приложения;
- уточнять содержание разделов, вводить новые разделы или объединять отдельные из них.
Содержание разделов в стандарте.
= Изучаемый документ =
ГОСТ 19.201
ТЗ по ГОСТ 19.201 должно содержать следующие разделы:
- введение;
- основания для разработки;
- назначение разработки;
- требования к программе или программному изделию;
- требования к программной документации;
- технико-экономические показатели;
- стадии и этапы разработки;
- порядок контроля и приемки.
в ТЗ допускается:
- включать приложения;
- уточнять содержание разделов, вводить новые разделы или объединять отдельные из них.
Содержание разделов в стандарте.
= Изучаемый документ =
ГОСТ 19.201
Спецификация (ПД)
Спецификация в общем случае должна содержать разделы:
- документация;
- комплексы;
- компоненты.
Наименование каждого раздела указывают в виде заголовка в графе "Наименование". Для документов, выполненных печатным способом, заголовок подчеркивают.
После каждого раздела спецификации необходимо оставлять несколько свободных строк для дополнительных записей.
Требования к заполнению разделов в стандарте.
= Изучаемый документ =
ГОСТ 19.202
Спецификация в общем случае должна содержать разделы:
- документация;
- комплексы;
- компоненты.
Наименование каждого раздела указывают в виде заголовка в графе "Наименование". Для документов, выполненных печатным способом, заголовок подчеркивают.
После каждого раздела спецификации необходимо оставлять несколько свободных строк для дополнительных записей.
Требования к заполнению разделов в стандарте.
= Изучаемый документ =
ГОСТ 19.202
Программы и методики испытаний
У многих людей происходит смещение до степени сходства документов:
- Программа и методика испытаний по ЕСПД - ГОСТ 19. 301-79;
- Программа и методика испытаний по ЕСКД - ГОСТ Р 2.106-2019;
- Программа и методики испытаний по СРПП - ГОСТ РВ 15.211-2002.
Больше пока сказать не могу... Завал
У многих людей происходит смещение до степени сходства документов:
- Программа и методика испытаний по ЕСПД - ГОСТ 19. 301-79;
- Программа и методика испытаний по ЕСКД - ГОСТ Р 2.106-2019;
- Программа и методики испытаний по СРПП - ГОСТ РВ 15.211-2002.
Больше пока сказать не могу... Завал
Текст программы
ГОСТ 19.401-78 устанавливает требования к программному документу "Текст программы"
Если в ТЗ есть требование соответствия ЕСПД, но здравый смысл подсказывает, что печатать символическую запись на исходном языке не лучшая идея.
Несколько раз приходилось так делать🤯🤦🏻♂️
Как правило текст программы оформляют документами на "магнитном носителе". О чем должна быть отметка в перечне (комплектности).
RU.АБВГ.ХХХХХ-ХХ 12 01 - Текст программы. Исходный модуль
RU.АБВГ.ХХХХХ-ХХ 12 02 - Текст программы. Загрузочный модуль
RU.АБВГ.ХХХХХ-ХХ-УД - Удостоверяющий лист
Удостоверяющий лист по ГОСТ 28388-89. Системы обработки информации. Документы на магнитных носителях данных. Порядок выполнения и обращения
Примечания:
1) по умолчанию ГОСТ 28388-89 используют для документов на оптических носителях: CD, DVD
2) не забудьте выпустить листы утверждения на каждый ПД Текст программы
= Изучаемые документы =
ГОСТ 19.401-78, ГОСТ 28388-89, ГОСТ 19.103-77
ГОСТ 19.401-78 устанавливает требования к программному документу "Текст программы"
Если в ТЗ есть требование соответствия ЕСПД, но здравый смысл подсказывает, что печатать символическую запись на исходном языке не лучшая идея.
Несколько раз приходилось так делать🤯🤦🏻♂️
Как правило текст программы оформляют документами на "магнитном носителе". О чем должна быть отметка в перечне (комплектности).
RU.АБВГ.ХХХХХ-ХХ 12 01 - Текст программы. Исходный модуль
RU.АБВГ.ХХХХХ-ХХ 12 02 - Текст программы. Загрузочный модуль
RU.АБВГ.ХХХХХ-ХХ-УД - Удостоверяющий лист
Удостоверяющий лист по ГОСТ 28388-89. Системы обработки информации. Документы на магнитных носителях данных. Порядок выполнения и обращения
Примечания:
1) по умолчанию ГОСТ 28388-89 используют для документов на оптических носителях: CD, DVD
2) не забудьте выпустить листы утверждения на каждый ПД Текст программы
= Изучаемые документы =
ГОСТ 19.401-78, ГОСТ 28388-89, ГОСТ 19.103-77
Описание программы
ПД как правило разрабатывают на этапе сертификации и содержит разделы:
- общие сведения;
- функциональное назначение;
- описание логической структуры;
- используемые технические средства;
- вызов и загрузка;
- входные данные;
- выходные данные.
= Изучаемый документ =
ГОСТ 19.402-78
ПД как правило разрабатывают на этапе сертификации и содержит разделы:
- общие сведения;
- функциональное назначение;
- описание логической структуры;
- используемые технические средства;
- вызов и загрузка;
- входные данные;
- выходные данные.
= Изучаемый документ =
ГОСТ 19.402-78
Пояснительная записка
ПД разрабатывают на стадиях эскизного и технического проектирования. Содержит разделы:
- введение;
- назначение и область применения;
- технические характеристики;
- ожидаемые технико-экономические показатели;
- источники, использованные при разработке.
Содержание разделов приведено в стандарте.
= Изучаемый документ =
ГОСТ 19.404-79
ПД разрабатывают на стадиях эскизного и технического проектирования. Содержит разделы:
- введение;
- назначение и область применения;
- технические характеристики;
- ожидаемые технико-экономические показатели;
- источники, использованные при разработке.
Содержание разделов приведено в стандарте.
= Изучаемый документ =
ГОСТ 19.404-79
Онлайн-курс «Техническая документация в IT-проектах» (2020) от documentat.io
О чем:
- Цели и задачи документации с точки зрения проектного управления.
- Жизненные циклы технических документов. Процессы создания, рецензирования, хранения и публикации документации.
- Типичные виды инструментария создания, хранения и публикации документации. Их сравнение с точки зрения применимости к разным видам документационных процессов.
- Обзор современных документационных стандартов (ГОСТ и ISO/IEC/IEEE).
- Профессиональный профиль технического писателя. Что нужно, чтобы быть хорошим техписателем, куда расти опытному техписателю, как нанимать их себе в команду.
Лекция 1. Два определения технической документации.
https://youtu.be/w0DNTDE3EgE
Лекция 2. Техническая документация — проектный артефакт или процесс?
https://youtu.be/BG5yBiyZTRc
Лекция 3. Жизненные циклы технических документов
https://youtu.be/qF9hDviKBYM
Лекция 4. Требования к документационному инструментарию.
https://youtu.be/Sawz84gY4Uk
Лекция 5. Введение в DocOps
https://youtu.be/1CuMeMYwtbg
Лекция 6. Docs as code на примере Foliant
https://youtu.be/6CKVodl2YcA
Лекция 7. ГОСТ 19 в современной разработке
https://youtu.be/1P18VkS7ORQ
Лекция 8. Help Authoring Tools на примере MadCap Flare
https://youtu.be/6fAQ1HC5fqI
Лекция 9. Локализация документации
https://youtu.be/UYRKX1ZuUzw
Лекция 10. ГОСТ 34 в современной разработке, часть 1
https://youtu.be/Cb7oyeIjWZ8
Лекция 11. ГОСТ 34 в современной разработке, часть 2
https://youtu.be/NLXbsE_HOJY
Лекция 12. ГОСТ 34 в современной разработке, часть 3
https://youtu.be/O9896hB0DSM
О чем:
- Цели и задачи документации с точки зрения проектного управления.
- Жизненные циклы технических документов. Процессы создания, рецензирования, хранения и публикации документации.
- Типичные виды инструментария создания, хранения и публикации документации. Их сравнение с точки зрения применимости к разным видам документационных процессов.
- Обзор современных документационных стандартов (ГОСТ и ISO/IEC/IEEE).
- Профессиональный профиль технического писателя. Что нужно, чтобы быть хорошим техписателем, куда расти опытному техписателю, как нанимать их себе в команду.
Лекция 1. Два определения технической документации.
https://youtu.be/w0DNTDE3EgE
Лекция 2. Техническая документация — проектный артефакт или процесс?
https://youtu.be/BG5yBiyZTRc
Лекция 3. Жизненные циклы технических документов
https://youtu.be/qF9hDviKBYM
Лекция 4. Требования к документационному инструментарию.
https://youtu.be/Sawz84gY4Uk
Лекция 5. Введение в DocOps
https://youtu.be/1CuMeMYwtbg
Лекция 6. Docs as code на примере Foliant
https://youtu.be/6CKVodl2YcA
Лекция 7. ГОСТ 19 в современной разработке
https://youtu.be/1P18VkS7ORQ
Лекция 8. Help Authoring Tools на примере MadCap Flare
https://youtu.be/6fAQ1HC5fqI
Лекция 9. Локализация документации
https://youtu.be/UYRKX1ZuUzw
Лекция 10. ГОСТ 34 в современной разработке, часть 1
https://youtu.be/Cb7oyeIjWZ8
Лекция 11. ГОСТ 34 в современной разработке, часть 2
https://youtu.be/NLXbsE_HOJY
Лекция 12. ГОСТ 34 в современной разработке, часть 3
https://youtu.be/O9896hB0DSM
Формуляр (программный документ)
Составление информационной части (аннотации и содержания) является обязательным.
В основную часть формуляра должны входить разделы:
- общие указания;
- общие сведения;
- основные характеристики;
- комплектность;
- периодический контроль основных характеристик при эксплуатации и хранении;
- свидетельство о приемке;
- свидетельство об упаковке и маркировке;
- гарантийные обязательства;
- сведения о рекламациях;
- сведения о хранении;
- сведения о закреплении программного изделия при эксплуатации;
- сведения об изменениях;
- особые отметки;
- приложения.
= Изучаемый документ =
ГОСТ 19.501-78
Составление информационной части (аннотации и содержания) является обязательным.
В основную часть формуляра должны входить разделы:
- общие указания;
- общие сведения;
- основные характеристики;
- комплектность;
- периодический контроль основных характеристик при эксплуатации и хранении;
- свидетельство о приемке;
- свидетельство об упаковке и маркировке;
- гарантийные обязательства;
- сведения о рекламациях;
- сведения о хранении;
- сведения о закреплении программного изделия при эксплуатации;
- сведения об изменениях;
- особые отметки;
- приложения.
= Изучаемый документ =
ГОСТ 19.501-78
Описание применения
Составление информационной части (аннотации и содержания) является обязательным.
Текст описания применения должен состоять из разделов:
- назначение программы;
- условия применения;
- описание задачи;
- входные и выходные данные.
= Изучаемый документ =
ГОСТ 19.502-78
Составление информационной части (аннотации и содержания) является обязательным.
Текст описания применения должен состоять из разделов:
- назначение программы;
- условия применения;
- описание задачи;
- входные и выходные данные.
= Изучаемый документ =
ГОСТ 19.502-78
Руководство системного программиста
Составление информационной части (аннотации и содержания) является обязательным.
Руководство системного программиста должно содержать разделы:
- общие сведения о программе;
- структура программы;
- настройка программы;
- проверка программы;
- дополнительные возможности;
- сообщения системному программисту.
= Изучаемый документ =
ГОСТ 19.503-79
Составление информационной части (аннотации и содержания) является обязательным.
Руководство системного программиста должно содержать разделы:
- общие сведения о программе;
- структура программы;
- настройка программы;
- проверка программы;
- дополнительные возможности;
- сообщения системному программисту.
= Изучаемый документ =
ГОСТ 19.503-79
Руководство программиста
Составление информационной части (аннотации и содержания) является обязательным.
Руководство программиста должно содержать следующие разделы:
- назначение и условия применения программы;
- характеристики программы;
- обращение к программе;
- входные и выходные данные;
- сообщения.
= Изучаемый документ =
ГОСТ 19.504-79
Составление информационной части (аннотации и содержания) является обязательным.
Руководство программиста должно содержать следующие разделы:
- назначение и условия применения программы;
- характеристики программы;
- обращение к программе;
- входные и выходные данные;
- сообщения.
= Изучаемый документ =
ГОСТ 19.504-79
Руководство оператора
Составление информационной части (аннотации и содержания) является обязательным.
Руководство оператора должно содержать следующие разделы:
- назначение программы;
- условия выполнения программы;
- выполнение программы;
- сообщения оператору.
= Изучаемый документ =
ГОСТ 19.505-79
Составление информационной части (аннотации и содержания) является обязательным.
Руководство оператора должно содержать следующие разделы:
- назначение программы;
- условия выполнения программы;
- выполнение программы;
- сообщения оператору.
= Изучаемый документ =
ГОСТ 19.505-79
Ведомость эксплуатационных документов
Составление информационной части (аннотации и содержания) является необязательным.
В ведомости перечисляют документы, входящие в перечень эксплуатационных программных документов.
Ведомость эксплуатационных документов должна содержать разделы:
- документы на программу;
- документы на составные части программы.
Ведомость эксплуатационных документов на компонент, имеющий самостоятельное применение, должна содержать только раздел "Документы на программу"
= Изучаемый документ =
ГОСТ 19.507-79
Составление информационной части (аннотации и содержания) является необязательным.
В ведомости перечисляют документы, входящие в перечень эксплуатационных программных документов.
Ведомость эксплуатационных документов должна содержать разделы:
- документы на программу;
- документы на составные части программы.
Ведомость эксплуатационных документов на компонент, имеющий самостоятельное применение, должна содержать только раздел "Документы на программу"
= Изучаемый документ =
ГОСТ 19.507-79
Руководство по техническому обслуживанию
Составление информационной части (аннотации и содержания) является обязательным.
Руководство по техническому обслуживанию должно содержать следующие разделы:
- введение;
- общие указания;
- требования к техническим средствам;
- описание функций.
В зависимости от особенностей документа допускается вводить дополнительные разделы.
= Изучаемый документ =
ГОСТ 19.508-79
Составление информационной части (аннотации и содержания) является обязательным.
Руководство по техническому обслуживанию должно содержать следующие разделы:
- введение;
- общие указания;
- требования к техническим средствам;
- описание функций.
В зависимости от особенностей документа допускается вводить дополнительные разделы.
= Изучаемый документ =
ГОСТ 19.508-79
Порядок документирования программных средств систем вооружения
Вопросу посвящен раздел 7 ГОСТ Р 51189-98. Хочу обратить внимание на пп. 7.7 - 7.9:
7.7 Программная документация на все ПССВ и их покупные программные компоненты должна быть выполнена на русском языке.
7.8 Эксплуатационная ПД на ПССВ должна быть выполнена в соответствии с требованиями стандартов ЕСПД и настоящего стандарта.
7.9 Проектную ПД на ПССВ выполняют по стандартам ЕСПД.
В реальной жизни эти требования могут привести и приводят к разработке документации на русском языке на покупное иностранное ПО. Мне довелось делать русскоязычную документацию на СУБД в составе документации которой не было текста программы, но была лицензия на DB2.
= Изучаемый документ =
ГОСТ Р 51189-98 раздел 7
Вопросу посвящен раздел 7 ГОСТ Р 51189-98. Хочу обратить внимание на пп. 7.7 - 7.9:
7.7 Программная документация на все ПССВ и их покупные программные компоненты должна быть выполнена на русском языке.
7.8 Эксплуатационная ПД на ПССВ должна быть выполнена в соответствии с требованиями стандартов ЕСПД и настоящего стандарта.
7.9 Проектную ПД на ПССВ выполняют по стандартам ЕСПД.
В реальной жизни эти требования могут привести и приводят к разработке документации на русском языке на покупное иностранное ПО. Мне довелось делать русскоязычную документацию на СУБД в составе документации которой не было текста программы, но была лицензия на DB2.
= Изучаемый документ =
ГОСТ Р 51189-98 раздел 7
Росстандарт_8262.pdf
3.4 MB
Требования к содержанию документов АС
РД 50-34.698-90 - недействующий.
Во вложении письмо Росстандарта.
В конце 2020 года завершено исполнение контракта "Разработка и подготовка к утверждению стандартов в области информационных технологий".
Выписал из контракта перечень стандартов на АС :
Информационная технология. Комплекс стандартов на автоматизированные системы. Виды, комплектность и обозначение документов при создании автоматизированных систем
Пересмотр ГОСТ 34.201-89
Информационная технология. Комплекс стандартов на автоматизированные системы. Автоматизированные системы. Термины и определения
Пересмотр ГОСТ 34.003-90
Информационная технология. Комплекс стандартов на автоматизированные системы. Техническое задание на создание автоматизированной системы
Пересмотр ГОСТ 34.602-89
РД 50-34.698-90 - недействующий.
Во вложении письмо Росстандарта.
В конце 2020 года завершено исполнение контракта "Разработка и подготовка к утверждению стандартов в области информационных технологий".
Выписал из контракта перечень стандартов на АС :
Информационная технология. Комплекс стандартов на автоматизированные системы. Виды, комплектность и обозначение документов при создании автоматизированных систем
Пересмотр ГОСТ 34.201-89
Информационная технология. Комплекс стандартов на автоматизированные системы. Автоматизированные системы. Термины и определения
Пересмотр ГОСТ 34.003-90
Информационная технология. Комплекс стандартов на автоматизированные системы. Техническое задание на создание автоматизированной системы
Пересмотр ГОСТ 34.602-89
Технические условия
В соответствии с ГОСТ 2.102 являются КД, содержащим требования (совокупность всех показателей, норм, правил и положений) к изделию, его изготовлению, контролю, приемке и поставке, которые нецелесообразно указывать в других КД;
В соответствии с ГОСТ 19.101 содержат требования к изготовлению, контролю и приемке программы.
В общем случае ТУ должны содержать вводную часть и разделы, расположенные в следующей последовательности:
- технические требования;
- требования безопасности;
- требования охраны окружающей среды;
- правила приемки;
- методы контроля (испытаний);
- указания по эксплуатации, в том числе требования хранения, транспортирования и утилизации изделия;
- гарантии изготовителя.
Для изделий ВВТ есть особенности построения ТУ, с которыми при необходимости можно ознакомиться в ГОСТ РВ 20.39.301-98 "Комплексная система общих технических требований (КСОТТ). Аппаратура, приборы, устройства, оборудование военной техники (АПУОВТ). Общие требования, методы обеспечения и оценки соответствия требованиям. Основные положения."
=Изучаемые документы=
ГОСТ 2.114
ГОСТ 19.101 п. 2.7
ГОСТ РВ 20.39.301-98 п. 7.4.2, 7.4.3, 9.5
ГОСТ РВ 20.39.415-97 (не применим к изделиям разработка которых началась после 2020 г. )
В соответствии с ГОСТ 2.102 являются КД, содержащим требования (совокупность всех показателей, норм, правил и положений) к изделию, его изготовлению, контролю, приемке и поставке, которые нецелесообразно указывать в других КД;
В соответствии с ГОСТ 19.101 содержат требования к изготовлению, контролю и приемке программы.
В общем случае ТУ должны содержать вводную часть и разделы, расположенные в следующей последовательности:
- технические требования;
- требования безопасности;
- требования охраны окружающей среды;
- правила приемки;
- методы контроля (испытаний);
- указания по эксплуатации, в том числе требования хранения, транспортирования и утилизации изделия;
- гарантии изготовителя.
Для изделий ВВТ есть особенности построения ТУ, с которыми при необходимости можно ознакомиться в ГОСТ РВ 20.39.301-98 "Комплексная система общих технических требований (КСОТТ). Аппаратура, приборы, устройства, оборудование военной техники (АПУОВТ). Общие требования, методы обеспечения и оценки соответствия требованиям. Основные положения."
=Изучаемые документы=
ГОСТ 2.114
ГОСТ 19.101 п. 2.7
ГОСТ РВ 20.39.301-98 п. 7.4.2, 7.4.3, 9.5
ГОСТ РВ 20.39.415-97 (не применим к изделиям разработка которых началась после 2020 г. )