Обновить
9
Арина Балерина@arinaballerina

Менторю технических писателей и их работодателей

Отправить сообщение

Застали :) У меня есть грамота от IBM/USSR Education Pilot Project

Думаю картинка всё объясняет. Мужчина в возрасте выпил с друзьями, вспомнил молодость и начал рассказывать, как сверстал свою кандидатскую :)

Сейчас я сокращу время освоения этого курса до 2 дней.

В первый день проходим бесплатный курс documentat. Второй день посвящаем Маркдауну. Этап 3 пропускаем — это лишь частное мнение, не совпадающее с потребностями работодателей и здравым смыслом.

По всем вопросам идём в чат technicalwriters :) Тут всё верно.

Мне понравилась идея с капсулой, хороший образ, спасибо. И за подсказку «выгорание — опустошенность, прокрастинация — страх».

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

А ныне вся айтишная работа, которая мне доступна по скилам, этого удовольствия не даёт даже на капелюшечку. Почитать, разобраться, описать — да. Ну менеджерское если — поговорить, порисерчить, послушать, разобраться, рассказать как надо. Генерить что-нибудь с помощью AI? Всё равно до боли похоже на учёбу в школе. Почитал, написал реферат, отчитался, садись пять.

PS Совет по статье. Мне нравится стиль, он индивидуальный, живой и человечный, резанул слух только заголовок. Я бы назвала статью как-нибудь ближе к сути — чем заменить помидор, если уже выгорел или близок к этому. Статья же на самом деле спокойная и оптимистичная, а нынешний заголовок-пугалка нагоняет лишнего уныния.

Где не принято так оформлять списки?

Я техписатель в айтишечке, давно так делаем, не в маркетинге, а в инструкциях, всё ок.

Сама удивляюсь тому, что получилось. Мы просто начали играть в «классифицируй это». А в итоге втянулись в постоянную работу над проектом, который не хочется бросать.

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

Я училась на факультете компьютерной техники и информатики. Девочки, как это обычно бывает, учились лучше парней. Но нам один преподаватель прямо на всю аудиторию однажды сказал, что мы здесь для того, чтобы выйти замуж. До сих пор помню!

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

В СССР женщин в IT или физике было больше, чем в других странах мира в тот период. Потому что была возможность учиться. И ролевые модели были. Женщина ученый или директор завода не была чем-то из ряда вон выходящим.

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

Проблема в том, что нельзя было перетягивать на себя внимание чата. Одно дело один раз обсудить теги, поблагодарить создателей. Другое — начать раздражать людей. Люди приходят в чат обменяться мнениями на проф темы, получить помощь. Чаще всего быстро — залетел, спросил, получил ответ, вернулся к работе. Они не хотят, чтобы их отвлекали.

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

Резюме одно потому что если рассылать ботом, то можно отправить только одно? Атата.

Если всё-таки сделать не одно резюме, а несколько, и править под конкретные вакансии, тогда я не понимаю проблемы — если человек знает Git, и забыл написать об этом в резюме, то он наверное, не лучший работник, зачем такого брать?

«Попытаюсь ответить на вопрос: какие навыки стоит указать кандидату, чтобы увеличить свои шансы на отклик?»

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

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

запулила мощно, чоуж. не стала делать вид, что я добрее, чем я есть на самом деле

Я тоже ожидала от заголовка «пять техник как помочь себе» 5 разных (!) советов, «как перестать забывать». Ну или хотя-бы 3 из них про это. Остальные два ладно, пусть будут про замену на более простые слова.

Да. Некоторым техписателям видимо лень установить себе раскладку Бирмана и потратить полчаса на тренировку слепого набора. При этом они могут работать на компе с двумя мониторами и пишут техническую документацию на многотысячную аудиторию.

можете привести конкретный пример? про термин, оформление или про знак препинания

Да, я тоже жду, когда уже настанет четырёхдневка с 6-часовым рабочим днём)

Честно говоря не исследовала, насколько стало нормой, и в каких текстах.

Но думаю пора бы уж, — римские цифры красивые, но неудобные. И непонятно зачем нам две системы кодирования одного и того же. Поэтому у меня лично они лежат на полке «выпендрёж». Для порядкового номера монарха хорошо подходят. Для веков — нет.

Ваше определение API подходит для всего, поэтому ничего не объясняет.

Я много лет документировала апи, но я сама не могу дать достаточно строгое и достаточно полное и достаточно общее определение. Которое при этом было бы коротким и объяснило бы всё новичку. Под определение «набор правил и протоколов» подходит модель OSI, например.

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

А про API советую прочитать вот это: https://twirl.github.io/The-API-Book/API.ru.pdf

Штош. Такая работа мне не подойдёт :) я пробовала

1

Информация

В рейтинге
Не участвует
Откуда
Санкт-Петербург, Санкт-Петербург и область, Россия
Зарегистрирована
Активность

Специализация

Технический писатель
Ведущий
От 300 000 ₽
Linux
Техническая документация
Написание инструкций
Русский язык
Консультирование
Наставничество
Onboarding
Публичные выступления
Корпоративные коммуникации
Развитие сотрудников