- From: Anne van Kesteren <annevk@opera.com>
- Date: Thu, 03 May 2012 06:59:01 -0700
- To: "Simon Pieters" <simonp@opera.com>, "Marcos Caceres" <w3c@marcosc.com>
- Cc: "Jonas Sicking" <jonas@sicking.cc>, "Webapps WG" <public-webapps@w3.org>, "Robin Berjon" <robin@berjon.com>
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