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

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

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

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

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

📝 Чтобы подать заявку на участие, нажмите кнопку «Записаться» на странице курса и заполните форму.
👍118🔥2
Набор на июньский поток экспресс-курса «Технический писатель» от documentat.io открыт!

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

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

На лекциях обсудим:
▪️ Что такое техническая документация и кто такой технический писатель.
▪️ Рынок труда технических писателей.
▪️ Пошаговые инструкции, руководства пользователя и концептуальные статьи.
▪️ ГОСТ 2, ГОСТ 19, ГОСТ 34.
▪️ Основные документы по ГОСТ (обзорно): техническое задание, пояснительная записка, руководство пользователя, программа и методика испытаний.
▪️ Гиды по стилю.
▪️ Ревью технической документации.

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

📝 Чтобы подать заявку на участие, нажмите кнопку «Записаться» на странице курса и заполните форму.
4👍2
До старта курсов «Технический писатель» и «Документация API» осталось две недели. Если планируете учиться этим летом, обязательно приходите к нам!

▪️ Экспресс-курс «Технический писатель» подойдёт тем, кто только начинает свой путь в профессии.
▪️ Курс «Документация API» предназначен для опытных техписателей, которые пока не документировали API, но хотят разобраться в этой теме.

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

Чтобы подать заявку, нажмите кнопку «Записаться» на странице нужного курса и заполните форму.
8🔥6❤‍🔥3
Впереди длинные выходные, а сразу после них — первая лекция курса «Документация API». Регистрация пока открыта: чтобы попасть на поток, нажмите кнопку «Записаться» и заполните форму.

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

До встречи!
6🔥4
Открываем запись на октябрьский курс «Управляем командой технических писателей».

📅 Когда: 6–10 октября с 10:00 до 12:00 по МСК.
📍 Где: онлайн в Zoom-конференции. Записи лекций будут доступны участникам после завершения курса.

Это курс об управлении документационными командами и документационными процессами «изнутри». Он пригодится руководителям отделов документирования, техписателям-тимлидам и тем, кто пока только примеряется к этим ролям.

На лекциях Семён Факторович расскажет о том, как нанимать технических писателей, помогать им расти, управлять командой и процессами документирования.

Ознакомиться с полной программой курса и оставить заявку на участие вы можете на сайте documentat.io.
10
21 августа Семён Факторович и Оксана Гаврюшенко встретятся с организаторами техписательской конференции TechWriter Days 3, которая пройдёт в Москве и онлайн 27–28 марта 2026 года. Организатор TWD 3 Эльдар Султанов и программный директор Таисия Толстунова расскажут о том, как продвигается подготовка к конференции, обсудят темы докладов и ответят на вопросы зрителей трансляции.

Вы узнаете:

🔹 Какие темы уже прошли отбор в программу конференции;
🔹 С какими докладами можно прийти на TWD 3;
🔹 Как изменились профессиональные тренды и какие вопросы сейчас актуальны для технических писателей.

А ещё мы разыграем среди зрителей офлайн-билет на TechWriter Days 3. Приходите!

📅 Когда: 21 августа в 12:00 по МСК.
📍 Где: YouTube, Rutube, ВКонтакте
17🔥12🤩3👍2
Уже завтра состоится прямой эфир, в котором Семён Факторович и Оксана Гаврюшенко встретятся с организаторами конференции TechWriter Days 3.

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

До встречи!

📅 Когда: завтра в 12:00 по МСК.
📍 Где: YouTube, Rutube, ВКонтакте
13👍2🥰1
Через десять минут встретимся в прямом эфире с организаторами техписательской конференции TechWriter Days 3 — забегайте в трансляцию на YouTube, Rutube или ВКонтакте, чтобы узнать новости TWD 3 и поучаствовать в розыгрыше билета на мартовскую конференцию!
9
Для участия в розыгрыше офлайн-билета на конференцию TechWriter Days 3 подпишитесь на каналы Documentat и TechWriter Days, а потом нажмите нажмите кнопку «Участвую».



👤 Участников: 126
🏅 Победители: @AntonNayd
7😢4
Доклады на какие темы вы хотите услышать на TechWriter Days 3? Расскажите о докладе мечты (или даже о нескольких таких докладах) в небольшой Яндекс Форме: clck.ru/3NmfPJ.

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

Итоги подведём 11 сентября.
18
Продолжается запись на курс «Управляем командой технических писателей»

📅 Когда: 6–10 октября с 10:00 до 12:00 по МСК.
📍 Где: онлайн в Zoom-конференции.

Семён Факторович расскажет о задачах и проблемах, с которыми сталкиваются в работе техписатели-тимлиды: от оценки трудозатрат на проектах и качества документации до развития команды и мотивации сотрудников.

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

Подробнее почитать о программе курса и оставить заявку на участие можно на сайте documentat.io.
8
Вчера на вебинаре TechWriter Days подвели итоги конкурса!

Записи трансляции с подведением итогов можно найти в Telegram-канале TWD, VK Видео и на YouTube — заходите, чтобы узнать четыре причины перестроить работу с текстом от Вероники Высотиной и выяснить, какие вопросы показались ведущим самыми удачными.

