Руководство пользователя

Руководство пользователя составляют на основании следующих регламентирующих документов:ГОСТ 34.201-89, РД 50-34.698-90, IEEE 1163-2001

Руководство пользователя — один из основных программных документов, основная задача которого состоит в обеспечении пользователям возможностью самостоятельно решать основные задачи, на которые нацелена программа.

Руководство пользователя содержит полное описание программы с точки зрения целевого применения последней, а именно:

– назначение программы;

– основные задачи и возможности;

– способ отражения предметной области в программе;

– пользовательский интерфейс программы;

– порядок решения основных пользовательских задач;

– все функции программы и порядок их применения;

– пользовательская настройка программы;

– проблемы при использовании и способы их решения.

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

В зависимости от особенностей программы и целевой аудитории руководство пользователя по способу изложения материала может приближаться к учебнику или к справочнику. Порядок изложения материала в руководстве пользователя определяется пользовательской перспективой программы.

Если программа представляет собой инструмент, позволяющий решать практические задачи из некоторого конечного набора, в руководстве приводят типовые процедуры решения каждой из них.

Например, пользователю почтового клиента необходимо знать, как написать и отправить сообщение, как загрузить новые сообщения с сервера, как ответить на сообщение и т. Д. Каждое из этих действий можно разложить на последовательные элементарные шаги. В крупной программе подобных пользовательских задач может быть много, но не бесконечно. Руководство пользователя, построенное по принципу пользовательских задач, напоминает учебник, хотя, как правило, лишено присущего учебникам методического аппарата: проверочных заданий, вопросов, упражнений.

Если программа представляет собой среду, в пределах которой пользователь может решать задачи, поставленные им самостоятельно, руководство пользователя должно быть ближе к справочнику. В нем последовательно и систематично должны быть описаны все функции программы и порядок их применения. Так, в руководстве пользователя по графическому редактору мы найдем описание всех графических примитивов, инструментов, фильтров, однако, там не будет напрямую сказано, как изобразить тот или иной предмет.

Возможны и другие пользовательские перспективы. Так, в программах, посредством которых пользователь контролирует состояние того или иного объекта (пусть промышленной установки) руководство пользователя строится по принципу таблицы: сообщение программы — реакция или возможные реакции пользователя.

Если пользователь применяет программу для решения задач в нетривиальных предметных областях, в руководство рекомендуется включить концептуальный раздел. В нем должен быть описан реализованный в программе способ представления объектов реального мира, чтобы пользователь хорошо понимал, с какими из них и на каком уровне абстракции он может работать.

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

1. Общие сведения.

2. Установка и первоначальная настройка.

3. Основные понятия и определения.

4. Интерфейс пользователя.

5. Работа с программой.

6. Пользовательская настройка.

7. Сообщения об ошибках.