David Abrahams wrote:
If I have any criticism, I'd have to say that boldifying links may over-emphasize them. But that is really a minor point.
Please have a look at the updated style: http://boost-sandbox.sourceforge.net/libs/xpressive
Very good. (Coming from me that's high praise)
I have made the following changes, based on feedback here:
- I have unboldified the links, lightened them up a tad to stand out better, and added an underline on mouse hover. It's an improvement IMO.
- The first row of tables get a light blue background, the other rows get light gray. Also an improvement.
- The C++ syntax highlighing colors are more to my taste. (Ha!) Feedback welcome.
Also to my taste :-) Although the scope braces are not lining up with the rest of the indented statements.
Also, for comparison purposes, I have put up a separate version of the docs that use a serif font instead of sans-serif. You can find it here:
http://tinyurl.com/4fdyb
The choice of font has a strong influence on the look and feel. I encourage everyone to take a second to compare the serif style to the sans-serif and say which they like better. (My vote goes for sans-serif.)
Definitely sans-serif is best. Any typographer will tell you that for low-res situations sans-serif is always the best choice. If you have the luxury of high-res typesetting of a book printing, then can you go serif.
The one improvement I would suggest is to remove the space between paragraphs and indent the first line of each, except for the first paragraph of a section. Like I just did for this and the preceding paragraph. That is the recommended typographic style, and it gives you the best use of whitespace to delineate sections.
Other good things that I see, and that others might not notice, other than the passing it looks good...
- Spacing is consistently used around section headings. A minor improvement could be to make the spacing above the heading larger than below the headings.
- Consistent use of color to make the headings stand out as section separators -- Without use of nasty horizontal rulers. Although you did break this in at least one place that I saw. But I'm betting that was not intentional, i.e. it's a bug ;-)
OK more improvements that come to mind as I continue to browse the docs...
- For the small icons, for example <!>, that appear inside a quote box. I would put them outside the box, if possible. That would make them stand out better as indicators. And would make the formatting of the quote box text flow better.
- Consistently use, or not use, the border around code and quote boxes. Using them for one and not the other when they look virtually identical otherwise is confusing.
And finally given all that, always remember that the content is still more important than the look when it comes to technical documentation. So don't kill yourself if it doesn't look just right :-)
-- -- Grafik - Don't Assume Anything -- Redshift Software, Inc. - http://redshift-software.com -- rrivera/acm.org - grafik/redshift-software.com - 102708583/icq
------------------------------------------------------- This SF.Net email is sponsored by: YOU BE THE JUDGE. Be one of 170 Project Admins to receive an Apple iPod Mini FREE for your judgement on who ports your project to Linux PPC the best. Sponsored by IBM. Deadline: Sept. 24. Go here: http://sf.net/ppc_contest.php _______________________________________________ Boost-docs mailing list [EMAIL PROTECTED] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
