W3C home > Mailing lists > Public > w3c-wai-ig@w3.org > July to September 2001

Re: WAI - Documentation and Procedures

From: Marc David Johnson <mjohnson@marcdavidjohnson.com>
Date: Wed, 11 Jul 2001 07:40:41 -0400
Message-ID: <00b801c109fe$510108d0$08c818ac@ncua.lan>
To: <w3c-wai-ig@w3.org>
> On Wed, 11 Jul 2001, David Woolley wrote:

>   I was once told that documents like this (guidelines for people too busy
>   to read and understand properly) are too long if they are over
>   about 3 pages.

Reply From: "Charles McCathieNevile" <charles@w3.org>

> I don't think there are hard and fast rules. In some cases a long,
detailed
> document that incorporates a lot of W3C material and a lot of other stuff
is
> really useful, in other cases the quicktips is ideal, and in other cases
it
> is something else again.

I tried to keep this document at 20 pages strictly to make it a little
easier for them to digest (and to 'break up' the document into the three
Priority levels so each could be digested separtely). So far, it has been
well received as my office (government) is used to documentation being a bit
long, but know how to read a simple document (and do not know how to
navigate the Internet for information quite as easily).

> On Tue, 10 Jul 2001, Marc David Johnson wrote:

>   > The conetent is from the W3C, I have just massaged it to make it a
little
>   > more understandable and organized for people.

> On Wed, 11 Jul 2001, David Woolley replied:

>   This implies that there are accessiblity/usablity problems with the W3C
>   web site.  Would you care to elaborate.

Well, I personally feel the site is well laid out and fairly easy to
navigate. I rarely have any problems finding exactly what I am looking for,
but many in my office don't use the Internet often enough to be able to do
much more than read the news or sports (even some of the various department
'webmasters' can't do simple searches for information, etc.). I will keep
the site-comments@w3.org address Charles mentioned handy though in case I
run into an issue or have a suggestion.

Take care. :-)

Marc David Johnson
mjohnson@marcdavidjohnson.com
http://www.MarcDavidJohnson.com
A little bit of everything ... and a whole lot of nothing.
Received on Wednesday, 11 July 2001 07:41:13 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 19 July 2011 18:13:55 GMT