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

Chris McDonough chrism@zope.com
Tue, 27 Aug 2002 17:27:39 -0400


Sure.  If you want to help, visit http://backtalk.sourceforge.net .
Any stylesheet or feature work you wish to do with it is possible
(one main stylesheet controls all output), and I'd accept any
contribution of time to perform the work.  I unfortunately cannot do
anything with it at the moment.

Thanks,

- C


----- Original Message -----
From: "Trevor Toenjes" <zope@toenjes.com>
To: "Chris McDonough" <chrism@zope.com>; "Zope.org Mailinglist"
<zope-web@zope.org>; "Carsten (via www.zope.org)"
<carsten.siedentopf@digital-spirit.de>
Sent: Tuesday, August 27, 2002 4:29 PM
Subject: RE: [ZWeb] Zope.org feedback: Zope Documentation / Zope
book online


> 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
>
>
> _______________________________________________
> Zope-web maillist  -  Zope-web@zope.org
> http://lists.zope.org/mailman/listinfo/zope-web
>