Skip to content

Commit e9b419e

Browse files
Follow up from TPAC deprecation breakout, new section for information
1 parent c14eafe commit e9b419e

File tree

1 file changed

+51
-2
lines changed

1 file changed

+51
-2
lines changed

compatibility.bs

Lines changed: 51 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -89,6 +89,8 @@ specified elsewhere.
8989

9090
The HTTP <code>User-Agent</code> header field as found in major browsers today is also described.
9191

92+
The removals of some features from the web platform are also described.
93+
9294
<h2 id='conformance'>Conformance</h2>
9395
All diagrams, examples, and notes in this specification are
9496
non-normative, as are all sections explicitly marked non-normative.
@@ -1055,11 +1057,58 @@ On mobile platforms, including smaller iPad form factors
10551057
</tbody>
10561058
</table>
10571059

1060+
1061+
<h2 id="removal">Deprecation and Removal</h2>
1062+
1063+
<em>This section is non-normative.</em>
1064+
1065+
While the web platform stives for backwards-compatibility, there are occasions which require the
1066+
outright removal or discouraged use of some features. To support making these changes
1067+
in the least disruptive and most consistent way for developers, we document them here. This is most
1068+
beneficial as a decalration of intent by browser engines to act together in a well reasoned way.
1069+
1070+
<h3 id="removal-features">Feature List</h3>
1071+
1072+
<table>
1073+
<thead>
1074+
<th><dfn for="deprecated feature list">Feature</dfn></th>
1075+
<th><dfn for="deprecated feature list">Deprecated from</dfn></th>
1076+
<th><dfn for="deprecated feature list">Removal</dfn></th>
1077+
<th><dfn for="deprecated feature list">Replacement</dfn></th>
1078+
<th><dfn for="deprecated feature list">Justification</dfn></th>
1079+
<th><dfn for="deprecated feature list">Automated Tools</dfn></th>
1080+
</thead>
1081+
<tbody>
1082+
1083+
</tbody>
1084+
</table>
1085+
1086+
<h4 id="removal-features-process">Process</h4>
1087+
1088+
Anyone can make an addition to the list by editing this specification.
1089+
However, because some content describes the future plans of browser engines, the author can use
1090+
their discretion in what reviewers are appropriate for a given change to the list.
1091+
[[#removal-support]] is provided to give a place to link to long-form content within this
1092+
document for list entries.
1093+
1094+
Each entry can include:
1095+
1096+
<ul>
1097+
<li> the [=deprecated feature list/Feature | feature or behavior=] that is being removed or deprecated.
1098+
<li> what browser engines have [=deprecated feature list/Deprecated from | deprecated =] the feature or behavior, discouraging its further use.
1099+
<li> when the feature will be, or has been, [=deprecated feature list/Removal | removed =] from various browser engines, preventing its use by default.
1100+
<li> what developers should use to achieve the same functional goals, as a [=deprecated feature list/Replacement | replacement =] for the old feature.
1101+
<li> [=deprecated feature list/Justification=] for the removal or deprecation, including any tradeoffs considered and steps taken to minimize disruption to developers.
1102+
<li> links to any [=deprecated feature list/Automated Tools | automated tools =] to assist developers, such as detection or migration scripts.
1103+
</ul>
1104+
1105+
<h3 id="removal-support">Supporting Information</h3>
1106+
10581107
<h2 id="acknowledgements" class="no-num">Acknowledgements</h2>
10591108
Thanks to Alan Cutter, Cameron McCormack, Chris Rebert, Chun-Min (Jeremy) Chen, Daniel Holbert,
10601109
David Håsäther, Domenic Denicola, Eric Portis, hexalys, Jean-Yves Perrier, Jacob Rossi, Karl Dubost,
1061-
Philip Jägenstedt, Rick Byers, Simon Pieters, Stanley Stuart, William Chen and Your Name Here for
1062-
feedback and contributions to this standard.
1110+
Philip Jägenstedt, Rick Byers, Simon Pieters, Stanley Stuart, William Chen, Benjamin VanderSloot,
1111+
and Your Name Here for feedback and contributions to this standard.
10631112

10641113
Thanks to Mounir Lamouri and Marcos Cáceres for defining the {{ScreenOrientation}} interface.
10651114
[[!screen-orientation]]

0 commit comments

Comments
 (0)