asciidoctor/asciidoctor-browser-extension

docs.asciidoctor.org/browser-extension shows Page not found, instead of docs.asciidoctor.org/browser-extension/latest/

sturtison opened this issue · 3 comments

The README.adoc directs the user to the user manual https://docs.asciidoctor.org/browser-extension

Expected behaviour: Opens the latest page for the browser extension.

Observed behaviour: Displays page not found in content pane with the docs menu on the left.
NOTE: This is the same for all docs, eg https://docs.asciidoctor.org/asciidoc

Solution: Do we change the URL in README.adoc, or do something with the docs overall?

If this is a versionless project from the user's perspective, what I recommend is setting the version to ~ in antora.yml to indicate there's only a single version and that the version value is not relevant. In this case, the version number will not be shown in the docs and the URL you cited will work.

If you want to retain the versioning, then the correct URL is https://docs.asciidoctor.org/browser-extension/latest/ (because a version must be specified).

If this is a versionless project from the user's perspective, what I recommend is setting the version to ~ in antora.yml to indicate there's only a single version and that the version value is not relevant. In this case, the version number will not be shown in the docs and the URL you cited will work.

Versionless seems good 👍🏻

Fixed!