Не так давно команда VK WorkSpace приняла смелое решение: мигрировать всю документацию с одного генератора статических сайтов MkDocs на другой Hugo. Что из этого вышло? Какие подводные камни обнаружились? И какой инструмент на самом деле лучше подходит для вас? На TechWriter Days 3 Никита Груздев поделился реальным опытом этой миграции. В докладе: ✅ Battle of the Generators: Сравним MkDocs и Hugo по ключевым параметрам: от простоты развертывания до возможностей кастомизации. ✅ Enterprise vs Стартап: Разберем, какой генератор лучше подходит для больших корпоративных продуктов, а какой — для динамичных стартапов. ✅ Развитие для техписателя: Узнаем, где у технического писателя больше возможностей для роста портала документации и развития личных навыков. ✅ Подводные камни: Реальные факапы и неочевидные решения, с которыми столкнулась команда в процессе миграции. ✅ Сыграем в БИНГО! Это поможет нам в интерактивном формате сравнить технические возможности обоих генераторов и закрепить знания. Смотреть видео: https://vkvideo.ru/video-223804668_456239251
Международная конференция по технической документации techwriterdays.ru 📍19-20 марта 2027 Москва 👥 Чат для нетворкинга: @twdays ВК vk.com/techwriterdays Ютуб youtube.com/@itconf
Статистика канала
Число подписчиков
Число постов
Последние посты
🚀 Друзья, в следующем месяце стоимость билетов на 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
Канал «TechWriter Days Channel» подключен к сервису MaxGate. Контент автоматически синхронизируется между Telegram и мессенджером MAX.
Подключить кросспостингДругие каналы в категории «Технологии»
О канале «TechWriter Days Channel»
«TechWriter Days Channel» - канал из категории «Технологии», подключенный к сервису кросспостинга MaxGate. Публикации канала синхронизируются между Telegram и мессенджером MAX, а на этой странице собраны ссылки на обе версии канала.
Сейчас у канала 755 подписчиков суммарно в Telegram и MAX. За последние 28 дней в истории MaxGate учтено 6 публикаций, поэтому перед подпиской можно оценить не только размер аудитории, но и регулярность обновлений.
Чтобы подписаться, используйте кнопки «Открыть в MAX» и «Открыть в Telegram» в верхней части страницы. У отдельных постов ссылка может быть доступна в обоих мессенджерах или только в одном из них, если MaxGate получил такой URL из истории обработки.