Re: V2 documentation format: a resolution?

From: David Abrahams (dave_at_[hidden])
Date: 2004-02-08 11:26:23

Vladimir Prus <ghost_at_[hidden]> writes:

> Douglas Gregor wrote:
>> On Tuesday 03 February 2004 05:24 pm, Christopher Currie wrote:
>> > What we *may* end up doing is tweaking the stylesheets to create a
>> > different L&F. I'm pretty sure the existing stylesheets are designed to
>> > follow some Boost guidelines, but Zbynek's layout got some good reviews,
>> > so if possible we'd like to modernize them a little.
>>
>> If you happen to come up with a slick new look & feel that we can apply to
>> BoostBook, I wouldn't mind :). I'm actually a bit envious of Spirit's docs,
>> which look _very_ nice, but not envious enough to actually try to duplicate
>> what they've done :)
>
> I too find Spirit docs to be very nice. I actually think it would be nice to 
> go ahead and steal at least the navigation arrors ;-)

Personally while I find Spirit's docs quite nice, I'd prefer to use
something a little less busy and a little more stripped-down and
professional. These sorts of designs are very hard to come by, but I
know that I can find some examples. Others may not agree when they
see what I have in mind, of course ;-)

> As for other elements: like gradient background of examples, and so on, I just 
> have no idea how it's implemented and how hard it's to steal.

That gradient background, in particular, is one element which I think
looks cool for the first two minutes but then gets to be a little
distracting after a while.

-- 
Dave Abrahams
Boost Consulting
www.boost-consulting.com