diff --git a/compatibility.bs b/compatibility.bs
index 3bda92d..876c5ee 100644
--- a/compatibility.bs
+++ b/compatibility.bs
@@ -89,6 +89,8 @@ specified elsewhere.
The HTTP User-Agent
header field as found in major browsers today is also described.
+The removals of some features from the web platform are also described.
+
All diagrams, examples, and notes in this specification are
non-normative, as are all sections explicitly marked non-normative.
@@ -1055,11 +1057,61 @@ On mobile platforms, including smaller iPad form factors
+
+Deprecation and Removal
+
+This section is non-normative.
+
+While the web platform stives for backwards-compatibility, there are occasions which require the
+outright removal or discouraged use of some features. To support making these changes
+in the least disruptive and most consistent way for developers, we document them here. This is most
+beneficial as a decalration of intent by browser engines to act together in a well reasoned way.
+
+Feature List
+
+
+
+
+ Feature |
+ Deprecated from |
+ Removal |
+ Replacement |
+ Justification |
+ Automated Tools |
+
+
+
+
+
+
+
+
+Process
+
+Anyone can make an addition to the list by editing this specification.
+However, because some content describes the future plans of browser engines, the author can use
+their discretion in what reviewers are appropriate for a given change to the list.
+[[#removal-support]] is provided to give a place to link to long-form content within this
+document for list entries.
+
+Each entry can include:
+
+
+ - the [=deprecated feature list/Feature | feature or behavior=] that is being removed or deprecated.
+
- what browser engines have [=deprecated feature list/Deprecated from | deprecated =] the feature or behavior, discouraging its further use.
+
- when the feature will be, or has been, [=deprecated feature list/Removal | removed =] from various browser engines, preventing its use by default.
+
- what developers should use to achieve the same functional goals, as a [=deprecated feature list/Replacement | replacement =] for the old feature.
+
- [=deprecated feature list/Justification=] for the removal or deprecation, including any tradeoffs considered and steps taken to minimize disruption to developers.
+
- links to any [=deprecated feature list/Automated Tools | automated tools =] to assist developers, such as detection or migration scripts.
+
+
+Supporting Information
+
Acknowledgements
-Thanks to Alan Cutter, Cameron McCormack, Chris Rebert, Chun-Min (Jeremy) Chen, Daniel Holbert,
-David Håsäther, Domenic Denicola, Eric Portis, hexalys, Jean-Yves Perrier, Jacob Rossi, Karl Dubost,
-Philip Jägenstedt, Rick Byers, Simon Pieters, Stanley Stuart, William Chen and Your Name Here for
-feedback and contributions to this standard.
+Thanks to Alan Cutter, Benjamin VanderSloot, Cameron McCormack, Chris Rebert, Chun-Min (Jeremy) Chen,
+Daniel Holbert,David Håsäther, Domenic Denicola, Eric Portis, hexalys, Jean-Yves Perrier, Jacob Rossi,
+Karl Dubost, Philip Jägenstedt, Rick Byers, Simon Pieters, Stanley Stuart, William Chen and
+Your Name Here for feedback and contributions to this standard.
Thanks to Mounir Lamouri and Marcos Cáceres for defining the {{ScreenOrientation}} interface.
[[!screen-orientation]]