Merge pull request #322 from httpwg/reschke-i303

ref RFC 8174 for BCP14 keywords as well (#303)

draft-ietf-httpbis-cache-latest.xml

@@ -171,9 +171,11 @@
 
 <section title="Requirements Notation" anchor="intro.requirements">
 <t>
-   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
-   "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
-   document are to be interpreted as described in <xref target="RFC2119"/>.
+   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL
+   NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED",
+   "MAY", and "OPTIONAL" in this document are to be interpreted as
+   described in BCP 14 <xref target="RFC2119"/> <xref target="RFC8174"/> when, and only when, they
+   appear in all capitals, as shown here.
 </t>
 <t>
    Conformance criteria and considerations regarding error handling
@@ -2056,14 +2058,21 @@
   <reference anchor="RFC2119">
     <front>
       <title>Key words for use in RFCs to Indicate Requirement Levels</title>
-      <author fullname="Scott Bradner" initials="S." surname="Bradner">
-        <organization>Harvard University</organization>
-        <address><email>sob@harvard.edu</email></address>
-      </author>
-      <date month="March" year="1997" />
+      <author initials="S." surname="Bradner" fullname="Scott Bradner"/>
+      <date month="March" year="1997"/>
+    </front>
+    <seriesInfo name="BCP" value="14"/>
+    <seriesInfo name="RFC" value="2119"/>
+  </reference>
+
+  <reference anchor="RFC8174">
+    <front>
+      <title>Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words</title>
+      <author initials='B.' surname='Leiba' fullname='Barry Leiba'/>
+      <date year="2017" month="May"/>
     </front>
-    <seriesInfo name="BCP" value="14" />
-    <seriesInfo name="RFC" value="2119" />
+    <seriesInfo name='BCP' value='14'/>
+    <seriesInfo name='RFC' value='8174'/>
   </reference>
 
   <reference anchor="RFC3986">
@@ -2391,6 +2400,7 @@
    <li>In <xref target="cache-response-directive.public"/> and <xref target="cache-response-directive.private"/>, clarify "private" and "public" so that they do not override all other cache directives (<eref target="https://github.com/httpwg/http-core/issues/268"/>)</li>
    <li>In <xref target="response.cacheability"/>, distinguish between private with and without qualifying headers (<eref target="https://github.com/httpwg/http-core/issues/270"/>)</li>
    <li>In <xref target="caching.negotiated.responses"/>, clarify that any "*" as a member of Vary will disable caching (<eref target="https://github.com/httpwg/http-core/issues/286"/>)</li>
+   <li>In <xref target="intro.requirements"/>, reference RFC 8174 as well (<eref target="https://github.com/httpwg/http-core/issues/303"/>)</li>
 </ul>
 </section>
 </section>