МР>Откуда тут возьмутся люди, умеющие легко и изящно объяснить что-либо? Да неоткуда им взяться.
Их есть у меня... )
МР>А вот в той же английской и американской системах образования (про остальные просто не знаю) весьма популярно написание эссе. Т.е ровно то, о чем мы говорим: небольшой текст, где своими словами, простым языком изложить произвольную тему: философскую, техническую, ... — не важно, главное что формируется навык изложения своих мыслей в доступной для читающего форме.
Да мы в советской школе сочинения и изложения писали каждую четверть по несколько раз.
И вполне себе умели все это своими словами.

МР>2. Работа над документацией — это жутко тягомотная и рутинная работа.
Совершенно верно.

МР>3. При этом, если мы говорим не о пользовательской, а технической документации, её разработчик должен иметь достаточно глубокое понимание предмета. Даже придумать хорошие тестовые примеры для демонстрации некоего API — та еще задачка.
Совершенно верно.

МР>И получается, что тех, кто способен хорошо изложить материал не так и много (не готовим), а те кто есть могут найти себе куда более интересное (и денежное) занятие.
И эйчары еще в этом ни бельмеса и совершенно не понимают, кого реально можно брать на такую работу.

LVV> Да мы в советской школе сочинения и изложения писали каждую четверть по несколько раз.
LVV> И вполне себе умели все это своими словами.

А нас научить не смогли, вот такие вы лошары.

https://quote.rbc.ru/news/article/655b44359a79473fe62f85e2

Микрософт наняла бывшего директора ChatGPT.
Теперь техническим писателям точно хана.

Здравствуйте, Михаил Романов, Вы писали:

A>>На жирный хабец

Автор: Marty
Дата: 16.11.23

хватит, а вот на жирную шавуху уже нет.
МР>Ничего сказать не могу.
МР>Я исхожу из того, что те продуктовые, где я успел поработать, периодически технических писателей в штат искали.
МР>Но на темы:
МР>- где они это делали?
МР>- как находили людей?
МР>- какие были/есть зарплаты?

МР>Ничего сказать не могу.

Я соблазнился пофрилансить (дурак!). Всё равно, думал, люблю писать и пишу бесплатно — почему бы не пописать за деньги? Даже за те, которые платят техписам в России. Закончилось как и следовало ожидать: как если бы девушка, любящая секс, решила подзаработать проституткой — доходы не покрывали даже профессиональные расходы, клиентура была пошлейшая, заставлявшая плевать себе в душу, писать то, с чем я не согласен, и не писать то, о чём думаю, а отношение — как к шалаве. При этом я работал только с теми клиентами, которые считаются лучшими на местном рынке и платят больше всех (аж баксов триста где-то за материал). Если вам дороги жизнь и рассудок, держитесь подальше от этих болот и пишите на сиплюплюсе.

LVV>> Да мы в советской школе сочинения и изложения писали каждую четверть по несколько раз.
LVV>> И вполне себе умели все это своими словами.
ЭФ>А нас научить не смогли, вот такие вы лошары.
Ишака можно затащить в реку, но невозможно заставить его пить.

LVV> невозможно заставить

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

МР>Откуда тут возьмутся люди, умеющие легко и изящно объяснить что-либо? Да неоткуда им взяться.

МР>А вот в той же английской и американской системах образования (про остальные просто не знаю) весьма популярно написание эссе. Т.е ровно то, о чем мы говорим: небольшой текст, где своими словами, простым языком изложить произвольную тему: философскую, техническую, ... — не важно, главное что формируется навык изложения своих мыслей в доступной для читающего форме.
МР>Да они тоже не на 100% справляются, но у них, по крайней мере, есть какая-то база. Наши же письменные работы — это именно шаблоны за редким исключением.



Вот эти вот англоязычные эссе — это и есть 100% шаблон. Там регламентирована каждая фраза практически. Наши школьные сочинения по сравнению с этим — просто недостижимая литературная высота.

Здравствуйте, LaptevVV, Вы писали:
LVV>Да мы в советской школе сочинения и изложения писали каждую четверть по несколько раз.
Шутку понял, смешно. "Ажно несколько раз за четверть"...

Чтобы необходимые навыки наработались, эти сочинения нужно писать
1. несколько раз в неделю (1-3) по каждому направлению
2. по разным предметам (а не по литературе!)
И повторять это в течение достаточно длинного времени — от года (для взрослых) до нескольких лет (если хотим с детства).

Здравствуйте, peiv, Вы писали:

P>Вот эти вот англоязычные эссе — это и есть 100% шаблон. Там регламентирована каждая фраза практически. Наши школьные сочинения по сравнению с этим — просто недостижимая литературная высота.
Наши школьные сочинения — трэш и угар.
Во-первых, там всё сводится к литературоведению. В жизни обзоры книг и персонажей не нужны примерно никогда, а вот тексты в различных прикладных областях встречаются сплошь и рядом. От объяснительных в полицию до деловой переписки и объявлений на авито.
Во-вторых, собственно литературоведение не преподаётся примерно никак. Поэтому у школьника нет инструмента, который бы он мог применить к задаче "описать Катерину как луч света в тёмном царстве", и описать результаты его применения. Сиди, изобретай.

В итоге, чему-то научить школьника эти сочинения не могут в принципе. Те, кто выходит из школы с навыками написания литературоведческих текстов, делают это не благодаря школьным сочинениям, а вопреки.

