Re: Poll: are people okay with function/operator table redesign? - Mailing list pgsql-hackers

From Isaac Morland
Subject Re: Poll: are people okay with function/operator table redesign?
Date
Msg-id CAMsGm5dhAAf9YZh3scCcs_SX+2F2k1QyRPWn0hgnOX2xQOPo4Q@mail.gmail.com
Whole thread Raw
In response to Re: Poll: are people okay with function/operator table redesign?  (Pierre Giraud <pierre.giraud@dalibo.com>)
Responses Re: Poll: are people okay with function/operator table redesign?  (Pavel Stehule <pavel.stehule@gmail.com>)
List pgsql-hackers
On Wed, 15 Apr 2020 at 11:26, Pierre Giraud <pierre.giraud@dalibo.com> wrote:
 
The best way to achieve this is to use some styling (font style and color).

Attached you will find two different options I worked on very quickly.

I really like the first. Just a couple of suggestions I would make:

- leave a space between the function name and (. Regardless of opinions on what source code should look like, your documentation has space between each parameter and the next one, and between the ) and the -> and the ->. and the return type so it seems crowded not to have space between the function name and the (.
- At this point it's not really a table any more; I would get rid of the lines, maybe tweak the spacing, and possibly use <dl> <dt> <dd> (definition list) rather than table-related HTML elements. See https://developer.mozilla.org/en-US/docs/Web/HTML/Element/dl.

I think the bolding really makes stand out the crucial parts one needs to find.

pgsql-hackers by date:

Previous
From: Tom Lane
Date:
Subject: Re: Race condition in SyncRepGetSyncStandbysPriority
Next
From: Pavel Stehule
Date:
Subject: Re: Poll: are people okay with function/operator table redesign?