| From: | Fabien COELHO <coelho(at)cri(dot)ensmp(dot)fr> |
|---|---|
| To: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
| Cc: | "Jonathan S(dot) Katz" <jkatz(at)postgresql(dot)org>, Alvaro Herrera <alvherre(at)2ndquadrant(dot)com>, pgsql-docs(at)lists(dot)postgresql(dot)org, PostgreSQL Developers <pgsql-hackers(at)lists(dot)postgresql(dot)org> |
| Subject: | Re: Another modest proposal for docs formatting: catalog descriptions |
| Date: | 2020-05-09 06:54:10 |
| Message-ID: | alpine.DEB.2.22.394.2005090847090.914063@pseudo |
| Views: | Whole Thread | Raw Message | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-docs pgsql-hackers |
Hello Tom,
> Here's a more fully fleshed out draft for this, with stylesheet
> markup to get extra space around the column type names.
I find this added spacing awkward, espacially as attribute names are
always one word anyway. I prefer the non spaced approach.
If spacing is discussed, should the layout rather try to align type
information, eg:
attribute type
description
---
foo bla
this does this and that ...
and here is an example about it
---
foo-foo-foo bla-bla
whatever bla bla blah bla foo foo foo ...
and stuff
I'm not sure how achievable it is from a xml & processing point of view,
and how desirable it is, I'm just throwing it for consideration.
--
Fabien.
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Michael Paquier | 2020-05-09 08:57:01 | Re: Logical replication subscription owner |
| Previous Message | Tom Lane | 2020-05-08 22:53:36 | Re: Another modest proposal for docs formatting: catalog descriptions |
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Michael Paquier | 2020-05-09 07:39:08 | Re: pg_restore error message |
| Previous Message | Amit Kapila | 2020-05-09 05:46:27 | Re: PG 13 release notes, first draft |