Международная конференция по технической документации
techwriterdays.ru
📍19-20 марта 2027 Москва
👥 Чат для нетворкинга: @twdays
ВК vk.com/techwriterdays
Ютуб youtube.com/@itconf
Международная конференция по технической документации
techwriterdays.ru
📍19-20 марта 2027 Москва
👥 Чат для нетворкинга: @twdays
ВК vk.com/techwriterdays
Ютуб youtube.com/@itconf
Не так давно команда VK WorkSpace приняла смелое решение: мигрировать всю документацию с одного генератора статических сайтов MkDocs на другой Hugo. Что из этого вышло? Какие подводные камни обнаружились? И какой инструмент на самом деле лучше подходит для вас?
На TechWriter Days 3 Никита Груздев поделился реальным опытом этой миграции.
В докладе:
✅ Battle of the Generators: Сравним MkDocs и Hugo по ключевым параметрам: от простоты развертывания до возможностей кастомизации.
✅ Enterprise vs Стартап: Разберем, какой генератор лучше подходит для больших корпоративных продуктов, а какой — для динамичных стартапов.
✅ Развитие для техписателя: Узнаем, где у технического писателя больше возможностей для роста портала документации и развития личных навыков.
✅ Подводные камни: Реальные факапы и неочевидные решения, с которыми столкнулась команда в процессе миграции.
✅ Сыграем в БИНГО! Это поможет нам в интерактивном формате сравнить технические возможности обоих генераторов и закрепить знания.
Смотреть видео: https://vkvideo.ru/video-223804668_456239251
«TechWriter Days Channel» - канал из категории «Технологии», подключенный к сервису кросспостинга MaxGate. Публикации канала синхронизируются между Telegram и мессенджером MAX, а на этой странице собраны ссылки на обе версии канала.
Сейчас у канала 755 подписчиков суммарно в Telegram и MAX. За последние 27 дней в истории MaxGate учтено 6 публикаций, поэтому перед подпиской можно оценить не только размер аудитории, но и регулярность обновлений.
Чтобы подписаться, используйте кнопки «Открыть в MAX» и «Открыть в Telegram» в верхней части страницы. У отдельных постов ссылка может быть доступна в обоих мессенджерах или только в одном из них, если MaxGate получил такой URL из истории обработки.
🚀 Друзья, в следующем месяце стоимость билетов на TechWriter Days 4 будет увеличиваться.
19-20 марта 2027 года в Москве и онлайн❤️
⚡️билеты
⚡️афиша
⚡️скидки
⚡️видео
Как вовремя информировать об обновлениях, фикcах и изменениях?
На TechWriter Days 3 Татьяна Кириллова рассказала, как команда из Cloud.ru перешла на автоматическую генерацию changelog по истории коммитов в GitLab и выстроила рабочий пайплайн, который объединил разработчиков и технического писателя. Это не только сократило ручную рутину, но и привело к неожиданным бонусам для процесса разработки.
Разберём:
✅ почему коммиты для changelog'а оказались надежнее задач;
✅ какие инструменты GitLab и скрипты использовали для парсинга и сборки текста changelog'а;
✅ как стандартизировать сообщения коммитов, чтобы их можно было сразу превращать в понятный текст;
✅ как наладить взаимодействие dev ↔️ tech writer: от шаблона коммита до финальной вёрстки;
Смотреть видео: https://vkvideo.ru/video-223804668_456239249
ГОСТ 34 — надёжный инструмент для структурирования информации об автоматизированных системах. Он хорош там, где поведение системы детерминировано и предсказуемо. Но что делать, если система на базе ИИ по своей природе недетерминирована?
Прямолинейное применение требований ГОСТ 34 к интеллектуальным системам часто даёт формально корректный, но практически бесполезный результат. Нужен ли совсем новый стандарт — или можно сохранить общий подход, адаптировав способы описания и документирования?
На TechWriter Days 3 Михаил Острогорский и Александр Лебедев разобрали:
✅ В чём именно конфликт между ГОСТ 34 и ИИ‑системами;
✅ Как разделение «поведение системы — средства реализации» остаётся рабочей идеей;
✅ Какие элементы описания нужно переосмыслить для ИИ;
✅ Практические шаблоны и примеры документирования ИИ‑систем, которые можно внедрить сразу.
Смотреть видео: https://vkvideo.ru/video-223804668_456239224
