From: | Pavel Stehule <pavel(dot)stehule(at)gmail(dot)com> |
---|---|
To: | Isaac Morland <isaac(dot)morland(at)gmail(dot)com> |
Cc: | Pierre Giraud <pierre(dot)giraud(at)dalibo(dot)com>, PostgreSQL Developers <pgsql-hackers(at)lists(dot)postgresql(dot)org> |
Subject: | Re: Poll: are people okay with function/operator table redesign? |
Date: | 2020-04-15 15:53:54 |
Message-ID: | CAFj8pRB0CL4sNuskp8NQ0g4stiOfy_Rfau35LyncwNvciJarZw@mail.gmail.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-hackers |
st 15. 4. 2020 v 17:43 odesílatel Isaac Morland <isaac(dot)morland(at)gmail(dot)com>
napsal:
> On Wed, 15 Apr 2020 at 11:26, Pierre Giraud <pierre(dot)giraud(at)dalibo(dot)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:
>
yes, it is very well readable
Pavel
> - 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.
>
>
From | Date | Subject | |
---|---|---|---|
Next Message | Robert Haas | 2020-04-15 15:57:29 | design for parallel backup |
Previous Message | Isaac Morland | 2020-04-15 15:43:24 | Re: Poll: are people okay with function/operator table redesign? |