2) The smaller font is undoubtably good for printing, but for
reading on the web it makes the text rather dense: depends a bit on
how wide your screen is.
A little dense is ok. Most of the websites I read regularly (cnn.com,
news.bbc.co.uk, osnews.com) use a font comparable in size to what
we're using now. The larger font size on the old docs looked less
professional, IMO, and resulted in less information displayed at a
time. And there's always Ctrl+. Obviously if everybody is hitting
Ctrl+ to read our docs, that would be bad, but I don't think it'll be that
way.
Most of the sites you mention place their text in quite complicated
multi-column layouts. My main concern is over large paragraphs of solid
text - although I admit we don't have too many of those at present - but
it's really hard to keep your eye on the line if the lines are full width
*and* of small font.
On the other hand I really like the way the table look now, *much* better
with the smaller font.
3) What happened to the color in the headers? If you look at the
type_traits docs now say
http://www.boost.org/regression-logs/cs-win32_metacomm/doc/html/boost_typetraits/reference.html#boost_typetraits.is_integral
then there's not much visual separation between headers and other
items.
Were we ever using color in the headers? Can you point me to an
example? In the 1.33.1 type traits docs, the headers are black.
So they are! I had got used to looking at the new-style quickbook docs
where header-are-links and therefore blue-coloured. IMO the bit of colour
on the headers works very well.
Of course this could be solved by better chunking, although it's
going to be hard to develop a "one chunk fits all" solution.
We'll certainly look at improving the chunking, but that'll be for
1.35.
Yep. I wonder is it possible to introduce some visual separation between
sections? Maybe a horizontal rule, or perhaps just a little extra
whitespace before a section header?
John.
-------------------------------------------------------
This SF.Net email is sponsored by xPML, a groundbreaking scripting language
that extends applications into web and mobile media. Attend the live webcast
and join the prime developer group breaking into this new coding territory!
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=110944&bid=241720&dat=121642
_______________________________________________
Boost-docs mailing list
[email protected]
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
