Document zuul generated log paths
zuul now suggests destinations for logs to help allow them to be
deterministic. Document these extra launcher parameters.
Change-Id: I43f100a058d3aec5b289a5ea81f08dd4639e03ef
diff --git a/doc/source/launchers.rst b/doc/source/launchers.rst
index accd80b..c799291 100644
--- a/doc/source/launchers.rst
+++ b/doc/source/launchers.rst
@@ -56,6 +56,16 @@
The URL for the zuul server as configured in zuul.conf.
A test runner may use this URL as the basis for fetching
git commits.
+**BASE_LOG_PATH**
+ zuul suggests a path to store and address logs. This is deterministic
+ and hence useful for where you want workers to upload to a specific
+ destination or need them to have a specific final URL you can link to
+ in advanced. For changes it is:
+ "last-two-digits-of-change/change-number/patchset-number".
+ For reference updates it is: "first-two-digits-of-newrev/newrev"
+**LOG_PATH**
+ zuul also suggests a unique path for logs to the worker. This is
+ "BASE_LOG_PATH/pipeline-name/job-name/uuid"
Change related parameters
~~~~~~~~~~~~~~~~~~~~~~~~~