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

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

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