Zybnek made some comments over on the Boost.Build list:
That is a common spelling mistake of my name (once I even had an ID card with it for almost a year) :-). It's Zbynek. But everybody does that all the time :-).
My personal preference is to add margins to the sides so the text does not run all the way from one border of the window to the other.
the huge green navbar at the top. It totally does not fit in with the rest of the document. IMHO a navbar to be at each page have to be nonintrusive (small, not much colors) and usefull (something that you really need at each page) and it should have at least similar design as the rest of the document.
Reece, I think you've already addressed these two.
Is there an online example that I could check it out?
I do not think it is a good idea to start with such a huge toc. Maybe a mix of condensed version and/or synopsis and/or "how to use this document" would be better.
I'm with Doug on this one. Often when I'm using docs for reference I know exactly which section I'm looking for, so I like a full TOC to be able to jump directly there. Other times, I'm looking for specific details, and I like being able to scan a full TOC for the right place, rather than reading an entire chapter to find the information.
I am not saying "dump the toc". I am just saying that a book or a website should have a title page and the toc can be "one click away" (ie like the reference documents from www.w3.org). That is usefull ie. when googling around for information. When I get a hit in some deep structure of files I either cut the url or use some "home" or "up" button to find out what it belongs to. Getting nothing else but endless toc of things I know nothing about is not helping much in that case.
Zbynek
-- http://zw.matfyz.cz/ http://robotika.cz/ Faculty of Mathematics and Physics, Charles University, Prague, Czech Republic
------------------------------------------------------- SF.Net is sponsored by: Speed Start Your Linux Apps Now. Build and deploy apps & Web services for Linux with a free DVD software kit from IBM. Click Now! http://ads.osdn.com/?ad_id=1356&alloc_id=3438&op=click _______________________________________________ Boost-docs mailing list [EMAIL PROTECTED] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
