Re: [heycam/webidl] [WIP] Link legacy APIs within the advisements (#416)

TimothyGu commented on this pull request.

I'm in favor of this change as well, as it can help limit any new usages of these extended attributes.

> +    The [{{LegacyArrayClass}}] [=extended attribute=] is an undesirable feature.
+    It exists only so that legacy Web platform features can be specified.
+    It should not be used in specifications
+    unless required to specify the behavior of legacy APIs,
+    or for consistency with these APIs.
+    Editors who wish to use this feature are strongly advised to discuss this
+    by <a href="https://github.com/w3c/respec/issues/new?title=[legacy]">filing an issue</a>
+    before proceeding.
+
+    <small class="non-normative">
+        The [{{LegacyArrayClass}}] [=extended attribute=] appears on
+        the following [=interfaces=]:
+        {{DOMRectList}},
+        {{MediaList}},
+        {{StyleSheetList}}, and
+        {{CSSRuleList}}. [[GEOMETRY]] [CSSOM]

Missing brackets around CSSOM?

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/heycam/webidl/pull/416#pullrequestreview-57803165