Mark Rotteveel wrote: > I have published an PDF and HTML version of the Firebird 2.5 Language > Reference built from asciidoc. I have used some elements of style from > the old documentation, but a lot of it is based on the standard asciidoc > styles. > > 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/html/en/experiment/fblangref25.html
First impressions of the HTML (after 1-2 minutes of reading and scrolling): - Font size is rather biggish. Maybe 10% smaller or so would be better and more in line with the average informative website? - I thought the horizontal margins around the main text were too small, but then I noticed that they grow if I widen the window. This is not what one expects in HTML, but it works. (However: could a minimum margin be imposed that is bigger that the current one?) - GREAT to have the ToC alongside! - But I really don't like the way the ToC adjusts when you use the slider to scroll up and down. Stuff in the ToC rolls up and down, collapses and expands, and all this is animated. That draws your attention constantly to a place where it isn't needed. If there's an option to turn the animation off, I would prefer that. (The fact as such that the ToC follows the scrolling is of course very useful.) - All in all though, it already looks _much better_ than our current HTML! Cheers, Paul Vinkenoog _______________________________________________ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
