КомпанияОбучениеСтатьиСервисы

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

Версия для печати

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

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

Документация: программная/эксплуатационная/документация пользователя
Предмет: программа, программный компонент комплекса или системы
Аудитория: пользователи программы, т. е. лица, применяющие ее для решения собственных прикладных задач
Задачи: обеспечить пользователям возможность в полном объеме самостоятельно освоить и применять программу
Стандарты: ГОСТ 34.201-89, РД 50-34.698-90, IEEE 1063-2001

Цели и задачи

Руководство пользователя — один из основных программных документов. Невозможно представить себе хоть сколько-нибудь сложный прикладной программный продукт, который не был бы укомплектован им в той или иной форме.

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

Содержание документа

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

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

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

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

Методика и стиль изложения

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

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

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

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

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

Типовая структура

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

  1. Общие сведения.
  2. Установка и первоначальная настройка.
  3. Основные понятия и определения.
  4. Интерфейс пользователя.
  5. Работа с программой.
  6. Пользовательская настройка.
  7. Сообщения об ошибках.

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

Особенности

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

© «Философт», 2008–2017

+7 (499) 500-44-77

mail@philosoft.ru

SpyLOG