Add documentation for SkiaLab

site/dev/testing/buildbot.md

Index: site/dev/testing/buildbot.md
diff --git a/site/dev/testing/buildbot.md b/site/dev/testing/buildbot.md
index 7d9035db14c5749d6e92a1eb865b4fd3e9292fa9..ef7d9cde8c57df5d05c64ce1556538d2e8ba2cb0 100644
--- a/site/dev/testing/buildbot.md
+++ b/site/dev/testing/buildbot.md
@@ -9,13 +9,20 @@ to run continuous builds and tests.
 
 Here is a link to our main status page: https://status.skia.org/
 
-There are also Skia client, compile, Android, and FYI console pages for a detailed
-view of those results: 
+There are also buildbot console pages for a detailed view of those results:
   
-  Externally-facing: http://build.chromium.org/p/client.skia/console
-  
-  Internally-facing: http://chromegw.corp.google.com/i/client.skia/console
-                     http://chromegw.corp.google.com/i/client.skia.internal/console
+  Externally-facing:
+    * http://build.chromium.org/p/client.skia/console

[rmistry, 2015/06/04 15:23:58]

All these bullets are showing up on the same line, try putting an extra line in
here or if that does not work then try keeping the bullets with no indentation
the indentation is not showing up anyway.

[borenet, 2015/06/04 19:18:29]

Done.

+    * http://build.chromium.org/p/client.skia.android/console
+    * http://build.chromium.org/p/client.skia.compile/console
+    * http://build.chromium.org/p/client.skia.fyi/console
+
+  Internally-facing:
+    * http://uberchromegw.corp.google.com/i/client.skia/console
+    * http://uberchromegw.corp.google.com/i/client.skia.android/console
+    * http://uberchromegw.corp.google.com/i/client.skia.compile/console
+    * http://uberchromegw.corp.google.com/i/client.skia.fyi/console
+    * http://uberchromegw.corp.google.com/i/client.skia.internal/console
                      \(only visible internally\)
 
 Architecture
@@ -25,30 +32,35 @@ The buildbot system consists of these elements: \(see
 http://buildbot.net/buildbot/docs/current/manual/introduction.html#system-architecture
 for more detail\) 
 
-* builder
+* Buildbot Master
 
-    * one repeatable build and/or test configuration on a given platform.
-    * each builder maintains its own local checkout of the Skia repo
-    * only one builder is running at any given time on any single buildslave; otherwise,
-       different builders could interfere with each other's performance numbers
+    * Watches for new commits to land in the Skia repository
+      \(https://skia.googlesource.com/skia\)
+    * Whenever a new commit lands, it triggers a **Build** on each **Builder**
+      to test the new revision.
+    * Serves up status pages whenever anybody requests them
 
-* buildbot master
-    
-    * watches for new commits to land in the Skia repository 
-      \(https://skia.googlesource.com/skia\) 
-    * whenever a new commit lands, it tells buildbot slaves to start building and 
-      testing the latest revision 
-    * serves up status pages whenever anybody requests them
+* Build
 
-* buildslave \(or "buildbot slave"\)
-    
-    * a process on a machine that builds and runs code as directed by the buildbot 
-      master
-    * one or more builders run on each buildslave
+    * One run of a particular **Builder**, at a particular code revision.
+    * "Build" is sort of a misnomer; it's just a list of steps (typically shell
+      commands) which are run by the **Buildslave** process on the host
+      machine, and those may include compiling and running code as well as
+      arbitrary other commands.
 
-* build
+* Builder
 
-    * one run of a particular builder, at a particular code revision
+    * One repeatable build and/or test configuration on a given platform. The
+      Builder is basically a blueprint which provides logic to determine which
+      steps to run within a Build.
+
+* Buildslave \(or "buildbot slave"\)
+    
+    * A process running on a host machine that builds and runs code as directed
+      by the Buildbot Master.
+    * One or more Builders may run on a given Buildslave, but only one runs at
+      a time.
+    * One or more Buildslaves may run on a given host machine.
 
 
 Status View