Автоматизируем документацию: чем хороши генераторы статических сайтов и как встроить их в процесс

Есть много способов предоставить документацию пользователю. Но практически всегда это доступный в интернете или внутренней сети веб-сайт с разделами, страницами и контентом.Наполнять такой сайт и следить за его состоянием — отдельная задача, зачастую связанная с генерацией каких-то данных и отслеживанием состояния. Такими задачами могут заниматься уже не технические писатели, а DocOps-инженеры, в сферу деятельности которых входят создание и подготовка пайплайнов для CI/CD-систем (систем автоматической сборки и доставки приложений).Одним из инструментов, которые помогают автоматизировать создание документации являются Jekyll или Hugo. В докладе в общих чертах рассматриваются идеология статической генерации сайтов, принципы работы генераторов и возможности по интеграции таких систем в CI/СD для автоматизации процесса.