#вопросвлоб
Вопрос из прошлого поста
мы задали неспроста, извините за рифму.
Это то, что у вас спросят на собеседовании. По крайней мере у нас его задавали в 100% случаях. Подготовьтесь заранее.

Почему вы решили стать техническим писателем?

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

Но исторически так сложилось, что принимающей стороне не очень приятно слышать, что вы с ними из-за денег. О материальной мотивации можно сказать, если вы прекрасно владеете устной речью и сможете сказать деликатно, и лучше последним пунктом.

Ответ может содержать следующее:
► Что вас привлекает: тексты, их особенность, их назначение (помощь людям). Возможно, вам надоели плохие инструкции, и вы хотите писать действительно полезные. Возможно, вам нравится передавать опыт. Возможно, вы любите общаться с другими людьми.
► Что из вашего прошлого опыта может пригодиться: вас хвалили за удачное интервью или за то, что улучшили процессы в мастерской. Возможно, вы что-то объяснили, и теперь вашей инструкцией коллеги делятся друг с другом.

Сформулируйте свой ответ, напишите его, прочитайте. Этот ответ должен убеждать в первую очередь вас. И если вы почувствовали, что да, вы действительно хотите стать техническим писателем, вы готовы)

#вопросвлоб
Всем привет!
Продолжаем знакомиться с вопросами, которые вам могут задать на собеседовании.

Какой должна быть качественная документация?

Ответ легко гуглится, но разбавим теорию примерами из практики.
Итак, какая же идеальная, качественная документация?

1️⃣ Актуальная
Все доработки и исправления должны быть описаны вовремя.

Проблема, если документация неактуальна:
Чтобы включить какую-то настройку, пользователь должен был заполнить 8 полей. Потом разработчики улучшили продукт, и теперь настройка включается одной лишь кнопкой, но в другом окне. Если вы забыли или не успели обновить документацию - она вроде бы есть, но при этом бесполезна.

2️⃣ Полная
Должны быть описаны все возможности продукта.

Проблема, если документация неполная:
Разработчик зашел в продукт и увидел раздел в меню: интеграции с сервисами Сбера. Это то, что ему нужно, но он не нашел в документации, как выполнить программную интеграцию, потому что из методов API вы описали только авторизацию.

3️⃣ Доступная
Нужную информацию пользователь должен получать быстро и на понятном ему языке.

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

Это три основных признака, но вы можете дополнить критериями из своей практики.

#вопросвлоб
Продолжаем рассматривать вопросы на собеседовании. Ранее мы рассмотрели, какой должна быть качественная документация. Но как решить обозначенные проблемы? Итак, вопрос:

Как создать качественную документацию?

▫️Автоматизируйте создание задач. В таск-трекерах настраивайте автоматическое создание задач на техписов, когда менеджер продукта (продакт) ставит задачу разработчикам.
▫️Регулярно опрашивайте продакта или собирайте релизноутс (заметки о новом в версии). Общайтесь с командой или получите доступ к их планам на релиз.
▫️Посещайте созвоны, которые проводит команда продукта. Вам нужны те встречи, на которых они рассматривают или показывают доработки.
▫️Продумывайте структуру документации, уменьшайте вложенность статей.
▫️Пишите на языке вашей аудитории.
▫️Следите за гигиеной текста. Ошибки и опечатки мешают восприятию документации.
▫️Проводите тестирование документации.
▫️Улучшайте поиск. Если нет возможности улучшить движок, подстраивайте заголовки и подзаголовки под возможности поиска и поисковые запросы.
▫️Не пренебрегайте сео (seo), особенно, если у вас пользовательская документация. Люди чаще гуглят, чем читают официальную доку.

Всем привет!
Нас зовут Лида, Маша и Катя, и мы технические писатели)

Этот пост — навигатор по каналу. Переходите по тегам и читайте то, что вам нужно.

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

Впереди ещё много тем и новых рубрик. Учитесь с нами)

#вопросвлоб
Продолжаем разбирать вопросы из собеседований.
Итак, вопрос, который вам зададут с вероятностью в 99,9%:

Почему решили уйти с предыдущего места работы?

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

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

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

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

Если предыдущая запись в трудовой уволен по статье или по согласованию сторон, вам придется поделиться болью. Старайтесь говорить без эмоций и оскорблений, обосновывая каждый свой шаг.

Готовьте свой ответ заранее. Это поможет вам быть убедительным и частично избавиться от стресса.

#вопросвлоб

Всем привет! Несмотря на предновогоднее затишье на рынке труда, продолжаем рассказывать о частых вопросах на собеседованиях. И сегодня у нас вопрос:

Что такое синхрофазотрон?

Нет-нет, мы не будем говорить о синхрофазотроне)

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

Так вот в вопросе "Что такое...?" вместо синхрофазотрона может оказаться любой термин из вашей документации. Например, что такое динамическая маршрутизация?

Конечно, вы не обязаны владеть предметной областью на 100%, но лучше продемонстрировать хотя бы общее понимание термина. Выжтехписатель, и выбор слов для документации должен быть осознанным.

Действующие техписатели, ставьте 👍, если знакомы со всеми терминами в вашей доке😉

