Update base job

Author: mnasiadka

zuul.d/jobs.yaml

@@ -3,21 +3,38 @@
     name: base
     parent: null
     description: |
-      The recommended base job.
+      The base job for StackHPC's installation of Zuul.
 
       All jobs ultimately inherit from this.  It runs a pre-playbook
       which copies all of the job's prepared git repos on to all of
-      the nodes in the nodeset.
+      the nodes in the nodeset.  It runs a post-playbook which copies
+      all of the files in the logs/ subdirectory of the executor
+      work directory to the logserver.
+
+      It also sets default timeout and nodeset values (which may be
+      overidden).
+
+      Responds to these variables:
+
+      .. zuul:jobvar:: base_serial
+         :default: Omitted
+
+         This sets the serial keyword in the pre and post playbooks
+         which can be an integer or percentage.
+
+         See ansible documentation for more information:
+         http://docs.ansible.com/ansible/latest/playbooks_delegation.html
 
-      It also sets a default timeout value (which may be overidden).
     pre-run: playbooks/base/pre.yaml
     post-run:
+      - name: playbooks/base/post.yaml
       - name: playbooks/base/cleanup.yaml
         cleanup: true
       - playbooks/base/post-logs.yaml
     roles:
       - zuul: zuul/zuul-jobs
     timeout: 1800
+    post-timeout: 1800
     nodeset:
       nodes:
         - name: ubuntu-jammy