Re: [IndexedDB] Checked in fix for ReSpec issue

On Thu, 03 May 2012 01:34:12 -0700, Marcos Caceres <w3c@marcosc.com> wrote:
> I strongly agree, but this is not Respec's fault. It's just a  
> particular(ly bad) editorial style adopted by some people. There is  
> nothing in Respec that prevents an editor from defining the algorithms  
> properly and then linking to them (as is done in HTML and DOM4).

Doesn't Respec encourage the style of

   member
     Member description.

     Parameters
       Parameter description.

     Return value
       Return value description.

     Exception 1
       Exception 1 description.
     Exception 2
       Exception 2 description.

whereas what you really want is

The member(Parameters) method must run these steps:

   1. ...

   2. ... throw Exception 2 ...

   ...

This is why I tell people to use http://wiki.whatwg.org/wiki/Anolis  
instead.


-- 
Anne van Kesteren
http://annevankesteren.nl/

Received on Thursday, 3 May 2012 13:59:49 UTC