Здравствуйте, Alekzander, Вы писали:

A>Я соблазнился пофрилансить (дурак!).
Возможно, будете смеяться, но у меня когда-то тоже был опыт подработки в качестве тех. писателя.

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

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

Здравствуйте, peiv, Вы писали:

P>Вот эти вот англоязычные эссе — это и есть 100% шаблон. Там регламентирована каждая фраза практически. Наши школьные сочинения по сравнению с этим — просто недостижимая литературная высота.
У меня сложилось обратное впечатление, но тут я не сильно великий специалист, так что, возможно это впечатление насквозь ошибочное.

LVV>> невозможно заставить
ЭФ>люди не ослы, людей можно замотивировать. Если, конечно, педагогических способностей достаточно.
1. Вас учили не люди, а лошары, с них и спрашивайте
2. Внешняя мотивация — ничто по сравнению с внутренней.

S>Здравствуйте, LaptevVV, Вы писали:
LVV>>Да мы в советской школе сочинения и изложения писали каждую четверть по несколько раз.
S>Шутку понял, смешно. "Ажно несколько раз за четверть"...
Радость ты моя. Ты в советской школе — то хоть учился ?
Я-то учился. И знаю, что говорю.
Можешь почитать мой слог в моих книжках.
А твой стиль изложения где прочесть можно ?
S>Чтобы необходимые навыки наработались, эти сочинения нужно писать
S>1. несколько раз в неделю (1-3) по каждому направлению
S>2. по разным предметам (а не по литературе!)
S>И повторять это в течение достаточно длинного времени — от года (для взрослых) до нескольких лет (если хотим с детства).
Это подготовка к журналистике и к окологоворилдьным профессиям.
А мы — технари. И тем не менее, вполне грамотно излагаем и формулируем.
Можешь еще почитать книжки Хазина — он тоже учился в советской школе и закончил МГУ.
Можешь почитать книжки Никонова — тоже из СССР. Тоже технарь бывший.

Здравствуйте, Mihal9, Вы писали:

M>Сабж

Скучно и денег меньше чем в разработке.

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

Здравствуйте, LaptevVV, Вы писали:
LVV>Радость ты моя. Ты в советской школе — то хоть учился ?
Отож.
LVV>Я-то учился. И знаю, что говорю.

LVV>Можешь почитать мой слог в моих книжках.
LVV>А твой стиль изложения где прочесть можно ?
Да хоть здесь, на сайте.
Но что вам это даст? Я свой стиль и слог вырабатывал не в школе. В школе у меня за сочинения было между двумя и тремя баллами.
А сейчас я и вовсе сертифицированный писатель-фантаст, у меня и справка есть

LVV>Это подготовка к журналистике и к окологоворилдьным профессиям.
Нет. Это подготовка к жизни в реальном мире.
LVV>А мы — технари. И тем не менее, вполне грамотно излагаем и формулируем.
В среднем — нет. Безграмотно излагаете, невнятно формулируете. Хуже текстов, написанных советскими технарями, только публичные выступления советских технарей.
Кстати, новое поколение (те, кому сейчас 20) инженеров-айтишников в этом плане гораздо лучше подготовлено, чем моё и предыдущее поколения.
А те, кто учился в советской школе — повторюсь — научились что-то писать не благодаря сочинениям на литературе, а вопреки.

LVV>Можешь еще почитать книжки Хазина — он тоже учился в советской школе и закончил МГУ.
LVV>Можешь почитать книжки Никонова — тоже из СССР. Тоже технарь бывший.
Угу. А если послушать Бутусова, то может сложиться впечатление, что в Свердловском Архитектурном Институте хорошо обучали рок-музыке.
Для технаря апеллировать к исключениям — как минимум странно.

LVV> Вас учили не люди, а лошары

дебилы вокруг — это норма. У Вас либо "ошибка выжившего", просто повезло,
либо скромности нехватает. Но в капиталистический век так и надо себя пиарить, так что всё нормально.

B> денег меньше чем в разработке.

Вот это единственное, что по-настоящему важно.
Было бы денег больше, пели бы другие песни. Про ответственность, важность работы, и так далее.

Здравствуйте, Эйнсток Файр, Вы писали:

ЭФ> B> денег меньше чем в разработке.
ЭФ> Вот это единственное, что по-настоящему важно.
ЭФ> Было бы денег больше, пели бы другие песни. Про ответственность, важность работы, и так далее.
Ты причину со следствием путаешь. Если бы работа была более ответственная, важная и так далее — платили бы больше денег.

·> Ты причину со следствием путаешь.

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

P>>Вот эти вот англоязычные эссе — это и есть 100% шаблон. Там регламентирована каждая фраза практически. Наши школьные сочинения по сравнению с этим — просто недостижимая литературная высота.
S>Наши школьные сочинения — трэш и угар.
S>Во-первых, там всё сводится к литературоведению.

Ты несёшь здесь какую-то дичь. Далеко не все сочинения пишутся по литературным произведениям. Они пишутся по любым темам (типа там "как я провел лето" или "рассказ о друге (маме и тд)"). Литература в сочинениях — это не объект изучения, а способ выражения мыслей, её изучают что бы показать как можно выражать мысли и чувства письменно.

Англоязычные эссе — это просто навык заполнения шаблона, не более того.