matplotlib
diff --git a/‎doc/devel/coding_guide.rst‎
Lines changed: 21 additions & 9 deletions b/‎doc/devel/coding_guide.rst‎
Lines changed: 21 additions & 9 deletions
@@ -161,24 +161,36 @@ Merging
     A core dev should only champion one PR at a time and we should try to keep
     the flow of championed PRs reasonable.
 
+* Do not self merge, except for 'small' patches to un-break the CI or
+  when another reviewer explicitly allows it (ex, "Approve modulo CI
+  passing, may self merge when green").
+
 .. _pr-automated-tests:
 
 Automated tests
 ---------------
 
-* Make sure the Travis, Appveyor, CircleCI, and codecov tests are passing
-  before merging.
+Whenever a pull request is created or updated, various automated test tools
+will run on all supported platforms and versions of Python.
+
+* Make sure the Travis, Appveyor, CircleCI, and Azure pipelines are passing
+  before merging. Here are some tips for finding the cause of the test failure:
 
-  - Whenever a pull request is created or updated, Travis and Appveyor
-    automatically runs the test suite on all versions of Python
-    supported by Matplotlib.  The tox_ support in Matplotlib may be
-    useful for testing locally.
+  - If *Travis flake8* fails, you have a code style issue, which will be listed
+    near the bottom of the *Travis flake8* log.
+  - If any other Travis run fails, search the log for ``FAILURES``. The
+    subsequent section will contain information on the failed tests.
+  - If CircleCI fails, likely you have some reStructuredText style issue in
+    the docs. Search the CircleCI log for ``WARNING``.
+
+* Codecov and LGTM are currently for information only. Their failure is not
+  necessarily a blocker.
+
+* tox_ is not used in the automated testing. It is supported for testing
+  locally.
 
   .. _tox: https://tox.readthedocs.io/
 
-* Do not self merge, except for 'small' patches to un-break the CI or
-  when another reviewer explicitly allows it (ex, "Approve modulo CI
-  passing, may self merge when green").
 
 .. _pr-squashing: