On Thu, 03 May 2012 01:34:12 -0700, Marcos Caceres <[email protected]> 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/
