Add "Choosing machines for a job" section

Signed-off-by: Zack Cerza <zack.cerza@inktank.com>

diff --git a/README.rst b/README.rst
index 54da1f96e5eabcd350099e07ecf7917fdae3964d..d15dacd55bb5a523ddeb626adb2119bdfa10f999 100644 (file)
--- a/README.rst
+++ b/README.rst
@@ -243,6 +243,18 @@ To see the status of all machines, use the ``--list`` option. This can
 be restricted to particular machines as well::
 
     ./virtualenv/bin/teuthology-lock --list machine1 machine2
+   
+
+Choosing machines for a job
+---------------------------
+
+It is possible to run jobs against machines of one or more  ``machine_type``
+values. It is also possible to tell ``teuthology`` to only select those
+machines which match the following criteria specified in the job's YAML:
+
+* ``os_type`` (e.g. 'rhel', 'ubuntu')
+* ``os_version`` (e.g. '7.0', '14.04')
+* ``arch`` (e.g. 'x86_64')
 
 
 Tasks