Техписалити! – Telegram
Техписалити!
1.91K subscribers
174 photos
16 videos
89 links
Первая открытая школа технических писателей

Пишут Лида Туляганова, Маша Щеблякова и Катя Марченко
Download Telegram
👏31😁8👀3🤔1
🤣42🔥7
#выпуск 9
Всем привет!
Сегодня поищем ответ на вопрос, который задают после собеседования и начинающие, и опытные техписатели: "Почему меня не взяли?"
Наша тема прозвучит так:


Топ-5 ошибок на собеседовании

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

1️⃣Не включить камеру
Если собеседование проходит по видеосвязи, команда ожидает, что кандидат включит камеру. Аргументы вроде "у меня не работает камера" или "плохая связь", как правило, выглядят некрасиво и даже нелепо.
При плохой связи попытайтесь включить камеру, показать себя, либо заранее предупредите рекрутера. Лучше, конечно, связь настроить или собеседоваться в тихом кафе.
Если проблема глубже, и вы стесняетесь включать камеру, рекомендуем не стесняться (от создателей "не грусти")). Если серьёзно, то навык работы с камерой вам ещё пригодится, к тому же это здорово повышает самооценку.
Можно не включать камеру, если люди, которые вас собеседуют, тоже не включили. Осуждаем их).

2️⃣Говорить невнятно
Правило хорошего техписателя: уметь рассказывать о своей работе. Если ваша речь несмелая и несвязная, создаётся ощущение, что вы ничего не знаете и не умеете.
Тренируйте свою речь, репетируйте вопросы и ответы заранее.

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

4️⃣Не показывать самостоятельность и проактивность
Часто от технического писателя ожидают самостоятельности. Команда не хочет "няньчить" своего новичка, даже если он не первый техпис. Покажите, что вы способны планировать свой день, оценивать задачи, расставлять приоритеты, и ни в коем случае не валите всё на менеджеров.
С демонстрацией проактивности не перестарайтесь) Например, не продвигайте инструменты с позиции "я это умею, поэтому нужно сделать это". Поинтересуйтесь процессами в команде и предложите адаптированный вариант, покажите желание помочь, а не самореализоваться.

5️⃣Не готовиться к собеседованию
Не забудьте перед собеседованием прочитать требования к вакансии. Освежите в памяти какие-то моменты из предметной области. Если вы джун, изучите документацию схожего продукта, приготовьтесь рассказать о плюсах и минусах такой документации. Изучите продукт, если доступ к нему открыт. Если доступа нет, попытайтесь изучить похожие.

Удачи на собеседованиях!

В следующих выпусках читайте: почему в вакансиях требуют опыт от 3-х лет, почему рекрутер переспрашивает всё, что я уже указал в резюме, и когда мне стоит отказаться от вакансии?
25🔥96
😭45😁7😢7💯1
Всем привет!

Мы приготовили для вас интерактивную учебную ролевую игру. Её цель — посмотреть, как мыслят коллеги-технические писатели, а новичкам дать наглядное представление о том, что можно ожидать от профессии: от трудностей до решений.

Суть: у нас есть персонаж, и мы описываем некоторую ситуацию из жизни. Затем проводим опрос, что персонаж должен сделать и, отталкиваясь от ответов, развиваем сюжет.

Часть 1. Пенелопа меняет профессию

Пенелопа несколько лет работает аккаунт-менеджером в небольшой компании. Она чувствует, что близка к выгоранию, но сделать с этим ничего не может. Где бы она ни работала аккаунтом, меньше стресса, звонков и времени, когда нужно быть на связи, не будет. Также ей надоело, что у неё нет нормального work-life balance: желательно быть на связи вечером, в выходные и даже в отпуске.
Пенелопе это всё надоело, и она решила сменить работу на менее стрессовую и менее зависимую от клиентов. Чтобы видеть результат своей работы, а также приносить пользу другим людям. А вишенкой на торте — получать больше денег.
Посмотрев на рынок труда, она увидела привлекательную профессию — технический писатель. Изучив, кто это такой, ей показалось, что это человек, который сидит в тишине, пишет инструкции для пользователей и никто его не трогает. Она тоже писала инструкции для своих клиентов и обучала их работе с системой. Девушка подумала, что это оно.
Пенелопа почитала рекомендации, обновила и выложила своё резюме. В нём она указала, что умеет работать с большим количеством информации, писала инструкции для клиентов, умеет в коммуникации и может сопровождать небольшие проекты.
Девушка начала откликаться и временами проходить собеседования.