Помимо двух победителей, которые получат по онлайн-билету на конференцию TechWriter Days 3, мы решили наградить ещё одного участника конкурса — в ближайшее время отправим ему промокод со скидкой 50% на любой курс Documentat.

Спасибо за ваши ответы!
8👍4😱1
18 сентября проведём эфир из новосибирского офиса Documentat

Семён Факторович и Оксана Гаврюшенко обсудят доклад Оксаны для конференции TechWriter Days 3, которая пройдёт в Москве весной 2026 года.

Оксана расскажет о разработанном ей новом подходе к оценке проектов, базирующемся на определении оптимального уровня качества технической документации:

▪️ Где пролегает граница между MVP и идеальным документом?
▪️ Как определить правильный уровень качества документации, опираясь на бизнес-цель?
▪️ Почему кликабельность перекрестных ссылок сказывается на стоимости проекта?

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

А ещё мы наградим ещё одного участника прошедшего конкурса. Приходите посмотреть!

📅 Когда: 18 сентября в 13:00 по МСК
📍 Где: YouTube, Rutube, ВКонтакте
15🔥13👍3
Через час начинаем нашу трансляцию с Семёном Факторовичем и Оксаной Гаврюшенко!

В 13:00 по МСК заглядывайте на YouTube, в Rutube или ВКонтакте, чтобы послушать о новом подходе Оксаны к оценке проектов и узнать, как определить нужный уровень качества документации, опираясь на бизнес-цели. И, конечно, задавайте вопросы в комментариях к этому посту — ответим на них в конце эфира.
🔥82
Сделали стикерпак для технических писателей от Documentat!

Жмите на ссылку, добавляйте набор и отправляйте стикеры коллегам — пусть рабочая переписка станет немного веселей 🎉
🔥3510👏1
This media is not supported in your browser
VIEW IN TELEGRAM
🔥25😁23💯43👌2
Запись на ноябрьский поток курса «Документация API» открыта!

📅 Когда: 22–30 ноября по субботам и воскресеньям с 11:00 до 14:00 по МСК
📍 Где: онлайн в Zoom-конференции

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

Ведущий курса — Денис Мазин, руководитель команды технических писателей в TradingView.

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

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

А ещё этот поток — нетипичный: все лекции будут на выходных. Если вы давно хотели больше узнать про документирование API, но не могли совместить курс с работой или сомневались, что вам хватит времени на домашки, приходите сейчас!

📝 Подробнее узнать о программе курса и оставить заявку можно на сайте documentat.io.
👍13🔥83🥰1
⚠️ Внимание, мошенники! ⚠️

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

Пожалуйста, игнорируйте подобные сообщения и сразу жалуйтесь на спам.

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

— Мы не делаем рассылки по личкам о том, что запись открыта.
— Мы не предлагаем оплатить участие в курсах «напрямую».
— Мы не просим передать нам коды подтверждения из SMS.
😱178👍5🤬2🙏1
Продолжается запись на ноябрьский поток курса «Документация API»

Курс пройдёт 22–30 ноября. Он предназначен для опытных технических писателей, которые пока не документировали API, но хотят разобраться в этой теме. На этот раз встречаемся по субботам и воскресеньям с 11:00 до 14:00 по МСК — этот поток особенно подойдёт тем, у кого нет возможности посещать лекции в будние дни.

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

Чтобы подать заявку на участие, заполните форму на странице курса.
👍5🔥2😁1
Открываем запись на новый курс по DITA

📅 Когда: 6–14 декабря по субботам и воскресеньям с 10:00 до 14:00 по МСК
📍 Где: онлайн в Zoom-конференции

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

На курсе разберём:
▪️ как устроена автоматизация документирования;
▪️ из чего состоит технологический стек DITA;
▪️ зачем нужны информационные типы;
▪️ как спроектировать систему сборки документов;
▪️ как внедрить технологию DITA в компании.

Вы научитесь:
▪️ устанавливать инструменты DITA и работать с ними;
▪️ проектировать информационную структуру документации;
▪️ публиковать документы в разных оформлениях и форматах;
▪️ автоматизировать выпуск документов;
▪️ аргументировать внедрение DITA руководству.

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

Бонус-трек — блок про поиск реюза и генерацию статей с помощью ИИ.

Ведущий курса — руководитель разработки профессионального стандарта «Технический писатель» и редактор проекта «Гостопедия» Μuxαuл Oငⲧρогоρငкuǔ.

Стоимость участия — 40 000 рублей.

📝 Подробнее узнать о программе курса и оставить заявку можно на сайте documentat.io.
🔥122👏1😍1💯1
UX без ручной работы: как заставить ИИ самостоятельно писать документацию

Уже в эту пятницу, 28 ноября, Семён Факторович в прямом эфире встретится с автором telegram-канала «Техниндзя» Дмитрием Развозжаевым.

Дмитрий анонсирует свой доклад на мартовской конференции для технических писателей TechWriter Days 3 и расскажет, как с помощью современных ИИ-технологий автоматизировать генерацию пользовательских инструкций на основе интерфейсных макетов из Figma.

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

📅 Когда: 28 ноября в 10:00 по МСК
📍 Где: YouTube и Rutube
🔥3310🎉3