Международная конференция по технической документации
techwriterdays.ru
📍19-20 марта 2027 Москва
👥 Чат для нетворкинга: @twdays
ВК vk.com/techwriterdays
Ютуб youtube.com/@itconf
Международная конференция по технической документации
techwriterdays.ru
📍19-20 марта 2027 Москва
👥 Чат для нетворкинга: @twdays
ВК vk.com/techwriterdays
Ютуб youtube.com/@itconf
Как вовремя информировать об обновлениях, фикcах и изменениях?
На TechWriter Days 3 Татьяна Кириллова рассказала, как команда из Cloud.ru перешла на автоматическую генерацию changelog по истории коммитов в GitLab и выстроила рабочий пайплайн, который объединил разработчиков и технического писателя. Это не только сократило ручную рутину, но и привело к неожиданным бонусам для процесса разработки.
Разберём:
✅ почему коммиты для changelog'а оказались надежнее задач;
✅ какие инструменты GitLab и скрипты использовали для парсинга и сборки текста changelog'а;
✅ как стандартизировать сообщения коммитов, чтобы их можно было сразу превращать в понятный текст;
✅ как наладить взаимодействие dev ↔️ tech writer: от шаблона коммита до финальной вёрстки;
Смотреть видео: https://vkvideo.ru/video-223804668_456239249
«TechWriter Days Channel» - канал из категории «Технологии», подключенный к сервису кросспостинга MaxGate. Публикации канала синхронизируются между Telegram и мессенджером MAX, а на этой странице собраны ссылки на обе версии канала.
Сейчас у канала 754 подписчика суммарно в Telegram и MAX. За последние 30 дней в истории MaxGate учтено 6 публикаций, поэтому перед подпиской можно оценить не только размер аудитории, но и регулярность обновлений.
Чтобы подписаться, используйте кнопки «Открыть в MAX» и «Открыть в Telegram» в верхней части страницы. У отдельных постов ссылка может быть доступна в обоих мессенджерах или только в одном из них, если MaxGate получил такой URL из истории обработки.
ГОСТ 34 — надёжный инструмент для структурирования информации об автоматизированных системах. Он хорош там, где поведение системы детерминировано и предсказуемо. Но что делать, если система на базе ИИ по своей природе недетерминирована?
Прямолинейное применение требований ГОСТ 34 к интеллектуальным системам часто даёт формально корректный, но практически бесполезный результат. Нужен ли совсем новый стандарт — или можно сохранить общий подход, адаптировав способы описания и документирования?
На TechWriter Days 3 Михаил Острогорский и Александр Лебедев разобрали:
✅ В чём именно конфликт между ГОСТ 34 и ИИ‑системами;
✅ Как разделение «поведение системы — средства реализации» остаётся рабочей идеей;
✅ Какие элементы описания нужно переосмыслить для ИИ;
✅ Практические шаблоны и примеры документирования ИИ‑систем, которые можно внедрить сразу.
Смотреть видео: https://vkvideo.ru/video-223804668_456239224
📌 Маленькая команда — не повод жить на устных договорённостях!
На TechWriter Days 3 Юлия Тимофеева показала, как простые инструкции в команде:
⚡️ сэкономили часы на объяснениях
⚡️ уменьшили количество повторяющихся багов
⚡️ ускорили онбординг новичков и работу техподдержки
В докладе:
✅ какие документы действительно нужны
✅ как мотивировать коллег писать инструкции и пользоваться ими
✅ простые принципы внедрения документирования, которые не требуют месячных воркшопов
Смотреть видео: https://vkvideo.ru/video-223804668_456239244
Можно ли собирать пакет документации в один клик? Оказывается, иногда можно!
На TechWriter Days 3 Никита Осокин показал, как с помощью Jinja2, Markdown и LLM удалось автоматизировать генерацию техдоков так, чтобы избавить себя от рутины и нескончаемой копи-пасты.
В докладе:
✅ Автогенерация форм слов (падежи, наклонения и др.) для обеспечения согласованности.
✅ Автоматическое форматирование документов при генерации DOC-файлов (прощай, копи-паст).
✅ Работа с LLM в режиме Copilot через MD-редактор.
✅ Промпты через JSON/YAML структуры для генерации качественных ответов от LLM.
✅ Технические и экономические ограничения в применении LLM («экономика токенов»).
Смотреть видео: https://vkvideo.ru/video-223804668_456239235
