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

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

 
* [https://2018.secrus.org/program/submitted-presentations/developing-documentation/ Talks page on SECR site]
<!-- <blockquote>[©]</blockquote> -->

{{vklink|1234}}                                          
{{fblink|2180595238860152}}                                          
<references/>





<!-- topub -->

[[Категория:SECR-2018]]
[[Категория:Документирование]]
{{stats|disqus_comments=0|refresh_time=2018-11-12T18:44:4426T19:35:11.834237633099|vimeo_plays=319|youtube_plays=0}}

Версия 16:35, 26 ноября 2018

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

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

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

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

Видео

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

Презентация

Разработка документации — от постановки до деплоя (Екатерина Носкова, 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:39   Comments:0

Источник — «https://0x1.tv/index.php?title=Разработка_документации_—_от_постановки_до_деплоя_(Екатерина_Носкова,_SECR-2018)&oldid=103907»