Re: Another modest proposal for docs formatting: catalog descriptions - Mailing list pgsql-docs

From Tom Lane
Subject Re: Another modest proposal for docs formatting: catalog descriptions
Date
Msg-id 3357.1589047741@sss.pgh.pa.us
Whole thread Raw
In response to Re: Another modest proposal for docs formatting: catalogdescriptions  (Fabien COELHO <coelho@cri.ensmp.fr>)
Responses Re: Another modest proposal for docs formatting: catalog descriptions
Re: Another modest proposal for docs formatting: catalog descriptions
List pgsql-docs
Fabien COELHO <coelho@cri.ensmp.fr> writes:
> Possibly. I'm a little at odds with Type not being above types, but far on 
> the left, so that you cannot really "see" that it is about the format, 

Yeah, agreed.  We can adjust the space in the header independently of
what's in the table entries, so it'd be possible to put more space
between "Column" and "Type" ... but I'm not sure if that would fix it.

> If I can suggest more adjustements, maybe the description margin is a too 
> much, I'd propose reduce it to about 3 chars wide. Obviously any aesthetic 
> opinion is by definition subjective and prone to differ from one person to 
> the next…

This is more Jonathan's department than mine, but I personally prefer more
indentation to less --- you want the column names to stick out so you can
find them.  Anyway, the present indentation is (it looks like) the same
as we are using in <variablelist>s, which this layout is based on.

            regards, tom lane



pgsql-docs by date:

Previous
From: Fabien COELHO
Date:
Subject: Re: Another modest proposal for docs formatting: catalogdescriptions
Next
From: Stephen Frost
Date:
Subject: Re: Logical replication subscription owner