From 03c1b9f22e97db642793f9bb0451d331585ccbd5 Mon Sep 17 00:00:00 2001
From: Guanzhou Song <guanzhou.song@gmail.com>
Date: Mon, 24 Aug 2026 19:14:11 -0400
Subject: [PATCH] Make the Download page agree with the repository

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
---
 app/packages/page.tsx | 47 ++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 42 insertions(+), 5 deletions(-)

diff --git a/app/packages/page.tsx b/app/packages/page.tsx
index ee63af6..76ae72d 100644
--- a/app/packages/page.tsx
+++ b/app/packages/page.tsx
@@ -438,52 +438,89 @@ export default function PackagesPage() {
                     <th className="px-3 py-2 font-semibold">Architectures</th>
                     <th className="px-3 py-2 font-semibold">PostgreSQL versions</th>
                     <th className="px-3 py-2 font-semibold">Package naming</th>
+                    <th className="px-3 py-2 font-semibold">Version served</th>
                   </tr>
                 </thead>
                 <tbody className="text-gray-300">
                   <tr className="border-b border-neutral-800">
                     <td className="px-3 py-3 font-semibold text-blue-300">APT</td>
-                    <td className="px-3 py-3">Ubuntu 24.04 (full stack)</td>
+                    <td className="px-3 py-3">Ubuntu 24.04 (full stack) · <code className="text-gray-200">ubuntu24</code></td>
                     <td className="px-3 py-3">amd64, arm64</td>
                     <td className="px-3 py-3">17, 18</td>
                     <td className="px-3 py-3">
                       <code className="text-gray-200">documentdb-&lt;pg&gt;</code>
                     </td>
+                    <td className="px-3 py-3">0.116</td>
                   </tr>
                   <tr className="border-b border-neutral-800">
                     <td className="px-3 py-3 font-semibold text-blue-300">APT</td>
-                    <td className="px-3 py-3">Ubuntu 22.04, Debian 11/12/13 (extension only)</td>
+                    <td className="px-3 py-3">Ubuntu 24.04 (extension only) · <code className="text-gray-200">ubuntu24</code></td>
+                    <td className="px-3 py-3">amd64, arm64</td>
+                    <td className="px-3 py-3">16</td>
+                    <td className="px-3 py-3">
+                      <code className="text-gray-200">postgresql-16-documentdb</code>
+                    </td>
+                    <td className="px-3 py-3">0.114</td>
+                  </tr>
+                  <tr className="border-b border-neutral-800">
+                    <td className="px-3 py-3 font-semibold text-blue-300">APT</td>
+                    <td className="px-3 py-3">Ubuntu 22.04 · <code className="text-gray-200">ubuntu22</code><br />Debian 11/12/13 · <code className="text-gray-200">deb11</code> / <code className="text-gray-200">deb12</code> / <code className="text-gray-200">deb13</code><br />(extension only)</td>
                     <td className="px-3 py-3">amd64, arm64</td>
                     <td className="px-3 py-3">16, 17, 18 (Debian 11: 16, 17)</td>
                     <td className="px-3 py-3">
                       <code className="text-gray-200">postgresql-&lt;pg&gt;-documentdb</code>
                     </td>
+                    <td className="px-3 py-3">0.114</td>
                   </tr>
                   <tr className="border-b border-neutral-800">
                     <td className="px-3 py-3 font-semibold text-red-300">RPM</td>
-                    <td className="px-3 py-3">RHEL-compatible 9 (full stack)</td>
+                    <td className="px-3 py-3">RHEL-compatible 9 (full stack) · <code className="text-gray-200">rpm/rhel9</code></td>
                     <td className="px-3 py-3">x86_64, aarch64</td>
                     <td className="px-3 py-3">17, 18</td>
                     <td className="px-3 py-3">
                       <code className="text-gray-200">documentdb-&lt;pg&gt;</code>
                     </td>
+                    <td className="px-3 py-3">0.116</td>
+                  </tr>
+                  <tr className="border-b border-neutral-800">
+                    <td className="px-3 py-3 font-semibold text-red-300">RPM</td>
+                    <td className="px-3 py-3">RHEL-compatible 9 (extension only) · <code className="text-gray-200">rpm/rhel9</code></td>
+                    <td className="px-3 py-3">x86_64, aarch64</td>
+                    <td className="px-3 py-3">16</td>
+                    <td className="px-3 py-3">
+                      <code className="text-gray-200">postgresql16-documentdb</code>
+                    </td>
+                    <td className="px-3 py-3">0.114</td>
                   </tr>
                   <tr>
                     <td className="px-3 py-3 font-semibold text-red-300">RPM</td>
                     <td className="px-3 py-3">
-                       RHEL-compatible 8 (extension only, tested on Rocky Linux)
+                       RHEL-compatible 8 (extension only, tested on Rocky Linux) · <code className="text-gray-200">rpm/rhel8</code>
                     </td>
                     <td className="px-3 py-3">x86_64, aarch64</td>
                     <td className="px-3 py-3">16, 17, 18</td>
                     <td className="px-3 py-3">
                       <code className="text-gray-200">postgresql&lt;pg&gt;-documentdb</code>
                     </td>
+                    <td className="px-3 py-3">0.114</td>
                   </tr>
                 </tbody>
               </table>
+              <p className="mt-3 text-xs text-amber-300">
+                <strong>PostgreSQL 16 is extension-only on every distribution</strong>, including
+                Ubuntu 24.04 and RHEL 9. There is no <code>documentdb-16</code> — requesting it
+                fails with <em>&quot;has no installation candidate&quot;</em> (APT) or{" "}
+                <em>&quot;No match for argument&quot;</em> (DNF). On PostgreSQL 16 you get the
+                extension alone, at 0.114: no gateway, no <code>documentdb-setup</code>, no
+                systemd units. The packaged stack requires PostgreSQL 17 or 18.
+              </p>
               <p className="mt-3 text-xs text-gray-400">
                 Use Package Finder above to generate the exact command for your selected
-                target instead of scanning all combinations manually.
+                target, or see the{" "}
+                <Link href="/docs/getting-started/packages" className="text-blue-400 hover:text-blue-300">
+                  Linux Packages Quick Start
+                </Link>{" "}
+                for every repository component and install command written out in full.
               </p>
               <p className="mt-2 text-xs text-gray-500">
                 Debian 13 packages are available in the <code>deb13</code> APT component and