public inbox for [email protected]  

help / color / mirror / Atom feed

From: Brar Piening <[email protected]>
To: Alvaro Herrera <[email protected]>
To: Karl O. Pinc <[email protected]>
Cc: Dagfinn Ilmari Mannsåker <[email protected]>
Cc: Peter Eisentraut <[email protected]>
Cc: Tom Lane <[email protected]>
Cc: pgsql-hackers <[email protected]>
Subject: Re: doc: add missing "id" attributes to extension packaging page
Date: Sat, 15 Nov 2025 11:53:34 +0100
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>

On 2025-11-14 at 11:59 Alvaro Herrera wrote:
> On 2023-Apr-13, Karl O. Pinc wrote:
>
>> Dagfinn Ilmari Mannsåker <[email protected]> wrote:
>>> Another side note: I notice the links don't appear on <refsectN>
>>> elements (e.g.
>>> https://www.postgresql.org/docs/devel/sql-select.html#SQL-WITH),
>>> only <sectN>.
>> This we know.  Working with <refsectN> elements is a different
>> dive into the XSLT which was deliberately put off for future
>> work.
> Hi, has anybody been able to spend some time on the <refsectN> aspect of
> these link things?

Hi,

tbh, this has been in my backlog since I did the initial thing.

I haven't prioritized it since it is really a completely different area 
XSLT-wise that cannot build on the changes I have made and I wanted to 
see how well my initial work will prove its value and be accepted by the 
maintainers and the community before starting to work on this and 
introducing even more changes in this kind of ugly XSLT area that nobody 
really likes to touch.

I think, now that some  time has passed, everybody working on patches in 
the docs area should have some opinion on how annoying it is to be 
forced to provide ids for various elements and if the advantage of being 
able to refer to specific items in the HTML docs is really worth it.

Also, as we've learnt the last time, a patch that enforces the presence 
of ids in refsections would need to be applied in a quick and 
cooperative way once we agree on the general structure, since it needs 
to be rebased and enhanced whenever a new refsection without ids (or 
other element where it enforces ids) is added by some patch and will 
break all subsequent patches that try to add refsections without ids 
(forcing their developers/reviewers to rebase and add ids accordingly).

If we can build some consensus that we want this for the refsections as 
well, I'm willing to put some time aside and work on this (probably at 
some point next year since I'm currently drowning in work).

Regards,

Barr

view thread (45+ messages)

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected], [email protected], [email protected], [email protected], [email protected]
  Subject: Re: doc: add missing "id" attributes to extension packaging page
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox