Skip to content

Commit

Permalink
Add informative section on legacy constructs (#506)
Browse files Browse the repository at this point in the history
  • Loading branch information
tobie authored Jan 4, 2018
1 parent d28856d commit 1244c86
Showing 1 changed file with 23 additions and 0 deletions.
23 changes: 23 additions & 0 deletions index.bs
Original file line number Diff line number Diff line change
Expand Up @@ -13396,6 +13396,29 @@ Extensions to any other aspect of the IDL language are
strongly discouraged.


<h2 id="legacy-constructs">Legacy constructs</h4>

<i>This section is informative.</i>

Legacy WebIDL constructs exist only so that
legacy Web platform features can be specified.
They are generally prefixed with the "<code>Legacy</code>" string.
It is strongly discouraged to use legacy WebIDL constructs in specifications
unless required to specify the behavior of legacy Web platform features,
or for consistency with such features.
Editors who wish to use legacy WebIDL constructs are strongly advised to discuss this
by <a href="https://github.com/heycam/webidl/issues/new?title=Intent%20to%20use%20a%20legacy%20WebIDL%20construct">filing an issue</a>
before proceeding.

Marking a construct as legacy does not, in itself,
imply that it is about to be removed from this specification.
It does suggest however, that it is a good candidate
for future removal from this specification,
whenever various heuristics indicate that
the Web platform features it helps specify can be removed altogether
or can be modified to rely on non-legacy WebIDL constructs instead.


<h2 id="referencing">Referencing this specification</h2>

<i>This section is informative.</i>
Expand Down

0 comments on commit 1244c86

Please sign in to comment.