Analog Devices Doctools
Doctools: Enterprise scale docs-as-code
Analog Devices Inc. documentation extensions, themes, and tools for multiple repositories in the organization.
Read the Documentation guidelines for writing conventions and the directives and roles provided by Doctools. See the Command line interface for the command line tools used to preview, build, and combine documentation.
Documentation
-
How to do a release install, and a development install of Doctools.
-
What belongs to this tool and core principles.
-
The documentation is written in reStructuredText (reST) and built with Sphinx and Doctools for HTML and PDF output. For installation and build commands, see install and cli.
-
"Serve" launches a live doc server, "custom doc" generates a custom html or pdf, with only the content that matters, and "aggregate" builds all docs at once.
-
Doctools is developed to work offline, in a local server as a rolling release (e.g., on GitHub Pages) and versioned in a dedicated server with orchestration.
-
Continuous deployment pipeline and instructions to set up a self-hosted GitHub Actions runner using Podman or Docker and systemd without root.
-
A Sphinx theme called harmonic (formerly cosmic) is available and is based on ADI’s harmonic design language.