- 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