Блог технического писателя Ильи Жукова

Книга «Разработка технической документации»

Уважаемые коллеги! Если вам нужно быстро освоить разработку документации по ГОСТ, рекомендую обратить внимание на книгу В.А. Глаголева «Разработка технической документации: руководство для технических писателей и локализаторов ПО». Это компактный справочник, который позволит быстро разобраться в НИОКР, ГСИ, ЕСКД, ЕСПД, ЕСТД, КСАС и начать применять полученные знания на практике.

В 2007 – 2008 годах в компании «Софтэнергоатом» я разрабатывал документацию по ГОСТ. Это были концепции, технические задания, эскизный и технический проекты, ПМИ и другая документация. Тогда быстро понять специфику работы по ГОСТ мне помог семинар компании «Философт» «Документирование автоматизированных систем в соответствии с требованиями ГОСТ серии 34». Полученный набор шаблонов и пустографок я использую и сегодня, когда возникает необходимость оформить документацию по ГОСТ.

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

 

распечатки ГОСТов

 

Книга В.А. Глаголева «Разработка технической документации» решила сразу несколько проблем: освободила место на моем рабочем столе и сделала мою сумку легче на несколько килограммов.

 

книга Разработка технической документации

 

А теперь серьезно: что дала мне книга В.А. Глаголева «Разработка технической документации»?

Во-первых, книга позволила взглянуть на систему стандартов в целом. Считается, что чтобы понять систему, нужно выйти за ее пределы. Книга Вадима Глаголева позволила посмотреть на систему государственных стандартов со стороны, извне, понять взаимосвязь стандартов, а также место ГОСТов 19 и 34 в этой системе.

Во-вторых, любая печатная книга — это фундаментальный источник информации. Коллеги меня часто спрашивают «Ты это сам придумал или откуда-то взял?». Печатная версия книги позволяет ответить на этот вопрос предметно. Не просто упомянуть – это есть в ГОСТе. А открыть книгу и показать страницу с первоисточником.

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

 

Добавить комментарий

Последние статьи

Как вставить тесты в CHM и WebHelp…

Форматы электронной документации CHM, WebHelp и EWriter давно используются для создания и распространения электронных книг и учебников. Разработать такое учебное пособ...

Читать полностью...

Оформление рисунков в Help+Manual при по…

Рисунки в проекте Help and Manual можно единообразно оформить тремя способами. Во-первых, это можно сделать в графическом редакторе, например в Impict. Во-вторых, для ...

Читать полностью...

Подключение таблицы стилей к проекту Hel…

При работе с форматами, основанными на HTML, для оформления контента в документах можно использовать каскадные таблицы стилей, cascading style sheets или CSS. Данная т...

Читать полностью...

Формулы в HTML Help (CHM)

Я по образованию филолог. Специализируюсь на разработке пользовательской документации на английском и русском языках. С формулами в документации сталкиваюсь редко и по...

Читать полностью...

Импорт документов MS Word в Help+Manual…

Часто технический писатель получает исходные данные от аналитиков, разработчиков, тестировщиков, маркетологов и других специалистов в форматах DOC, DOCX и RTF (реже, и...

Читать полностью...

Поиск в WebHelp находит удаленные раздел…

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

Читать полностью...

Контекстная справка в приложениях Window…

Понятие контекстной или контекстно-зависимой справки (от англ. context-sensitive help) появилось в 1987 году с выходом формата WinHelp. Изначально контекстная справка ...

Читать полностью...

Как поддерживать скриншоты в актуальном …

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

Читать полностью...

Перевод выходных документов в Help and M…

Выбрав русский язык и русскую кодировку в настройках проекта Help and Manual, многие авторы после первой сборки удивляются, увидев в выходных документах английские сло...

Читать полностью...

Размер и расположение окна CHM при перво…

Разработчик справки в формате CHM может задать размер и расположение окна, которые будут использоваться при первом запуске CHM-файла. После того, как пользователь пере...

Читать полностью...

Рваные края скриншотов в Help and Manual…

Многие платные редакторы скриншотов, например, SnagIt, FastStone Capture и др., умеют создавать эффект рваных краев. В сети Интернет можно найти множество видеоуроков ...

Читать полностью...
новое в Help and Manual 9

Новое в Help and Manual 9

23 ноября 2022 года компания EC Software к 25-летнему юбилею выпустила 9-ю версию программного комплекса Help and Manual (выходит c 1997 года). Комплект шаблонов Premi...

Читать полностью...

Создание CHM-справки в бесплатной програ…

KEL CHM Creator — это «новая» хорошо забытая программа, выпущенная в 2012 году, предназначенная для создания и декомпиляции CHM-файлов. Программа не требовательна к ре...

Читать полностью...

KEL CHM Creator — бесплатная программа д…

Если вам нужно создать CHM-файл, и вы больше не хотите пользоваться глючной программой HTML Help Workshop, тогда KEL CHM Creator — это ваш вариант. Программа позволяет...

Читать полностью...
ключевые слова

Ключевые слова в Help+Manual…

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

Читать полностью...

HTML Help Workshop – бесплатная программ…

В 1997 году Microsoft выпустила новый формат справки, HTML Help (CHM), а также бесплатную программу для создания и редактирования справки в этом формате — HTML Help Wo...

Читать полностью...

Все о справке и документации для пользователей!

Следить за новыми статьями:

© Илья Жуков, 2019-2024. Охраняется законом об авторском праве.