Skip to content

Fix version-pinning examples on /packages to match the repo-served version - #124

Merged
guanzhousongmicrosoft merged 1 commit into
documentdb:mainfrom
GuanzhouSong:packages-repo-version-examples
Aug 3, 2026
Merged

Fix version-pinning examples on /packages to match the repo-served version#124
guanzhousongmicrosoft merged 1 commit into
documentdb:mainfrom
GuanzhouSong:packages-repo-version-examples

Conversation

@GuanzhouSong

@GuanzhouSong GuanzhouSong commented Aug 2, 2026

Copy link
Copy Markdown
Contributor

Summary

The version-pinning section on /packages shows 0.114-0 / 0.114.0-1.el9 as example output of apt-cache madison / dnf --showduplicates list, but the live APT/RPM repositories at documentdb.io currently serve 0.113-0 / 0.113.0-1.el9 (confirmed against the repo package indexes and documentdb.io/packages/release-info.json). Users following the pinning instructions would look for a version string the list commands never show.

  • Split the single version constant into a latest-GitHub-release version (0.114-0, still used for the direct .deb/.rpm download filename examples, which correctly reference GitHub Release assets) and a repo-served version (0.113-0, now used for the pinning examples).
  • Add a note that the package repositories can lag the newest GitHub release, so users should pin to a version the list command actually shows.

Also verified while auditing against released versions (no changes needed):

  • The Debian 11 caveat is still accurate: a deb11 PG 18 package now exists in the APT repo, but it depends on postgresql-18-postgis-3, which bullseye-pgdg still does not ship, so it cannot install.
  • The "no gateway package published" statements still hold for v0.114-0 (release assets are extension-only).
  • The package catalog matrix matches the v0.114-0 release assets exactly.

Test plan

  • tsc --noEmit passes
  • eslint app/packages/page.tsx passes
  • npm test — 102/102 pass

The version-pinning section on /packages used the latest GitHub release
(0.114-0) as the example output of apt-cache madison / dnf list, but the
APT and RPM repositories currently serve 0.113-0. Split the constants so
the direct-download examples keep tracking the latest GitHub release
while the pinning examples show the repo-served version, and note that
the package repositories can lag GitHub Releases.
@GuanzhouSong
GuanzhouSong force-pushed the packages-repo-version-examples branch from 2860ef5 to 55203bb Compare August 3, 2026 11:58
@guanzhousongmicrosoft
guanzhousongmicrosoft merged commit 5b2730f into documentdb:main Aug 3, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants