Skip to main content
✱ Инструменты

Опыт внедрения Docs as a Code в продуктовую команду с нуля: от идеи, до проверенного workflow

Analyst Days #20
2025-05-23 11:00
Секция A
40 мин
Просто
Доклад был на прошедшей конференции Analyst Days #20 и сейчас находится в архиве.

На Analyst Days прошел доклад Ярослава Госудаскина, посвященный внедрению Docs as Code в продуктовые команды с нуля. Ярослав поделился уникальным опытом перехода от идеи к проверенному рабочему процессу. В своей лекции он рассказал, как компания ASRA справилась с ростом числа клиентов и сложностью запросов, которые сопровождали этот процесс.

Доклад будет особенно полезен руководителям, которые задумываются о том, нужна ли их команде концепция документации как кода. Ярослав подробно объяснил, что такое Docs as Code, какие процессы разработаны для поддержки этой концепции, с какими трудностями может столкнуться команда во время миграции, и, самое главное, сколько это стоит в человекоресурсах. Он также рассказал, почему выбрал tools и как организовал единый рабочий процесс.

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

B2B продукты IT-компаний зачастую требуют наличия документации, чтобы специалисты заказчика могли работать с продуктом. ALD Pro — один из таких продуктов.
Цель доклада — рассказать, как наша команда за 3 месяца конвертировала разрозненные материалы на 1000+ листов А4 в унифицированную, автоматизированную систему на основе концепции Docs as a Code. Основная работа заключалась в переводе текстовых, графических, табличных и прочих материалов в формат rST с хранением в Git VCS, и реализации автоматизированной сборки готовых PDF-документов и Справочного центра (для просмотра в веб-браузере). Мы столкнулись с нетривиальными вызовами: обучение коллег для использования rST и Git, доработка ГОСТ-стилей оформления PDF документов для сертифицированного исполнения, проработка workflow для техписателей и аналитиков, и др.
В докладе расскажем, какие возникли задачи, и как мы их решили, что не получилось, сколько человеко-ресурсов потратили и кому делегировать данную работу в условиях сжатых сроков.

Доступно только после покупки 😊

Другие доклады Analyst Days #20