| 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
| 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 |