doc: add notes about "documentation" jobs

Add a bit of documentation regarding "documentation" jobs in Jenkins.
This records our lessons learned during Andrew's work to create the
"teuthology-docs-build" job configuration and get that particular one
running.

diff --git a/README.rst b/README.rst
index 32715f72323a72eec7520d23f567a5997a10bd4e..19ed207699021753a261b16021005f7ff28faa13 100644 (file)
--- a/README.rst
+++ b/README.rst
@@ -210,3 +210,12 @@ You should also use the ``triggers`` setting for the job, like so::
             github-hooks: true
             permit-all: false
             auto-close-on-fail: false
+
+"Document" Jobs
+---------------
+Some jobs don't actually run code; they simply build a project's documentation
+and upload the docs to ceph.com. One example is the "teuthology-docs-build"
+job.
+
+For these jobs, note that the destination directory must be created on the
+ceph.com web server before the ``rsync`` command will succeed.