Tim Bray on the style chosen for writing the HTML5 and WebSockets standards(tbray.org)
tbray.org
Tim Bray on the style chosen for writing the HTML5 and WebSockets standards
http://www.tbray.org/ongoing/When/201x/2010/02/15/HTML5
3 comments
Goddamn do I hate specs that try and write code in English. Specifications are for WHAT I have to implement, not HOW.
For another offender, see ECMA-262, the Javascript specification.
For another offender, see ECMA-262, the Javascript specification.
The style of the spec very elegantly combines the disadvantages of a declarative written description and pseudocode.
Read Ian's response in the comments, its brilliant. I love when the author of the spec casually comments on some blog ;)
Also worth noting is Dorian Taylor's amusing troll.
I have more where that came from.
A good read, good points criticizing the spec. At first, I was dead set against HTML5 because I had been waiting for wide XHTML+RDFa adoption. That isn't going to happen now. Still, if HTML5 implementations are good and support web app portability between browsers, then I am happy enough with it. I also liked Bray's point on bring patent troll problems with video codecs more into the public view.
Completely agree. I found it very hard to get to the 'meat' of what the data format actually was. Look at the following.
Here's a sample from the spec:
I think you could better write this as: