Make the Download page agree with the repository - #153
Merged
guanzhousongmicrosoft merged 1 commit intoAug 24, 2026
Merged
Conversation
A confirmation round of cold installs found the docs guide now matches reality exactly -- one tester predicted the PostgreSQL 16 outcome from the page and hit it verbatim, including the literal `has no installation candidate` error, and another installed on four distributions without guessing a single value. The remaining gap is that /packages, the page people actually land on, disagreed with the guide. Its catalog omitted PostgreSQL 16 on Ubuntu 24.04 and RHEL 9 entirely, listing 16 only under the extension-only distributions. That reads as ""PostgreSQL 16 is not available on Ubuntu 24.04"", when in fact `postgresql-16-documentdb` installs there quite happily -- as the extension alone, at 0.114 rather than 0.116. A reader of only that page would conclude they had to leave Ubuntu 24.04 to use PostgreSQL 16. Add the rows, add a version-served column so the 0.114 and 0.116 tiers are visible at a glance, and carry the no-`documentdb-16` warning onto the page instead of leaving it in the guide. The catalog also named only the `deb13` repository component, so a terminal user who never reached the guide had no way to know the component for their distribution and no JavaScript to generate it. Each row now carries its component, and the footnote links to the guide for the full commands. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 8df9084a-ccaf-432c-b015-2ccd8893a9d8
guanzhousongmicrosoft
approved these changes
Aug 24, 2026
guanzhousongmicrosoft
left a comment
guanzhousongmicrosoft
left a comment
Contributor
There was a problem hiding this comment.
Confirmed by two cold terminal-only install runs: the docs guide now matches reality exactly, and this brings the Download page into agreement with it. Adds the missing PostgreSQL 16 rows, the version-served column, the documentdb-16 warning, and every repository component. CI green.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
A confirmation round of cold installs (terminal-only testers, live site, real repository, Docker) found the docs guide now matches reality exactly:
0.114-0, the absentdocumentdb-setup, and even the literalhas no installation candidateerror fordocumentdb-16.The remaining gap is that
/packages— the page people land on — disagreed with the guide.What was wrong
1. The catalog said PostgreSQL 16 was unavailable on the paved road. It listed 16 only under the extension-only distributions, so Ubuntu 24.04 and RHEL 9 appeared to be 17/18-only. In reality
postgresql-16-documentdbinstalls there fine — as the extension alone, at 0.114 rather than 0.116. A reader of only this page would conclude they had to leave Ubuntu 24.04 to use PostgreSQL 16.2. No version was shown, while every example string on the page reads 0.116 — so the 0.114 tiers were invisible.
3. Only the
deb13component was named. A terminal user who never reached the guide had no component for their distribution and no JavaScript to generate one.Changes
documentdb-16warning onto the page, with both package managers' error text.ubuntu24,ubuntu22,deb11/deb12/deb13,rpm/rhel9,rpm/rhel8).Validation
130 tests,
tsc --noEmit,eslintandnext buildall pass. Every added string verified present in the rendered page, including all seven component names.