Bug 1483498 [wpt PR 12493] - Document rough consensus on reverting changes, a=testonly
authorPhilip Jägenstedt <philip@foolip.org>
Wed, 22 Aug 2018 13:20:18 +0000
changeset 488203 4b4863b6778762764d7d8f9b4cb37f946019d800
parent 488202 0435e5afe9d2f4dc150c4ae64751b0ea751311b4
child 488204 c20e7de28c1e4e6cea625478a4b67e1ca84e87ee
push id9719
push userffxbld-merge
push dateFri, 24 Aug 2018 17:49:46 +0000
treeherdermozilla-beta@719ec98fba77 [default view] [failures only]
perfherder[talos] [build metrics] [platform microbench] (compared to previous push)
reviewerstestonly
bugs1483498, 12493
milestone63.0a1
first release with
nightly linux32
nightly linux64
nightly mac
nightly win32
nightly win64
last release without
nightly linux32
nightly linux64
nightly mac
nightly win32
nightly win64
Bug 1483498 [wpt PR 12493] - Document rough consensus on reverting changes, a=testonly Automatic update from web-platform-testsDocument rough consensus on reverting changes (#12493) Fixes https://github.com/web-platform-tests/wpt/issues/9953. -- wpt-commits: 7abda4e7227b65fba2452980d106ed5f11d51b2b wpt-pr: 12493
testing/web-platform/meta/MANIFEST.json
testing/web-platform/tests/docs/_appendix/reverting.md
--- a/testing/web-platform/meta/MANIFEST.json
+++ b/testing/web-platform/meta/MANIFEST.json
@@ -274623,16 +274623,21 @@
      {}
     ]
    ],
    "docs/_appendix/index.md": [
     [
      {}
     ]
    ],
+   "docs/_appendix/reverting.md": [
+    [
+     {}
+    ]
+   ],
    "docs/_appendix/test-templates.md": [
     [
      {}
     ]
    ],
    "docs/_config.yml": [
     [
      {}
@@ -580388,16 +580393,20 @@
   "docs/_appendix/github-intro.md": [
    "9b7144840a9e6b37b832b188391d6d9b7197039a",
    "support"
   ],
   "docs/_appendix/index.md": [
    "12cfdfa13ade604dec791174ffcd2e3732c7a185",
    "support"
   ],
+  "docs/_appendix/reverting.md": [
+   "1f549b3a341f2a78a16be835ae43e2d8da5b7137",
+   "support"
+  ],
   "docs/_appendix/test-templates.md": [
    "39b599569876967d6de158c6497ecff59dd7bbef",
    "support"
   ],
   "docs/_config.yml": [
    "760c991820bee4d403f6a33d769430f92ac13628",
    "support"
   ],
new file mode 100644
--- /dev/null
+++ b/testing/web-platform/tests/docs/_appendix/reverting.md
@@ -0,0 +1,31 @@
+---
+layout: page
+title: Reverting Changes
+order: 3
+---
+Testing is imperfect and from time to time changes are merged into master which
+break things for users of web-platform-tests. Such breakage can include:
+
+  * Failures in Travis or Taskcluster runs for this repository, either on the
+    master branch or on pull requests following the breaking change.
+
+  * Breakage in browser engine repositories which import and run
+    web-platform-tests, such as Chromium, Edge, Gecko, Servo and WebKit.
+
+  * Breakage in results collections systems for results dashboards, such as
+    [wpt.fyi](https://wpt.fyi).
+
+  * Breakage in supplemental tooling used by working groups, such as the
+    [CSS build system][].
+
+When such breakage happens, if the maintainers of the affected systems request
+it, pull requests to revert the original change should normally be approved and
+merged as soon as possible. (When the original change itself was fixing a
+serious problem, it's a judgement call, but prefer the fastest path to a stable
+state acceptable to everyone.)
+
+Once a revert has happened, the maintainers of the affected systems are
+expected to work with the original patch author to resolve the problem so that
+the change can be relanded. A reasonable timeframe to do so is within one week.
+
+[CSS build system]: https://github.com/web-platform-tests/wpt/tree/master/css/tools