Merge ~jugmac00/launchpad:add-how-to-get-overview-of-buildfarm into launchpad:master

[Jürgen Gmach]

Add how-to get overview of Launchpad's build farm

[Colin Watson (cjwatson)]

review: Approve

diff --git a/doc/how-to/getting-overview-of-build-farm.rst b/doc/how-to/getting-overview-of-build-farm.rst
new file mode 100644
index 0000000..153931a
--- /dev/null
+++ b/doc/how-to/getting-overview-of-build-farm.rst
@@ -0,0 +1,26 @@
+=============================================
+Getting an overview of Launchpad's build farm
+=============================================
+
+In order to get an overview of Launchpad's build farm,
+you can either use a web view or a command line application.
+
+Overview via web view
+=====================
+
+https://launchpad.net/builders
+
+.. note:
+
+    The web view is public.
+
+Overview via CLI application
+============================
+
+Call...
+
+.. code:: bash
+
+    $ ./manage-builders -v
+
+from the `ubuntu-archive-tools <https://launchpad.net/ubuntu-archive-tools>`_.
diff --git a/doc/how-to/index.rst b/doc/how-to/index.rst
index 80a4c6d..5ebddba 100644
--- a/doc/how-to/index.rst
+++ b/doc/how-to/index.rst
@@ -47,3 +47,4 @@ Operating Canonical's instances
    restarting-services-on-dogfood
    deploying-configuration-changes
    checking-availability-of-launchpad-frontends
+   getting-overview-of-build-farm