Re: Doc: Rework contrib appendix -- informative titles, tweaked sentences
Karl O. Pinc <kop@karlpinc.com>
From: "Karl O. Pinc" <kop@karlpinc.com>
To: Alvaro Herrera <alvherre@alvh.no-ip.org>
Cc: PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>
Date: 2023-01-22T14:09:03Z
Lists: pgsql-hackers
On Sat, 21 Jan 2023 08:11:43 -0600
"Karl O. Pinc" <kop@karlpinc.com> wrote:
> Attached are 2 v9 patch versions. I don't think I like them.
> I think the v8 versions are better. But I thought it
> wouldn't hurt to show them to you.
>
> On Fri, 20 Jan 2023 14:22:25 -0600
> "Karl O. Pinc" <kop@karlpinc.com> wrote:
>
> > Attached are 2 alternatives:
> > (They touch separate files so the ordering is meaningless.)
> >
> >
> > v8-0001-List-trusted-and-obsolete-extensions.patch
> >
> > Instead of putting [trusted] and [obsolete] in the titles
> > of the modules, like v7 does, add a list of them into the text.
>
> v9 puts the list in vertical format, 5 columns.
>
> But the column spacing in HTML is ugly, and I don't
> see a parameter to set to change it. I suppose we could
> do more work on the stylesheets, but this seems excessive.
Come to think of it, this should be fixed by using CSS
with a
table.simplelist
selector. Or something along those lines. But I don't
have a serious interest in proceeding further. A inline
list seems good enough, even if it does not stand out
in a visual scan of the page. There is a certain amount
of visual-standout due to all the hyperlinks next to each
other in the inline presentation.
Regards,
Karl <kop@karlpinc.com>
Free Software: "You don't pay back, you pay forward."
-- Robert A. Heinlein
Commits
-
Remove new <para id="contrib-obsolete">.
- 244ab8c00c42 16.0 landed
-
doc/PDF: Add page breaks for <sect1> in contrib appendix
- 30e9f2608adf 16.0 landed
-
doc: Add lists of modules trusted/obsolete
- a0137388cb64 16.0 landed
-
HTML docs: Add padding to table.simplelist for more readable output
- a7e584a7d68a 16.0 landed
-
Describe each contrib module in its SGML section title
- e86c8b728f3c 16.0 landed