МР>>А так — профессия нужная, но редкая. В основном люди привлекаются к написанию внешней документации (иногда пользовательской, иногда — что сложнее — для технических специалистов). МР>>Как правило, выделенных технических писателей привлекают компании имеющие собственный продукт (в заказной разработке редкость).
N>кстати, может объяснишь, почему она в своем большинстве такого плохого качества?
Не знаю.
У меня есть некие соображения, но и только.
1. У нас в целом большAя часть специалистов (не только технических) с очень большим трудом умеет изложить свои мысли просто и доступно.
И здесь, как мне кажется, основная проблема, что в нашей образовательной системе этот навык систематически не тренируется. Т.е., что в школе, что в вузе мы пишем сочинения, рефераты, но... пишем их достаточно шаблонно.
А всякие курсовые, дипломные, ... — которые делают большинство студентов это какой-то кошмар: один сплошной канцелярит, да еще и по строгому шаблону.
Ну и большинство учебников для ВУЗа кажется написаны по принципу "давайте напишем даже о простом на столько непонятно, чтобы никто не сомневался в нашей гениальности и даже не пытался понять ,что мы тут изложили".
Откуда тут возьмутся люди, умеющие легко и изящно объяснить что-либо? Да неоткуда им взяться.
А вот в той же английской и американской системах образования (про остальные просто не знаю) весьма популярно написание эссе. Т.е ровно то, о чем мы говорим: небольшой текст, где своими словами, простым языком изложить произвольную тему: философскую, техническую, ... — не важно, главное что формируется навык изложения своих мыслей в доступной для читающего форме.
Да они тоже не на 100% справляются, но у них, по крайней мере, есть какая-то база. Наши же письменные работы — это именно шаблоны за редким исключением.
2. Работа над документацией — это жутко тягомотная и рутинная работа.
Нужно кропотливо отслеживать изменения в продукте, по многу раз переписывать одни и те же разделы, обновлять скриншоты, ...
Т.е. это даже не техническая книга, над которой может быть реально интересно работать. Это тяжелая, нудная и кропотливая работа!
Конечно же, в случае наличия иных возможностей, мало кто будет стремиться идти в технические писатели.
3. При этом, если мы говорим не о пользовательской, а технической документации, её разработчик должен иметь достаточно глубокое понимание предмета. Даже придумать хорошие тестовые примеры для демонстрации некоего API — та еще задачка.
И получается, что тех, кто способен хорошо изложить материал не так и много (не готовим), а те кто есть могут найти себе куда более интересное (и денежное) занятие.
Re[4]: Технический писатель - что думаете об этой профессии?
хватит, а вот на жирную шавуху уже нет. МР>Ничего сказать не могу. МР>Я исхожу из того, что те продуктовые, где я успел поработать, периодически технических писателей в штат искали. МР>Но на темы: МР>- где они это делали? МР>- как находили людей? МР>- какие были/есть зарплаты?
МР>Ничего сказать не могу.
Я соблазнился пофрилансить (дурак!). Всё равно, думал, люблю писать и пишу бесплатно — почему бы не пописать за деньги? Даже за те, которые платят техписам в России. Закончилось как и следовало ожидать: как если бы девушка, любящая секс, решила подзаработать проституткой — доходы не покрывали даже профессиональные расходы, клиентура была пошлейшая, заставлявшая плевать себе в душу, писать то, с чем я не согласен, и не писать то, о чём думаю, а отношение — как к шалаве. При этом я работал только с теми клиентами, которые считаются лучшими на местном рынке и платят больше всех (аж баксов триста где-то за материал). Если вам дороги жизнь и рассудок, держитесь подальше от этих болот и пишите на сиплюплюсе.
Re: Технический писатель - что думаете об этой профессии?
Много чего. Вы бы как-то уточнили, что именно хочется узнать?
А так — профессия нужная, но редкая. В основном люди привлекаются к написанию внешней документации (иногда пользовательской, иногда — что сложнее — для технических специалистов).
Как правило, выделенных технических писателей привлекают компании имеющие собственный продукт (в заказной разработке редкость).
В России определенный рынок есть, но, судя по всему, не очень большой.
Помню, что было даже пара русскоязычных сообществ — поищите, наверняка там будет полный ответ на ваши вопросы.
Re[4]: Технический писатель - что думаете об этой профессии?
M>По моему опыту внешняя документация (без привязки к странам) бывает плохого качества по следующим причинам: M>1) тех. пис. плохо понимает тему, а время на то, чтобы исправить все ошибки вместе с разработчиками продукта, ограничено M>2) документация отстала от разработки продукта, а обновить нет времени или просто забыли M>3) алгоритм работы продукта очень нетривиальный/кривой, и описать его на человеческом языке без смысловых потерь непросто (псевдо/кодом проще) M>4) продукт имеет слабые стороны, но честно их описать в документации нельзя по маркетинговым соображениям (при этом совсем не писать о проблемах нельзя, т.к. нужно на что-то сослаться, если enduser будет недоволен)
Дополню еще:
5) Документация недостаточно была задействована в процессе тестирования
a) не тестировали саму документацию: точно ли получится сделать то, что надо, если следовать документации.
б) не тестировали покрытие документацией: все ли важные нюансы расписаны в документации
Re: Технический писатель - что думаете об этой профессии?
Здравствуйте, nikkit, Вы писали:
N>кстати, может объяснишь, почему она в своем большинстве такого плохого качества?
Экономят, навешивая написание документации как бы между делом
Re[3]: Технический писатель - что думаете об этой профессии?
N>кстати, может объяснишь, почему она в своем большинстве такого плохого качества? N>вроде и писать текст умеют, и вроде технический склад ума, но если рассматривать что вижу в российском секторе по толковости сильно уступает зарубежным аналогам (что там в Китае творится в этом плане могу только гадать)
Что такое документация в российском секторе? Документация для продуктов, которые продаются только в РФ?
По моему опыту внешняя документация (без привязки к странам) бывает плохого качества по следующим причинам:
1) тех. пис. плохо понимает тему, а время на то, чтобы исправить все ошибки вместе с разработчиками продукта, ограничено
2) документация отстала от разработки продукта, а обновить нет времени или просто забыли
3) алгоритм работы продукта очень нетривиальный/кривой, и описать его на человеческом языке без смысловых потерь непросто (псевдо/кодом проще)
4) продукт имеет слабые стороны, но честно их описать в документации нельзя по маркетинговым соображениям (при этом совсем не писать о проблемах нельзя, т.к. нужно на что-то сослаться, если enduser будет недоволен)
Re[7]: Технический писатель - что думаете об этой профессии?
M>>Вопрос был "почему тех документация в большинстве такого плохого качества?". При чем тут техписатели?
N>А Кто еще занимается ей, беря в штат технического писателя?
Когда она херовая, как правило ей занимаются разработчики по остаточному принципу
Re[4]: Технический писатель - что думаете об этой профессии?
МР>Откуда тут возьмутся люди, умеющие легко и изящно объяснить что-либо? Да неоткуда им взяться.
Их есть у меня... ) МР>А вот в той же английской и американской системах образования (про остальные просто не знаю) весьма популярно написание эссе. Т.е ровно то, о чем мы говорим: небольшой текст, где своими словами, простым языком изложить произвольную тему: философскую, техническую, ... — не важно, главное что формируется навык изложения своих мыслей в доступной для читающего форме.
Да мы в советской школе сочинения и изложения писали каждую четверть по несколько раз.
И вполне себе умели все это своими словами.
МР>2. Работа над документацией — это жутко тягомотная и рутинная работа.
Совершенно верно.
МР>3. При этом, если мы говорим не о пользовательской, а технической документации, её разработчик должен иметь достаточно глубокое понимание предмета. Даже придумать хорошие тестовые примеры для демонстрации некоего API — та еще задачка.
Совершенно верно.
МР>И получается, что тех, кто способен хорошо изложить материал не так и много (не готовим), а те кто есть могут найти себе куда более интересное (и денежное) занятие.
И эйчары еще в этом ни бельмеса и совершенно не понимают, кого реально можно брать на такую работу.
Хочешь быть счастливым — будь им!
Без булдырабыз!!!
Re[6]: Технический писатель - что думаете об этой профессии?
S>Здравствуйте, LaptevVV, Вы писали: LVV>>Да мы в советской школе сочинения и изложения писали каждую четверть по несколько раз. S>Шутку понял, смешно. "Ажно несколько раз за четверть"...
Радость ты моя. Ты в советской школе — то хоть учился ?
Я-то учился. И знаю, что говорю.
Можешь почитать мой слог в моих книжках.
А твой стиль изложения где прочесть можно ? S>Чтобы необходимые навыки наработались, эти сочинения нужно писать S>1. несколько раз в неделю (1-3) по каждому направлению S>2. по разным предметам (а не по литературе!) S>И повторять это в течение достаточно длинного времени — от года (для взрослых) до нескольких лет (если хотим с детства).
Это подготовка к журналистике и к окологоворилдьным профессиям.
А мы — технари. И тем не менее, вполне грамотно излагаем и формулируем.
Можешь еще почитать книжки Хазина — он тоже учился в советской школе и закончил МГУ.
Можешь почитать книжки Никонова — тоже из СССР. Тоже технарь бывший.
Хочешь быть счастливым — будь им!
Без булдырабыз!!!
Re[6]: Технический писатель - что думаете об этой профессии?
P>>Вот эти вот англоязычные эссе — это и есть 100% шаблон. Там регламентирована каждая фраза практически. Наши школьные сочинения по сравнению с этим — просто недостижимая литературная высота. S>Наши школьные сочинения — трэш и угар. S>Во-первых, там всё сводится к литературоведению.
Ты несёшь здесь какую-то дичь. Далеко не все сочинения пишутся по литературным произведениям. Они пишутся по любым темам (типа там "как я провел лето" или "рассказ о друге (маме и тд)"). Литература в сочинениях — это не объект изучения, а способ выражения мыслей, её изучают что бы показать как можно выражать мысли и чувства письменно.
Англоязычные эссе — это просто навык заполнения шаблона, не более того.
Re[2]: Технический писатель - что думаете об этой профессии?
__>Не видел представителей данной профессии. __>В разработке ПО это делает программист или его коллеги, но ни у кого нет должности "технический писатель", это лишь одна из обязанностей.
Ты путаешь внутреннюю документацию по проекту и документацию для конечного пользователья ПО (или внешнего API).
Вот для второй и нужны технические писатели.
Но если компания совсем маленькая маленькая, то отдельных тех. писателей может и не быть.
Технический писатель - что думаете об этой профессии?
в моем понимании, это кастрированные сисадмины, которые более универсально подкованы и не заточены подо что-то одно. не?
плохо выразился. не сисадмины кастрированные, а наоборот
МР>А так — профессия нужная, но редкая. В основном люди привлекаются к написанию внешней документации (иногда пользовательской, иногда — что сложнее — для технических специалистов). МР>Как правило, выделенных технических писателей привлекают компании имеющие собственный продукт (в заказной разработке редкость).
кстати, может объяснишь, почему она в своем большинстве такого плохого качества?
вроде и писать текст умеют, и вроде технический склад ума, но если рассматривать что вижу в российском секторе по толковости сильно уступает зарубежным аналогам (что там в Китае творится в этом плане могу только гадать)
Re[2]: Технический писатель - что думаете об этой профессии?
МР>Как правило, выделенных технических писателей привлекают компании имеющие собственный продукт (в заказной разработке редкость).
Ну я бы не сказал, что такая уж редкость.
В заказной разработке очень часто встречаются требования наличия документации в соответствии с какими-то стандартами (в нашей стране обычно по ГОСТам, но возможны и другие варианты).
И вот тут технические писатели очень нужны (хотя должность формально может даже называться не "технический писатель", а какой-нибудь "инженер 1-й категории", но фактически человек работает как технический писатель).
И еще один нюанс — обычно технические писатели не сами из головы выдумывают что писать. Чаще бывает так: программист или проектировщик дает техническому писателю свои материалы в вольном изложении, а технический писатель уже их причесывает, структурирует и оформляет как надо.
Re[4]: Технический писатель - что думаете об этой профессии?
Вообще писатели разные нужны. Работы невпроворот. У меня на работе большущий отдел пишет сотни страниц ежедневно с шаблонами, специально заточенными под это программами, с планом документов итд. Сейчас ещё и локальный чатик на LLaMa пытаются ко всему этому добру припахать.
Но сам я писать не очень люблю. Плюс там желательно владеть английским, лучше, чем любыми другими языками.
Re[5]: Технический писатель - что думаете об этой профессии?
M>>Экономят, навешивая написание документации как бы между делом
N>а что они еще делают, если занимают позицию "технический писатель"? мебель собирают?
Вопрос был "почему тех документация в большинстве такого плохого качества?". При чем тут техписатели?
Re[2]: Технический писатель - что думаете об этой профессии?
K>Дополню еще: K>5) Документация недостаточно была задействована в процессе тестирования K> a) не тестировали саму документацию: точно ли получится сделать то, что надо, если следовать документации. K> б) не тестировали покрытие документацией: все ли важные нюансы расписаны в документации
в) нахрен ему это все вообще уперлось
Re[3]: Технический писатель - что думаете об этой профессии?
Здравствуйте, klopodav, Вы писали:
МР>>Как правило, выделенных технических писателей привлекают компании имеющие собственный продукт (в заказной разработке редкость).
K>Ну я бы не сказал, что такая уж редкость.
Не буду спорить, это исключительно мои наблюдения по всего лишь одной компании (т.е. репрезентативность та еще...)
У нас отдел технических писателей был, но:
— я ни на одном из проектов с ними не пересекался
— относительно остального состава фирмы ребята просто терялись (т.е. по количеству шли как-то так: разработчики, тестировщик, аналитики, девопс/админы, дизайнеры, разные узконаправленные специалисты (типа DBA), тех. писатели),
Т.е. подавляющее число проектов обходилось без выделенных тех. писателей.
Зато в 2-х продуктовых где я работал такие отделы были (причем, я искренне считаю, что у одной из компаний документация практически образцовая была), а в третьей шел процесс формирования такового (там компания очень бурно росла и просто не успевала за всем).
Re[3]: Технический писатель - что думаете об этой профессии?
хватит, а вот на жирную шавуху уже нет.
Ничего сказать не могу.
Я исхожу из того, что те продуктовые, где я успел поработать, периодически технических писателей в штат искали.
Но на темы:
— где они это делали?
— как находили людей?
— какие были/есть зарплаты?
Ничего сказать не могу.
Re: Технический писатель - что думаете об этой профессии?
1) скорее всего LaTeX, для того, чтобы делать .pdf-документы.
2) хорошо бы ещё уметь делать HTML (можно через какой-нибудь texinfo)
3) уметь рисовать .svg в Inkscape, чтобы везде их вставлять
(хорошо бы ещё уметь делать скриншоты в .svg, но это надо сильно заморочится с софтом)
4) рисовать вообще полезно ещё в 3D, т.е. blender и freecad, иллюстрации всякие.
5) уметь в переводы, в том числе автоматизированные.
Т.е. владение https://www.transifex.com , translation memory и т.п.
Посмотрите на лидеров рынка вообще и автоматически переведённую документацию Microsoft в частности.
Т.е. там дофига скиллов, и ни в какой школе такому не учат.
Ну и само составление текстов тоже скилл, там же стили разные, терминология, стандарты
(надо не только знать о существовании ГОСТ 19 и 34, но и иметь к ним шаблоны для всех программ,
шрифты специальные и т.д.)
LVV>> Да мы в советской школе сочинения и изложения писали каждую четверть по несколько раз. LVV>> И вполне себе умели все это своими словами. ЭФ>А нас научить не смогли, вот такие вы лошары.
Ишака можно затащить в реку, но невозможно заставить его пить.
Хочешь быть счастливым — будь им!
Без булдырабыз!!!
Re[7]: Технический писатель - что думаете об этой профессии?
МР>Откуда тут возьмутся люди, умеющие легко и изящно объяснить что-либо? Да неоткуда им взяться.
МР>А вот в той же английской и американской системах образования (про остальные просто не знаю) весьма популярно написание эссе. Т.е ровно то, о чем мы говорим: небольшой текст, где своими словами, простым языком изложить произвольную тему: философскую, техническую, ... — не важно, главное что формируется навык изложения своих мыслей в доступной для читающего форме. МР>Да они тоже не на 100% справляются, но у них, по крайней мере, есть какая-то база. Наши же письменные работы — это именно шаблоны за редким исключением.
Вот эти вот англоязычные эссе — это и есть 100% шаблон. Там регламентирована каждая фраза практически. Наши школьные сочинения по сравнению с этим — просто недостижимая литературная высота.
Re[5]: Технический писатель - что думаете об этой профессии?
Здравствуйте, LaptevVV, Вы писали: LVV>Да мы в советской школе сочинения и изложения писали каждую четверть по несколько раз.
Шутку понял, смешно. "Ажно несколько раз за четверть"...
Чтобы необходимые навыки наработались, эти сочинения нужно писать
1. несколько раз в неделю (1-3) по каждому направлению
2. по разным предметам (а не по литературе!)
И повторять это в течение достаточно длинного времени — от года (для взрослых) до нескольких лет (если хотим с детства).
Уйдемте отсюда, Румата! У вас слишком богатые погреба.
Re[5]: Технический писатель - что думаете об этой профессии?
Здравствуйте, peiv, Вы писали:
P>Вот эти вот англоязычные эссе — это и есть 100% шаблон. Там регламентирована каждая фраза практически. Наши школьные сочинения по сравнению с этим — просто недостижимая литературная высота.
Наши школьные сочинения — трэш и угар.
Во-первых, там всё сводится к литературоведению. В жизни обзоры книг и персонажей не нужны примерно никогда, а вот тексты в различных прикладных областях встречаются сплошь и рядом. От объяснительных в полицию до деловой переписки и объявлений на авито.
Во-вторых, собственно литературоведение не преподаётся примерно никак. Поэтому у школьника нет инструмента, который бы он мог применить к задаче "описать Катерину как луч света в тёмном царстве", и описать результаты его применения. Сиди, изобретай.
В итоге, чему-то научить школьника эти сочинения не могут в принципе. Те, кто выходит из школы с навыками написания литературоведческих текстов, делают это не благодаря школьным сочинениям, а вопреки.
Уйдемте отсюда, Румата! У вас слишком богатые погреба.
Re[5]: Технический писатель - что думаете об этой профессии?
Здравствуйте, Alekzander, Вы писали:
A>Я соблазнился пофрилансить (дурак!).
Возможно, будете смеяться, но у меня когда-то тоже был опыт подработки в качестве тех. писателя.
Правда, я работал на одну конкретную компанию и занимался именно тем, что писал пользовательскую документацию на их продукт.
Опыт был интересным, не столь драматическим, как у вас, но я пришел к выводу, что подобного рада подработки — точно не для меня (при том, что претензий к компании на которую я работал у меня ровным счетом никаких — они все свои обязательства выполнили в полном объеме, а я свою работу почти завалил).
Но у меня была возможность и посмотреть на работу отдела технической документации на одном из прошлых мест работы, и хотя это не взгляд изнутри, но по моим ощущениям, там всё был кардинально иначе:
Во-первых, это была точно такая же часть команды продукта, как разработка, аналитика или тестирование.
Поэтому, и отношение — совсем иное. Например, планы по выпуску версии в обязательном порядке утрясали с отделом документирования — сколько им потребуется для обновления существующих разделов или написания новых.
Во-вторых, принцип "документация — тоже продукт", т.е. в чем-то аналогичные подходы к развитию и управлению:
— трэкинг замечаний и задач, так же как у остального продукта
— наличие согласованных планов развития, причем самого разного плана, например, какие-то разделы в документации, которых не было ранее, или переезд на другой инструмент подготовки, или что-то вроде "мы решили поменять подход к подготовке скриншотов, но чтобы не было вразнобой, запланировали задачу в релизе X переделать все скриншоты", и т.д.
— ну и в целом к девчонкам (там работали на моей памяти всегда девушки — но это скорее чисто специфика именно этого отдела) было очень уважительное отношение — "они делают штуку, за которую нас очень ценят клиенты".
Re[5]: Технический писатель - что думаете об этой профессии?
Здравствуйте, peiv, Вы писали:
P>Вот эти вот англоязычные эссе — это и есть 100% шаблон. Там регламентирована каждая фраза практически. Наши школьные сочинения по сравнению с этим — просто недостижимая литературная высота.
У меня сложилось обратное впечатление, но тут я не сильно великий специалист, так что, возможно это впечатление насквозь ошибочное.
Re[8]: Технический писатель - что думаете об этой профессии?
LVV>> невозможно заставить ЭФ>люди не ослы, людей можно замотивировать. Если, конечно, педагогических способностей достаточно.
1. Вас учили не люди, а лошары, с них и спрашивайте
2. Внешняя мотивация — ничто по сравнению с внутренней.
Хочешь быть счастливым — будь им!
Без булдырабыз!!!
Re: Технический писатель - что думаете об этой профессии?
Пишешь же не что-то прикольное (например, инструкцию к своей программе, где можно отттянуться), а описание чьей-то работы, далеко не факт что вообще интересной.
Проект Ребенок8020 — пошаговый гайд как сделать, вырастить и воспитать ребенка.
Re[7]: Технический писатель - что думаете об этой профессии?
Здравствуйте, LaptevVV, Вы писали: LVV>Радость ты моя. Ты в советской школе — то хоть учился ?
Отож. LVV>Я-то учился. И знаю, что говорю. LVV>Можешь почитать мой слог в моих книжках. LVV>А твой стиль изложения где прочесть можно ?
Да хоть здесь, на сайте.
Но что вам это даст? Я свой стиль и слог вырабатывал не в школе. В школе у меня за сочинения было между двумя и тремя баллами.
А сейчас я и вовсе сертифицированный писатель-фантаст, у меня и справка есть
LVV>Это подготовка к журналистике и к окологоворилдьным профессиям.
Нет. Это подготовка к жизни в реальном мире. LVV>А мы — технари. И тем не менее, вполне грамотно излагаем и формулируем. В среднем — нет. Безграмотно излагаете, невнятно формулируете. Хуже текстов, написанных советскими технарями, только публичные выступления советских технарей.
Кстати, новое поколение (те, кому сейчас 20) инженеров-айтишников в этом плане гораздо лучше подготовлено, чем моё и предыдущее поколения.
А те, кто учился в советской школе — повторюсь — научились что-то писать не благодаря сочинениям на литературе, а вопреки.
LVV>Можешь еще почитать книжки Хазина — он тоже учился в советской школе и закончил МГУ. LVV>Можешь почитать книжки Никонова — тоже из СССР. Тоже технарь бывший.
Угу. А если послушать Бутусова, то может сложиться впечатление, что в Свердловском Архитектурном Институте хорошо обучали рок-музыке.
Для технаря апеллировать к исключениям — как минимум странно.
Уйдемте отсюда, Румата! У вас слишком богатые погреба.
Re[9]: Технический писатель - что думаете об этой профессии?
дебилы вокруг — это норма. У Вас либо "ошибка выжившего", просто повезло,
либо скромности нехватает. Но в капиталистический век так и надо себя пиарить, так что всё нормально.
Здравствуйте, Эйнсток Файр, Вы писали:
ЭФ> B> денег меньше чем в разработке. ЭФ> Вот это единственное, что по-настоящему важно. ЭФ> Было бы денег больше, пели бы другие песни. Про ответственность, важность работы, и так далее.
Ты причину со следствием путаешь. Если бы работа была более ответственная, важная и так далее — платили бы больше денег.
Ничего я не путаю. Рынок определяет, сколько денег, а потом из количества денег уже придумывают причины и следствия.
Не нужна, значит, документация, по мнению руководителей. Я об этом и говорю — руководители считают тем или иным образом.
Re[6]: Технический писатель - что думаете об этой профессии?
S>Наши школьные сочинения — трэш и угар. S>Во-первых, там всё сводится к литературоведению. В жизни обзоры книг и персонажей не нужны примерно никогда, а вот тексты в различных прикладных областях встречаются сплошь и рядом. От объяснительных в полицию до деловой переписки и объявлений на авито.
Что за хрень. Найдите 10 различий между литературными персонажами и реальными людьми, если о тех и других надо что-то написать.
Не знаю, как вас, а нас учили писать заявления и объяснительные записки.
Здравствуйте, Эйнсток Файр, Вы писали:
ЭФ> ·> Ты причину со следствием путаешь. ЭФ> Ничего я не путаю. Рынок определяет,
Рынок это такое еврейское имя? Почему все его слушаются?
ЭФ> сколько денег, а потом из количества денег уже придумывают причины и следствия.
Кладут столько денег, сколько требуется для обеспечения ответственности, важности работы и так далее.
ЭФ> Не нужна, значит, документация, по мнению руководителей. Я об этом и говорю — руководители считают тем или иным образом.
Нужна настолько на сколько руководители готовы вложить денег для обеспечения бизнеса.
Не видел представителей данной профессии.
В разработке ПО это делает программист или его коллеги, но ни у кого нет должности "технический писатель", это лишь одна из обязанностей.
К сожалению, в победившем дебилоидном agile код ценится выше документации, а это на практике означает, что документации вообще нет, и пишут её только когда припрёт, и это надо для какой-нибудь сертификации.
А код пишется одной командой на один проект. Потом команда уходит, и код становится легаси, и какие там были интенции в коде, знает только автор, а может, забыл уже, и никто не знает.
Re[8]: Технический писатель - что думаете об этой профессии?
)
