TechWriter Days

Когда компания растет и продуктов становится много, интерфейсы начинают неумолимо «разъезжаться». Кнопки разной формы, хаос в шрифтах, несогласованные тексты... Как сохранить целостность бренда и не сойти с ума? Команда фронтенда нашла решение — они инициировали создание единой дизайн-системы и общего UI-кита, который стал «источником истины» для всех: от макетов в Figma до готового кода в продакшене. На TechWriter Days 3 Антон Жуков поделился реальным кейсом и рассказал, как построить сквозные процессы и вовлечь в работу всю команду. В докладе: ✅ От макета до продакшена: как выстроить бесшовную навигацию компонентов из Figma прямо в рабочий код. ✅Работа с текстом и локализацией: как организовать процессы перевода и адаптации контента внутри дизайн-системы. ✅Командная синергия: как объединить вокруг дизайнеров, разработчиков, аналитиков, техписателей и продакт-менеджеров. ✅База знаний: как документировать компоненты и зачем вести внутренний фронтенд-блог, который помогает быстро онбордить новичков и масштабировать знания. Смотреть видео: https://vkvideo.ru/video-223804668_456239246

Добрый день! Добрались руки и глаза до этого замечательного доклада. Но вот незадача: по QR-коду иду на Дополнительные материалы: https://disk.yandex.ru/i/beVkD-S3Cq8DlQ Но там docx, который в Яндекс-диске как-то очень странно работает и по ссылкам перейти нельзя. И скачать файл нельзя 😢😢😢 А очень хотелось посмотреть Гипербатон 1 и 2 и почитать американских коллег. Пытаюсь уйти в чат Ольги Коршуновой по QR-коду в презентации... Не считывается... 🤷‍♂😢 Замкнутый круг! Коллеги, есть у кого нормальные ссылки на эти материалы, поделитесь, плиз, буду очень признателен! 🤓😉

Спасибо огромное ! 🤓👍🤝

Доклад отличный! 🤓😉

И честный! 🤝

Увы, подтверждаю 😢😢😢

Благодарю! 🤝👍

Ольга, большое спасибо!

Можно ли собирать пакет документации в один клик? Оказывается, иногда можно! На TechWriter Days 3 Никита Осокин показал, как с помощью Jinja2, Markdown и LLM удалось автоматизировать генерацию техдоков так, чтобы избавить себя от рутины и нескончаемой копи-пасты. В докладе: ✅ Автогенерация форм слов (падежи, наклонения и др.) для обеспечения согласованности. ✅ Автоматическое форматирование документов при генерации DOC-файлов (прощай, копи-паст). ✅ Работа с LLM в режиме Copilot через MD-редактор. ✅ Промпты через JSON/YAML структуры для генерации качественных ответов от LLM. ✅ Технические и экономические ограничения в применении LLM («экономика токенов»). Смотреть видео: https://vkvideo.ru/video-223804668_456239235

📌 Маленькая команда — не повод жить на устных договорённостях! На TechWriter Days 3 Юлия Тимофеева показала, как простые инструкции в команде: ⚡️ сэкономили часы на объяснениях ⚡️ уменьшили количество повторяющихся багов ⚡️ ускорили онбординг новичков и работу техподдержки В докладе: ✅ какие документы действительно нужны ✅ как мотивировать коллег писать инструкции и пользоваться ими ✅ простые принципы внедрения документирования, которые не требуют месячных воркшопов Смотреть видео: https://vkvideo.ru/video-223804668_456239244