#Пенелопа_ищет_икигай #невыдуманныеистории
9🔥5
😁30💯6👍1👎1🏆1
Audio
Подкаст с Лидией Тулягановой 03.10.2023

#подкаст #ЛидияТуляганова #встречазнакомство
👍71
#колонкаредактора
На канале Техпис говорит с Анной Костягиной вышел подкаст с одним из админов Техписалити!

О чём говорили:
- Технический писатель - он больше технический или больше писатель?
- Какие софт-навыки помогут на собеседовании.
- Какой ресурс важен при переходе из профессии в профессию. И это не курсы)
А также: о красоте гостовских текстов, немного о Техписалити!, об интровертах и экстравертах и многом другом.

Главный нетехписный инсайд встречи:
- Из какой необычной сферы деятельности пришла в IT Маша - второй админ канала Техпис говорит.
14👍3👏2
🤣38😢2🐳2
#какэтоработает

Всем привет!
Напоминаем, что сегодня в 18:00 по Москве начнётся Ozon Tech Community Techdoc Meetup

Что внутри:

😤 Маша Смирнова, Ozon Tech, расскажет о том, как принципы буддизма помогают писать документацию и где искать новые пути оптимизации работы над текстами.

💚 Анна Мария Попова из X5 Tech в своём выступлении по пунктам сравнит работу технического и художественного писателей. Узнаем, какие навыки объединяют и разнят эти сферы.

😎 Александр Мачулин, кофаундер Gramax, поделится опытом применения подхода Docs as Code со своими факапам и победами.

📍Зарегистрируйтесь, чтобы получить ссылку на трансляцию.
Please open Telegram to view this post
VIEW IN TELEGRAM
104👌3🎉2
😁31👏5
#выпуск 11
Всем привет!
🔆Неожиданно в рубрике Выпуск у нас не просто пост, а информация о вакансии для начинающих.

Озон (да-да, именно там работает Маша) набирает ❗️джунов и причём рассматривают даже без опыта работы.

Вы часто спрашивали, куда возьмут без опыта - вот он ответ)

😉Откликаться на Ozon Job или HH.
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥13👍72
#какэтоработает
Всем привет!
Мы любим свой текст, потому что он - наш. А правки не любим, потому что они - чужие. Сегодня пост про то, как предложить правки и сделать их любимыми:


Правила обратной связи

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

1️⃣ Уважение. Относитесь к автору текста как к равному. Не оскорбляйте и не переходите на личности. Негативные формулировки нам не нравятся, ведь так? Они не только расстраивают, но и убивают мотивацию. Немотивированные сотрудники - это проблема, особенно если вы их руководитель.

🤓"Чё, Ильяхова не судьба почитать?"

2️⃣ Конструктивность. Аргумент “потому что я так сказал” в правках не подходит. Объясните, почему вы считаете что-то неверным, дайте возможность автору ответить на ваши замечания. Что это даст:

*️⃣ Автор поймёт, что не так и почему не так и, возможно, в следующий раз ошибку не повторит.
*️⃣Вы поймёте, чего не знает автор, какие стороны в нём нужно развить.

😎 “Нет”.
О, это реальная правка, которую я получала) Спасëт ли она меня от повторной ошибки? Да я даже не понимаю, в чëм ошиблась!

Бывает, что момент неоднозначный и допускает разные варианты, которые в своей пользе равные. Например, возьмём пустяковое: какой знак препинания нужен в конце пунктов списка. Или посложнее: какие типы статей должна включать документация, если у автора - только туториалы. Зафиксируйте договорённости.

