Other automation options
Treating documentation as code means you can automate a great deal of things. Here are two more ideas that I have tried.
Converting file formats
When anyone asks, “How do I convert format x to format y?” in the open source and/or docs-as-code world, the answer is almost always pandoc (https://pandoc.org/). It’s a venerable tool with decades of history and can convert dozens of formats between each other, with a dizzying amount of configuration options. It’s a relatively large installation, and if you want to convert to PDF, it also depends on LaTeX (https://www.latex-project.org/), another venerable and large dependency. This means it’s not always optimal when run in CI systems, but it’s not impossible. Also, bear in mind that if you want to use it, convert pages of documentation into formats more suitable for other not-so-technical teams such as marketing or sales; it’s possible with pandoc, but you need...
