Troubleshooting Antora build errors

This probably means that there are two branches of the same repository defined in the Antora playbook, that have the same version set. They both supply a nav.adoc file for the same component and version, and Antora doesn’t know which one to pick. Make sure that the release branches have the correct version set in their antora.yml files and also make sure that the main branch is still set to nightly.

If the page containing the xref is also in the home component, do not include the component name in the xref. Read the xref documentation. Creating a reference to a page and specifying a component without a version means that the link is pointing to the latest version. This is usually not what you want! Omitting the component entirely will instead link to the target page within the same version as the page resides in.

Familiarize yourself with the xref documentation which explains the syntax in great detail. Unfortunately the xref syntax is a common place to make mistakes, and it is easy to accidently link to the wrong place.