Re: [GENERAL] Postgres 10 manual breaks links with anchors

From: Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>
To: Thomas Kellerer <spam_eater(at)gmx(dot)net>, pgsql-hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: [GENERAL] Postgres 10 manual breaks links with anchors
Date: 2017-10-26 19:22:52
Message-ID: 117c1306-32fd-c82f-8d76-81c31a81ef88@2ndquadrant.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-general pgsql-hackers

On 10/16/17 03:19, Thomas Kellerer wrote:
> I don't know if this is intentional, but the Postgres 10 manual started to use lowercase IDs as anchors in the manual.
>
> So, if I have e.g.: the following URL open in my browser:
>
> https://www.postgresql.org/docs/current/static/sql-createindex.html#sql-createindex-concurrently
>
> I cannot simply switch to an older version by replacing "current" with e.g. "9.5" because in the 9.5 manual the anchor was all uppercase, and the URL would need to be:
>
> https://www.postgresql.org/docs/9.5/static/sql-createindex.html#SQL-CREATEINDEX-CONCURRENTLY
>
> Is this intentional?
>
> This also makes "cleaning" up links in e.g. StackOverflow that point to outdated versions of the manual a bit more cumbersome.

Here is a patch that can be applied to PG 10 to put the upper case
anchors back.

The question perhaps is whether we want to maintain this patch
indefinitely, or whether a clean break is better.

--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services

Attachment Content-Type Size
0001-doc-Convert-ids-to-upper-case-at-build-time.patch text/plain 1.5 KB

In response to

Responses

Browse pgsql-general by date

  From Date Subject
Next Message Alvaro Aguayo Garcia-Rada 2017-10-26 19:42:29 Re: Question regarding logical replication
Previous Message Weiping Qu 2017-10-26 19:07:54 Question regarding logical replication

Browse pgsql-hackers by date

  From Date Subject
Next Message Justin Pryzby 2017-10-26 19:45:15 Re: performance drop after upgrade (9.6 > 10)
Previous Message David Rowley 2017-10-26 19:19:18 Re: Removing [Merge]Append nodes which contain a single subpath