😏"Я создал мерж реквест в редполитику, что думаешь?"

3️⃣ Сбалансированность. Постоянно указывать на проблемные места, как и постоянно хвалить, - плохо. В первом случае сотрудник может впасть в уныние, а во втором - угодить в застой и зазвездиться. Поэтому критикуйте конструктивно и не забывайте отметить то, что у сотрудника получилось блестяще. Только будьте искренними.

😍"Там в первом абзаце поправить надо, а так все отлично. У тебя хороший стиль, читается легко!"

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

☀️Кстати, про ложку. Однажды мой бывший тимлид сказал: “Помнишь, несколько месяцев назад я попросил тебя сделать задачу в пятницу, а ты сделала в понедельник?”
Я в этот момент: *с трудом вспоминаю, что было вчера*.
Please open Telegram to view this post
VIEW IN TELEGRAM
18🤝4😁2👍1🤔1
😢24😭10💔9😁4
🥰238😢6👍2😁2
Техписалити!
Всем привет! Мы приготовили для вас интерактивную учебную ролевую игру. Её цель — посмотреть, как мыслят коллеги-технические писатели, а новичкам дать наглядное представление о том, что можно ожидать от профессии: от трудностей до решений. Суть: у нас есть…
Всем привет!

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

Часть 2. Пенелопа делает первые шаги

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

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

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

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

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

#Пенелопа_ищет_икигай #невыдуманныеистории
10🤯6🔥2
#мемница

С наступающим Новым годом, друзья! Пусть документация подольше остаётся актуальной!
🔥36😁21🎉11💯3🍾1
#выпуск 12
С наступившим, друзья!

Как говорит Маша, новогодние салаты доедены, кто-то врывается в рабочие будни, а кто-то лениво в них заползает. Не стоит сильно забивать себе голову чем-то супер полезным, а лучше следовать правилу “Новый год — новая жизнь” :)

Поэтому я (Лида) зову в свою команду технического писателя, нового, никто не уходил)


Плюсы:
Интересный проект: Kubernetes+мониторинг. Это работа, которая поднимет вашу стоимость на рынке труда.
Команда готова обучать. Покажите, насколько вы классные, и специальный человек поможет вам влиться в проект.
Зп выше средней по Москве, а если вы покорите сердце и мозг руководителя, сможете претендовать на желаемую сумму.

Минусы:
Вы будете в команде один. Но коллеги из других проектов всегда помогут, а я буду сопровождать на протяжении всего испытательного срока. Если, наоборот, хотите самостоятельности - тоже пожалуйста)

Переходите в опрос и оставьте свои контакты в форме. До встречи!
Please open Telegram to view this post
VIEW IN TELEGRAM
👍12🔥2🤝21👏1
Всем привет!

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

Что это такое?
Лучшие практики — они же best practices — это набор принципов и приёмов, которые делают продукт топовым. Это действует для любой сферы, даже для документации!

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

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

📌 Можно получить помощь в решении задач.
Если вы столкнулись с глобальной задачей по документации, которую раньше никогда не делали, ответ может быть где-то в лучших практиках. Например, вам поручили сделать публичную документацию с нуля. Возможно, вы когда-то и хотя бы писали публичную доку, но уже тонкости позабыли. Вот и время подсмотреть, как и что делают коллеги. Так вы сможете избежать шишек и быстрее сделать красивую доку.

📌 Быть в курсе трендов.
Если в 2024 году ваша документация будет выглядеть как из 2004, в этом не будет ничего хорошего.

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

Поделимся несколькими ссылками с красивой и классной документацией:
https://angular.dev/
https://learning.postman.com/docs/
https://www.tarantool.io/ru/doc/latest/

А теперь ваша очередь делиться классной документаций в комментариях ✍️

Upd: третью ссылку заменили, спасибо за участие!❤️
#писалитирекомендует
Please open Telegram to view this post
VIEW IN TELEGRAM
23👍3🏆1