Skip to content

docs(web): use active doc version for install manifest link - #1074

Open
mnencia wants to merge 4 commits into
mainfrom
dev/docs-install-manifest-version
Open

docs(web): use active doc version for install manifest link#1074
mnencia wants to merge 4 commits into
mainfrom
dev/docs-install-manifest-version

Conversation

@mnencia

@mnencia mnencia commented Aug 25, 2026

Copy link
Copy Markdown
Member

The install snippet always linked to the manifest of the latest released version, regardless of which versioned docs page it was rendered on. Viewing the 0.13.0 installation page therefore pointed at the 0.14.0 manifest.

Build the manifest URL from the active doc version directly: each versioned page links its own release tag, and the unreleased "current" docs link the manifest built off main instead of a (nonexistent) release tag.

The install snippet always linked to the manifest of the latest
released version, regardless of which versioned docs page it was
rendered on. Viewing the 0.13.0 installation page therefore pointed
at the 0.14.0 manifest.

Fall back to the latest released version only when there is no
active version, or the active version is the unreleased "current"
docs.

Signed-off-by: Marco Nenciarini <marco.nenciarini@enterprisedb.com>
Docusaurus already exposes the latest released version via
useLatestVersion (backed by GlobalVersion.isLast), making the manual
filter and numeric-string sort redundant.

Signed-off-by: Marco Nenciarini <marco.nenciarini@enterprisedb.com>
The unversioned "current" docs describe unreleased functionality, so
a tagged release manifest doesn't make sense there. Install from the
manifest built off main instead.

Signed-off-by: Marco Nenciarini <marco.nenciarini@enterprisedb.com>
@mnencia
mnencia requested a review from a team as a code owner August 25, 2026 10:24
@dosubot dosubot Bot added size:M This PR changes 30-99 lines, ignoring generated files. documentation Improvements or additions to documentation labels Aug 25, 2026
useCurrentVersion's 'latestReleased' branch had no remaining caller
after the previous commit, and InstallationSnippet was calling
useActiveVersion twice (once directly, once through the hook) to
re-run the same check. Build the manifest URL straight from the
active version and drop hooks/versions.ts entirely.

Signed-off-by: Marco Nenciarini <marco.nenciarini@enterprisedb.com>
@mnencia
mnencia force-pushed the dev/docs-install-manifest-version branch from 807babf to 8a9aae1 Compare August 25, 2026 12:21
@mnencia mnencia changed the title fix(web): use active doc version for install manifest link docs(web): use active doc version for install manifest link Aug 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size:M This PR changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant