Инструкция для пользователей 1С: как составить, чтобы её читали

Хорошая инструкция для пользователя 1С отвечает на один вопрос: «Что мне нажать, чтобы получить результат?» Один документ, одна задача, от 3 до 12 шагов, к каждому шагу экран и ожидаемый итог. Всё, что не помогает выполнить задачу, убирайте.

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

Для кого пишем: аудитория и формат инструкции

Начните не с текста, а с портрета читателя. Спросите себя три вещи: как часто человек работает в программе, что он уже умеет и где будет читать инструкцию.

Типичные группы в компании:

• 🧾 Бухгалтер и кадровик. Знает предметную область, не знает ваших настроек. Ему нужны отличия вашей базы от «типовой».
• 📦 Кладовщик, менеджер по продажам. Знает свою операцию, терминов 1С не любит. Ему нужен короткий маршрут «кнопка за кнопкой».
• 🆕 Новичок в первую неделю. Не знает, где в интерфейсе что находится. Ему нужны названия разделов и картинки.
• 🔧 Руководитель. Читает редко, но ему важен результат: какой отчёт открыть и как понять, что всё в порядке.

От аудитории зависит формат. Выбирайте по таблице.

Правило: один документ — одна задача. Инструкция «Работа в 1С: Бухгалтерия» не работает . Инструкция «Как оформить поступление товара от поставщика» работает.

Структура инструкции: как выстроить логику изложения

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

Скелет документа

1. Название-задача. Глагол и результат: «Оформить возврат от покупателя».
2. Кому и когда нужна. Одно-два предложения: роль, ситуация, ожидаемый итог.
3. Что подготовить. Права, данные, документы-основания, нужный режим работы.
4. Шаги. Нумерованный список, одно действие на пункт.
5. Как проверить результат. Что должно появиться в журнале, отчёте или на экране.
6. Если что-то пошло не так. Короткая таблица «симптом — причина — что делать».
7. Контакты. Кому писать, если не помогло, и в каком формате.

Правила для шагов

Один шаг — одно действие. «Откройте документ, заполните шапку и проведите» превращаются в три пункта.

Начинайте шаг с глагола в повелительном наклонении: «Нажмите», «Выберите», «Введите». Не «необходимо произвести нажатие».

Называйте элементы так, как они подписаны на экране. Если кнопка называется «Провести и закрыть», так и пишите. Заменять её на «сохранить» нельзя: человек будет искать другое.

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

Что вынести в отдельный блок

• ⚠️ Опасные действия. Массовое удаление, перепроведение за период, закрытие периода . Предупреждайте до шага, а не после.
• 💡 Подсказки. Горячие клавиши , быстрый поиск, копирование строк.
• 📌 Исключения. Что делать, если контрагент иностранный, если товар возвращается частично, если документ уже проведён.

Скриншоты в инструкции: как снимать и подписывать

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

Что снимать

• Экран, на котором человек должен найти нужный элемент: раздел, кнопку, вкладку.
• Заполненную форму с реальным примером значений.
• Итог: что появилось в журнале или в отчёте.

Как оформить

1. Обрежьте лишнее. Читателю нужна рабочая область, а не весь монитор с панелью задач и чужими вкладками.
2. Выделите нужное красной рамкой или стрелкой. Один скриншот — один акцент.
3. Поставьте номер шага на картинке, если на ней несколько действий.
4. Добавьте подпись одной строкой: «Рис. 3. Форма документа после заполнения».
5. Размер файла держите до 300-500 КБ: PNG для интерфейса, JPEG вреден из-за артефактов вокруг текста.

Чего не должно быть на картинке

Перед публикацией проверьте экран на персональные данные. Фамилии сотрудников, суммы зарплат, ИНН клиентов, названия реальных договоров, пароли. Делайте скриншоты в тестовой базе или копии с обезличенными данными. Если снимаете в рабочей, закройте всё лишнее и размойте остаток.

Видео и анимированные GIF дополняют текст, но не заменяют. Они не копируются, и по ним нельзя быстро найти нужное место. Давайте ссылку на ролик внутри шага.

