ГОСТ 19.505-79
Группа Т55
МЕЖГОСУДАРСТВЕННЫЙ СТАНДАРТ
Единая система программной документации
РУКОВОДСТВО ОПЕРАТОРА
Требования к содержанию и оформлению
Unified system for program documentation. Operation’s guide. Requirements for contents and form of presentation
МКС 35.080
Дата введения 1980-01-01
Постановлением Государственного комитета CCCР по стандартам от 12 января 1979 г. N 74 дата введения установлена 01.01.80
ИЗДАНИЕ (январь 2010 г.) с Изменением N 1, утвержденным в сентябре 1981 г. (ИУС 11-81).
Настоящий стандарт устанавливает требования к содержанию и оформлению программного документа «Руководство оператора», определенного ГОСТ 19.101-77.
Стандарт полностью соответствует СТ СЭВ 2096-80*.
(Измененная редакция, Изм. N 1).
1. ОБЩИЕ ПОЛОЖЕНИЯ
1.1. Структура и оформление программного документа устанавливаются в соответствии с ГОСТ 19.105-78.
Составление информационной части (аннотации и содержания) является обязательным.
1.2. Руководство оператора должно содержать следующие разделы:
назначение программы;
условия выполнения программы;
выполнение программы;
сообщения оператору.
В зависимости от особенностей документа допускается объединять отдельные разделы или вводить новые.
(Измененная редакция, Изм. N 1).
2. СОДЕРЖАНИЕ РАЗДЕЛОВ
2.1. В разделе «Назначение программы» должны быть указаны сведения о назначении программы и информация, достаточная для понимания функций программы и ее эксплуатации.
2.2. В разделе «Условия выполнения программы» должны быть указаны условия, необходимые для выполнения программы (минимальный и (или) максимальный состав аппаратурных и программных средств и т.п.).
2.3. В разделе «Выполнение программы» должны быть: указана последовательность действий оператора, обеспечивающих загрузку, запуск, выполнение и завершение программы, приведены описание функций, формата и возможных вариантов команд, с помощью которых оператор осуществляет загрузку и управляет выполнением программы, а также ответы программы на эти команды.
2.2, 2.3. (Измененная редакция, Изм. N 1).
2.4. (Исключен, Изм. N 1).
2.5. В разделе «Сообщения оператору» должны быть приведены тексты сообщений, выдаваемых в ходе выполнения программы, описание их содержания и соответствующие действия оператора (действия оператора в случае сбоя, возможности повторного запуска программы и т.п.).
2.6. Допускается содержание разделов иллюстрировать поясняющими примерами, таблицами, схемами, графиками.
(Измененная редакция, Изм. N 1).
2.7. В приложения к руководству оператора допускается включать различные материалы, которые нецелесообразно включать в разделы руководства.
(Введен дополнительно, Изм. N 1).
Помимо использования, автоматизированную систему необходимо также устанавливать и настраивать. Каким образом решается этот вопрос (ГОСТ 19)?
Назначение руководства системного администратора
Системный администратор – это сотрудник, должностные инструкции которого подразумевают обеспечение штатной работы парка компьютерной техники, сети и программного обеспечения (ранее должность называлась «системный программист»). Соответственно, именно этот человек будет заниматься установкой вашего программного обеспечения на конкретных технических средствах, будь то персональный компьютер с определенными характеристиками, либо промышленный серверный комплекс.
Руководство системного администратора призвано максимально подробно раскрыть информацию о комплексе технических средств, необходимых для работы вашего программного обеспечения, а также описать процесс и особенности установки, настройки и поддержки работоспособности вашего ПО.
Состав типового руководства системного администратора
В системе ЕСПД требования к содержанию и оформлению данного руководства регулируются стандартом ГОСТ 19.503-79. В соответствии с ним, документ должен содержать следующие разделы:
1) Общие сведения о программе – назначение и функции программы и сведения о технических и программных средствах, обеспечивающих выполнение данной программы.
2) Структура программы – сведения о структуре программы, ее составных частях, о связях между составными частями и о связях с другими программами.
3) Настройка программы – описание инструкций по настройке программы на условия конкретного применения (настройка на состав технических средств, выбор функций и др.).
4) Проверка программы – описание способов проверки, позволяющих дать общее заключение о работоспособности программы (контрольные примеры, методы прогона, результаты).
5) Дополнительные возможности – описание дополнительных разделов функциональных возможностей программы и способов их выбора.
6) Сообщения системному программисту – тексты сообщений, выдаваемых в ходе выполнения настройки, проверки программы, а также в ходе выполнения программы, описание их содержания и действий, которые необходимо предпринять по этим сообщениям.
В зависимости от особенностей документы допускается объединять отдельные разделы или вводить новые.
Стандарты для руководства системного администратора
Руководство системного администратора выполняется в соответствии с требованиями ГОСТ 19.503.
Стоимость разработки руководства системного администратора
|
Наименование документа |
Наименование стандарта |
Стоимость разработки |
|---|---|---|
|
Руководство системного администратора на ПО |
ГОСТ 19.503 |
от 80 тыс. р. |
Для того, чтобы учесть все принципиальные моменты, а также соблюсти все требования стандартов и методик, закажите разработку руководства системного администратора в компании ТехРайтКонсалт, и вы получите документ, позволяющий работать с вашим программным продуктом всегда правильно!
Возможно, вас также заинтересует:
– создание руководства программиста;
– разработка руководства администратора;
– разработка руководства оператора.
Журавлев Денис
Когда и у кого возникает необходимость создания руководства пользователя по ГОСТ
Многие IT-компании, которые занимаются разработкой и сопровождением программного обеспечения и автоматизированных комплексов, сталкиваются с задачей создания пользовательской документации или руководств для своих продуктов в соответствии с требованиями ГОСТ.
Как правило, необходимость в наличии пользовательского руководства, составленного по ГОСТ, возникает при сотрудничестве с государственными организациями, крупными производствами и компаниями, при заказной разработке программного обеспечения по тендерам и госзаказам или при необходимости добавить программный продукт в «Единый реестр российских программ для электронных вычислительных машин и баз данных (реестр отечественного ПО)».
Какие ГОСТ используются при написании руководства пользователя приложения
Существует две серии (набора) стандартов, которые регламентируют набор создаваемых документов и правила их оформления при разработке автоматизированных систем, комплексов и программного обеспечения:
- ГОСТ 34 — Автоматизированные системы
- ГОСТ 19 — Единая система программной документации (ЕСПД)
С одной стороны, эти два стандарта конкурируют между собой, предлагаю различные варианты комплектности документации на проект. С другой стороны, они фокусируются на разных аспектах, и поэтому хорошо дополняют друг друга.
ГОСТ 34 главным образом определяет комплектность, виды, структуру и содержание создаваемых документов.
ГОСТ 19 в большей степени определяет правила оформления документов.
Поэтому, на практике часто используются сразу оба этих ГОСТа.
Руководство пользователя — основной документ для конечного пользователя
Если говорить именно о документации для конечного пользователя системы, то из перечня описываемых в ГОСТ 34 документов нас интересует «Руководство пользователя». В ГОСТ 19 аналогичный по смыслу документ называется «Руководство оператора», но для программного обеспечения чаще используется именно первый вариант.
Руководство пользователя поставляется с любым изделием, программой, системой. Он должен предоставлять пользователю информацию о свойствах продукта, его функциональности, способах использования и работе с ним.
Сложности написания руководства пользователя по ГОСТ
Для начинающего технического писателя или простого специалиста, которому неожиданно поручили написать руководство пользователя по ГОСТ, эта задача является серьезной проблемой.
Мало того, что необходимо изучить большое число нормативных документов, изобилующих перекрестными ссылками и написанных сложным, излишне канцелярским, почти юридическим языком, так еще необходимо выбрать оттуда требования, относящиеся именно к создаваемому виду документа. Затем, на протяжении всей работы, нужно постоянно контролировать соблюдение этих требований в рабочем документе, постоянно сверяясь со стандартами.
Обычно проблема усугубляется еще и нехваткой времени, так как писать пользовательскую документацию, к сожалению, часто принято в самом конце проекта, перед самым дедлайном — датой сдачи или запуска системы.
У опытного технического писателя документирование по ГОСТ, возможно, не вызовет серьезных затруднений. Однако, даже у него подготовка шаблонов новых документов, приведение к требованиями стандартов существующей документации или проверка финального документа на соответствие этим требованиям может занять существенное время.
Dr.Explain упрощает создание руководства пользователя по ГОСТ
Начиная с версии 5.5.1100 программа для создания пользовательской документации Dr.Explain предлагает функцию автоматизированной поддержки ГОСТ в проектах. Эта функция призвана значительно облегчить жизнь пользователям, перед которыми стоит задача создания руководства пользователя в соответствии с требованиями государственных стандартов.
В частности программа Dr.Explain контролирует и автоматизирует поддержку следующих требований стандартов:
- Наличие обязательных разделов документа “Руководство пользователя” [ГОСТ 34 РД 50-34.698-90]. Все разделы снабжаются пояснениями по их содержанию.
- Оформление титульных листов, аннотации и содержания [ГОСТ 19.105-78, 19.104-78].
- Параметры печатных страниц документа и расположение основных элементов на них [ГОСТ 19.106-78].
- Структуру и оформление колонтитулов [ГОСТ 19.106-78].
- Оформление текстовой части документа: стили шрифтов, абзацные отступы, межстрочные интервалы [ГОСТ 19.106-78].
- Формирование и оформление заголовков, разделов, перечислений (списков) [ГОСТ 19.106-78].
Управление функцией поддержки ГОСТ для проекта доступно в Настройках проекта в разделе Общие.
При включенном режиме поддержки ГОСТ для проекта соответствующие пользовательские настройки для печатаемых форматов RTFDOC и PDF автоматически перекрываются программой, что гарантирует полное соответствие параметров выходных документов требованиям стандартов.
Для выходных форматов HTML и CHM будут использоваться пользовательские настройки вне зависимости от активности режима поддержки ГОСТ. Это снимает ограничение на свободную стилизацию этих форматов и позволяет, например, оформить онлайн-справку полностью в корпоративном или тематическом стиле.
Важно: Перед включением режима поддержки ГОСТ для уже существующих в формате Dr.Explain проектов необходимо сделать резервную копию gui-файла проекта.
Важно: Функция поддержки ГОСТ доступна в Dr.Explain только в русскоязычной версии интерфейса. Язык интерфейса программы выбирается в меню НастройкиВыбор языка программы (OptionsApplication language).
Создание нового руководства пользователя по ГОСТ
Для создания нового руководства пользователя по требованиям ГОСТ 34 в программе Dr.Explain можно использовать команды меню Файл Создать локальный проект — Руководство пользователя по ГОСТ 34 или Файл Создать общий проект на tiwri.com — Руководство пользователя по ГОСТ 34
или аналогичные кнопки на стартовом экране приложения.
Программа создаст новый проект, в котором уже присутствуют шаблон титульного листа, аннотация, оглавление и обязательные разделы, оформленные по ГОСТ.
В тексте каждого раздела будет приведена краткая инструкция-подсказка о том, что необходимо включить в данный раздел. Пользователю необходимо только наполнить разделы актуальным содержимым.
Настройки оформления для печатных форматов RTF/DOC и PDF будут выставлены в соответствии с требованиям ГОСТ 19.
Приведение существующей пользовательской документации в соответствие с требованиями ГОСТ
Также программа Dr.Explain позволяет привести существующую пользовательскую документацию в соответствии с требованиями ГОСТ.
Важно: Перед включением режима поддержки ГОСТ для уже существующих в формате Dr.Explain проектов необходимо сделать резервную копию gui-файла проекта.
Если исходная документация еще не ведется в Dr.Explain, а хранится в других форматах, первым шагом необходимо выполнить импорт существующих документов в программу. Dr.Explain поддерживает импорт документов из ряда популярных форматов. Команды импорта доступны как на стартовом окне программы, так и в меню Файл.
Затем необходимо включить режим поддержки ГОСТ в свойствах проекта описанным ранее способом.
Программа проверит структуру документа на наличие обязательных разделов и, если они отсутствуют, создаст их. Остальные существующие разделы, наличие которых не регламентировано ГОСТами, будут перенесены в скрытый от экспорта раздел “Старое дерево разделов”.
Пользователь должен будет перенести содержимое этих разделов или разделы целиком методом drag-n-drop в основное дерево проекта и отредактировать их по необходимости.
Как и в первом случае настройки оформления для печатных форматов RTF/DOC и PDF будут выставлены в соответствии с требованиям ГОСТ 19.
Создайте документацию, соответсвующую ГОСТ 19 и ГОСТ 34 в Dr.Explain бесплатно
Смотрите также
- Шаблоны файлов помощи, руководства пользователя программного обеспечения или сайта, шаблон базы знаний — бесплатные шаблоны и примеры пользовательской документации
Шаблоны для разработки технической документации
В этом разделе собраны шаблоны документов для разработки технической документации согласно ГОСТ 19, ГОСТ 34 и др. Надеемся они Вам пригодятся. Обсудить все тонкости разработки технической документации согласно ГОСТ вы можете на форуме разработчиков технической документации или в комментариях под каждым из шаблонов.
Все шаблоны предоставляются бесплатно!
Если не нашли шаблона, то пишите здесь
Если у Вас есть шаблоны документов, которых еще нет в этом каталоге, то просим прислать их на нашу почту. Помогите своим коллегам!
Благодарность за помощь в пополнении коллекции выражаем: Максиму Казначееву
Скачать шаблон файла с TechWriters.ru: Загрузить
В зависимости от особенностей программы допускается вводить дополнительные разделы или объединять отдельные разделы.
Допускается содержание разделов иллюстрировать поясняющими примерами, таблицами, схемами, графиками.
Назад в раздел