Re: Another modest proposal for docs formatting: catalog descriptions
Tom Lane <tgl@sss.pgh.pa.us>
From: Tom Lane <tgl@sss.pgh.pa.us>
To: "Jonathan S. Katz" <jkatz@postgresql.org>
Cc: Alvaro Herrera <alvherre@2ndquadrant.com>,
Fabien COELHO <coelho@cri.ensmp.fr>, pgsql-docs@lists.postgresql.org,
PostgreSQL Developers <pgsql-hackers@lists.postgresql.org>
Date: 2020-05-08T22:53:36Z
Lists: pgsql-hackers, pgsql-docs
Attachments
- catalog-description-prototype-2.patch (text/x-diff) patch
- website-style.patch (text/x-diff) patch
- pg-aggregate-v2.png (image/png)
Here's a more fully fleshed out draft for this, with stylesheet markup to get extra space around the column type names. I realized that I can probably automate this conversion, unlike the function-table conversion: I'm not feeling any need to editorialize on the column descriptions, so I can probably just extract the data from the SGML programmatically and rebuild it as I want. Seems like it should be a fairly quick process. So, if this seems good from your standpoint, please push up the patch on main.css and then I'll see about doing the edit. (BTW, said patch also removes some no-longer-used detritus from the earlier markup attempt.) regards, tom lane
Commits
-
Doc: reformat catalog/view description tables.
- a042750646db 13.0 landed