Add versioning and evolution

Fixes #581
httpwg · May 4, 2018 · 2b1fcbe · 2b1fcbe · martinthomson · May 4, 2018
1 parent e1ce474
commit 2b1fcbe
Showing 1 changed file with 11 additions and 0 deletions.
diff --git a/draft-ietf-httpbis-bcp56bis.md b/draft-ietf-httpbis-bcp56bis.md
@@ -822,6 +822,17 @@ Applications using server push directly need to enforce the requirements regardi
 {{?RFC7540}}, Section 8.2, to avoid cross-origin push attacks.
 
 
+## Versioning and Evolution {#versioning}
+
+It's often necessary to introduce new features into application protocols, and change existing ones.
+
+In HTTP, backwards-incompatible changes are possible using a number of mechanisms:
+
+* Using a distinct link relation type {{!RFC8288}} to identify a URL for a resource that implements the new functionality
+* Using a distinct media type {{!RFC6838}} to identify formats that enable the new functionality
+* Using a distinct HTTP header field to implement new functionality outside the message body
+
+
 # IANA Considerations
 
 This document has no requirements for IANA.