Document that page-component-title should not depend on component-version
EDIT: this was a misunderstanding, and the result is documentation should be improved.
Original misunderstanding:.... Scenario: One component, two versions v2 and v1. V2 has no visible content (in my example, it has a _index.adoc file that is included elsewhere) On the pages of v1, the component title is wrong for:
- the asciidoctor rendered partial page
- the top of the navigation tree (also rendered by asciidoctor from generated source, IIUC)
- the component explorer
However, the breadcrumbs show the correct component title.
At the moment, this scenario is unreasonable, because the component-versions with no content are displayed in the component explorer and selecting them results in a 404 error. However, it needs to be fixed for #503.
There's a sample demonstrating the problem at
- https://gitlab.com/djencks/simple-examples
- branch issue-503-hidden-versions
- example multiple-components/hidden-empty-versions
- after building, the start page is at multiple-components/hidden-empty-versions/build/site/component1/v1/index.html
The antora version at https://gitlab.com/djencks/antora in the issue-503-hide-empty-component-versions branch produces a more reasonable version of the example, with no-content branches and components hidden from the component explorer.