Horton

Re: Doc: Rework contrib appendix -- informative titles, tweaked sentences

Karl O. Pinc <kop@karlpinc.com>

View thread View on postgr.es
From: "Karl O. Pinc" <kop@karlpinc.com>
To: Brar Piening <brar@gmx.de>
Cc: PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>
Date: 2023-01-15T13:35:21Z
Lists: pgsql-hackers 
On Sun, 15 Jan 2023 07:11:30 +0100
Brar Piening <brar@gmx.de> wrote:

> On 03.01.2023 at 01:00, Karl O. Pinc wrote:
> > Attached is a patch: contrib_v1.patch
> >
> > It modifies Appendix F, the contrib directory.  
> 
> Review:

> It adds a brief explanatory part to the headers of all contrib modules

> The explanatory parts added make sense to me, althogh I'm not an
> expert in all the different contrib modules.

Neither am I.  I read the beginning of each module's docs and
made a best-effort.  There may sometimes be a better
summary phrase to describe a module/extension.

Thanks for the review.

Regards,

Karl <kop@karlpinc.com>
Free Software:  "You don't pay back, you pay forward."
                 -- Robert A. Heinlein

Commits

  1. Remove new <para id="contrib-obsolete">.

  2. doc/PDF: Add page breaks for <sect1> in contrib appendix

  3. doc: Add lists of modules trusted/obsolete

  4. HTML docs: Add padding to table.simplelist for more readable output

  5. Describe each contrib module in its SGML section title