From a9ed4dd8ef27d70eaac80cdcc1fbcf10dc98fff3 Mon Sep 17 00:00:00 2001
From: Tobie Langel <tobie@codespeaks.com>
Date: Thu, 17 Aug 2017 12:26:06 +0200
Subject: [PATCH 01/22] Link legacy APIs within the advisements

Make advisements more prominent.
---
 index.bs | 119 +++++++++++++++++++++++++++++++++++++++----------------
 1 file changed, 84 insertions(+), 35 deletions(-)

diff --git a/index.bs b/index.bs
index 6a52cc4e..98aba89b 100644
--- a/index.bs
+++ b/index.bs
@@ -29,14 +29,24 @@ Boilerplate: omit issues-index, omit conformance, omit feedback-header
 
 <pre class="link-defaults">
 spec: infra; type: dfn; text: list
+spec: url; type: interface; text: URL
+spec: dom; type: interface; text: Document
 </pre>
 
 <pre class="anchors">
 urlPrefix: https://html.spec.whatwg.org/; spec: HTML
     type: interface
-        text: Audio; url: dom-audio
-        text: Option; url: dom-option
-        text: Image; url: dom-image
+        text: HTMLAudioElement; url: htmlaudioelement
+        text: HTMLOptionElement; url: htmloptionelement
+        text: HTMLImageElement; url: htmlimageelement
+        text: onmouseenter; for: Document; url: handler-onmouseenter
+        text: onmouseleave; for: Document; url: handler-onmouseleave
+        text: onreadystatechange; for: Document; url: handler-onreadystatechange
+urlPrefix: https://fullscreen.spec.whatwg.org/; spec: FULLSCREEN
+    type: interface;
+        text: fullscreenEnabled; for: Document; url: dom-document-fullscreenenabled
+        text: fullscreen; for: Document; url: dom-document-fullscreen
+        text: fullscreenElement; for: DocumentOrShadowRoot; url: dom-document-fullscreenelement
 urlPrefix: http://www.unicode.org/glossary/; spec: UNICODE
     type: dfn
         text: Unicode scalar value; url: unicode_scalar_value
@@ -157,6 +167,14 @@ urlPrefix: https://tc39.github.io/ecma262/; spec: ECMA-262
         text: JSON.stringify; url: sec-json.stringify
 </pre>
 
