Reece Dunn wrote:
Rene Rivera wrote:
David Abrahams wrote:
Rene Rivera <[EMAIL PROTECTED]> writes:
Very unhappy. I won't bother with a patch now. Instead here's what I
have in mind:
<http://boost.redshift-software.com/development/exemplar.html>
I like this *very* much! The top section (the Boost banner and the
tabbed links just below it) is *far* better than the previous versions.
I also like the consistent layout with the Boost documentation, making
it have a clear, consistent layout.
Thank you... You are looking at more than six months of calendar work. I
started the new design on a vacation to Spain :-)
I also like the bottom section and the cleaner, simplified menus.
However, in the introduction menu, FireFox clips the bottom of the
"Who's using Boost" section if you highlight over FAQ.
Yep.. Need to fix those.
Some of the documentation have inconsistent/odd layouts (I understand
that most of this depends on whether the docs are in HTML or generated
from BoostBook or QuickBook):
It not only depends on that. But also on how much effort I put into
transforming the non-BoostBook documentation into a presentable and
consistent form. You see all those docs are dynamically extracted and
reformatted from a boost_1_33_1.zip archive. So it's a bit of work to
accomplish that.
For the comments below I should note that the styles I'm using are *not*
meant for the standalone documentation. It is specifically designed for
the website only.
* any: the navigation helpers have a border and a grey background when
they should have no border and a white BG.
That is intentional. All groups of navigation elements have that style.
The consistency helps in finding them within the rest of the website
content.
* wave: ToC is squashed in the center of the page - I would prefer to
have this indented slightly (10%? and have a slight BG color, e.g.
#EEE); the navigation elements are center aligned which is inconsistent
with the other docs.
Yep... There are various custom HTML looks I haven't fully accounted for
yet. It's a lot of work to go through all the Boost documentation and
tweak styles and transformations.
* spirit: see wave; the preface/icons table doesn't look right; the
titles are duplicated with the spirit logo.
Yep... Much of this would be alleviated with by people moving docs to
BoostBook. And if I remember Joel mentioed he was going to do that with
the Spirit docs.
* call traits: I am not too keen on the table colouring being used.
Oh, yea. Another instance of needing to make those conform to the
BoostBook like look. At some point the Documentation Wizard needs to
step up and have people work on transporting docs to BoostBook ;-)
* config: at the top, I am getting "Notice: Undefined offset: 1 in
/export/website/boost/public_html/common/code/archive_file.php on line 215"
Ah, thanks for finding that. I'll investigate.
Question: why the plus signs in the bullet lists? Bullets mean
bullets; plus signs mean addition (or "collapsible list item"), no?
It seems needlessly unconventional to me.
That's the current, as in the now 1 year old Boost style. It's meant
to refer to C++. But like you say it's not a common bullet style.
Bullet styles are far ranging, I've seen hundreds. Perhaps one of the
square bullet styles would work better :-)
I agree with Dave on this one: the '+' on the bullets make me want to
click on them to expand the item. If you want to use '+', how about:
++ Item 1
++ Item 2
++ Item 3
that way, it has more of a reference to C++ and doesn't make you want to
expand the items. However, using a standard bullet symbol (circle,
square, etc.) would be better.
Yea I think the squares is the way to go. It's not worth the effort to
come up with some custom look.
Great work! Looking forward to seeing this in the main web page and the
BoostBook/QuickBook docs :).
Thanks, again. But I'll warn people now that it will be some time to
work out all the issues and new content, the wiki is one pending item.
And I won't have more time to spend on it soon as I need to get bjam
boost.build stuff done ASAP.
--grafik
-------------------------------------------------------
This SF.net email is sponsored by: Splunk Inc. Do you grep through log files
for problems? Stop! Download the new AJAX search engine that makes
searching your log files as easy as surfing the web. DOWNLOAD SPLUNK!
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=103432&bid=230486&dat=121642
_______________________________________________
Boost-docs mailing list
[email protected]
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
