Документирование и сертификация практическаяя работа. ДиСпр4. Стандарты на документацию пользователя программных средств

• Название: Стандарты на документацию пользователя программных средств
• Анкор: Документирование и сертификация практическаяя работа
• Дата: 27.02.2022
• Размер: 22.16 Kb.
• Имя файла: ДиСпр4.docx
• Тип: Практическая работа; #375892

Практическая работа №4

Вариант 1

Тема: Стандарты на документацию пользователя программных средств
Цель: изучение национальных стандартов и стандартов ЕСПД на документацию пользователя программных средств:

- ГОСТ Р ИСО/МЭК 15910-2002. «Информационная технология. Процесс создания документации пользователя программного средства»;

- ГОСТ Р ИСО/МЭК 9127-94. «Системы обработки информации. Документация пользователя и информация на упаковке для потребительских программных пакетов»;

- ГОСТ 19.503. Руководство системного программиста. Требования к содержанию и оформлению;

- ГОСТ 19.504. Руководство программиста;

- ГОСТ 19.505. Руководство оператора
Задание:
А) изучить национальный стандарт ГОСТ Р ИСО/МЭК 15910-2002. Информационная технология. Процесс создания документации пользователя программного средства (п.8.2, приложение Н).
Б) Ответить на вопросы по варианту, указанному преподавателем:

1. 
   Виды документации пользователя ПС
   
2. 
   Типы документации пользователя ПС
   

2.1 типы диалоговой документации

2.2 типы справочной информации

3. 
   Пояснить значение следующих элементов стиля бумажной документации ПС:
   

3.1 правила пагинации

3.2 правила плотности документа

3.3 количество уровней и наименования заголовков

3.4 стиль текста заголовков

4. 
   Пояснить значение следующих элементов стиля электронной документации ПС:
   

4.1 компоновка отчетов

4.2 стиль текста уведомлений и предостережений

4.3 заголовки диалоговой документации и справочного текста

4.4 правила навигации

5. 
   Общие положения спецификации указателя
   
6. 
   Качество спецификации указателя
   
7. 
   В каком порядке должны располагаться заголовки указателя?
   
8. 
   Какие ссылки удобнее для пользователя?
   

В) изучить национальный стандарт ГОСТ Р ИСО/МЭК 9127-94. «Системы обработки информации. Документация пользователя и информация на упаковке для потребительских программных пакетов»
Г) Ответить на вопросы по варианту, указанному преподавателем:

9. 
   Понятие потребительского программного пакета
   
10. 
    Категории информации, установленные в настоящем стандарте
    
11. 
    Назначение документации пользователя
    
12. 
    Назначение информации на упаковке
    
13. 
    Информация на упаковке, поставляемая по усмотрению изготовителя ПС
    
14. 
    Структура обязательной информации в документации пользователя
    

вариант	индивидуальное задание
1	1) Ответить на вопросы №№ 1, 3.1, 3.3, 4.1, 4.3, 5, 7, 9, 11, 13. 2) Пояснить требования к содержанию руководства системного программиста, в соответствии со стандартом ЕСПД: ГОСТ 19.503. Руководство системного программиста. Требования к содержанию и оформлению.
2	1) Ответить на вопросы №№ 2.1, 3.2, 3.4, 4.2, 4.4, 6, 8, 10, 12, 14. - ГОСТ 2) Пояснить требования к содержанию руководства оператора, в соответствии со стандартом ЕСПД: 19.505. Руководство оператора.
3	1) Ответить на вопросы №№ 2.2, 3.2, 3.3, 4.2, 4.3, 6, 7, 9, 12, 13. 2) Пояснить требования к содержанию руководства программиста, в соответствии со стандартом ЕСПД: ГОСТ 19.504. Руководство программиста.

№1:

• 
  Общее функциональное описание ПС. Дает краткую характеристику функциональных возможностей ПС. Предназначено для пользователей, которые должны решить, насколько необходимо им данное ПС.
  
• 
  Руководство по инсталяции ПС. Предназначено для администраторов ПС. Оно должно детально предписывать, как устанавливать системы в конкретной среде, в частности, должно содержать описание компьютерно-считываемого носителя, на котором поставляется ПС, файлы, представляющие ПС, и требования к минимальной конфигурации аппаратуры.
  
• 
  Инструкция по применению ПС. Предназначена для ординарных пользователей. Содержит необходимую информацию по применению ПС, организованную в форме удобной для ее изучения.
  
• 
  Справочник по применению ПС. Предназначен для ординарных пользователей. Содержит необходимую информацию по применению ПС, организованную в форме удобной для избирательного поиска отдельных деталей.
  
• 
  Руководство по управлению ПС. Предназначено для администраторов ПС. Оно должно описывать сообщения, генерируемые, когда ПС взаимодействует с другими системами, и как должен реагировать администратор на эти сообщения. Кроме того, если ПС использует системную аппаратуру, этот документ может объяснять, как сопровождать эту аппаратуру.
  

№3.1:

Заголовки не должны попадать в конец страницы. Таблицы объемом менее страницы должны размешаться на одной странице. Каждый заголовок первого уровня должен располагаться вверху правой страницы.
№3.3:

Четыре; заголовки части, главы, раздела и подраздела.
№4.1:

Должны быть представлены в горизонтальной (альбомной) компоновке без использования страниц-раскладок.
№4.3:

Заголовки подсвечивают, используя более яркую цветовую тональность. Применяют только два уровня заголовков. Заголовки излагают в повествовательном стиле (см. 8.2.3.7.2). Сверху и снизу каждого заголовка оставляют пробел, равный одной строке.

№5:

Каждый документ, содержащий более 32 страниц, должен иметь указатель.

Примечание - Указатель должен охватывать все компоненты документа, включая вводные материалы, приложения, дополнения и рисунки.
№7:

Заголовки указателя должны располагаться в алфавитном порядке, пробел должен трактоваться как символ, предшествующий последующему (например, термин «Alt key» размещается перед «Alternative»).
№9:

Потребительский программный пакет (далее - программный пакет): Программная продукция, спроектированная и продаваемая для выполнения определенных функций; программа и соответствующая ей документация, упакованные для продажи как единое целое.
№11:

Назначением документации пользователя является обеспечение конечного пользователя достаточной информацией для ясного понимания:

а) цели, функций и характеристик программного средства;

b) того, как ввести в действие и использовать программное средство;

с) договорных прав и обязанностей.
№13:

Факультативная - информация, поставляемая по усмотрению изготовителя или торгующей организации.