+<pre class=biblio>
+{
+    "GEOMETRY": {
+        "aliasOf": "GEOMETRY-1"
+    }
+}
+</pre>
+
 <style>
         pre.set {
           font-size: 80%;
@@ -8546,6 +8564,23 @@ entails.
 
 <h4 id="LegacyWindowAlias" extended-attribute lt="LegacyWindowAlias">[LegacyWindowAlias]</h4>
 
+<div class="advisement">
+
+    [{{LegacyWindowAlias}}] [=extended attributes=] are an undesirable feature.
+    They exist only so that legacy Web platform features can be specified.
+    They should not be used in specifications
+    unless required to specify the behavior of legacy APIs.
+
+    <p class="note">
+        The [{{LegacyWindowAlias}}] [=extended attribute=] appears on the following [=interfaces=]:
+        {{DOMPoint}},
+        {{DOMRect}},
+        {{DOMMatrix}}, and
+        {{URL}}. [[GEOMETRY]] [[URL]]
+    </p>
+
+</div>
+
 If the [{{LegacyWindowAlias}}] [=extended attribute=] appears on an [=interface=],
 it indicates that the [=primary global interface=] will have a property
 for each [=identifier=] mentioned in the extended attribute,
@@ -8580,13 +8615,6 @@ An interface must not have more than one [{{LegacyWindowAlias}}] extended attrib
 See [[#es-interfaces]] for details on how legacy window aliases
 are to be implemented.
 
-<p class="advisement">
-    [{{LegacyWindowAlias}}] extended attributes are an undesirable feature.
-    They exist only so that legacy Web platform features can be specified.
-    They should not be used in specifications
-    unless required to specify the behavior of legacy APIs.
-</p>
-
 <div class="example">
 
     The following IDL defines an interface that uses the
@@ -8621,14 +8649,6 @@ are to be implemented.
 
 <h4 id="LenientSetter" extended-attribute lt="LenientSetter">[LenientSetter]</h4>
 
-If the [{{LenientSetter}}]
-[=extended attribute=]
-appears on a [=read only=]
-[=regular attribute=],
-it indicates that a no-op setter will be generated for the attribute’s
-accessor property.  This results in erroneous assignments to the property
-in strict mode to be ignored rather than causing an exception to be thrown.
-
 <div class="advisement">
 
     Specifications should not use [{{LenientSetter}}]
@@ -8644,8 +8664,24 @@ in strict mode to be ignored rather than causing an exception to be thrown.
     <a href="mailto:public-script-coord@w3.org">public-script-coord@w3.org</a>
     mailing list before proceeding.
 
+    <p class="note">
+        The [{{LenientSetter}}] [=extended attribute=] appears on
+        the {{Document/fullscreenEnabled}} and {{Document/fullscreenEnabled}} [=attributes=]
+        of the {{Document}} interface, and on
+        the {{DocumentOrShadowRoot/fullscreenElement}} [=attribute=]
+        of the {{DocumentOrShadowRoot}} mixin. [[FULLSCREEN]]
+    </p>
+
 </div>
 
+If the [{{LenientSetter}}]
+[=extended attribute=]
+appears on a [=read only=]
+[=regular attribute=],
+it indicates that a no-op setter will be generated for the attribute’s
+accessor property.  This results in erroneous assignments to the property
+in strict mode to be ignored rather than causing an exception to be thrown.
+
 The [{{LenientThis}}] extended attribute
 must [=takes no arguments|take no arguments=].
 It must not be used on anything other than
@@ -8695,6 +8731,22 @@ See the <a href="#es-attributes">Attributes</a> section for how
 
 <h4 id="LenientThis" extended-attribute lt="LenientThis">[LenientThis]</h4>
 
+<div class="advisement">
+    Specifications should not use [{{LenientThis}}]
+    unless required for compatibility reasons.  Specification authors who
+    wish to use this feature are strongly advised to discuss this on the
+    <a href="mailto:public-script-coord@w3.org">public-script-coord@w3.org</a>
+    mailing list before proceeding.
+
+    <p class="note">
+        The [{{LenientThis}}] [=extended attribute=] appears on
+        the {{Document/onreadystatechange}},
+        {{Document/onmouseenter}}, and
+        {{Document/onmouseleave}} [=attributes=]
+        of the {{Document}} interface. [[HTML]]
+    </p>
+</div>
+
 If the [{{LenientThis}}]
 [=extended attribute=]
 appears on a [=regular attribute=],
@@ -8712,14 +8764,6 @@ It must not be used on a
 The [{{LenientThis}}] extended attribute must not be used on an attribute declared on a
 [=namespace=].
 
-<p class="advisement">
-    Specifications should not use [{{LenientThis}}]
-    unless required for compatibility reasons.  Specification authors who
-    wish to use this feature are strongly advised to discuss this on the
-    <a href="mailto:public-script-coord@w3.org">public-script-coord@w3.org</a>
-    mailing list before proceeding.
-</p>
-
 See the <a href="#es-attributes">Attributes</a> section for how
 [{{LenientThis}}]
 is to be implemented.
@@ -8763,6 +8807,20 @@ is to be implemented.
 
 <h4 id="NamedConstructor" extended-attribute lt="NamedConstructor">[NamedConstructor]</h4>
 
+<div class="advisement">
+
+    [{{NamedConstructor}}] [=extended attributes=] are an undesirable feature.
+    They exist only so that legacy Web platform features can be specified.
+    They should not be used in specifications
+    unless required to specify the behavior of legacy APIs.
+
+    <p class="note">
+        Known [=interfaces=] requiring the use of the [{{NamedConstructor}}] [=extended attribute=] are:
+        {{HTMLAudioElement}}, {{HTMLOptionElement}} and {{HTMLImageElement}}. [[HTML]]
+    </p>
+
+</div>
+
 If the [{{NamedConstructor}}]
 [=extended attribute=]
 appears on an [=interface=],
@@ -8801,15 +8859,6 @@ must not be used on a [=callback interface=].
 See [[#named-constructors]] for details on how named constructors
 are to be implemented.
 
-<p class="advisement">
-    [{{NamedConstructor}}] extended attributes are an undesirable feature.
-    They exist only so that legacy Web platform features can be specified.
-    They should not be used in specifications
-    unless required to specify the behavior of legacy APIs.
-    Known APIs requiring the use of [{{NamedConstructor}}] extended attributes are:
-    {{Audio}}, {{Option}} and {{Image}}.
-</p>
-
 <div class="example">
 
     The following IDL defines an interface that uses the

From 1c63dbc2c249aa63534a1678b8963e0f96d03064 Mon Sep 17 00:00:00 2001
From: Tobie Langel <tobie@codespeaks.com>
Date: Thu, 17 Aug 2017 13:00:54 +0200
Subject: [PATCH 02/22] Use small.non-normative instead of p.note

---
 index.bs | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/index.bs b/index.bs
index 98aba89b..4d42401d 100644
--- a/index.bs
+++ b/index.bs
@@ -8571,13 +8571,13 @@ entails.
     They should not be used in specifications
     unless required to specify the behavior of legacy APIs.
 
-    <p class="note">
+    <small class="non-normative">
         The [{{LegacyWindowAlias}}] [=extended attribute=] appears on the following [=interfaces=]:
         {{DOMPoint}},
         {{DOMRect}},
         {{DOMMatrix}}, and
         {{URL}}. [[GEOMETRY]] [[URL]]
-    </p>
+    </small>
 
 </div>
 
@@ -8664,13 +8664,13 @@ are to be implemented.
     <a href="mailto:public-script-coord@w3.org">public-script-coord@w3.org</a>
     mailing list before proceeding.
 
-    <p class="note">
+    <small class="non-normative">
         The [{{LenientSetter}}] [=extended attribute=] appears on
         the {{Document/fullscreenEnabled}} and {{Document/fullscreenEnabled}} [=attributes=]
         of the {{Document}} interface, and on
         the {{DocumentOrShadowRoot/fullscreenElement}} [=attribute=]
         of the {{DocumentOrShadowRoot}} mixin. [[FULLSCREEN]]
-    </p>
+    </small>
 
 </div>
 
@@ -8738,13 +8738,13 @@ See the <a href="#es-attributes">Attributes</a> section for how
     <a href="mailto:public-script-coord@w3.org">public-script-coord@w3.org</a>
     mailing list before proceeding.
 
-    <p class="note">
+    <small class="non-normative">
         The [{{LenientThis}}] [=extended attribute=] appears on
         the {{Document/onreadystatechange}},
         {{Document/onmouseenter}}, and
         {{Document/onmouseleave}} [=attributes=]
         of the {{Document}} interface. [[HTML]]
-    </p>
+    </small>
 </div>
 
 If the [{{LenientThis}}]
@@ -8814,10 +8814,10 @@ is to be implemented.
     They should not be used in specifications
     unless required to specify the behavior of legacy APIs.
 
-    <p class="note">
+    <small class="non-normative">
         Known [=interfaces=] requiring the use of the [{{NamedConstructor}}] [=extended attribute=] are:
         {{HTMLAudioElement}}, {{HTMLOptionElement}} and {{HTMLImageElement}}. [[HTML]]
-    </p>
+    </small>
 
 </div>
 

From d2b96a3f7ec18474c3260d43ed1994ceb36ab811 Mon Sep 17 00:00:00 2001
From: Tobie Langel <tobie@codespeaks.com>
Date: Thu, 17 Aug 2017 18:13:56 +0200
Subject: [PATCH 03/22] Add TreatNonObjectAsNull to the list

---
 index.bs | 33 ++++++++++++++++++++-------------
 1 file changed, 20 insertions(+), 13 deletions(-)

diff --git a/index.bs b/index.bs
index 4d42401d..9115e706 100644
--- a/index.bs
+++ b/index.bs
@@ -9436,6 +9436,26 @@ that does specify [{{SecureContext}}].
 
 <h4 id="TreatNonObjectAsNull" extended-attribute lt="TreatNonObjectAsNull">[TreatNonObjectAsNull]</h4>
 
+<div class="advisement">
+    Specifications should not use [{{TreatNonObjectAsNull}}] 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">
+        At the time of writing,
+        the only known valid use of [{{TreatNonObjectAsNull}}]
+        is for the [=callback functions=] {{EventHandlerNonNull}},
+        {{OnBeforeUnloadEventHandlerNonNull}}, and
+        {{OnErrorEventHandlerNonNull}}
+        used as the type of [=event handler IDL attributes=]
+        such as <code>onclick</code> and <code>onerror</code>. [[HTML]]
+    </small>
+
+</div>
+
 If the [{{TreatNonObjectAsNull}}]
 [=extended attribute=]
 appears on a [=callback function=],
@@ -9445,19 +9465,6 @@ whose type is a [=nullable type|nullable=]
 that is not an object will be converted to
 the <emu-val>null</emu-val> value.
 
-<p class="advisement">
-    Specifications should not use [{{TreatNonObjectAsNull}}]
-    unless required to specify the behavior of legacy APIs or for consistency with these
-    APIs.  Specification authors who
-    wish to use this feature are strongly advised to discuss this on the
-    <a href="mailto:public-script-coord@w3.org">public-script-coord@w3.org</a>
-    mailing list before proceeding.  At the time of writing, the only known
-    valid use of [{{TreatNonObjectAsNull}}]
-    is for the [=callback functions=] used as the type
-    of [=event handler IDL attributes=]
-    such as <code>onclick</code> and <code>onerror</code>.
-</p>
-
 See [[#es-nullable-type]]
 for the specific requirements that the use of
 [{{TreatNonObjectAsNull}}] entails.

From 1f81a2db3fd674e0364163f9182b55083de1a1f0 Mon Sep 17 00:00:00 2001
From: Tobie Langel <tobie@codespeaks.com>
Date: Thu, 17 Aug 2017 18:14:29 +0200
Subject: [PATCH 04/22] Add suggestion to file issue before proceeding

---
 index.bs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/index.bs b/index.bs
index 9115e706..63f760fe 100644
--- a/index.bs
+++ b/index.bs
@@ -8570,6 +8570,9 @@ entails.
     They exist only so that legacy Web platform features can be specified.
     They should not be used in specifications
     unless required to specify the behavior of legacy 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 [{{LegacyWindowAlias}}] [=extended attribute=] appears on the following [=interfaces=]:
@@ -8813,6 +8816,9 @@ is to be implemented.
     They exist only so that legacy Web platform features can be specified.
     They should not be used in specifications
     unless required to specify the behavior of legacy 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">
         Known [=interfaces=] requiring the use of the [{{NamedConstructor}}] [=extended attribute=] are:

From a2b7a1d0de472daf61be73897a97a3a10c6fabab Mon Sep 17 00:00:00 2001
From: Tobie Langel <tobie@codespeaks.com>
Date: Thu, 17 Aug 2017 18:14:50 +0200
Subject: [PATCH 05/22] Ask to file issue instead of taking to the mailing list

---
 index.bs | 16 +++++++---------
 1 file changed, 7 insertions(+), 9 deletions(-)

diff --git a/index.bs b/index.bs
index 63f760fe..ab3817d0 100644
--- a/index.bs
+++ b/index.bs
@@ -8661,11 +8661,9 @@ are to be implemented.
     exists.  In strict mode, this would cause an exception to be thrown,
     potentially breaking page.  Without [{{LenientSetter}}],
     this could prevent a browser from shipping the feature.
-
-    Specification authors who
-    wish to use this feature are strongly advised to discuss this on the
-    <a href="mailto:public-script-coord@w3.org">public-script-coord@w3.org</a>
-    mailing list before proceeding.
+    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 [{{LenientSetter}}] [=extended attribute=] appears on
@@ -8736,10 +8734,10 @@ See the <a href="#es-attributes">Attributes</a> section for how
 
 <div class="advisement">
     Specifications should not use [{{LenientThis}}]
-    unless required for compatibility reasons.  Specification authors who
-    wish to use this feature are strongly advised to discuss this on the
-    <a href="mailto:public-script-coord@w3.org">public-script-coord@w3.org</a>
-    mailing list before proceeding.
+    unless required for compatibility reasons. 
+    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 [{{LenientThis}}] [=extended attribute=] appears on

From 3df3d523ced1bc7c59624b42dff80ac1613e2820 Mon Sep 17 00:00:00 2001
From: Tobie Langel <tobie@codespeaks.com>
Date: Thu, 17 Aug 2017 18:27:57 +0200
Subject: [PATCH 06/22] Whitespace

---
 index.bs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/index.bs b/index.bs
index ab3817d0..b7b21c55 100644
--- a/index.bs
+++ b/index.bs
@@ -8733,6 +8733,7 @@ See the <a href="#es-attributes">Attributes</a> section for how
 <h4 id="LenientThis" extended-attribute lt="LenientThis">[LenientThis]</h4>
 
 <div class="advisement">
+
     Specifications should not use [{{LenientThis}}]
     unless required for compatibility reasons. 
     Editors who wish to use this feature are strongly advised to discuss this
@@ -8746,6 +8747,7 @@ See the <a href="#es-attributes">Attributes</a> section for how
         {{Document/onmouseleave}} [=attributes=]
         of the {{Document}} interface. [[HTML]]
     </small>
+
 </div>
 
 If the [{{LenientThis}}]
@@ -9441,6 +9443,7 @@ that does specify [{{SecureContext}}].
 <h4 id="TreatNonObjectAsNull" extended-attribute lt="TreatNonObjectAsNull">[TreatNonObjectAsNull]</h4>
 
 <div class="advisement">
+
     Specifications should not use [{{TreatNonObjectAsNull}}] unless
     required to specify the behavior of legacy APIs
     or for consistency with these APIs.

From d38b789422571c4e9f4ed1ec1a330528e724323c Mon Sep 17 00:00:00 2001
From: Tobie Langel <tobie@codespeaks.com>
Date: Thu, 17 Aug 2017 18:28:14 +0200
Subject: [PATCH 07/22] Issues instead of mailing list.

---
 index.bs | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/index.bs b/index.bs
index b7b21c55..82202c5f 100644
--- a/index.bs
+++ b/index.bs
@@ -3412,8 +3412,8 @@ is.
     [=support indexed properties=],
     or (b) with a forEach method that instead invokes its callback like
     Set.protoype.forEach (where the key is the same as the value).
-    If you’re creating an API that needs such a forEach method, please send a request to
-    <a href="mailto:public-script-coord@w3.org">public-script-coord@w3.org</a>.
+    If you’re creating an API that needs such a forEach method, please
+    <a href="https://github.com/w3c/respec/issues/new?title=[Iterable forEach]">file an issue</a>.
 
 </div>
 
@@ -8951,10 +8951,10 @@ will not exist for the interface in the ECMAScript binding.
     The [{{NoInterfaceObject}}] extended attribute
     should not be used on interfaces that are not
     solely used as [=supplemental interfaces|supplemental=] interfaces,
-    unless there are clear Web compatibility reasons for doing so.  Specification authors who
-    wish to use this feature are strongly advised to discuss this on the
-    <a href="mailto:public-script-coord@w3.org">public-script-coord@w3.org</a>
-    mailing list before proceeding.
+    unless there are clear Web compatibility reasons for doing so. 
+    Editors who wish to use this feature are strongly advised to discuss this
+    by <a href="https://github.com/w3c/respec/issues/new?title=[NoInterfaceObject]">filing an issue</a>
+    before proceeding.
 </p>
 
 The [{{NoInterfaceObject}}] extended attribute

From 4e392a823d55f4a8be2c9e5e0656ed3b5a6a47dd Mon Sep 17 00:00:00 2001
From: Tobie Langel <tobie@codespeaks.com>
Date: Thu, 17 Aug 2017 18:41:03 +0200
Subject: [PATCH 08/22] Remove fullscreen from anchors now that it's in
 Shepherd

---
 index.bs | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/index.bs b/index.bs
index 82202c5f..48fe4b1a 100644
--- a/index.bs
+++ b/index.bs
@@ -42,11 +42,6 @@ urlPrefix: https://html.spec.whatwg.org/; spec: HTML
         text: onmouseenter; for: Document; url: handler-onmouseenter
         text: onmouseleave; for: Document; url: handler-onmouseleave
         text: onreadystatechange; for: Document; url: handler-onreadystatechange
-urlPrefix: https://fullscreen.spec.whatwg.org/; spec: FULLSCREEN
-    type: interface;
-        text: fullscreenEnabled; for: Document; url: dom-document-fullscreenenabled
-        text: fullscreen; for: Document; url: dom-document-fullscreen
-        text: fullscreenElement; for: DocumentOrShadowRoot; url: dom-document-fullscreenelement
 urlPrefix: http://www.unicode.org/glossary/; spec: UNICODE
     type: dfn
         text: Unicode scalar value; url: unicode_scalar_value

From b93d6c529aa3975b5a939bfe1c0f63aa4cc22b1e Mon Sep 17 00:00:00 2001
From: Tobie Langel <tobie@codespeaks.com>
Date: Fri, 18 Aug 2017 01:21:56 +0200
Subject: [PATCH 09/22] Add advisement for [OverrideBuiltins]

---
 index.bs | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/index.bs b/index.bs
index 48fe4b1a..ede9e1d2 100644
--- a/index.bs
+++ b/index.bs
@@ -9015,6 +9015,24 @@ for the specific requirements that the use of
 
 <h4 id="OverrideBuiltins" extended-attribute lt="OverrideBuiltins">[OverrideBuiltins]</h4>
 
+<div class="advisement">
+
+    Specifications should not use [{{OverrideBuiltins}}] 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 [{{OverrideBuiltins}}] [=extended attribute=] appears on the
+        {{DOMStringMap}},
+        {{Document}}, and
+        {{HTMLFormElement}} [=interfaces=]. [[HTML]]
+    </small>
+
+</div>
+
 If the [{{OverrideBuiltins}}]
 [=extended attribute=]
 appears on an [=interface=],

From 6bb519f0aea834af6eff3bf63b0a9357e5ca30e2 Mon Sep 17 00:00:00 2001
From: Tobie Langel <tobie@codespeaks.com>
Date: Fri, 18 Aug 2017 10:00:18 +0200
Subject: [PATCH 10/22] Remove unnecessary HTML anchors

---
 index.bs | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/index.bs b/index.bs
index ede9e1d2..33a206e0 100644
--- a/index.bs
+++ b/index.bs
@@ -36,9 +36,6 @@ spec: dom; type: interface; text: Document
 <pre class="anchors">
 urlPrefix: https://html.spec.whatwg.org/; spec: HTML
     type: interface
-        text: HTMLAudioElement; url: htmlaudioelement
-        text: HTMLOptionElement; url: htmloptionelement
-        text: HTMLImageElement; url: htmlimageelement
         text: onmouseenter; for: Document; url: handler-onmouseenter
         text: onmouseleave; for: Document; url: handler-onmouseleave
         text: onreadystatechange; for: Document; url: handler-onreadystatechange

From d092aa2996f77dec2975fd4b3066635dc3d798ca Mon Sep 17 00:00:00 2001
From: Tobie Langel <tobie@codespeaks.com>
Date: Fri, 18 Aug 2017 10:01:47 +0200
Subject: [PATCH 11/22] Minor refactoring

---
 index.bs | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/index.bs b/index.bs
index 33a206e0..8e1573e7 100644
--- a/index.bs
+++ b/index.bs
@@ -8932,17 +8932,14 @@ a [=promise type=].
 
 <h4 id="NoInterfaceObject" extended-attribute lt="NoInterfaceObject">[NoInterfaceObject]</h4>
 
-If the [{{NoInterfaceObject}}]
-[=extended attribute=]
-appears on an [=interface=],
-it indicates that an
-[=interface object=]
+If the [{{NoInterfaceObject}}] [=extended attribute=] appears on an [=interface=],
+it indicates that an [=interface object=]
 will not exist for the interface in the ECMAScript binding.
 
 <p class="advisement">
-    The [{{NoInterfaceObject}}] extended attribute
-    should not be used on interfaces that are not
-    solely used as [=supplemental interfaces|supplemental=] interfaces,
+    The [{{NoInterfaceObject}}] [=extended attribute=]
+    should not be used on [=interfaces=] that are not
+    solely used as [=supplemental interfaces=],
     unless there are clear Web compatibility reasons for doing so. 
     Editors who wish to use this feature are strongly advised to discuss this
     by <a href="https://github.com/w3c/respec/issues/new?title=[NoInterfaceObject]">filing an issue</a>

From 0225e14520446f8b53cb6ee62ee0a7402ef19cd8 Mon Sep 17 00:00:00 2001
From: Tobie Langel <tobie@codespeaks.com>
Date: Tue, 22 Aug 2017 01:00:38 +0200
Subject: [PATCH 12/22] Remove now unnecessary anchor dfns

---
 index.bs | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/index.bs b/index.bs
index 8e1573e7..52b62b34 100644
--- a/index.bs
+++ b/index.bs
@@ -34,11 +34,6 @@ spec: dom; type: interface; text: Document
 </pre>
 
 <pre class="anchors">
-urlPrefix: https://html.spec.whatwg.org/; spec: HTML
-    type: interface
-        text: onmouseenter; for: Document; url: handler-onmouseenter
-        text: onmouseleave; for: Document; url: handler-onmouseleave
-        text: onreadystatechange; for: Document; url: handler-onreadystatechange
 urlPrefix: http://www.unicode.org/glossary/; spec: UNICODE
     type: dfn
         text: Unicode scalar value; url: unicode_scalar_value

From 3a840fd9e6dc7e04a7fc374244e317868fa3f10c Mon Sep 17 00:00:00 2001
From: Tobie Langel <tobie@codespeaks.com>
Date: Tue, 22 Aug 2017 16:05:27 +0200
Subject: [PATCH 13/22] Make LegacyWindowAlias test singular.

---
 index.bs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/index.bs b/index.bs
index 52b62b34..0696c9ad 100644
--- a/index.bs
+++ b/index.bs
@@ -8553,9 +8553,9 @@ entails.
 
 <div class="advisement">
 
-    [{{LegacyWindowAlias}}] [=extended attributes=] are an undesirable feature.
-    They exist only so that legacy Web platform features can be specified.
-    They should not be used in specifications
+    The [{{LegacyWindowAlias}}] [=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.
     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>

From 17822192b4397392e80faae92acbf22c839ec380 Mon Sep 17 00:00:00 2001
From: Tobie Langel <tobie@codespeaks.com>
Date: Tue, 22 Aug 2017 16:05:44 +0200
Subject: [PATCH 14/22] Add advisement for LegacyUnenumerableNamedProperties

---
 index.bs | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/index.bs b/index.bs
index 0696c9ad..62c8fe87 100644
--- a/index.bs
+++ b/index.bs
@@ -8527,6 +8527,31 @@ entails.
 
 <h4 id="LegacyUnenumerableNamedProperties" extended-attribute lt="LegacyUnenumerableNamedProperties">[LegacyUnenumerableNamedProperties]</h4>
 
+<div class="advisement">
+
+    The [{{LegacyUnenumerableNamedProperties}}] [=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.
+    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 [{{LegacyUnenumerableNamedProperties}}] [=extended attribute=] appears on
+        the following [=interfaces=]:
+        {{HTMLCollection}},
+        {{NamedNodeMap}},
+        {{HTMLAllCollection}},
+        {{HTMLFormElement}},
+        {{PluginArray}},
+        {{MimeTypeArray}},
+        {{Plugin}}, and
+        {{Window}}. [[DOM]] [[HTML]]
+    </small>
+
+</div>
+
 If the [{{LegacyUnenumerableNamedProperties}}]
 [=extended attribute=]
 appears on a [=interface=]

From 08403db8dbc85a0dbfb88f27ea12d713f3628ca5 Mon Sep 17 00:00:00 2001
From: Tobie Langel <tobie@codespeaks.com>
Date: Tue, 22 Aug 2017 16:16:53 +0200
Subject: [PATCH 15/22] Add LegacyArrayClass advisement

---
 index.bs | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/index.bs b/index.bs
index 62c8fe87..cb14edf4 100644
--- a/index.bs
+++ b/index.bs
@@ -8453,6 +8453,27 @@ corresponding to [=interface members=].
 
 <h4 id="LegacyArrayClass" extended-attribute lt="LegacyArrayClass">[LegacyArrayClass]</h4>
 
+<div class="advisement">
+
+    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.
+    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]
+    </small>
+
+</div>
+
 If the [{{LegacyArrayClass}}]
 [=extended attribute=]
 appears on an [=interface=]

From ff11a474eda0213ea88dde0186f23c7d31130852 Mon Sep 17 00:00:00 2001
From: Tobie Langel <tobie@codespeaks.com>
Date: Tue, 22 Aug 2017 16:36:58 +0200
Subject: [PATCH 16/22] Make advisements more consistent.

---
 index.bs | 18 +++++++++++-------
 1 file changed, 11 insertions(+), 7 deletions(-)

diff --git a/index.bs b/index.bs
index cb14edf4..da370951 100644
--- a/index.bs
+++ b/index.bs
@@ -8458,7 +8458,8 @@ corresponding to [=interface members=].
     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.
+    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.
@@ -8553,7 +8554,8 @@ entails.
     The [{{LegacyUnenumerableNamedProperties}}] [=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.
+    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.
@@ -8602,7 +8604,8 @@ entails.
     The [{{LegacyWindowAlias}}] [=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.
+    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.
@@ -8845,10 +8848,11 @@ is to be implemented.
 
 <div class="advisement">
 
-    [{{NamedConstructor}}] [=extended attributes=] are an undesirable feature.
-    They exist only so that legacy Web platform features can be specified.
-    They should not be used in specifications
-    unless required to specify the behavior of legacy APIs.
+    [{{NamedConstructor}}] [=extended attributes=] 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.

From 74baae23a1bf14c4398eead934fb65dc7ebc16c8 Mon Sep 17 00:00:00 2001
From: Tobie Langel <tobie@codespeaks.com>
Date: Tue, 22 Aug 2017 16:46:51 +0200
Subject: [PATCH 17/22] Minor edits.

---
 index.bs | 38 +++++++++++++++++++++++++++-----------
 1 file changed, 27 insertions(+), 11 deletions(-)

diff --git a/index.bs b/index.bs
index da370951..3262744f 100644
--- a/index.bs
+++ b/index.bs
@@ -8848,7 +8848,7 @@ is to be implemented.
 
 <div class="advisement">
 
-    [{{NamedConstructor}}] [=extended attributes=] is an undesirable feature.
+    [{{NamedConstructor}}] [=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,
@@ -8858,8 +8858,10 @@ is to be implemented.
     before proceeding.
 
     <small class="non-normative">
-        Known [=interfaces=] requiring the use of the [{{NamedConstructor}}] [=extended attribute=] are:
-        {{HTMLAudioElement}}, {{HTMLOptionElement}} and {{HTMLImageElement}}. [[HTML]]
+        The [{{NamedConstructor}}] [=extended attribute=] appears on the following [=interfaces=]:
+        {{HTMLAudioElement}},
+        {{HTMLOptionElement}}, and
+        {{HTMLImageElement}}. [[HTML]]
     </small>
 
 </div>
@@ -9056,8 +9058,10 @@ for the specific requirements that the use of
 
 <div class="advisement">
 
-    Specifications should not use [{{OverrideBuiltins}}] unless
-    required to specify the behavior of legacy APIs
+    The [{{OverrideBuiltins}}] [=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>
@@ -9495,18 +9499,19 @@ that does specify [{{SecureContext}}].
 <h4 id="TreatNonObjectAsNull" extended-attribute lt="TreatNonObjectAsNull">[TreatNonObjectAsNull]</h4>
 
 <div class="advisement">
-
-    Specifications should not use [{{TreatNonObjectAsNull}}] unless
-    required to specify the behavior of legacy APIs
+    
+    The [{{TreatNonObjectAsNull}}] [=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">
-        At the time of writing,
-        the only known valid use of [{{TreatNonObjectAsNull}}]
-        is for the [=callback functions=] {{EventHandlerNonNull}},
+        The [{{TreatNonObjectAsNull}}] [=extended attribute=] appears on
+        the [=callback functions=] {{EventHandlerNonNull}},
         {{OnBeforeUnloadEventHandlerNonNull}}, and
         {{OnErrorEventHandlerNonNull}}
         used as the type of [=event handler IDL attributes=]
@@ -9574,6 +9579,17 @@ for the specific requirements that the use of
 
 <h4 id="TreatNullAs" extended-attribute lt="TreatNullAs">[TreatNullAs]</h4>
 
+<p class="advisement">
+    The [{{TreatNullAs}}] [=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.
+</div>
+
 If the [{{TreatNullAs}}] [=extended attribute=] appears on the {{DOMString}} type, it creates a new
 IDL type such that that when an ECMAScript <emu-val>null</emu-val> is converted to the IDL type, it
 will be handled differently from its default handling. Instead of being stringified to

From b6d33bddd0a030a14bd99b9cc18dbb7924bbfb32 Mon Sep 17 00:00:00 2001
From: Tobie Langel <tobie@codespeaks.com>
Date: Tue, 22 Aug 2017 16:58:21 +0200
Subject: [PATCH 18/22] Add missing brackets

---
 index.bs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.bs b/index.bs
index 3262744f..365de6f3 100644
--- a/index.bs
+++ b/index.bs
@@ -8470,7 +8470,7 @@ corresponding to [=interface members=].
         {{DOMRectList}},
         {{MediaList}},
         {{StyleSheetList}}, and
-        {{CSSRuleList}}. [[GEOMETRY]] [CSSOM]
+        {{CSSRuleList}}. [[GEOMETRY]] [[CSSOM]]
     </small>
 
 </div>

From 560871477d8c4205159c9bd7693c0cad77b7b096 Mon Sep 17 00:00:00 2001
From: Tobie Langel <tobie@codespeaks.com>
Date: Thu, 24 Aug 2017 19:28:10 +0200
Subject: [PATCH 19/22] Fixup! Wrong links.

---
 index.bs | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/index.bs b/index.bs
index 365de6f3..25e97afa 100644
--- a/index.bs
+++ b/index.bs
@@ -3400,7 +3400,7 @@ is.
     or (b) with a forEach method that instead invokes its callback like
     Set.protoype.forEach (where the key is the same as the value).
     If you’re creating an API that needs such a forEach method, please
-    <a href="https://github.com/w3c/respec/issues/new?title=[Iterable forEach]">file an issue</a>.
+    <a href="https://github.com/heycam/webidl/issues/new?title=[Iterable%20forEach]">file an issue</a>.
 
 </div>
 
@@ -8461,7 +8461,7 @@ corresponding to [=interface members=].
     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>
+    by <a href="https://github.com/heycam/webidl/issues/new?title=[legacy]">filing an issue</a>
     before proceeding.
 
     <small class="non-normative">
@@ -8557,7 +8557,7 @@ entails.
     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>
+    by <a href="https://github.com/heycam/webidl/issues/new?title=[legacy]">filing an issue</a>
     before proceeding.
 
     <small class="non-normative">
@@ -8607,7 +8607,7 @@ entails.
     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>
+    by <a href="https://github.com/heycam/webidl/issues/new?title=[legacy]">filing an issue</a>
     before proceeding.
 
     <small class="non-normative">
@@ -8698,7 +8698,7 @@ are to be implemented.
     potentially breaking page.  Without [{{LenientSetter}}],
     this could prevent a browser from shipping the feature.
     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>
+    by <a href="https://github.com/heycam/webidl/issues/new?title=[legacy]">filing an issue</a>
     before proceeding.
 
     <small class="non-normative">
@@ -8773,7 +8773,7 @@ See the <a href="#es-attributes">Attributes</a> section for how
     Specifications should not use [{{LenientThis}}]
     unless required for compatibility reasons. 
     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>
+    by <a href="https://github.com/heycam/webidl/issues/new?title=[legacy]">filing an issue</a>
     before proceeding.
 
     <small class="non-normative">
@@ -8854,7 +8854,7 @@ is to be implemented.
     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>
+    by <a href="https://github.com/heycam/webidl/issues/new?title=[legacy]">filing an issue</a>
     before proceeding.
 
     <small class="non-normative">
@@ -9064,7 +9064,7 @@ for the specific requirements that the use of
     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>
+    by <a href="https://github.com/heycam/webidl/issues/new?title=[legacy]">filing an issue</a>
     before proceeding.
 
     <small class="non-normative">
@@ -9506,7 +9506,7 @@ that does specify [{{SecureContext}}].
     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>
+    by <a href="https://github.com/heycam/webidl/issues/new?title=[legacy]">filing an issue</a>
     before proceeding.
 
     <small class="non-normative">
@@ -9586,7 +9586,7 @@ for the specific requirements that the use of
     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>
+    by <a href="https://github.com/heycam/webidl/issues/new?title=[legacy]">filing an issue</a>
     before proceeding.
 </div>
 

From 796638147d7689ab9bb10c4aad44778f9a9eaeef Mon Sep 17 00:00:00 2001
From: Tobie Langel <tobie@codespeaks.com>
Date: Thu, 24 Aug 2017 20:00:34 +0200
Subject: [PATCH 20/22] Fixup! current refs

---
 index.bs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/index.bs b/index.bs
index 25e97afa..82be710a 100644
--- a/index.bs
+++ b/index.bs
@@ -25,6 +25,7 @@ Abstract: and that newly published specifications reference this
 Abstract: document to ensure conforming implementations of interfaces
 Abstract: are interoperable.
 Boilerplate: omit issues-index, omit conformance, omit feedback-header
+Default Biblio Status: current
 </pre>
 
 <pre class="link-defaults">

From a169236ce7f9d1b4e22490f838c607f4c6e8b119 Mon Sep 17 00:00:00 2001
From: Tobie Langel <tobie@codespeaks.com>
Date: Thu, 24 Aug 2017 20:03:40 +0200
Subject: [PATCH 21/22] fixup! more links

---
 index.bs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.bs b/index.bs
index 82be710a..d7ce8278 100644
--- a/index.bs
+++ b/index.bs
@@ -8990,7 +8990,7 @@ will not exist for the interface in the ECMAScript binding.
     solely used as [=supplemental interfaces=],
     unless there are clear Web compatibility reasons for doing so. 
     Editors who wish to use this feature are strongly advised to discuss this
-    by <a href="https://github.com/w3c/respec/issues/new?title=[NoInterfaceObject]">filing an issue</a>
+    by <a href="https://github.com/heycam/webidl/issues/new?title=[NoInterfaceObject]">filing an issue</a>
     before proceeding.
 </p>
 

From 580c20848c4cb035db5d8f8daadc3a965438fc6e Mon Sep 17 00:00:00 2001
From: Tobie Langel <tobie@codespeaks.com>
Date: Thu, 24 Aug 2017 20:20:38 +0200
Subject: [PATCH 22/22] fixup! Make issue titles more descriptive

---
 index.bs | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/index.bs b/index.bs
index d7ce8278..d5d5a302 100644
--- a/index.bs
+++ b/index.bs
@@ -3401,7 +3401,7 @@ is.
     or (b) with a forEach method that instead invokes its callback like
     Set.protoype.forEach (where the key is the same as the value).
     If you’re creating an API that needs such a forEach method, please
-    <a href="https://github.com/heycam/webidl/issues/new?title=[Iterable%20forEach]">file an issue</a>.
+    <a href="https://github.com/heycam/webidl/issues/new?title=Enhancement%20request%20for%20Iterables">file an issue</a>.
 
 </div>
 
@@ -8462,7 +8462,7 @@ corresponding to [=interface members=].
     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/heycam/webidl/issues/new?title=[legacy]">filing an issue</a>
+    by <a href="https://github.com/heycam/webidl/issues/new?title=Intent%20to%20use%20[LegacyArrayClass]">filing an issue</a>
     before proceeding.
 
     <small class="non-normative">
@@ -8558,7 +8558,7 @@ entails.
     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/heycam/webidl/issues/new?title=[legacy]">filing an issue</a>
+    by <a href="https://github.com/heycam/webidl/issues/new?title=Intent%20to%20use%20[LegacyUnenumerableNamedProperties]">filing an issue</a>
     before proceeding.
 
     <small class="non-normative">
@@ -8608,7 +8608,7 @@ entails.
     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/heycam/webidl/issues/new?title=[legacy]">filing an issue</a>
+    by <a href="https://github.com/heycam/webidl/issues/new?title=Intent%20to%20use%20[LegacyWindowAlias]">filing an issue</a>
     before proceeding.
 
     <small class="non-normative">
@@ -8699,7 +8699,7 @@ are to be implemented.
     potentially breaking page.  Without [{{LenientSetter}}],
     this could prevent a browser from shipping the feature.
     Editors who wish to use this feature are strongly advised to discuss this
-    by <a href="https://github.com/heycam/webidl/issues/new?title=[legacy]">filing an issue</a>
+    by <a href="https://github.com/heycam/webidl/issues/new?title=Intent%20to%20use%20[LenientSetter]">filing an issue</a>
     before proceeding.
 
     <small class="non-normative">
@@ -8774,7 +8774,7 @@ See the <a href="#es-attributes">Attributes</a> section for how
     Specifications should not use [{{LenientThis}}]
     unless required for compatibility reasons. 
     Editors who wish to use this feature are strongly advised to discuss this
-    by <a href="https://github.com/heycam/webidl/issues/new?title=[legacy]">filing an issue</a>
+    by <a href="https://github.com/heycam/webidl/issues/new?title=Intent%20to%20use%20[LenientThis]">filing an issue</a>
     before proceeding.
 
     <small class="non-normative">
@@ -8855,7 +8855,7 @@ is to be implemented.
     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/heycam/webidl/issues/new?title=[legacy]">filing an issue</a>
+    by <a href="https://github.com/heycam/webidl/issues/new?title=Intent%20to%20use%20[NamedConstructor]">filing an issue</a>
     before proceeding.
 
     <small class="non-normative">
@@ -8990,7 +8990,7 @@ will not exist for the interface in the ECMAScript binding.
     solely used as [=supplemental interfaces=],
     unless there are clear Web compatibility reasons for doing so. 
     Editors who wish to use this feature are strongly advised to discuss this
-    by <a href="https://github.com/heycam/webidl/issues/new?title=[NoInterfaceObject]">filing an issue</a>
+    by <a href="https://github.com/heycam/webidl/issues/new?title=Intent%20to%20use%20[NoInterfaceObject]%20on%20a%20non-supplemental%20interface">filing an issue</a>
     before proceeding.
 </p>
 
@@ -9065,7 +9065,7 @@ for the specific requirements that the use of
     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/heycam/webidl/issues/new?title=[legacy]">filing an issue</a>
+    by <a href="https://github.com/heycam/webidl/issues/new?title=Intent%20to%20use%20[OverrideBuiltins]">filing an issue</a>
     before proceeding.
 
     <small class="non-normative">
@@ -9507,7 +9507,7 @@ that does specify [{{SecureContext}}].
     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/heycam/webidl/issues/new?title=[legacy]">filing an issue</a>
+    by <a href="https://github.com/heycam/webidl/issues/new?title=Intent%20to%20use%20[TreatNonObjectAsNull]">filing an issue</a>
     before proceeding.
 
     <small class="non-normative">
@@ -9587,7 +9587,7 @@ for the specific requirements that the use of
     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/heycam/webidl/issues/new?title=[legacy]">filing an issue</a>
+    by <a href="https://github.com/heycam/webidl/issues/new?title=Intent%20to%20use%20[TreatNullAs]">filing an issue</a>
     before proceeding.
 </div>