From aaffa55dd1d584a91436c8590d0c99eb652e5020 Mon Sep 17 00:00:00 2001
From: "James E. Blair" <jeblair@redhat.com>
Date: Thu, 8 Jun 2017 16:48:22 -0700
Subject: [PATCH] Add documentation to jobs

Change-Id: Ie2b130af6ce5bb336d829fc2ec9458effc81f844
Depends-On: Ida98e767db561dd77090bc5710026349342d58b2
---
 .zuul.yaml | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/.zuul.yaml b/.zuul.yaml
index 6640a2908..c4ffe7232 100644
--- a/.zuul.yaml
+++ b/.zuul.yaml
@@ -1,21 +1,39 @@
 - job:
     name: unittests
     parent: base
+    description: |
+      Perform setup common to all unit test jobs.
+
+      This performs basic host and general project setup tasks common
+      to all types of unit test jobs.
     pre-run: unittests/pre
 
 - job:
     name: unittests-python
     parent: unittests
+    description: |
+      Perform setup common to python unit test jobs.
+
+      This performs basic host and general project setup tasks common
+      to all python unit test jobs.
     run: unittests/python
 
 - job:
     name: python27
     parent: unittests-python
+    description: |
+      Run unit tests for a Python project under cPython version 2.7.
+
+      Uses tox with the "py27" environment.
     vars:
       zuul_python_version: 27
 
 - job:
     name: python35
     parent: unittests-python
+    description: |
+      Run unit tests for a Python project under cPython version 3.5.
+
+      Uses tox with the "py35" environment.
     vars:
       zuul_python_version: 35