Size: a a a

technicalwriters

2021 January 23

NV

Nick Volynkin in technicalwriters
Roman Dynnik
Коллеги, antora позволяет многоязычную документацию организовать?
+1, когда-то исследовал этот вопрос, там было всё очень грустно. Если рассматриваете Sphinx как вариант — приходите, расскажу.
источник

СФ

Семён Факторович... in technicalwriters
Начнем свой день с бодрящей кружечки свеклы?
источник

NV

Nick Volynkin in technicalwriters
Елена, а как этот пост относится к теме нашего чата?
источник

ДЧ

Дарья Чернавина... in technicalwriters
Nick Volynkin
Елена, а как этот пост относится к теме нашего чата?
Я думаю, это реклама по типу массфоловинга. Чтоб люди заинтересовались, перешли в "Фабрику здоровья" и подписались.
источник

ДЧ

Дарья Чернавина... in technicalwriters
Nick Volynkin
Елена, а как этот пост относится к теме нашего чата?
Ну или техпису надо быть бодрым — и это сопутствующие навыки: выбирать продукты для поддержания концентрации.
источник

NV

Nick Volynkin in technicalwriters
Дарья Чернавина
Я думаю, это реклама по типу массфоловинга. Чтоб люди заинтересовались, перешли в "Фабрику здоровья" и подписались.
Спасибо, что напомнила.
источник

IS

Igor Shakhbazyan in technicalwriters
Или это девушка хотела переслать полезный пост подруге, но ошиблась чатом, банальный кейс.
источник

IS

Igor Shakhbazyan in technicalwriters
Хотя техпис должен быть внимателен к деталям)
источник
2021 January 24

ТФ

Таня Фокина... in technicalwriters
Привет. Для всех, кто проходил опрос про зарплаты UX писателей (или тех, кто просто интересуется результатами): я опубликовала результаты в канале @rishavant. Можно заходить, смотреть и комментировать:)
источник

EN

Ekaterina Noskova in technicalwriters
нормальный такой разброс
источник

L

Lana in technicalwriters
https://habr.com/ru/company/jugru/blog/538698/ Интересная попытка от Heisenbug, объяснение технических терминов для людей не из it
источник

СФ

Семён Факторович... in technicalwriters
Ekaterina Noskova
нормальный такой разброс
маленькие выборки — они такие:(

@ftanuxa всё правильно делает, через год-два результатов будет гораздо больше, а статистика — еще интереснее
источник

AD

Alyona Devon in technicalwriters
а можно уточнить, встречались ли кому-то курсы по веб-разработке для техрайтеров. вообще бывает такое понятие?

мне просто не встречается, а те которые для программистов - они все углубленные и много "лишней" информации.
по типу https://skillbox.ru/course/webdev/ или каналы на ютуб
https://www.youtube.com/watch?v=a6xtQQqx1tg
то есть потратится личное время жизни на то, что в итоге и не применишь (я же не буду создавать) зато загрузишь голову (кажется чем больше новой информации, тем быстрее старая вытесняется. а если новая не применяется, то и она улетучивается)

мне нужно просто больше для понимания когда "читаешь" кусочки кода и как его правильнее описать используя корректную терминологию.

я то обычно просто задаю вопросы разработчику, верю на слово и так и записываю или смотрю уже по факту по предоставленной документации другого сервиса, но хотелось бы сразу "уметь"/"понимать".
источник

СФ

Семён Факторович... in technicalwriters
Alyona Devon
а можно уточнить, встречались ли кому-то курсы по веб-разработке для техрайтеров. вообще бывает такое понятие?

мне просто не встречается, а те которые для программистов - они все углубленные и много "лишней" информации.
по типу https://skillbox.ru/course/webdev/ или каналы на ютуб
https://www.youtube.com/watch?v=a6xtQQqx1tg
то есть потратится личное время жизни на то, что в итоге и не применишь (я же не буду создавать) зато загрузишь голову (кажется чем больше новой информации, тем быстрее старая вытесняется. а если новая не применяется, то и она улетучивается)

мне нужно просто больше для понимания когда "читаешь" кусочки кода и как его правильнее описать используя корректную терминологию.

я то обычно просто задаю вопросы разработчику, верю на слово и так и записываю или смотрю уже по факту по предоставленной документации другого сервиса, но хотелось бы сразу "уметь"/"понимать".
> курсы по веб-разработке для техрайтеров

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

Не думаю, что вы сможете найти готовый курс под ваши нужды.

Я в предыдущей компании решал схожую задачу — научить техписателей необходимому минимуму C++ и основам software engineering, и мы в итоге очень много времени потратили именно на очерчивание нужного подмножества знаний. И набор обучающих материалов получился очень многосоставной — книги (много и разные), устные рассказы инженеров на конкретные темы, практические упражнения и пр.
источник

AD

Alyona Devon in technicalwriters
придется значит проходить все курсы и самой выбирать зернышки себе в виде собственной библиотеки знаний)
мне в принципе и не говорили описывать процесс что происходит когда работает определенный скрипт (где он берет данные, как их обрабатывает и передает и тд. это мне лично было интересно понять и если бы я поняла все окончательно я бы это обязательно добавила)

