Руководство пользователя, также известное как руководство пользователя, предназначено для помощи пользователям в использовании определенного продукта, услуги или приложения. Обычно его пишет технический специалист, разработчик продукта или сотрудники службы поддержки клиентов компании.
Руководство пользователя часто прилагается к покупке бытовой техники. Но теперь это распространено и в сервисах, и в программном обеспечении, и в приложениях ... Оно публикуется в бумажном виде или в электронном (документ или приложение).
Большинство руководств пользователя содержат как письменное руководство, так и связанные с ним изображения. В случае компьютерных приложений обычно включаются снимки экрана человеко-машинного интерфейса (ов), а руководства по аппаратному обеспечению часто включают четкие и упрощенные схемы . Используемый язык подбирается для целевой аудитории с минимальным количеством жаргона или подробным объяснением.
Содержание руководства пользователя
Разделы руководства пользователя часто включают:
- Титульный лист
- Титульный лист и страница с авторскими правами
- Предисловие, содержащее подробную информацию о связанных документах и информацию о том, как ориентироваться в руководстве пользователя.
- Страница содержания
- Раздел "Назначение". Это должен быть обзор, а не подробное описание цели документа.
- Раздел "Аудитория", в котором явно указывается, кто является целевой аудиторией, которую необходимо читать, включая дополнительные параметры.
- Раздел «Область действия» имеет решающее значение, поскольку он также служит отказом от ответственности, в котором указывается, что выходит за рамки, а также то, что покрывается.
- Руководство по использованию хотя бы основной функции системы
- Раздел устранения неполадок, в котором подробно описаны возможные ошибки или проблемы, которые могут возникнуть, а также способы их устранения.
- FAQ (часто задаваемые вопросы)
- Где найти дополнительную помощь и контактные данные
- Глоссарий и для больших документов, индекс
История
Руководства пользователя были обнаружены с древних устройств. Одним из примеров является механизм Antikythera , [1] 2000 года греческий аналог компьютера , который был найден у берегов греческого острова Антикитера в 1900 году на обложке этого устройства отрывки текста , которые описывают функции и операции механизм.
По мере развития индустрии программного обеспечения вопрос о том, как лучше всего документировать программы, оставался нерешенным. Это была уникальная проблема для разработчиков программного обеспечения, поскольку пользователи часто разочаровывались в текущих справочных документах. [2] Некоторые соображения по написанию руководства пользователя, разработанного в это время, включают:
- использование простого языка [2]
- длина и трудности чтения [2]
- роль печатных руководств пользователя для цифровых программ [3]
- ориентированный на пользователя дизайн [3]
Руководства и руководства по компьютерному программному обеспечению
Руководства пользователя и руководства пользователя для большинства нетривиальных программных приложений представляют собой документы в виде книг с содержанием, аналогичным приведенному выше списку. Они могут распространяться в печатном или электронном виде. Некоторые документы имеют более гибкую структуру с множеством внутренних ссылок. Google Earth Руководство пользователя [4] является примером такого формата. Термин « руководство» часто применяется к документу, в котором рассматривается конкретный аспект программного продукта. Некоторые обычаи Установка Руководство , Руководство по началу работы , а также различные Как гидами. Примером может служить Руководство по началу работы с Picasa . [5]
В некоторых бизнес-программных приложениях, где группы пользователей имеют доступ только к подмножеству полной функциональности приложения, для каждой группы может быть подготовлено руководство пользователя. Пример такого подхода является Autodesk Topobase 2010 Помощи [6] документа, который содержит отдельный администратор Руководство , пользователь Руководство , а также для разработчиков Руководства .
Смотрите также
Рекомендации
- ^ "Боффинс расшифровывает руководство для древнегреческого компьютера 2000-летней давности" . Проверено 29 ноября 2018 .
- ^ а б в Чафин, Рой (январь 1982 г.). «Руководства пользователя: что на самом деле нужно пользователю?». SIGDOC '82 Труды 1-й ежегодной международной конференции по системной документации : 36–39 - через ACM Digital Library.
- ^ а б Макки, Джон (август 1986). «Руководства пользователя компьютеров в печати: есть ли у них будущее?». ACM SIGDOC Asterisk Journal компьютерной документации . 12 : 11–16 - через цифровую библиотеку ACM.
- ^ «Руководство пользователя Google Планета Земля» . Google. 4 июня 2009 . Проверено 13 августа 2009 года .
- ^ «Начало работы с Picasa: руководство по началу работы» . Google. 15 июня 2009 . Проверено 13 августа 2009 года .
- ^ «Справка по Autodesk Topobase 2010» . Autodesk . Проверено 13 августа 2009 года .