[ZWeb] Zope.org feedback: Zope Documentation / Zope book online

[Trevor Toenjes]

I think Carsten's feedback is pretty accurate.
Turning off Com is not the solution, because he is addressing what the
comments look like when they are on.
I think most people are interested in reading the Comments (some of them are
actually helpful) but not having them pop-out the way they do now.  So this
is just a style preference discussion.

I agree that presenting Comments as more subdued elements makes the main
text in a BackTalk chapter easier to read in HTML.  After all, Comments are
not endorsed content by the author and therefore should not overpower the
main text as they do now.

As a happy medium, if you think the current strong display is better, a
possible solution is to make an additional option just like COM ON/OFF.
Give the option to make Comments display as STRONG or LIGHT.

$.02

> -----Original Message-----
> From: zope-web-admin@zope.org [mailto:zope-web-admin@zope.org]On Behalf
> Of Chris McDonough
> Sent: Tuesday, August 27, 2002 9:34 AM
> To: Zope.org Mailinglist; Carsten (via www.zope.org)
> Subject: Re: [ZWeb] Zope.org feedback: Zope Documentation / Zope book
> online
>
>
> Did you try the COM OFF button at the top of the page to turn the
> comments off?
>
> ----- Original Message -----
> From: "Carsten (via www.zope.org)"
> <carsten.siedentopf@digital-spirit.de>
> To: "Zope.org Mailinglist" <zope-web@zope.org>
> Sent: Tuesday, August 27, 2002 6:45 AM
> Subject: [ZWeb] Zope.org feedback: Zope Documentation / Zope book
> online
>
>
> > hi,
> >
> > please change the css for the online version of the zope book. It
> will end up unreadable (some chapters already are).
> > I am new to zope, tried to read the Introduction etc.
> > I ended up reading all the comments first, just because they
> caught my eyes much more than the basic text. It was hard to
> actively ignore them.
> >
> > My suggestions:
> > comments should have less visual contrast than the main text. They
> are comments, not the "core information".
> >
> > - no background color, as it disrupts the reading flow
> > - textcolor should be dark grey or blue-grey (less contrast than
> main text)
> > - the typeface shouldn't be "bolder" than the main typeface
> > - a border just on the left or right, not all around. Or no border
> at all
> > - don't use a yellow image for the comment link. It absorbs
> attention. A grey text link on the bottom right of every paragraph
> would do the job well.
> >
> > These are just suggestions, but they really would increase the
> readability of the zope book online.
> >
> > Greetings, Carsten
> >
> > ----------------------------------------------------------
> > This email was generated from the Zope.org feedback form
> > It was invoked from a link on http://www.zope.org/Documentation
> >
> >
> > _______________________________________________
> > Zope-web maillist  -  Zope-web@zope.org
> > http://lists.zope.org/mailman/listinfo/zope-web
> >
>
>
> _______________________________________________
> Zope-web maillist  -  Zope-web@zope.org
> http://lists.zope.org/mailman/listinfo/zope-web