Create a playbook for publishing contributor-guide

The Documentation team has previously used /contributor-guide for their
own on-boarding documentation. This publishes the general contributor
guide to /contributors.

Change-Id: I223610d480b7754176dd00366ae093676cf612c9

playbooks/publish/contributor-guide-afs.yaml

@@ -0,0 +1,15 @@
+- hosts: all
+  roles:
+    - fetch-tox-output
+    - role: write-root-marker
+      root_marker_dir: "src/{{ zuul.project.canonical_name }}/doc/build/html"
+    - role: fetch-sphinx-output
+      sphinx_output_src: "{{ zuul.project.src_dir }}/doc/build/html"
+      zuul_executor_dest: "{{ zuul.executor.work_root }}/artifacts"
+
+- hosts: localhost
+  roles:
+    - create-afs-token
+    - role: upload-afs
+      afs_target: "{{ afs.path }}/contributors"
+    - destroy-afs-token

zuul.d/jobs.yaml

@@ -155,6 +155,23 @@
       - secret: afsdocs_secret
         name: afs
 
+- job:
+    name: publish-openstack-contributor-guide
+    description: |
+      Publish contributor-guide documents to
+      https://docs.openstack.org/contributors
+    final: True
+    pre-run: playbooks/python-docs/pre
+    run: playbooks/project-config/run-tox
+    post-run: playbooks/publish/openstack-contributor-guide-afs
+    roles:
+      - zuul: openstack-infra/zuul-jobs
+      - zuul: openstack-infra/openstack-zuul-jobs
+    branches: master
+    secrets:
+      - secret: afsdocs_secret
+        name: afs
+
 - job:
     name: publish-openstack-releasenotes
     description: |