Docs Format

[Sandro Santilli]

On Fri, Jun 12, 2026 at 11:58:55AM -0700, Paul Ramsey wrote:
> 
> 
> > On Jun 12, 2026, at 11:20 AM, Sandro Santilli <strk at kbt.io> wrote:
> > But even better some good old shell or perl script to stub the sections
> > of a new function so we don't need GPUs to release the XML pain.
> > 
> >> I think I would like to see a migration before signing on to a big change.
> > 
> > What do you mean by “migration”
> 
> I mean a conversion of docbook to md or rst would be proceeded by said conversion a “best effort” PoC

I personally find the Docbook way better in terms of structure.

Formats like md and rst were meant to make human-readable files a bit more machine-readable
while we want efficient machine readable structure.

Btw, today common Markdown usage badly broke the initial intention,
as often find it hard to read an .md file with just a pager, with all
those oververbose hrefs and inline images and what not...

--strk;
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 659 bytes
Desc: not available
URL: <http://lists.osgeo.org/pipermail/postgis-devel/attachments/20260613/3864c825/attachment.sig>