W3C home > Mailing lists > Public > public-script-coord@w3.org > January to March 2012

Specification links in code generated from WebIDL

From: Stefan Haustein <haustein@google.com>
Date: Wed, 22 Feb 2012 13:39:58 +0100
Message-ID: <CABCa6-q+h_USS8ykgKtp6HRnC1A1A5M=vKPBGE1xgTbuMec4pg@mail.gmail.com>
To: public-script-coord@w3.org
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

This archive was generated by hypermail 2.3.1 : Wednesday, 8 May 2013 19:30:05 UTC