W3C home > Mailing lists > Public > public-html-comments@w3.org > December 2011

how to read a spec

From: Elisabeth Robson <bethrobson@gmail.com>
Date: Fri, 9 Dec 2011 15:51:53 -0800
Message-ID: <CAFSNtX48qkvw=H+PGUoWbFvEV+_6RUnKDXb7LFfNuTJJo4H-iw@mail.gmail.com>
To: public-html-comments@w3.org
I think it would be very helpful if the W3C created a document for HTML
(and it's related specifications from the WAWG) on "How to read a
specification".  There could be two sections: one for browser implementors
and one for developers.  For every part of the spec (including the APIs),
link to this document, as well as to any mirrored documents being
maintained for that spec (or section) that are written specifically for
developers rather than implementors.  And I'd like to see links from the
"How to read" document to any other helpful documents (like  the Web IDL
spec, tutorials, etc).

What do you think?

I would find it incredibly helpful, especially given how much more
formalized the specs have become and because they are written for
implementors rather than developers (in general). And certainly those new
to reading the specs, and new to HTML, CSS, and JavaScript would benefit
from this.

Received on Saturday, 10 December 2011 04:26:18 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 20:26:28 UTC