Как описывать поля и ввод данных

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

Таблица полей

Для форм с большим числом полей давайте таблицу из трёх колонок.

Колонка «Пример» нужна обязательно. Она снимает половину вопросов.

Обязательные и необязательные

Отметьте поля, без которых документ не проведётся. Остальные коротко пометьте как «по необходимости» или не описывайте вовсе, если они не влияют на задачу. Лишнее поле в описании хуже, чем отсутствующее: человек начнёт его заполнять и сделает ошибку.

Правила ввода, которые стоит объяснить

• 📅 Формат даты и чисел. Разделитель дробной части, как вводить суммы с копейками.
• 🔍 Выбор из справочника. Как искать по части названия и что делать, если позиции нет. Создавать новую или звать ответственного?
• ✏️ Ручной ввод или выбор. Где можно писать вручную, а где только выбирать, иначе в базе появятся дубли.
• 🔒 Автозаполнение. Какие поля заполнятся сами и когда их надо перепроверить.

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

Ошибки и нестандартные ситуации: что писать пользователю

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

Формат раздела с ошибками

Дословно приводите текст сообщения в обратных кавычках. Человек копирует его и ищет в документе. Рядом объясните причину простыми словами и дайте действие.

Когда обращаться в поддержку

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

Объясните, какие данные приложить к заявке: название документа, номер и дату, текст сообщения, скриншот экрана, время, когда ошибка случилась. Такая заявка решается за один заход вместо трёх переписок.

Проверка инструкции на живом человеке

Автор не видит собственных ошибок: он знает, что имел в виду. Единственный надёжный способ проверки — дать документ тому, кто не участвовал в написании.

Как провести проверку за 30 минут

1. Выберите человека из целевой аудитории, а не коллегу-айтишника.
2. Дайте тестовую базу и только инструкцию, без устных пояснений.
3. Попросите говорить вслух, что он делает и что ему непонятно.
4. Не подсказывайте. Фиксируйте, где человек замялся, перелистнул назад или спросил.
5. После теста сверьте результат: должен получиться тот документ, что описан в инструкции.

Каждое место, где человек остановился, значит: тут не хватает слова, картинки или предупреждения. Исправьте и проведите вторую проверку с другим человеком.

Актуализация: как не дать инструкции устареть

Инструкция живёт до первого обновления конфигурации. Кнопка переехала, документ переименовали, добавился обязательный реквизит. Через полгода на неё никто не смотрит, потому что «там всё не так».

Что делать после обновления

• 🔄 Назначьте владельца каждого документа. Без владельца никто не обновляет.
• 📅 Проверяйте инструкции после перехода на новый релиз и после смены порядка работы в компании. В карточке документа фиксируйте дату последней проверки.
• 🗂 Храните один экземпляр в общем месте и давайте ссылку, а не рассылайте файл. Копии на почте и рабочих столах расходятся.
• 📝 Ведите короткий список изменений в конце: «Добавлен шаг 6: проверка склада». Пользователь сразу видит, что нового.

Как понять, что инструкцию пора править

Следите за сигналами:

• одни и те же вопросы снова появляются в заявках;
• люди присылают скриншоты, которые не совпадают с вашими;
• новые сотрудники всё равно идут к коллеге вместо документа;
• шаги ссылаются на отчёты или кнопки, которых уже нет.

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

Типичные промахи при написании инструкций

Некоторые ошибки повторяются у всех. Сверьте свой текст:

• ❌ Жаргон. «Перепроведите, потом ребилдните регистр» понятно одному человеку из десяти. Объясняйте или заменяйте.
• ❌ Скриншоты вместо слов. Картинка устарела, а текст ничего не поясняет.
• ❌ Лишние подробности. Описание всех вкладок формы, когда нужны две.
• ❌ Нет результата. После шага 8 человек не знает, закончил он или нет.
• ❌ Пропущенные права. Инструкция работает у автора с полными правами и ломается у сотрудника с ограниченной ролью.

Хороший признак: после чтения человек не задаёт вопросов вроде «а потом что?». Если задаёт, добавьте в документ ответ.

Частые вопросы