MIME-Version: 1.0
References: <0781CAB9-187C-42C6-BB66-F82F66591F92@yesql.se>
 <CAApHDvpOXAOPEhXRnWimyWmuRf+gN=yx22AoP_WM3aZ0M=n6Vw@mail.gmail.com>
 <13E61A7B-D329-4187-B351-4698912255FD@yesql.se>
 <82C35F30-1559-4C7F-9E27-1E3177F457A2@yesql.se>
In-Reply-To: <82C35F30-1559-4C7F-9E27-1E3177F457A2@yesql.se>
From: David Rowley <dgrowleyml@gmail.com>
Date: Wed, 22 Oct 2025 12:56:49 +1300
Message-ID: 
 <CAApHDvok66dPgYmRiwopy8+8dDPGQxD-bdmFNFj5Unve1qd0Zg@mail.gmail.com>
Subject: Re: Typos in the featurematrix
To: Daniel Gustafsson <daniel@yesql.se>
Cc: pgsql-www@lists.postgresql.org, Magnus Hagander <magnus@hagander.net>
Content-Type: text/plain; charset="UTF-8"
Archived-At: 
 <https://www.postgresql.org/message-id/CAApHDvok66dPgYmRiwopy8%2B8dDPGQxD-bdmFNFj5Unve1qd0Zg%40mail.gmail.com>
Precedence: bulk

On Wed, 22 Oct 2025 at 01:09, Daniel Gustafsson <daniel@yesql.se> wrote:
> The featurematrix was a rabbithole that went deep, looking closer I realized
> that links were using a variety of target versions: /current/, /devel/, or the
> version which was current at the time of adding.  This means that for old
> features we we still linking to the 9.x version of the docs, which clearly
> isn't helpful to our users.  We also had quite a few /static/ links which 301
> redirects since we don't have that level anymore.
>
> On top of that, a few links in the descriptions were not markdown encoded and
> thus rendered as plain text.
>
> The attached v3 fixes these in 0003 and 0004.

* The new link seems dead. Looks like it should be
https://www.postgresql.org/docs/current/brin.html#BRIN-INTRO

-    url: https://www.postgresql.org/docs/current/static/brin-intro.html
+    url: https://www.postgresql.org/docs/current/brin-intro.html

* Looks like this will cause issues as "current" moves forward in
versions and we add new sections before this:

-    url: https://www.postgresql.org/docs/16/functions-aggregate.html#id-1.5.8.27.5.2.4.1.1.1.1
+    url: https://www.postgresql.org/docs/current/functions-aggregate.html#id-1.5.8.27.6.2.4.1.1.1.1

If I adjust /current/ to /17/ it works, but not before then. Is there
anything more future proof we can do there?

Likewise with:

-    url: https://www.postgresql.org/docs/16/functions-info.html#id-1.5.8.32.3.4.2.2.24.1.1.1
+    url: https://www.postgresql.org/docs/current/functions-info.html#id-1.5.8.33.3.4.2.2.26.1.1.1

Also:

-    url: https://www.postgresql.org/docs/18/functions-string.html#id-1.5.8.10.7.2.2.8.1.1.1
+    url: https://www.postgresql.org/docs/current/functions-string.html#id-1.5.8.10.7.2.2.8.1.1.1

Going back to /14/ that links to left() instead of casefold().

* The following no longer links to where it intended to:

-    url: https://www.postgresql.org/docs/current/static/collation.html#id-1.6.10.4.5.7.5
+    url: https://www.postgresql.org/docs/current/collation.html#id-1.6.10.4.5.7.5

i.e basically someone made the same mistake as the above ones were
about to make.

David