Antora

Antora is an open source documentation site generator for AsciiDoc content. It can pull docs from one or many Git repositories and build them into a single site.

A playbook file tells Antora which repositories and branches to use and which UI to apply. The Antora CLI reads the playbook and generates the site, including versioned documentation built from Git branches. Teams can keep docs close to the code they describe while still publishing one unified site.

• Collect docs from many Git repositories
• Publish versioned docs from Git branches
• Configure sites with a playbook file
• Apply a custom UI to the generated site
• Publish to local, test or production environments

Technical writers and documentation teams who write in AsciiDoc. Engineering groups that keep docs next to code use it for docs-as-code workflows, and teams with several products often use it to combine their documentation into one place.

Antora is open source and free to use. It runs as a command-line tool on Node.js, so it needs a machine with that runtime installed. Setup takes some learning, especially for playbooks and multi-repo layouts, but the documentation and community examples help with the first site.