Specification links in code generated from WebIDL

Hi,

The HTML 5 Canvas spec (1) provides link targets of the form

CONSTANT_PREFIX + interfaceName.toLowerCase() + "-" +
operationName.toLowercase();

This makes it quite easy to link to the relevant parts of the
specification, for instance in IDEs and / or generated JavaDoc comments.
Unfortunately, other specifications such as WebGL or TypedArrays do not
follow this schema.

Do you think it would make sense to support this link schema as a general
recommendation in WebIDL?

Stefan

1)
http://www.whatwg.org/specs/web-apps/current-work/multipage/the-canvas-element.html

Received on Thursday, 23 February 2012 09:24:43 UTC