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

Пишут Лида Туляганова, Маша Щеблякова и Катя Марченко
Download Telegram
This media is not supported in your browser
VIEW IN TELEGRAM
Всем привет!

Будем кратки: сегодня в 13:00 по Москве разыграем тот самый деньрожденческий мерч 🎉

Присоединяйтесь к прямому эфиру или смотрите результаты в записи🎥

Присвоенные номера участников ищите вот тут.

UPD:

Итак, встречаем победителей — 20 (@Lubasha_iva), 8 (@PollyNiky), 21 (@Tinuviel_Kaoru) и 11 (@el_cortador)🥳

Спасибо всем за участие🩵
🔥28🎉4🦄41
Live stream started
Live stream finished (4 minutes)
🤣81😁17💯8
#опросHR
Всем привет!
Возвращаемся с результатами опроса, не так быстро, как нам хотелось бы. Классика "давайте уже после майских" в деле)

Почему мы увольняемся? Результаты опроса

Часть 1. Вынужденное увольнение

Опрос показал, что 73% техписателей увольняются по собственному желанию. 2% попали под сокращение. Остальные случаи — вынужденное увольнение по собственному: невыносимые условия труда или замаскированное сокращение.

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

25% вынужденных увольнений — это много или мало? Нам кажется, много. Но в этих процентах кроются как вина работодателя, так и вина работника, ведь он вполне мог не справиться с работой. Здесь мы видим простор для исследований, которые пока не можем провести. Поэтому предлагаем заранее не паниковать.

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

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

В 16% случаев сотрудника предупредили о предстоящих переменах за 2 недели. Здесь также провели беседы, но лишь половина опрошенных согласились с мнением работодателя. В этой же группе некоторые опрошенные отметили, что претензии работодатель высказывал в оскорбительной форме и оказывал моральное давление.

К сожалению, в 32% случаев техписателей не предупреждали заранее, а вынудили уволиться в кратчайшие сроки. В этой группе не все работодатели провели встречи с техписателем. Кто-то сообщил "новость" по телефону, в месседжере, а один работодатель и вовсе объявил об увольнении сотрудника на общем созвоне.

В оставшихся случаях техписатели и их работодатели мирно договаривались о сроках отработки.

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

В следующей части мы начнём рассказывать о случаях увольнения по действительно собственному желанию.
🔥31👍87👏3
Всем привет!

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

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

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

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

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

Как обычно, позже поделимся результатами опроса!
Please open Telegram to view this post
VIEW IN TELEGRAM
👍16🔥9🤝4
Техписалити! pinned «Всем привет! Одна из самых «темных» зон для технического писателя — это метрики, которые должны быть показателем полезности работы. Но что такое метрика в технической документации? Ведь это не маркетинговый текст, который должен привлекать людей. При этом…»
Всем привет!
Пока мы анализируем опросы, победители нашего розыгрыша получают посылки с мерчем❤️
Надеемся, что эти шоперы будут радовать вас и сделают нашу профессию чуть более заметной!😊

Фото Полины Никоновой
🥰39🔥3314❤‍🔥4👍1😁1
Всем привет!

Сегодня мы с вакансией! ✍️

Наши друзья в компании Индид ищут опытного технического писателя, хорошо владеющего как русским, так и английским, на проект в сфере информационной безопасности.
Кандидата ждут комфортная атмосфера, гибкий график, использование docs as code, ДМС, обучения и прочие приятные вещи)

🔍Почитать подробнее о вакансии и откликнуться можно на HH.

#вакансия
👍18🤝8🔥6
#мемница
Когда в компании docs-as-code)
😁54🤣25🥰5🔥41👍1
😁69💯17🔥113🤝3😢2
Please open Telegram to view this post
VIEW IN TELEGRAM
#опросHR

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

Почему мы увольняемся? Результаты опроса

Часть 2. Увольнение по собственному. Общее состояние

Для начала поделимся неожиданным открытием - 65% опрошенных периодически испытывали желание уволиться. Некоторых техписателей это желание преследовало от 2 до 6 месяцев.

Ещё около 14% опрошенных отметили, что решили уволиться спонтанно. Однако у большинства последующие ответы (низкая зарплата, недопонимание с руководством) говорят о том, что предпосылки для ухода с этого места работы были. 18% спонтанно уволившихся приняли такое решение из-за предложений с более высокими заработными платами.

Иначе говоря, только 21% опрошенных до момента увольнения работали в условиях, которые их полностью устраивали.


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

Из всех опрошенных 13% пришли к решению уволиться из-за возникших проблем: конфликт с руководителем, проблемы с заказчиком, ситуации в личной жизни.

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

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


Подробнее о конкретных причинах мы расскажем в следующем посте.
👍1812🔥9
😁73💯16👍7🤣6😢3😭3
🤣78💯32🔥6
🤣89🔥12👍11💯10😁5
#колонкаредактора

Всем привет! Данные, собранные компанией documentat, говорят, что техписатели, работающие в парадигме docs as code зарабатывают больше тех, кто использует стандартные подходы с редакторами-wysiwyg ("что видишь, то и получишь"). Иногда хочется просто присоединиться к касте "продвинутых" и тоже перейти на DaC. Предлагаем сначала задать себе вопрос:

Нужен ли мне docs as code?

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

Любая смена инструментов и методологии ведёт к расходу ресурсов. А мы должны считать свои ресурсы и тратить их только обоснованно.

Итак, когда этот расход обоснован:

1️⃣ Процесс создания документации сложен. Например, вы описываете одновременно несколько функциальностей, причём над документами работают разные техписатели, перед публикацией нужно получить согласования лидов, а документы могут "заехать" в прод в разное время.
2️⃣ Большинство из тех, кто создаёт документацию, работает в git. Например, разработчики создают и документируют свой сервис.
3️⃣ Изучение инструментов и подходов разработчиков целесообразно для остальных. Ценность продакт-менеджера не в том, что он может писать в markdown, а том, что он видит место продукта на рынке и может направить его развитие в экономически обоснованное русло. А кроме такого менеджера есть ещё бизнес-аналитики, профильные ручные тестировщики и другие люди, чьё время тратить на обучение ненужного им инструментария неправильно.
4️⃣ Количество людей, которые создают документацию, кратно меньше тех, кто её потребляет. Этот пункт связан с использованием процесса CI/CD. В ситуации, когда разработчик написал документацию, которую читают и используют три команды, подход docs as code оправдан. Когда над документом работают продакт-менеджер, аналитик, дизайнер и заказчик, и этот документ нужен только им — не оправдан.

Что мы имеем:

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

Например, требования, обсуждения и обзоры можно фиксировать с помощью линейных процессов и обычного инструмента с wysiwyg-редактором. А для создания документации, которую вы поставляете пользователям, удобно использовать подход docs as code.

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