Re: Howto spec

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?