[Python-checkins] devguide: Add discussion of buildbot console and irc notices.

[r.david.murray]

https://hg.python.org/devguide/rev/bff43c5c8c4f
changeset:   746:bff43c5c8c4f
user:        R David Murray <rdmurray at bitdance.com>
date:        Fri Jun 12 12:27:12 2015 -0400
summary:
  Add discussion of buildbot console and irc notices.

files:
  buildbots.rst |  23 ++++++++++++++++++++---
  1 files changed, 20 insertions(+), 3 deletions(-)


diff --git a/buildbots.rst b/buildbots.rst
--- a/buildbots.rst
+++ b/buildbots.rst
@@ -26,12 +26,13 @@
 Checking results of automatic builds
 ------------------------------------
 
-There are two ways of visualizing recent build results:
+There are three ways of visualizing recent build results:
 
 * The Web interface for each branch at http://python.org/dev/buildbot/,
   where the so-called "waterfall" view presents a vertical rundown of recent
   builds for each builder.  When interested in one build, you'll have to
-  click on it to know which changesets it corresponds to.
+  click on it to know which changesets it corresponds to.  Note that
+  the buildbot web pages are often slow to load, be patient.
 
 * The command-line ``bbreport.py`` client, which you can get from
   http://code.google.com/p/bbreport/. Installing it is trivial: just add
@@ -42,6 +43,22 @@
 
       bbreport.py -q 3.x
 
+* The buildbot "console" interface at http://buildbot.python.org/all/console
+  This works best on a wide, high resolution
+  monitor.  You can enter your mercurial username ("your name
+  <your at email>") in the 'personalized for' box in the upper right corner to see
+  the results just for changesets submitted by you.  Clicking on the colored
+  circles will allow you to open a new page containing whatever information
+  about that particular build is of interest to you.  You can also access
+  builder information by clicking on the builder status bubbles in the top
+  line.
+
+If you like IRC, having an IRC client open to the #python-dev channel on
+irc.freenode.net is useful.  Any time a builder changes state (last build
+passed and this one didn't, or vice versa), a message is posted to the channel.
+Keeping an eye on the channel after pushing a changeset is a simple way to get
+notified that there is something you should look in to.
+
 Some buildbots are much faster than others.  Over time, you will learn which
 ones produce the quickest results after a build, and which ones take the
 longest time.
@@ -83,7 +100,7 @@
 Ordering-dependent failures
 ---------------------------
 
-Sometimes even the failure is subtler, as it relies on the order in which
+Sometimes the failure is even subtler, as it relies on the order in which
 the tests are run.  The buildbots *randomize* test order (by using the ``-r``
 option to the test runner) to maximize the probability that potential
 interferences between library modules are exercised; the downside is that it

-- 
Repository URL: https://hg.python.org/devguide