Разработка документации — от постановки до деплоя (Екатерина Носкова, SECR-2018)

Материал из 0x1.tv

Докладчик
Екатерина Носкова.jpg
Екатерина Носкова

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

Для решения задач документирования мы используем генератор статических сайтов Hugo (markdown + Go templates + YAML) и Gitlab CI/CD. Статические страницы документации собираются из шаблонов и публикуются в HTML на 6 языках. Каждый шаблон описывает логику сборки страницы в соответствии с типом контента. Для локализации документации используется подход Continuous localization, который реализован через связку Gitlab CI/CD + Serge + Smartcat.

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

Видео

on youtube

Посмотрели доклад? Понравился? Напишите комментарий! Не согласны? Тем более напишите.

Презентация

Разработка документации — от постановки до деплоя (Екатерина Носкова, SECR-2018).pdf Разработка документации — от постановки до деплоя (Екатерина Носкова, SECR-2018).pdf Разработка документации — от постановки до деплоя (Екатерина Носкова, SECR-2018).pdf Разработка документации — от постановки до деплоя (Екатерина Носкова, SECR-2018).pdf Разработка документации — от постановки до деплоя (Екатерина Носкова, SECR-2018).pdf Разработка документации — от постановки до деплоя (Екатерина Носкова, SECR-2018).pdf Разработка документации — от постановки до деплоя (Екатерина Носкова, SECR-2018).pdf Разработка документации — от постановки до деплоя (Екатерина Носкова, SECR-2018).pdf Разработка документации — от постановки до деплоя (Екатерина Носкова, SECR-2018).pdf Разработка документации — от постановки до деплоя (Екатерина Носкова, SECR-2018).pdf Разработка документации — от постановки до деплоя (Екатерина Носкова, SECR-2018).pdf Разработка документации — от постановки до деплоя (Екатерина Носкова, SECR-2018).pdf Разработка документации — от постановки до деплоя (Екатерина Носкова, SECR-2018).pdf Разработка документации — от постановки до деплоя (Екатерина Носкова, SECR-2018).pdf Разработка документации — от постановки до деплоя (Екатерина Носкова, SECR-2018).pdf Разработка документации — от постановки до деплоя (Екатерина Носкова, SECR-2018).pdf Разработка документации — от постановки до деплоя (Екатерина Носкова, SECR-2018).pdf Разработка документации — от постановки до деплоя (Екатерина Носкова, SECR-2018).pdf Разработка документации — от постановки до деплоя (Екатерина Носкова, SECR-2018).pdf Разработка документации — от постановки до деплоя (Екатерина Носкова, SECR-2018).pdf Разработка документации — от постановки до деплоя (Екатерина Носкова, SECR-2018).pdf
Разработка документации — от постановки до деплоя (Екатерина Носкова, SECR-2018)!.jpg

Примечания и ссылки


Plays:186   Comments:0