W3C home > Mailing lists > Public > site-comments@w3.org > December 2000

suggestion: working demos

From: DelVecchio, Matthew <mdelvecchio@marketwatch.com>
Date: Tue, 12 Dec 2000 19:26:42 -0600
Message-ID: <B80328047496CE4995A308C487289398168F5A@mspexch1.office.mktw.net>
To: "'site-comments@w3.org'" <site-comments@w3.org>

Today I wanted to learn one thing. I wanted to use the L2 DOM to change a
div's font color from Red to Blue. I could not learn how to do this on your

Your documentation is very defficult to use and navigate. No search on each
page, complete lack of global navigation, etc...

But even the docs themselves. They're far too conceptually-technical--no
working examples. I consider myself to be pretty good w/ css, js, dhtml, and
i find your docs meaningless. They may be great to software architects and
programmers, but not to ordinary web people.

The docs I manged to retrieve via the search box couldn't even tell me how
to access the DOM in order to change a font color on a css div element. Red
to blue. That's sad. On MSND, I search for "font css javascript" and BOOM,
there it is.

MSDN has *examples* that work. Code examples, actual .html pages that do
things. They show me things that may have been stated in techno-babble, but
never made sense until i *saw it*. Worth a thousand words. Plus, it proves
that the docs/syntax works. 

MSDN online. *Everything* I need as a developer, right there.

Consider it. If you aren't going to make the site easier to use, just put in
some working examples. After failing at your site, I spoke w/ the Gecko team
at NS. Eric and JTS and Vlad are writing their own docs, and were receptive
to the usability feedback.

Without the support of developers (users) you have nothing. 

Matt Del Vecchio
Web Developer
(612) 752-1118
(612) 865-7293 cell
Received on Tuesday, 12 December 2000 20:30:09 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:15:29 UTC