мне главное было не сделать ошибок в синтаксисе, правильно разделись на составляющие и прописать типы данных
я иду, читаю по этой одной теме
там к примеру было https://learn.javascript.ru/function-expressions
https://learn.javascript.ru/types https://learn.javascript.ru/structure
но на след раз (который через 6 мес, такие задания редкие) я снова ничего не помню и все заново будто
источник

AD

Alyona Devon in technicalwriters
Семён Факторович
> курсы по веб-разработке для техрайтеров

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

Не думаю, что вы сможете найти готовый курс под ваши нужды.

Я в предыдущей компании решал схожую задачу — научить техписателей необходимому минимуму C++ и основам software engineering, и мы в итоге очень много времени потратили именно на очерчивание нужного подмножества знаний. И набор обучающих материалов получился очень многосоставной — книги (много и разные), устные рассказы инженеров на конкретные темы, практические упражнения и пр.
а у вас что-нибудь осталось по тому обучению, хоть план тем примерно?
источник

NV

Nick Volynkin in technicalwriters
Alyona Devon
а можно уточнить, встречались ли кому-то курсы по веб-разработке для техрайтеров. вообще бывает такое понятие?

мне просто не встречается, а те которые для программистов - они все углубленные и много "лишней" информации.
по типу https://skillbox.ru/course/webdev/ или каналы на ютуб
https://www.youtube.com/watch?v=a6xtQQqx1tg
то есть потратится личное время жизни на то, что в итоге и не применишь (я же не буду создавать) зато загрузишь голову (кажется чем больше новой информации, тем быстрее старая вытесняется. а если новая не применяется, то и она улетучивается)

мне нужно просто больше для понимания когда "читаешь" кусочки кода и как его правильнее описать используя корректную терминологию.

я то обычно просто задаю вопросы разработчику, верю на слово и так и записываю или смотрю уже по факту по предоставленной документации другого сервиса, но хотелось бы сразу "уметь"/"понимать".
я с ментором советовался, рисовал карту знаний о фронтенде под свои задачи, потом вместе обсуждали
источник

AD

Alyona Devon in technicalwriters
Nick Volynkin
я с ментором советовался, рисовал карту знаний о фронтенде под свои задачи, потом вместе обсуждали
звучит интересно по карте знаний о фронтенде. а у вас она есть в таком виде, что могли бы поделится?

Я тоже хотела как-то словить наших фротендеров чтобы они поделились что нужно знать по основам
но они не сильно любят делится
источник

СФ

Семён Факторович... in technicalwriters
Nick Volynkin
я с ментором советовался, рисовал карту знаний о фронтенде под свои задачи, потом вместе обсуждали
Вот да, тут еще важный момент, что сложно сформировать себе план обучения в области, которую сам не знаешь. Это как делать самому себе экскурсию по городу, в котором ты впервые — что-то, конечно, получится, но будет очень далеко от идеала.

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

Но в вашем (нашем) случае ситуация усложняется тем, что ни мы, ни методолог на самом деле не знаем, какие именно знания нам нужны.
источник

NV

Nick Volynkin in technicalwriters
Семён Факторович
Вот да, тут еще важный момент, что сложно сформировать себе план обучения в области, которую сам не знаешь. Это как делать самому себе экскурсию по городу, в котором ты впервые — что-то, конечно, получится, но будет очень далеко от идеала.

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

Но в вашем (нашем) случае ситуация усложняется тем, что ни мы, ни методолог на самом деле не знаем, какие именно знания нам нужны.
Я знаю, какие у меня задачи. Ментор знает, что нужно знать для их решения. Не идеально, но good enough.
источник