Mark Rotteveel wrote:

> Could you look at the overall style of things to see if there are things 
> you really don't like.

> https://www.lawinegevaar.nl/fbdocs/pdf/en/experiment/fblangref25.pdf

First reaction to the PDF:

- Overall, OK!

- Document title and author listing: really don't like the right-alignment here,
I'd rather see it left-aligned or centered.

- Navigation pane: only has a depth of 2 (chapter and top-level paragraph).
This means that lots of 2nd- and 3rd-level paragraphs are now missing from
the nav pane. It would be very useful having them back.

- Some of the fonts are not very pleasant to the eye (at least my eye); they
look horizontally compressed.

- Some other fonts are too big (e.g. in Examples sections), but I guess you
already know that; this is simple a matter of adjustment, nothing complicated.

- In tables, sometimes the first column is centered and the second one
left-justified; sometimes the first is right-justified and the second 
left-justiified.
I know this is already the case in the existing LangRef, but I find it 
absolutely
horrible, so maybe we should fix this. Same for unnecessary parentheses
around language elements in tables.
(OK, I realize this is in the source and not in the rendering, but I'll leave it
here as a reminder ;-))

Cheers,
Paul Vinkenoog


_______________________________________________
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/firebird-docs

Reply via email to