On Wed, Dec 04, 2024 at 08:29:57PM +0100, Peter Eisentraut wrote: > On 29.11.24 21:39, Noah Misch wrote: > > > I remembered where that's documented: > > > > > > https://wiki.postgresql.org/wiki/Committing_checklist#Maintaining_ABI_compatibility_while_backpatching > > I'd say the source tree's <sect2 id="xfunc-api-abi-stability-guidance">, > > which > > David Wheeler mentioned, is authoritative. It currently matches > > postgr.es/c/e54a42a. Let's update both or change that wiki heading to point > > to the authoritative doc section.
I hereby revoke the last sentence and replace it with "Let's update both in some way." The revoked sentence and its replacement are probably the least important thing I wrote in that mail. > I don't know if this proposing to merge the text in the wiki into the docs? The revoked proposal wasn't that specific. 1576843.1732586...@sss.pgh.pa.us offered some wiki changes mostly about struct fields. Doc section xfunc-api-abi-stability-guidance also writes about struct fields. Specifically, it discusses "squeezing a new field into padding space or appending it to the end of a struct". If we change the wiki about struct fields, we should not leave that quote unchanged. I no longer wish to affect how we allocate text to the wiki vs. xfunc-api-abi-stability-guidance.
