ЯК написати керівництво користувача :: як правильно написати інструкцію по експлуатації :: ПЗ

Яким би геніальним не був винахідник, програміст або раціоналізатор, часом його творіннями просто неможливо користуватися за призначенням. Виною тому - невірно складена інструкція з експлуатації або її повна відсутність. Але навіть геніальні винахідники іноді пишуть такі інструкції, що крім вузьких фахівців ніхто ці папери прочитати не може. Так як же правильно скласти такий необхідний документ?

Вам знадобиться

- стовідсоткове знання пристрою або програмного продукту, для якого пишеться керівництво;
- пізнання в галузі мовознавства;
- навички письменницької майстерності.

Інструкція

Керівництво користувача або, іншими словами, керівництво з експлуатації - документ, покликаний надати допомогу у використанні деякої системи її користувачам. Для складання керівництва користувача вам необхідно знати описувану систему на всі сто відсотків, проте дивитися на неї очима нічого не тямить школяра. Припустимо, керівництво користувача пишеться для якоїсь програмної утиліти, аналогів якої ще не було. Уявіть, що ви зіткнулися з цією програмою вперше. З чого потрібно починати? Що необхідно знати в першу чергу? Систематизуйте ці знання, розбивши їх на категорії важливості.

Розбивши всю інформацію, що стосується вашого творіння, на групи, ви склали план для написання керівництва користувача. Почніть описувати роботу у вашій програмі з азів, залишаючи наостанок найскладніші деталі, що стосуються, скажімо, перепрограмування можливостей або роботі з критичними помилками. На цьому етапі у вас має бути готове зміст керівництва користувача - Одна з обов'язкових частин цього документа.

Якщо створюване вами керівництво призначене для використання у великій компанії, то варто звернути увагу на прийняті там корпоративні стандарти. Наприклад, у багатьох російських компаніях керівництво користувачів не приймаються без ілюстративного супроводу, простіше кажучи, картинок, пояснюючих написане. У керівництві користувача крім змісту повинні бути й інші обов'язкові частини: - Анотація, тобто пояснення загальних завдань керівництва та описуваного продукта-- введення, в якому розповідається про пов'язані з керівництвом користувача документах і методах використання руководства-- розділи, що пояснюють про використання продукту на різних стадіях його використання, наприклад, перші кроки, ремонт або профілактіка-- розділ поширених запитань і відповідей на ніх-- глосарій або предметний покажчик.

Зазвичай створенням керівництва користувача займається технічний письменник - людина, що має всі не обхідні пізнання як у мові, так і в описуваному продукті. Займаючись діяльністю технічного письменника без відповідної підготовки, потрібно пам'ятати про декілька правилах. По-перше, не можна зловживати спеціальними термінами, незрозумілими для рядового користувача. По-друге, кожен використовуваний термін повинен бути детально розписаний і пояснений. По-третє, писати потрібно максимально зрозуміло і лаконічно. Нарешті, технічний письменник повинен вміти дивитися на власний текст очима пересічного користувача, щоб бачити недоліки власного тексту.

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