Настройки дизайна
  • Общие
  • Шапка
  • Главная
Базовый цвет
Свой цвет
Сайдбар
Тень на внутренних страницах
Фон логотипа в цвет сайта
Шапка сайта всегда видна
Шапка по ширине экрана
Кнопка "Оставить заявку" вместо слогана
Главное меню
Пункты меню 3-го уровня
Скрыть слайдер
"Услуги" на главной
"Тизеры" на главной
"Форма обратной связи" на главной
"Выполненные работы" на главной
"Новости" на главной
"Блог" на главной
"Партнеры" на главной

С чего следует начинать техническому писателю?

Wiki для разработчиков технической документации


Чтобы стать редактором Wiki оставьте заявку в произвольной форме на форуме 



С чего следует начинать техническому писателю?



  1. Прочитать раздел Wiki :  Базовая квалификация технического писателя
  2. Пройти обучение
  3. Зарегистрироваться и задавать вопросы на форуме технических писателей
  4. Прочитать книги


0

0
writer
Уважаемые технические писатели! Давайте обсудим эту статью на Wiki с чего следует все-таки начинать техническому писателю? Ваше мнение?
1
elanor
Ну как с чего.. с изучения стандартов и регламентов, по которым ему предстоит писать эту самую документацию.
По поводу "прочитать книги", я бы рекомендовала:
  • Ю.В. Кагарлицкий "Разработка документации пользователя программного продукта"
  • В. Глаголев "Разработка технической документации" - тут просто хорошая выжимка из всех российских стандартов, хотя лично мне из этой книги пригодились реально пара глав, от силы.
  • Если собрались переводить или писать руководства на английском, то Microsoft Manual of Style это просто must read.
0
ADVANCED
Цитата
elanor пишет:
Ну как с чего.. с изучения стандартов и регламентов, по которым ему предстоит писать эту самую документацию.
Вот с ГОСТов вообще не следует начинать, ими пользуются (или их требуют) только фанаты-извращенцы.
У меня сложилось мнение, что чем больше влияние ГОСТов на документацию, тем меньше зарплата. В крупных компаниях разрабатывают свои стандарты.
0
elanor
Так вот эти стандарты компании также входят в список для изучения =)
Я, например, пишу в крупной фирме с кучей отделов,  в каждом отделе своя документация.
У нас на всех единый формат и единый регламент подготовки документации.
0
ADVANCED
Цитата
elanor пишет:
Так вот эти стандарты компании также входят в список для изучения =)
Я, например, пишу в крупной фирме с кучей отделов, в каждом отделе своя документация.
У нас на всех единый формат и единый регламент подготовки документации.
Мертвого уговорите!

С этого можно начинать, но не с ГОСТов.
0
writer
Согласен, ГОСТы могут отбить все желание быть техписом)
0
MarMak
Я начинала с написания художественной литературы. Работала "литнегром" у блогеров, влогеров и писателей. Нужно заинтересовать тех.пользователя словом. Чем оно будет проще, тем лучше.) Стандарт должен быть, учитывая, что организации типа Минпромторга без ГОСТов документ даже рассматривать не станут. Но внутренняя документация и руководства - вполне могут иметь собственную, корпоративную унификацию.  
0
MarMak
Цитата
MarMak пишет:
Я начинала с написания художественной литературы. Работала "литнегром" у блогеров, влогеров и писателей. Нужно заинтересовать тех.пользователя словом. Чем оно будет проще, тем лучше.) Стандарт должен быть, учитывая, что организации типа Минпромторга без ГОСТов документ даже рассматривать не станут. Но внутренняя документация и руководства - вполне могут иметь собственную, корпоративную унификацию.  
"...вполне может... - вместо "...вполне могут..." - простите, была испугана(с). Допустила некорректность.
Зарегистрируйтесь
Рейтинг@Mail.ru