C вами Семён Факторович и компания documentat.io. С 2018 года мы помогаем IT-компаниям создавать техническую документацию: пишем документацию на заказ, консультируем инженерные команды по процессам документирования, учим техписателей и инженеров писать документацию.
В январе 2024 года мы провели большой опрос среди техписателей и других IT-специалистов, разрабатывающих документацию. Теперь я начинаю серию статей, в которой поделюсь с вами результатами опроса.
В первой статье я расскажу о географии и демографии русскоязычных техписателей — где мы живём, сколько нам лет, каков наш гендерный состав — а также рассмотрю зарплатную статистику в техписательском сообществе РФ.
Что это был за опрос и зачем он?
Какие задачи я хотел решить этим опросом:
Узнать, как пишут документацию в русскоязычных IT-компаниях. Какие документы пишут IT-специалисты в разных командах? Какой инструментарий разработки документации используют? Кто обычно занимается разработкой документации — техписатели, аналитики, разработчики?
Изучить рынок труда и специфику работы русскоязычных техписателей. Сколько они зарабатывают? Как видят свой карьерный рост? Что им нравится и не нравится в профессии? Какие компании и задачи видятся им интересными?
Чтобы выяснить всё это, мы с коллегами сделали анкету из 100 вопросов. Вот все вопросы анкеты, собранные в один документ.
Как всё прошло?
Опрос проводился с конца декабря 2023 по конец января 2024, за это время анкету заполнили более 500 респондентов. Входным вопросом в анкете был «разрабатываете ли вы документацию, пусть даже и в параллель с другими рабочими обязанностями»: на него положительно ответили 100% респондентов.
Первый срез опроса, который мне захотелось рассмотреть — кто вообще занимается разработкой документации в разных компаниях?
Командная роль | Количество ответивших | Процент ответивших от общего количества респондентов |
Технический писатель | 365 | 70% |
Системный аналитик, бизнес-аналитик | 43 | 8% |
Менеджер проекта, руководитель проекта | 14 | 3% |
Разработчик, программист | 12 | 2% |
Технический директор, CTO, engineering manager | 9 | 2% |
Менеджер продукта, product owner | 5 | 1% |
QA-инженер | 5 | 1% |
Тимлид разработки | 4 | 1% |
Топ-менеджер или C-level менеджер, кроме CTO | 3 | 1% |
DevOps-инженер, платформенный или инфраструктурный инженер | 3 | 1% |
Прочие командные роли (преимущественно в индустриях, отличных от IT) | 57 | 11% |
Всего | 520 | 100% |
Повторюсь: все эти люди разрабатывают документацию. Да, даже проектные менеджеры, CTO и DevOps-инженеры!
Но основной моей задачей было изучение техписательского сообщества, поэтому все дальнейшие выводы я делаю только по ответам респондентов-техписателей. Их в нашей выборке 365.
Можно ли оценить по этому количеству весь объём русскоязычного техписательского сообщества? Я считаю, что нельзя: наш опрос не даёт никакой объективной информации о том, сколько всего техписателей в России. Тем не менее, группа в 365 техписателей кажется мне достаточно большой и репрезентативной, чтобы строить по ней статистику и вообще делать выводы о профсообществе техписателей.
И ещё одно важное соображение. Картина, рисуемая этим опросом, почти наверняка будет отличаться от картины, которую вы можете составить, изучая техписательские вакансии. Почему? Потому что в рамках этого опроса мы просили техписателей рассказать о текущих реалиях своей работы: например, о той зарплате, какую они получают сейчас, и о том, какие задачи им приходится решать на текущем месте работы. Мы не анализировали тексты вакансий, не строили зарплатную статистику по ним и не опрашивали HR-ов и прочих нанимающих менеджеров.
География русскоязычных техписателей
Чтобы определить географическое распределение техписательского сообщества, мы спрашивали, в какой стране и в каком городе живут наши респонденты.
Нас интересовало именно место фактического проживания: не регион прописки, не страна гражданства или налогового резидентства и не локация компании, на которую работает респондент.
Цифровым кочевникам — тем, кто в последние годы часто менял место жительства — мы предлагали ответить на вопрос «в какой стране и в каком городе вы прожили бóльшую часть последних шести месяцев».
Получилось вот что:
Страна | Количество респондентов-техписателей |
Россия | 320 |
Грузия | 9 |
Сербия | 8 |
Армения | 4 |
Германия | 4 |
Белоруссия | 3 |
Казахстан | 3 |
Кипр | 2 |
Великобритания | 1 |
Болгария | 1 |
Вьетнам | 1 |
Израиль | 1 |
Киргизия | 1 |
Китай | 1 |
Молдова | 1 |
Нидерланды | 1 |
Узбекистан | 1 |
Финляндия | 1 |
Хорватия | 1 |
Черногория | 1 |
Всего | 365 |
Помимо России, основными техписательскими локациями оказались популярные хабы айтишной эмиграции последних лет: Грузия, Сербия, Армения.
А как российские техписатели оказались распределены по городам РФ?
Город | Количество респондентов-техписателей | Процент от общего количества техписателей-россиян, указавших город проживания |
Москва и область | 96 | 31% |
Санкт-Петербург и область | 69 | 22% |
Новосибирск | 24 | 8% |
Самара | 13 | 4% |
Екатеринбург | 10 | 3% |
Пермь | 10 | 3% |
Нижний Новгород | 8 | 3% |
Казань | 7 | 2% |
Томск | 7 | 2% |
Воронеж | 5 | 2% |
Уфа | 5 | 2% |
Другие города | 60 | 19% |
Всего техписателей-россиян, указавших город проживания | 314 | 100% |
Что за другие города?
Города РФ, в которых количество респондентов-техписателей меньше 5
Город | Количество респондентов-техписателей |
Белгород | 4 |
Ижевск | 4 |
Омск | 4 |
Тула | 4 |
Красноярск | 3 |
Челябинск | 3 |
Вологда | 2 |
Калининград | 2 |
Краснодар | 2 |
Ростов-на-Дону | 2 |
Рязань | 2 |
Смоленск | 2 |
Чебоксары | 2 |
Барнаул | 1 |
Владимир | 1 |
Дзержинск | 1 |
Димитровград | 1 |
Донецк (Ростовская область) | 1 |
Иркутск | 1 |
Ишимбай | 1 |
Йошкар-Ола | 1 |
Калуга | 1 |
Каменск-Уральский | 1 |
Киров | 1 |
Курчатов | 1 |
Майкоп | 1 |
Мурманск | 1 |
Нижневартовск | 1 |
Орёл | 1 |
Пенза | 1 |
Петрозаводск | 1 |
Саратов | 1 |
Саров | 1 |
Хабаровск | 1 |
Югорск | 1 |
Южно-Сахалинск | 1 |
Ярославль | 1 |
Всего | 60 |
Самыми населёнными техписательскими регионами оказались Москва и Питер вместе со своими областями: суммарно в них живут 53% российских техписателей. Третий по населённости техписательский город — Новосибирск, там проживает 8% респондентов.
Зарплаты техписателей в РФ
333 из 365 наших респондентов-техписателей (более 90%) указали размер своей ежемесячной зарплаты. Я считаю эту выборку достаточно крупной, чтобы попытаться построить по ней статистику техписательских зарплат.
Эту статистику я строил в следующих предположениях:
Фултаймеры, не фрилансеры
Я анализировал только зарплаты штатных сотрудников с фиксированной ежемесячной зарплатой. Фрилансеров среди наших респондентов было всего 9%: я не считаю эту выборку достаточно большой, чтобы делать достоверные выводы о типовых ставках техписателей-фрилансеров.
Только РФ
85% техписателей-респондентов указали местом проживания Россию. В каждой из остальных стран (Грузия, Сербия, Армения, Кипр и пр.) живут менее 10 респондентов нашего опроса. Я счел это количество недостаточным для того, чтобы строить в этих странах достоверную зарплатную статистику.
Поэтому все зарплатные данные в этом исследовании приводятся только для техписателей, живущих на территории РФ.
Распределение зарплат по регионам РФ — в соответствии с регионами проживания
Мы спрашивали у наших респондентов только город их проживания, а не местоположение их офиса или регион регистрации юрлица работодателя. Соответственно, все зарплатные данные мы привязывали только к локации самого техписателя, а не к локации его компании.
Техписатель, живущий в Южно-Сахалинске и работающий удалённо на московский офис российского IT-гиганта, внесёт свою зарплату в статистику по Южно-Сахалинску.
Респондент, живущий в Химках, но работающий на свердловскую компанию, будет причислен к техписателям Московской области.
Зарплата жителя Новосибирска, работающего на кипрскую компанию, будет пересчитана в рубли и внесена в зарплатную статистику Новосибирска.
Не среднее, а медиана
Как и во многих других зарплатных исследованиях, мы не рассчитываем среднее арифметическое всех зарплат, а используем две других характерных метрики: медиану и 95-й процентиль.
Медианная зарплата: 50% респондентов получают меньше этой суммы.
95-й процентиль зарплат: 5% самых высокооплачиваемых респондентов получают больше этой суммы.
Чуть подробнее о медианных и процентильных значениях
Средняя зарплата — не самая информативная величина. Если подсчитать среднее арифметическое зарплат в отделе из двух сотрудников, один из которых получает 200 тысяч, а другой — 60, средняя зарплата в отделе составит 130 тысяч рублей. Эта величина бесполезна и для претендующего на большую зарплату опытного сотрудника, и для низкооплачиваемого стажёра.
Медианная зарплата и 95-й процентиль
Давайте представим танцевальный коллектив из 40 человек, в котором работают 38 артистов кордебалета с небольшими зарплатами и 2 высокооплачиваемые солистки. В кордебалете 20 артистов получают по 30 тысяч рублей, а 18 артистов — по 35 тысяч. Зарплата первой солистки — 300 тысяч, а вторая получает 320 тысяч.
Чтобы узнать медианную зарплату в коллективе:
Расположим участников коллектива по возрастанию зарплаты.
Возьмём два серединных элемента в этом списке — двадцатого и двадцать первого артистов кордебалета. Они зарабатывают 30 и 35 тысяч, соответственно.
Посчитаем их среднее арифметическое их зарплат, получим 32,5 тысячи. Это и будет медианной зарплатой.
Медианная зарплата даст нанимающемуся в кордебалет артисту довольно чёткое представление о том, сколько он сможет заработать. А ещё он будет знать, что 50% его будущих коллег зарабатывают меньше этой суммы.
Если в коллектив решит устроиться ещё один солист, претендующий на высокую зарплату, то медианная зарплата в 32,5 тысячи будет для него малоинформативной. Ему поможет 95-й процентиль — нижняя граница самых высоких 5% зарплат.
Посчитаем 95-й процентиль зарплат:
Выстроим участников коллектива по возрастанию зарплаты.
Посмотрим на 5% участников, расположенных в самом конце этого списка. В нашем случае самые высокооплачиваемые 5% коллектива — это две солистки с зарплатами 300 и 320 тысяч.
Посмотрим, какова нижняя граница зарплат этих 5% коллектива: это и будет 95-й процентиль. В нашем случае он равен 300 тысячам, меньшей из зарплат двух солисток.
Это значение говорит нашему солисту-соискателю: 5% самых высокооплачиваемых артистов в коллективе получают не меньше 300 тысяч.
В итоге в нашем танцевальном коллективе:
Медианная зарплата: 32 500 ₽.
95-й процентиль зарплат: 300 000 ₽.
Средняя зарплата (среднее арифметическое всех зарплат): 46 250 ₽.
Медиана и 95-й процентиль обычно гораздо информативнее, чем среднее значение.
С учётом всех этих предположений главные зарплатные метрики техписательского сообщества в РФ оказались такими:
Медиана техписательских зарплат — 120к, 95-й процентиль — 240к. Все зарплатные величины в нашем исследовании указаны «нетто», после вычета всех налогов и отчислений.
Для сравнения, по результатам зарплатного исследования Хабра медианная зарплата всех IT-специалистов в России на конец 2023 года (именно в это время мы запустили наш опрос) — 140 833 рубля.
А как техписательские зарплаты распределяются по городам РФ? Начнём с медиан.
Город / регион | Медианная зарплата техписателей |
Москва и область | 140 000 ₽ |
Санкт-Петербург и область | 119 000 ₽ |
Новосибирск | 90 000 ₽ |
Все остальные города России | 100 000 ₽ |
Вся Россия | 120 000 ₽ |
А теперь посмотрим 95-ые процентили.
Город / регион | 95-й процентиль зарплат техписателей |
Москва и область | 240 000 ₽ |
Санкт-Петербург и область | 200 000 ₽ |
Новосибирск | 180 000 ₽ |
Все остальные города России | 200 000 ₽ |
Вся Россия | 240 000 ₽ |
Если судить по медианам, то в Москве и в Питере техписатели получают больше, чем в остальных регионах. Никаких сюрпризов.
Ситуация с 95-м процентилем чуть интереснее: самые высокооплачиваемые москвичи получают больше всех остальных россиян, а вот топовые техписатели в Питере зарабатывают вровень с топовыми техписателями из регионов.
Небольшой FAQ по зарплатным результатам нашего опроса
Q: Но в техписательских вакансиях предлагают совсем другие деньги!
A: Вполне возможно. Наш опрос касался ситуации «на местах»: мы спрашивали у техписателей, сколько они зарабатывают сейчас. Мы не изучали публикуемые в вакансиях зарплаты и не строили статистику по ним.
Q: Но моя личная статистика рисует совсем другую картину зарплат!
A: Вполне возможно. Но, скорее всего, ваша статистика построена на 3–4 компаниях, в которых вы работали в последние годы (или в которые собеседовались), а также на данных 5–10 ваших знакомых и коллег. Наше исследование покрывает гораздо большее количество техписателей, компаний и регионов.
Q: 95-й процентиль — всего 240к? Я и все мои друзья получают больше!
A: По моим данным, вы и ваши друзья входите в 5% самых высокооплачиваемых техписателей РФ. Поздравляю вас!
Сколько лет типичному техписателю?
Медианный возраст русскоязычных техписателей — 33 года, а три четверти из них старше 28 лет. Привожу эти данные, чтобы вы представляли, какого примерно возраста будут ваши коллеги в той техписательской команде, в которую вы попадёте, если решите сменить работу.
Отдельное уважение хочется выразить самому старшему из наших респондентов-техписателей, возраст которого — 73 года.
Техписатель — мужская или женская профессия?
И снова никаких сюрпризов: соотношение мужчин и женщин в русскоязычном техписательском сообществе — 1 к 3. Это довольно хорошо совпадает с тем, что я вижу в большинстве знакомых техписательских команд.
Есть ли гендерное неравенство в зарплатах?
Исследования во многих индустриях показывают, что женщины зарабатывают меньше мужчин. Так ли это для профессии техписателя?
С одной стороны, медианная зарплата технических писательниц на 10 000 рублей меньше, чем у техписателей-мужчин.
Медианные зарплаты техписателей в РФ в гендерной разбивке:
Медиана у женщин | 120 000 ₽ |
Медиана у мужчин | 130 000 ₽ |
Общая медиана по России | 120 000 ₽ |
С другой стороны, например, в Москве 95-й процентиль для женщин выше.
95-ые процентили зарплат техписателей в Москве в гендерной разбивке:
95-й процентиль у москвичек | 248 500 ₽ |
95-й процентиль у москвичей | 213 000 ₽ |
Общий 95-й процентиль по Москве | 240 000 ₽ |
Данные в разных выборках противоречивы, поэтому я не возьмусь делать какие-то обобщающие выводы о гендерном разрыве в техписательских зарплатах.
Подытожим
Мы опросили 365 русскоязычных техписателей из разных стран и регионов.
320 опрошенных техписателей (88%) живут в России, прочие крупные локации русскоязычных техписателей — Грузия, Сербия и Армения.
Медиана ФакторовичаМедианная зарплата техписателя в РФ — 120 000 ₽. Половина российских техписателей получает меньше этой суммы.95-й процентиль зарплат техписателей в РФ — 240 000 ₽. Только 5% российских техписателей зарабатывают больше.
Техписательские зарплаты в Москве выше, чем в остальной России (медиана в Москве — 140к, медиана в регионах — 100к).
Технический писатель — преимущественно женская профессия, мужчин-техписателей втрое меньше, чем женщин (22% против 76%).
Медианный возраст русскоязычных техписателей — 33 года.
Что дальше?
Это первая статья о результатах нашего техписательского опроса.
В следующей статье я расскажу об отраслях и индустриях, в которых работают русскоязычные техписатели, и о документах, которые они разрабатывают. Вы узнаете:
Кому платят больше — техписателям на заводах или техписателям в IT-компаниях?
Сколько процентов русскоязычных техписателей пишут по ГОСТ?
Увеличивает ли зарплату техписателя навык документирования API?
Чтобы не пропустить новые статьи, подпишитесь на наш блог на Хабре и на телеграм-канал documentat.io.
И приходите к нам за услугами по разработке документации и за обучением: мы давно и успешно учим техписателей и инженеров писать хорошую документацию.
Автор текста и создатель опроса: Семён Факторович
Численный анализ данных: Илья Улеско
Редактура: Ната Мелихова
Инфографика: Валерий Балдин
Неконструктивная критика: Юрий Панкратов
