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
" 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.
+
+