#такбывает #вопросвлоб

Всем привет!
Сегодня поговорим о быстром найме: как компании стараются не спугнуть соискателя многочисленными испытаниями.

Быстрый наём: что это и как проходить

Что такое быстрый наём? Это процесс, средний между one-day offer (когда компания принимает решение во время собеседования и ожидает ответ от работника в тот же день) и усложнённым отбором с более чем тремя собеседованиями.

Подобная схема найма довольно распространена, иногда её немного усложняют: добавляют тестовые и делят основное собеседование на техническое и встречу с руководителем.

Быстрый наём строится на трёх важных вещах:

1️⃣ Прежде всего серьёзный hr-фильтр, на котором отсеиваются кандидаты, которые хоть по одному из существенных позиций не соответствуют требованиям. Рекрутеры также выявляют кандидатов с проблемными "софтами": грубые, необязательные, которые очень запутанно отвечают на вопросы, вызывают подозрения.

😉 Наберитесь терпения и ответьте на вопросы, даже если рекрутер спрашивает то, что указано в резюме. Чаще всего он хочет услышать, КАК вы это рассказываете.

2️⃣ Серьёзный механизм собеседования с теорией, практикой, поведенческими заданиями и проверкой на соответствие майндсету команды. Да, то, вписывается человек в команду по ценностям, взглядам или нет, важно не только для коллектива, но и для сотрудника. Ощущать себя чужим — дополнительный стресс для человека.

🤗 Иногда, если вы не знаете точного ответа на вопрос, подходят ваши рассуждения и предположения - это следует уточнить. И не смущайтесь, если у вас спросят "Слизерин или Гриффиндор?" — это может быть не тест на амбициозность, а желание снизить градус напряжённости.

3️⃣ Специалисты, способные верно интерпретировать ответы кандидата. Если таких специалистов нет, этот пункт заменяют чётким регламентированием и матрицей анализа ответов.

😉 Оспаривать решение, принятое командой, если вы с ним не согласны, нет смысла. Разве что вы хотите устроиться на работу по решению суда — такую возможность предоставляет трудовой кодекс.

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

А что бы предпочли пройти вы — одно собеседование в быстром найме или тщательный отбор?

#колонкаредактора #вопросвлоб #опрос

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

Почему мы уходим из компаний?

Почему мы меняем работу? Как часто техписателей вынуждают уволиться? Всегда ли работодатель оправдывает надежды техписателя?

При найме рекрутеры часто не возвращаются с обратной связью. Но приходят ли они за обратной связью, когда человек покидает компанию?

У нас есть некоторые наблюдения, но для большей объективности нужна ваша помощь!

Просим пройти наш анонимный опрос и рассказать об обстоятельствах вашего увольнения — по собственному желанию или вынужденного.

❗️Обратите внимание: опрос состоит из двух разделов — для уволенных и уволившихся по собственному желанию. Заполняйте только подходящий вам раздел.

Мы проходили опрос и засекали время — у нас ушло не более 5 минут.

🧐 — Можно ли проходить опрос, если я не техписатель?

— Да, только укажите в первом вопросе, что вы из другой сферы, и не отвечайте на специфические вопросы.

Общая статистика тоже будет полезна.

https://forms.gle/zxCcNgozk72Fm7eA8

#вопросвлоб

Всем привет! В рубрике "Вопрос в лоб" мы рассказываем о частых вопросах на собеседованиях. А сегодня поговорим об одном из приёмов: лайфдокинге.
Впервые мы встретили этот термин в одном из профессиональных чатов, так что слово не наше, а приём знакомый)

Лайфдокинг. Анализ статьи

Не все компании дают тестовое задание, посколько его легко можно выполнить с ИИ. Поэтому на собеседованиях могут попросить проанализировать статью.
Рассмотрим, как можно выполнить это задание.

В первую очередь постарайтесь успокоиться. Не стесняйтесь рассуждать вслух.

1️⃣ Попытайтесь выяснить или предположить, для какой аудитории написана статья.
2️⃣ Уточните или предположите, какова её цель: описать интерфейс, описать возможности или дать конкретную инструкцию.

Далее смотрите на статью, учитывая ответы на эти два вопроса.

3️⃣ Есть ли в статье внятная структура: заголовок и связанные между собой подзаголовки.
4️⃣ Чаще всего показывают инструкцию: убедитесь, что в ней есть предварительные требования, информация о правах и доступах, пошаговое описание действий, ожидаемый результат, а также информация о решении проблем или ссылка на нужный раздел.

Обязательно скажите, что это то, что вы можете сказать быстро. Попросите ещё время, чтобы выполнить анализ содержания статьи. Дополнительное время - это нормально.

5️⃣ Проверьте, соответствует ли содержание статьи её цели, выполняет ли нужные задачи. Например, достаточно ли информации, чтобы пользователь выполнил нужную настройку.
6️⃣ Проверьте, нет ли в статье опечаток или ошибок, и прост ли язык изложения. Учтите, что статья может быть написана по правилам, установленным в компании.

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

А вы сталкивались с лайфдокингом? Расскажите о своём опыте.