Re: [Firebird-docs] Style of rendering parameters

[Mark R. <ma...@la...>]

On 30-05-2020 13:06, Paul Vinkenoog wrote:
> Mark Rotteveel wrote:
> 
>> I'm currently converting the Firebird Language Reference, and I was
>> wondering if there is a preference in the rendering of parameter lists
>> as used for function arguments and for syntax elements (in the current
>> language reference, a table is used).
>>
>> I would like to have input on what style to apply
>>
>> I have prepared three example:
>> 1. full width table
>> 2. autowidth table (which seems to have width issues in PDF)
>> 3. definition list
> 
> The tables look clearer to me. You 'get' them in one glance. In general
> I'd prefer autowidth, but it doesn't work well in the PDF (quite apart
> from the in-word break in 'Parameter', there's too little horizontal
> padding) and full width is fine too.

I can increase the padding for tables in the PDF through the stylesheet.

> However, above left-aligned
> columns I'd also left-align the headers. And we could do without the
> useless striping in the HTML tables.

I have updated the examples (same links):

- little bit more padding in PDF
- Column heading left-aligned
- No striping

> All that said, I think the definition list is fine as well. A little
> better in the PDF, probably because of the boldfacing of the terms (if
> they are - at least they look a tad darker to me).

It should be bold as well in the HTML, but there is a conflict in style 
rules, which means text in code tags is rendered in font-weight normal. 
I'll fix that later.

Mark
-- 
Mark Rotteveel