Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.96) (envelope-from ) id 1vKDur-003I8A-2Z for pgsql-hackers@arkaria.postgresql.org; Sat, 15 Nov 2025 10:54:01 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.96) (envelope-from ) id 1vKDup-009Amd-1h for pgsql-hackers@arkaria.postgresql.org; Sat, 15 Nov 2025 10:53:59 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.96) (envelope-from ) id 1vKDup-009AmV-0T for pgsql-hackers@lists.postgresql.org; Sat, 15 Nov 2025 10:53:59 +0000 Received: from mout.gmx.net ([212.227.17.20]) by magus.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.96) (envelope-from ) id 1vKDum-007s6z-2h for pgsql-hackers@postgresql.org; Sat, 15 Nov 2025 10:53:58 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmx.de; s=s31663417; t=1763204016; x=1763808816; i=brar@gmx.de; bh=xD9PP1KqpwcU0WZ/cW89+JDjQdg9XL5DX+Q39DxC5nQ=; h=X-UI-Sender-Class:Message-ID:Date:MIME-Version:Subject:To:Cc: References:From:In-Reply-To:Content-Type: Content-Transfer-Encoding:cc:content-transfer-encoding: content-type:date:from:message-id:mime-version:reply-to:subject: to; b=kHWiAkITr3IASskNc5rG4Fk1ZY8Riwr2mUCIF/1XPM2Fc6t58+H7yXjuJzd5wfkA QojdBrcdB8qrXSpb/GL+lEgR8l9nJM6M34+2Ulw21aW4RJLTa0WLjCMyDqF8+zsAT F99afAh23xX2pwsAr003SCs+iw8OeY+CeD2QYOfvmtCgF8S/uzmMPuqozmBgFE4Sw OAlh09IPG4DkIgzutJGD9CgnILOHVKagli6UIUYX+X6d3X17Fb+ZhbJfIyikCVQbv y2VpslxDm+P0CYTupCYvQ4c8aWyB7gKuEMELOMw67EN871e4yDVCocZ82SgFch23g BR8KekxuU48t5pcJhw== X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a Received: from [192.168.178.54] ([178.25.17.221]) by mail.gmx.net (mrgmx105 [212.227.17.168]) with ESMTPSA (Nemesis) id 1MTABT-1vkIyF2fzL-00Kuis; Sat, 15 Nov 2025 11:53:36 +0100 Message-ID: <77fec8f4-ff5f-40f8-88ae-8e8baaaf8489@gmx.de> Date: Sat, 15 Nov 2025 11:53:34 +0100 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: doc: add missing "id" attributes to extension packaging page To: Alvaro Herrera , "Karl O. Pinc" Cc: =?UTF-8?Q?Dagfinn_Ilmari_Manns=C3=A5ker?= , Peter Eisentraut , Tom Lane , pgsql-hackers References: <202511141056.zqdmaf7bl5hh@alvherre.pgsql> Content-Language: en-US From: Brar Piening In-Reply-To: <202511141056.zqdmaf7bl5hh@alvherre.pgsql> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: quoted-printable X-Provags-ID: V03:K1:fK44W8m9163kMxDgBo5nVPcMLAVYEJNZVmglZtpj8ezLVIZELe1 97f7PvSy+Lmvc/h+CGlHunnPCIjsBHs5wOjnIRZrF+GJaEPKIuSrMZnJ3WVTlNwl2GXPB2p l4ECuZARZ++Yj9iDFBXJ81aQ3a51RILaH7un7+GGJkpWlV6WtoykFuC31CP3IBjP2LYA5Mq sg6cEGRNlOb/lQTlOaRUw== X-Spam-Flag: NO UI-OutboundReport: notjunk:1;M01:P0:yFQsqMa4qR4=;Zk2EsyM5vg8omrX9YR2cUsIVeo2 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 rgGlfGa9T0shQS/Y8aYhD5eU8TTD/vz5k7A97v List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk On 2025-11-14=C2=A0at 11:59 Alvaro Herrera wrote: > On 2023-Apr-13, Karl O. Pinc wrote: > >> Dagfinn Ilmari Manns=C3=A5ker wrote: >>> Another side note: I notice the links don't appear on >>> elements (e.g. >>> https://www.postgresql.org/docs/devel/sql-select.html#SQL-WITH), >>> only . >> This we know. Working with 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 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=20 XSLT-wise that cannot build on the changes I have made and I wanted to=20 see how well my initial work will prove its value and be accepted by the= =20 maintainers and the community before starting to work on this and=20 introducing even more changes in this kind of ugly XSLT area that nobody= =20 really likes to touch. I think,=C2=A0now that some=C2=A0 time has passed, everybody working on pa= tches in=20 the docs area should have some opinion on how annoying it is to be=20 forced to provide ids for various elements and if the advantage of being= =20 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=20 of ids in refsections would need to be applied in a quick and=20 cooperative way once we agree on the general structure, since it needs=20 to be rebased and enhanced whenever a new refsection without ids (or=20 other element where it enforces ids) is added by some patch and will=20 break all subsequent patches that try to add refsections without ids=20 (forcing their developers/reviewers to rebase and add ids accordingly). If we can build some consensus that we want this for the refsections as=20 well, I'm willing to put some time aside and work on this (probably at=20 some point next year since I'm currently drowning in work). Regards, Barr