documentat.io – Telegram
documentat.io
1.05K subscribers
22 photos
2 files
80 links
Разработка технической документации, онлайн-курсы для технических писателей. documentat.io
Download Telegram
Привет всем!

Забежали напомнить, что завтра в 12:00 по МСК начнётся наш прямой эфир — обсудим результаты большого техписательского опроса, который проводили в прошлом январе.

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

До встречи в эфире!
12👍6
Прямой эфир начнётся ровно через 40 минут! В 12:00 расскажем о результатах большого опроса для техписателей, который команда Documentat провела в январе 2024 года.

Оставляйте ваши вопросы в чате — мы ответим на них в конце эфира.

📌 YouTube
📌
VK Video
📌
Rutube
13
У техписов нет вопросов.pdf
4.5 MB
Спасибо всем, кто вчера присоединился к трансляции! Были рады пообщаться и ответить на ваши вопросы.

Если посмотреть трансляцию в прямом эфире не получилось, записи доступны по старым ссылкам:

📌 YouTube
📌 Rutube

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

📌 Результаты большого техписательского опроса. География, демография, зарплаты
📌 Результаты большого техписательского опроса, часть 2. ГОСТ, индустрии, виды документации, зарплаты
📌 Результаты большого техписательского опроса, часть 3. Документационный инструментарий, Docs as Code, зарплаты

И не забудьте поучаствовать в новом опросе!
🔥31👍1
Мы не договорили!

В следующую среду, 5 марта, в 11:00 по МСК мы проведём ещё один прямой эфир.

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

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

📅 Когда: 5 марта в 11:00 по МСК.
📍 Где: на YouTube, в Rutube и ВКонтакте.
🔥20👏3
Небывалый случай: до начала курса по API всего две недели, а свободные места еще есть.

Успевайте их занять!

❇️ Документация API. Расскажем о принципах REST API, о современном инструментарии документирования API и о взаимодействии техписателя и команды разработки. Попрактикуемся в описании реального API с помощью Swagger. 17—28 марта 2025.
🔥9
Второй прямой эфир о результатах прошлогоднего опроса для техписателей начнётся через час!

Задавайте вопросы в нашем tg-чате — мы обязательно ответим на них в конце трансляции.
4
Эфир про опрос-2025 №2.pdf
3.5 MB
Мы закончили рассказывать о результатах большого техписательского опроса — 2024. Спасибо всем, кто смотрел трансляцию и писал нам в чате!

Презентацию прикрепляем к этому посту, а записи сегодняшнего прямого эфира доступны по старым ссылкам:

📌 YouTube
📌 Rutube
📌 ВКонтакте

А до конца нового опроса осталось всего пять дней — самое время пройти его, если вы сохранили ссылку и благополучно про неё забыли :)
14
До закрытия нашего ежегодного опроса осталось всего три дня — и это отличный повод для пятничной прокрастинации шанс стать частью крупнейшего исследования о русскоязычных техписателях, выиграть призы и получить скидку в 25% на любой наш курс.

Пройти опрос можно здесь — сделать это нужно до конца воскресенья (потом карета превратится в тыкву, а форма закроется).

Заранее благодарим за ваши ответы!
👍6
14 марта (это пятница) в 12:00 по МСК мы встретимся на стриме с командой конференции для технических писателей TechWriter Days.

На трансляции:

📌 Поговорим о том, кому и зачем стоит посещать конференции.
📌 Выясним, как программный комитет TechWriter Days выбирает спикеров и темы докладов.
📌 Получим полезные советы и узнаем, как стать спикером в следующем году.
📌 Узнаем, как организовать конференцию и сколько техписателей нужно, чтобы вкрутить лампочку в лекционном зале.
📌 Ответим на вопросы зрителей.
📌 Разыграем два промокода, которые позволят купить билет на TechWriter Days 2 со скидкой в 30%.

📅 Когда: 14 марта в 12:00 по МСК
📍 Где: на YouTube, в Rutube и ВКонтакте
🔥9
Начинаем встречу с командой конференции TechWriter Days уже через полчаса!

Стримить будем на все наши площадки — выбирайте самую удобную:

📌 YouTube
📌 VK Video
📌 Rutube

И обязательно задавайте вопросы — сделать это можно в нашем чате.
👍8
Наш большой документационный опрос — 2025 завершен!

В этом году нашу анкету заполнило 550 техписателей (в 2024 году респондентов-техписателей было 365). Спасибо всем, кто уделил время нашим непростым вопросам!

Обещанные призы участникам опроса будут разыграны завтра, и завтра же мы свяжемся со всеми призерами.

А первые результаты нашего исследования будут озвучены 29 марта на конференции TechWriter Days #2.

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

И да, слушатели конференции первыми узнают техписательскую медиану 2025 года😊

Еще раздумываете, идти ли на конференцию? Как насчет небольшой скидки?

🎁 По промокоду SURVEY99 вы получите скидку в 5% на онлайн- или офлайн-билет.

До встречи на TechWriter Days #2!
15👍14
Теперь обзорный курс documentat.io о технической документации есть в нашем сообществе ВКонтакте.

В первую очередь курс будет полезен для начинающих технических писателей, но может пригодиться и опытным разработчикам технической документации. Среди затронутых тем — процессы документирования, инструментарий техписателя, подход Docs as Code, локализация, ГОСТ 19 и ГОСТ 34.

Для удобства собрали все лекции в один плейлист. А ещё курс можно посмотреть на YouTube и в Rutube.

Приятного просмотра!
👍4116🔥9🤩2🙏1🫡1
Ждете зарплатную статистику за 2025 год?

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

Подпишитесь на наш канал, чтобы не пропустить: @documentatio_official
🔥41😁12🏆61
Этот пост адресован тем, кто слушал мой доклад на TechWriter Days #2 и кто обратил внимание на озвученную в нем обновленную медианную зарплату техписателей.

К сожалению, в доклад вкралась техническая ошибка: медиана 2025 года оказалась посчитана неправильно:(

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

Приношу свои извинения всем, кому важна эта информация.

🔴 Почему так вышло?
Для доклада я по невнимательности посчитал медиану по респондентам со всего мира, а не только из РФ. Другими словами, озвученная на конференции медиана смешала техписателей из России, Сербии, Грузии, Армении, Казахстана и т.д. Методика нашего исследования не подразумевает этого: во всей зарплатной статистике мы всегда учитываем только резидентов РФ.

🟡 Влияет ли это на другие тезисы, озвученные в докладе?
Нет, все относительные расчеты (например, разница зарплат мидлов и сеньоров) и все выводы остаются верными.

🟢 Не томите, скажите уже актуальную медиану для РФ!
Опубликуем ее завтра, 15 апреля, в нашем канале @documentatio_official. Оставайтесь на связи!
👍25
Итак, по результатам большого техписательского опроса documentat.io медианная зарплата техписателя в РФ на февраль 2025 составила 140 000 рублей.

(на конференции TechWriter Days #2 была озвучена другая сумма, она ошибочна. Вот здесь можно почитать, почему так вышло)

95-й процентиль техписательских зарплат на февраль 2025 — 250 000 рублей.

Остальные данные — в картинках к посту.

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

Да начнется конструктивное обсуждение!
👍47
Открываем запись на июньский поток курса «Документация API» от documentat.io.

📅 Когда: 16–27 июня по понедельникам, средам и пятницам с 17:00 до 19:00 по МСК.
📍 Где: онлайн в Zoom-конференции. Записи вебинаров будут доступны участникам после занятий.

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

В программе:
▪️ Введение в API.​ Виды API-документации.
▪️ REST API: особенности, форматы данных.
▪️ Работа технического писателя в команде разработчиков.​
▪️ Справочники API: спецификация OpenAPI.
▪️ Инструменты для разработки API-документации.
▪️ Публикация API-документации.

В курс входят не только вебинары, но и практические задания: участники смогут поэкспериментировать со структурой документационного портала, сделать запросы к API, написать собственные документы в редакторе VS Code и опубликовать их.

📝 Чтобы подать заявку на участие, нажмите кнопку «Записаться» на странице курса и заполните форму.
👍118🔥2