[docs] Document the staging buildbot
Summary:
This also adds docs to suggest that maintainers of buildbots for
experimental backends should use this buildmaster.
Reviewers: dsanders, grosser, asb, mehdi_amini
Reviewed By: grosser
Subscribers: llvm-commits
Differential Revision: https://reviews.llvm.org/D29560
llvm-svn: 294144
GitOrigin-RevId: 7457130f7a39c5e2c4393ef27e3078e38b86d4b4
diff --git a/docs/HowToAddABuilder.rst b/docs/HowToAddABuilder.rst
index 9e06a32..fcc2293 100644
--- a/docs/HowToAddABuilder.rst
+++ b/docs/HowToAddABuilder.rst
@@ -6,9 +6,19 @@
============
This document contains information about adding a build configuration and
-buildslave to private slave builder to LLVM Buildbot Infrastructure
-`<http://lab.llvm.org:8011>`_.
+buildslave to private slave builder to LLVM Buildbot Infrastructure.
+Buildmasters
+============
+
+There are two buildmasters running.
+
+* The main buildmaster at `<http://lab.llvm.org:8011>`_. All builders attached
+ to this machine will notify commit authors every time they break the build.
+* The staging buildbot at `<http://lab.llvm.org:8014>`_. All builders attached
+ to this machine will be completely silent by default when the build is broken.
+ Builders for experimental backends should generally be attached to this
+ buildmaster.
Steps To Add Builder To LLVM Buildbot
=====================================
@@ -73,6 +83,11 @@
* slaves are added to ``buildbot/osuosl/master/config/slaves.py``
* builders are added to ``buildbot/osuosl/master/config/builders.py``
+ It is possible to whitelist email addresses to unconditionally receive notifications
+ on build failure; for this you'll need to add an ``InformativeMailNotifier`` to
+ ``buildbot/osuosl/master/config/status.py``. This is particularly useful for the
+ staging buildmaster which is silent otherwise.
+
#. Send the buildslave access name and the access password directly to
`Galina Kistanova <mailto:gkistanova@gmail.com>`_, and wait till she
will let you know that your changes are applied and buildmaster is
