John Maddock wrote:
The good folks at boost-docs have been working on improving the
look-and-feel of Boost's documentation. This work is based largely on
Rene Rivera's website redesign. The change went in to both HEAD and
the release branch a few days ago. The biggest change is a smaller
font.
Report any problems with the new style to
[EMAIL PROTECTED]
1) The server is so slow that the type_traits docs won't load, looks
like it really is time to change. (Actually it did load eventually -
after about 20 minutes!)
2) The Boost.Math docs reference quite a lot of images under
libs/math/doc that aren't on the server.
That's odd. I wonder why the images aren't there. I don't know much
about how the nightly generated docs machine is configured. Aleksey?
Style comments:
1) I quite liked the colored backgrounds to code blocks, it made them
stand out visually quite nicely.
This is certainly a matter of taste. I liked the colored backgrounds,
too, but now that I've gotten used to the borders, I wouldn't switch back.
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.
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.
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.
I really didn't intent to complain about everything... but I don't seem
to have left much out. Probably I'll get used to it, so just my 2c worth.
Thanks for your feedback.
--
Eric Niebler
Boost Consulting
www.boost-consulting.com
-------------------------------------------------------
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
