W3C home > Mailing lists > Public > public-webapps@w3.org > April to June 2012

Re: Howto spec

From: Glenn Adams <glenn@skynav.com>
Date: Wed, 23 May 2012 11:09:22 -0600
Message-ID: <CACQ=j+eM8+vrwysv-xGLxDFssjFLuVy5ecwGE6iYOUszAqX7iw@mail.gmail.com>
To: Anne van Kesteren <annevk@annevk.nl>
Cc: WebApps WG <public-webapps@w3.org>
On Wed, May 23, 2012 at 6:45 AM, Anne van Kesteren <annevk@annevk.nl> wrote:

> Hi,
>
> I have made some updates to the "howto spec" wiki page outlining how
> you should go about writing a specification, with some emphasis on
> specifications for APIs.
>
> http://wiki.whatwg.org/wiki/Howto_spec
>
> In particular the "Patterns" and "Legacy DOM-style" sections are
> probably of interest. I would love to have feedback to see what else
> people would like to see explained or how what is explained thus far
> can be done better.
>

I would like to see more explanation of some statements under the "Legacy
DOM-style" section, particularly:

   - what is the "particular style of defining methods and attributes" that
   is to be discouraged?
   - how does ReSpec.js use or promote the discouraged particulars?
Received on Wednesday, 23 May 2012 17:10:20 GMT

This archive was generated by hypermail 2.3.1 : Tuesday, 26 March 2013 18:49:52 GMT