[boost] Re: [Poll] New look-n-feel for Boost documentation

From: Eric Niebler (eric_at_[hidden])
Date: 2004-09-30 12:26:25

Thanks for the detailed reply. Comments inline...

Rob Stewart wrote:
> 
> 1. My browser's "always underline links" setting is not being
>    respected. <snip>
> 
> 2. My browser's link colors are not being honored. <snip>
> 

These specific design issues can be revisited, but the larger question 
is of a style-sheet overriding browser defaults. Are you against any 
website creating a distinct look-n-feel by customizing settings such as 
these?

> 3. Sans serif text is harder to read.  You should use a font with
>    serifs for the body text and sans serif fonts for headings.

This issue was discussed on the boost-docs list. I put up a side-by-side 
comparison of serif and sans-serif documentation, and without exception, 
everyone there found sans-serif to be both more attractive *and* easier 
to read than serif, even those who initially expressed doubt. If you 
feel strongly about this point, I suggest you re-open the discussion on 
boost-docs. Many people you would need to convice loiter there.

> 
> 4. Some things don't adapt well to differing resolutions and font
>    sizes.  Consider the preferred/portable syntax table at
>    http://zigzag.lvk.cs.msu.su/~ghost/boost_docs/function.tutorial.html#id478061.
>    At my default settings, I see half of the second column.  Were
>    the table not offset so far, I'd see the whole thing.
<snip>

I can reduce the margin used by tables. Thanks.

> 
> 5. In
>    http://zigzag.lvk.cs.msu.su/~ghost/boost_docs/function.tutorial.html#id478410,
>    a list is introduced with, "Three such libraries are
>    summarized below:," but there are no bullets setting off the
>    three paragraphs.

CSS bug. I'll fix it.

The other issues you mention do not have anything to do with the style 
sheet.

Thanks.

-- 
Eric Niebler
Boost Consulting
www.boost-consulting.com