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

Руководство пользователя (англ. user guide или user manual), руководство по эксплуатации, руководство оператора — документ, назначение которого — предоставить людям помощь в использовании некоторой системы. Документ входит в состав технической документации на систему и, как правило, подготавливается техническим писателем.

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

Типичное руководство пользователя содержит:

• Аннотацию, в которой приводится краткое изложение содержимого документа и его назначение
• Введение, содержащее ссылки на связанные документы и информацию о том, как лучше всего использовать данное руководство
• Страницу содержания
• Главы, описывающие, как использовать, по крайней мере, наиболее важные функции системы
• Глава, описывающая возможные проблемы и пути их решения
• Часто задаваемые вопросы и ответы на них
• Где ещё найти информацию по предмету, контактная информация
• Глоссарий и, в больших документах, предметный указатель

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

Стандарты

Структура и содержание документа Руководство пользователя автоматизированной системы регламентированы подразделом 3.4 документа РД 50-34.698-90. Структура и содержание документов Руководство оператора, Руководство программиста, Руководство системного программиста регламентированы ГОСТ 19.505-79, ГОСТ 19.504-79 и ГОСТ 19.503-79 соответственно.

• Комплекс стандартов и руководящих документов на автоматизированные системы (ГОСТ 34)
  • РД 50-34.698-90 АВТОМАТИЗИРОВАННЫЕ СИСТЕМЫ. ТРЕБОВАНИЯ К СОДЕРЖАНИЮ ДОКУМЕНТОВ
  • ГОСТ 2.601-2006 Эксплуатационные документы
  • ГОСТ 2.610-2006 Правила выполнения эксплуатационных документов
  • ГОСТ 19.101-77 Виды программ и программных документов
  • ГОСТ 19.105-78 Общие требования к программным документам
  • ГОСТ 19.505-79 Руководство оператора. Требования к содержанию и оформлению
  • ГОСТ 19.508-79 Руководство по техническому обслуживанию. Требования к содержанию и оформлению

  См. также

  Ссылки

  • Руководство пользователя. Пример оформления по РД 50-34.698-90
  • Бесплатные инструкции по эксплуатации бытовой электроники
  • Как писать руководство пользователя? Часть I
  • Как писать руководство пользователя? Часть II
  • Сайт разработчиков технической документации (технических писателей)
  • MetaGuide — руководство для разработчиков технической документации к программному обеспечению
  • Типичные ошибки в справке пользователя для ПО и как их избежать
  • Руководства по ремонту автомобилей
  • Руководства по эксплуатации автомобильной техники
  • Руководства по эксплуатации бытовой техники
  • Техническая документация

  Wikimedia Foundation . 2010 .

  User guide

  

  A user guide, also commonly known as a user manual, is intended to assist users in using a particular product, service or application. It’s usually written by a technician, product developer, or a company’s customer service staff.

  Most user guides contain both a written guide and associated images. In the case of computer applications, it is usual to include screenshots of the human-machine interface(s), and hardware manuals often include clear, simplified diagrams. The language used is matched to the intended audience, with jargon kept to a minimum or explained thoroughly.

  Contents

  • 1 Contents of a user manual
  • 2 History
  • 3 Computer software manuals and guides
  • 4 See also
  • 5 References

  Contents of a user manual

  The sections of a user manual often include:

  • A cover page
  • A title page and copyright page
  • A preface, containing details of related documents and information on how to navigate the user guide
  • A contents page
  • A Purpose section. This should be an overview rather than detail the objective of the document
  • An Audience section to explicitly state who is the intended audience who is required to read, including optionals
  • A Scope section is crucial as it also serves as a disclaimer, stating what is out-of-scope as well as what is covered
  • A guide on how to use at least the main function of the system
  • A troubleshooting section detailing possible errors or problems that may occur, along with how to fix them
  • A FAQ (Frequently Asked Questions)
  • Where to find further help, and contact details
  • A glossary and, for larger documents, an index

  History

  

  The user guide engraved into a model of the Antikythera Mechanism.

  User guides have been found with ancient devices. One example is the Antikythera Mechanism, [1] a 2,000 year old Greek analogue computer that was found off the coast of the Greek island Antikythera in the year 1900. On the cover of this device are passages of text which describe the features and operation of the mechanism.

  As the software industry was developing, the question of how to best document software programs was undecided. This was a unique problem for software developers, since users often became frustrated with current help documents. [2] Some considerations for writing a user guide that developed at this time include:

  • the use of plain language [2]
  • length and reading difficulty [2]
  • the role of printed user guides for digital programs [3]
  • user-centered design [3]

  Computer software manuals and guides

  User manuals and user guides for most non-trivial software applications are book-like documents with contents similar to the above list. They may be distributed either in print or electronically. Some documents have a more fluid structure with many internal links. The Google Earth User Guide [4] is an example of this format. The term guide is often applied to a document that addresses a specific aspect of a software product. Some usages are Installation Guide, Getting Started Guide, and various How to guides. An example is the Picasa Getting Started Guide. [5]

  In some business software applications, where groups of users have access to only a sub-set of the application’s full functionality, a user guide may be prepared for each group. An example of this approach is the Autodesk Topobase 2010 Help [6] document, which contains separate Administrator Guides, User Guides, and a Developer’s Guide.

  See also

  • Owner’s manual
  • Release notes
  • Moe book
  • Technical writer
  • Manual page (Unix)
  • Instruction manual (gaming)
  • Reference card
  • RTFM
  • HOWTO

  References

  1. ↑»Boffins decipher manual for 2,000-year-old Ancient Greek computer» (in en) . https://www.theregister.co.uk/2016/06/15/antikythera_mechanism_inscriptions_deciphered/ .
  2. ↑ 2.02.12.2 Chafin, Roy (January 1982). «User Manuals: What Does the User Really Need?». SIGDOC ’82 Proceedings of the 1st Annual International Conference on Systems Documentation: 36–39. doi:10.1145/800065.801307.
  3. ↑ 3.03.1 McKee, John (August 1986). «Computer User Manuals in Print: Do They Have a Future?». ACM SIGDOC Asterisk Journal of Computer Documentation12 (2): 11–16. doi:10.1145/15505.15507.
  4. ↑»Google Earth User Guide». 4 June 2009 . http://earth.google.com/userguide/v4/ .
  5. ↑»Getting Started with Picasa: Getting Started Guide». 15 June 2009 . http://picasa.google.com/support/bin/answer.py?hl=en&answer=93183 .
  6. ↑»Autodesk Topobase 2010 Help». Autodesk . http://docs.autodesk.com/TOPOBSCLNT/2010/ENU/Autodesk%20Topobase%202010%20User%20Documentation/index.html?url=WSfacf1429558a55de9af080101d7e8b304-7c61.htm,topicNumber=d0e342 .

  При подготовке материала использовались источники:
  https://dic.academic.ru/dic.nsf/ruwiki/45728
  https://handwiki.org/wiki/User_guide

  Читайте также:  Народная программа единой России что это