Skip to content

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

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

docs(web): use active doc version for install manifest link#1074
mnencia wants to merge 5 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.

@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
@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
@dosubot dosubot Bot added size:L This PR changes 100-499 lines, ignoring generated files. and removed size:M This PR changes 30-99 lines, ignoring generated files. labels Aug 27, 2026
@mnencia
mnencia force-pushed the dev/docs-install-manifest-version branch from 3763571 to f9e59c5 Compare August 27, 2026 16:34
mnencia and others added 5 commits August 28, 2026 10:55
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>
Its '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>
The installation page said "the manifest for the latest release"
everywhere, even on older versioned docs and on the unreleased Dev
docs. Show the actual version instead (or "the latest development
snapshot from the main branch" on Dev docs).

The "Testing the latest development snapshot" section now explains,
on Dev docs, that the command above already installs that snapshot,
instead of duplicating it.

Signed-off-by: Danish <danish.khan@enterprisedb.com>
@mnencia
mnencia force-pushed the dev/docs-install-manifest-version branch 2 times, most recently from 6ef00ff to d1c3639 Compare August 28, 2026 09:15
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:L This PR changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants