diff --git a/index.bs b/index.bs index 135b927e..007a352a 100644 --- a/index.bs +++ b/index.bs @@ -13396,6 +13396,29 @@ Extensions to any other aspect of the IDL language are strongly discouraged. +

Legacy constructs

+ +This section is informative. + +Legacy WebIDL constructs exist only so that +legacy Web platform features can be specified. +They are generally prefixed with the "Legacy" 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 filing an issue +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. + +

Referencing this specification

This section is informative.