Как написать понятную инструкцию. Опыт инженера

О книге

Автор книги - . Произведение относится к жанрам руководства, книги о компьютерах. Оно опубликовано в 2023 году. Книге не присвоен международный стандартный книжный номер.

Аннотация

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

Читать онлайн Владимир Юсупов - Как написать понятную инструкцию. Опыт инженера


Предисловие

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


Данную небольшую работу можете считать этаким криком души. И далее немного вам поясню, что я имею в виду. Но для начала, как принято в приличном обществе, представлюсь и расскажу немного о себе.


Я – инженер. Когда-то окончил машиностроительный факультет Саратовского государственного технического университета (ныне имени Ю.А. Гагарина). По многим причинам мне не довелось реализоваться по своей специальности, но вот уже почти 15 лет (на момент написания этой книги) я успешно работаю в сфере информационных технологий.


Основными моими задачами на протяжении всего моего профессионального пути являлись разработка хранилищ данных и визуализация данных. При этом практически весь мой опыт связан с конкретным программным обеспечением (ПО) – SAP (в нашем профессиональном сообществе мы используем название – САП). Специалистов, которые внедряют различные информационные системы на базе данного ПО называют SAP-консультантами (произносится, как САП-консультант), коим я также и являюсь. SAP-консультант – это такой «и швец, и жнец, и на дуде игрец», этакий «универсальный солдат», который не только технические настройки и разработки выполняет, но готовит материалы для обучения пользователей, проводит это самое обучение в различных форматах и выполняет много других задач, среди которых и подготовка документации.


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


Теперь вернемся к причинам выбора темы.


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


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


Рекомендации для вас