From 552310000c4328ccf03ca55415dc358c8a006556 Mon Sep 17 00:00:00 2001
From: Jason Robbins <jrobbins@gmail.com>
Date: Thu, 14 Apr 2022 11:12:58 -0700
Subject: [PATCH] Revise field help for antipated_spec_changes. (#1835)

---
 pages/guideforms.py                      | 9 ++++++---
 templates/blink/intent_to_implement.html | 8 +++++---
 2 files changed, 11 insertions(+), 6 deletions(-)

diff --git a/pages/guideforms.py b/pages/guideforms.py
index 806bb0ec..a49de68c 100644
--- a/pages/guideforms.py
+++ b/pages/guideforms.py
@@ -506,9 +506,12 @@ ALL_FIELDS = {
             attrs={'rows': 4, 'cols': 50, 'maxlength': 500,
                    'placeholder': 'https://\nhttps://'}),
         help_text=
-        ('Please list known spec issues whose resolution may introduce '
-         'web compat risk (e.g., change to naming or structure of '
-         'the API).')),
+        ('Open questions about a feature may be a source of future web compat '
+         'or interop issues. Please list open issues (e.g. links to known '
+         'github issues in the project for the feature specification) whose '
+         'resolution may introduce web compat/interop risk (e.g., changing '
+         'to naming or structure of the API in a '
+         'non-backward-compatible way).')),
 
     'finch_url': forms.URLField(
         required=False, label='Finch experiment',
diff --git a/templates/blink/intent_to_implement.html b/templates/blink/intent_to_implement.html
index f1a9f6f4..555483f1 100644
--- a/templates/blink/intent_to_implement.html
+++ b/templates/blink/intent_to_implement.html
@@ -238,9 +238,11 @@
 {% if 'anticipated_spec_changes' in sections_to_show or feature.anticipated_spec_changes %}
   <br><br><h4>Anticipated spec changes</h4>
   <p style="font-style: italic">
-    Please list known spec issues whose resolution may introduce
-    web compat risk (e.g., change to naming or structure of
-    the API).</p>
+    Open questions about a feature may be a source of future web compat or
+    interop issues. Please list open issues (e.g. links to known github
+    issues in the project for the feature specification) whose resolution
+    may introduce web compat/interop risk (e.g., changing to naming or
+    structure of the API in a non-backward-compatible way).</p>
 
   {{feature.anticipated_spec_changes|urlize}}
 {% endif %}