ГОСТ 34 — надёжный инструмент для структурирования информации об автоматизированных системах. Он хорош там, где поведение системы детерминировано и предсказуемо. Но что делать, если система на базе ИИ по своей природе недетерминирована? Прямолинейное применение требований ГОСТ 34 к интеллектуальным системам часто даёт формально корректный, но практически бесполезный результат. Нужен ли совсем новый стандарт — или можно сохранить общий подход, адаптировав способы описания и документирования? На TechWriter Days 3 Михаил Острогорский и Александр Лебедев разобрали: ✅ В чём именно конфликт между ГОСТ 34 и ИИ‑системами; ✅ Как разделение «поведение системы — средства реализации» остаётся рабочей идеей; ✅ Какие элементы описания нужно переосмыслить для ИИ; ✅ Практические шаблоны и примеры документирования ИИ‑систем, которые можно внедрить сразу. Смотреть видео: https://vkvideo.ru/video-223804668_456239224

Как вовремя информировать об обновлениях, фикcах и изменениях? На TechWriter Days 3 Татьяна Кириллова рассказала, как команда из Cloud.ru перешла на автоматическую генерацию changelog по истории коммитов в GitLab и выстроила рабочий пайплайн, который объединил разработчиков и технического писателя. Это не только сократило ручную рутину, но и привело к неожиданным бонусам для процесса разработки. Разберём: ✅ почему коммиты для changelog'а оказались надежнее задач; ✅ какие инструменты GitLab и скрипты использовали для парсинга и сборки текста changelog'а; ✅ как стандартизировать сообщения коммитов, чтобы их можно было сразу превращать в понятный текст; ✅ как наладить взаимодействие dev ↔️ tech writer: от шаблона коммита до финальной вёрстки; Смотреть видео: https://vkvideo.ru/video-223804668_456239249

Не так давно команда VK WorkSpace приняла смелое решение: мигрировать всю документацию с одного генератора статических сайтов MkDocs на другой Hugo. Что из этого вышло? Какие подводные камни обнаружились? И какой инструмент на самом деле лучше подходит для вас? На TechWriter Days 3 Никита Груздев поделился реальным опытом этой миграции. В докладе: ✅ Battle of the Generators: Сравним MkDocs и Hugo по ключевым параметрам: от простоты развертывания до возможностей кастомизации. ✅ Enterprise vs Стартап: Разберем, какой генератор лучше подходит для больших корпоративных продуктов, а какой — для динамичных стартапов. ✅ Развитие для техписателя: Узнаем, где у технического писателя больше возможностей для роста портала документации и развития личных навыков. ✅ Подводные камни: Реальные факапы и неочевидные решения, с которыми столкнулась команда в процессе миграции. ✅ Сыграем в БИНГО! Это поможет нам в интерактивном формате сравнить технические возможности обоих генераторов и закрепить знания. Смотреть видео: https://vkvideo.ru/video-223804668_456239251

Приветы, а напомните, где посмотреть записи с TWD3? Помню, что была некая отдельная платформа, ваще не вспомню какая Т_Т

🚚 Как перевезти всю документацию Яндекса с DITA на YFM и Diplodoc (и выжить)? Переезд с одного стека на другой — это всегда сложный процесс. А когда речь идет об огромном объеме документации в экосистеме Яндекса — это масштабный проект, затрагивающий десятки команд. Длительное время документация Яндекса поддерживалась в формате DITA. Но за последние несколько лет её полностью перевезли на новые технологии: разметку YFM (Yandex Flavored Markdown) и платформу Diplodoc. На TechWriter Days 3 Эльвира Гильманова и Михаил Кошкин детально разобрали методологию проведения таких глобальных изменений и показали процесс изнутри — с двух разных ракурсов! Смотреть видео: https://vkvideo.ru/video-223804668_456239234

🚀 TechWriter Days 3: полный видео-обзор смотрите в ВК Мы собрали самые классные моменты двух дней конференции, искренние эмоции участников и эксклюзивные фрагменты интервью💥 Погрузитесь в атмосферу сообщества техписателей — ищите себя и коллег в кадре и проживите эти два дня снова! Напоминаем, что TechWriter Days 4 состоится 19-20 марта в Москве и онлайн-формате! Становись участником или партнером☺️ ⚡️билеты ⚡️афиша ⚡️скидки ⚡️видео