What’s a Component Version?

A component version represents a discrete version of the documentation for a project, product, library, service, training course, etc. Antora looks for sources files associated with the same component name and component version in multiple content sources and collates them together to make a component version. The component version descriptor (named antora.yml) declares each component version and marks the source files that belong to it. It also supplies additional configuration for that component version.

A component—more formally a documentation component or simply docs component—refers to all of the component versions that share the same component name. A component is never declared directly. Instead, it gets created by having at least one component version.