Re: Typos in the featurematrix

From: Daniel Gustafsson <daniel(at)yesql(dot)se>
To: "Jonathan S(dot) Katz" <jkatz(at)postgresql(dot)org>
Cc: David Rowley <dgrowleyml(at)gmail(dot)com>, pgsql-www(at)lists(dot)postgresql(dot)org, Magnus Hagander <magnus(at)hagander(dot)net>
Subject: Re: Typos in the featurematrix
Date: 2025-10-23 12:14:44
Message-ID: EFBF4DCE-9D3E-4A5B-844E-79ABF9BC4295@yesql.se
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-www

> On 23 Oct 2025, at 03:04, Jonathan S. Katz <jkatz(at)postgresql(dot)org> wrote:

> * Going through 0001:
>
> - description: automatic invalidation of cached exceutions plans
> + description: automatic invalidation of cached executions plans
>
> should probably be "cached execution plans". Otherwise LGTM.

Fixed

> * Going through 0002:
>
> - - name: IN/OUT/INOUT parameters for pl/pgsql and PL/SQL
> + - name: IN/OUT/INOUT parameters for PL/pgSQL and PL/SQL
>
> We should probably not call it "PL/SQL" since it's not a procedural language. Perhaps:
>
> - - name: IN/OUT/INOUT parameters for pl/pgsql and PL/SQL
> + - name: IN/OUT/INOUT parameters for PL/pgSQL and SQL stored functions

Fixed

>> 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.
>
> There were some reasons for this, the "version at the time of adding" ensuring that the links were accessible during the beta period (which also explained some of the /devel/, which I likely did). During the beta period, we'll still need to use the `/NN/` number so the links are accessible, but we can make it part of the procedure to more to `/current/` when we GA.

That makes a lot of sense. We also need to use the /NN/ number for any feature
which is removed, to stabilise the link on the last version where it was
present.

Adding a "link-refresh" step to the GA checklist sounds like a good idea (and I
can volunteer to tackle it next time).

--
Daniel Gustafsson

In response to

Browse pgsql-www by date

  From Date Subject
Next Message Daniel Gustafsson 2025-10-23 12:28:29 Re: Typos in the featurematrix
Previous Message George MacKerron 2025-10-23 10:27:37 Wiki editor request