Publish devstack documents

Publish devstack documents in a post job on
docs.openstack.org/developer/devstack

Also, add a check job (non-voting for now).

We need extra jobs since devstack does not support the
build_sphinx target.

This depends on these two patches for devstack:
* https://review.openstack.org/126714
* https://review.openstack.org/126720

Change-Id: I68f85e13848af0bc25a101ae7474ce9fb240393f

jenkins/jobs/devstack.yaml

@@ -0,0 +1,38 @@
+# Devstack does not support "python setup.py publish_sphinx", thus
+# we cannot use the normal docs jobs.
+
+- job:
+    name: devstack-publish-docs
+    node: 'bare-precise || bare-trusty'
+
+    builders:
+      - revoke-sudo
+      - gerrit-git-prep
+      - tox:
+          envlist: 'docs'
+      - zuul_swift_upload_console_log
+
+    publishers:
+      - ftp:
+          site: 'docs.openstack.org'
+          source: 'doc/build/html/**'
+          target: 'developer/devstack'
+          remove-prefix: 'docs/html'
+          excludes: ''
+      - console-log
+
+- job:
+    name: gate-devstack-publish-docs
+
+    builders:
+      - revoke-sudo
+      - gerrit-git-prep
+      - tox:
+          envlist: 'docs'
+      - zuul_swift_upload_console_log
+
+    publishers:
+      - console-log
+      - upload-sphinx-draft
+
+    node: '{node}'

zuul/layout.yaml

@@ -776,6 +776,8 @@ jobs:
     voting: false
   - name: gate-kolla-bashate
     voting: false
+  - name: gate-devstack-publish-docs
+    voting: false
 
 # The project list is grouped by type of project, and within each
 # group, projects are sorted (mostly) alphabetically.
@@ -2780,6 +2782,7 @@ projects:
       - check-tempest-dsvm-ironic-pxe_ssh-nv
       - check-tempest-dsvm-ironic-pxe_ssh-postgres-nv
       - check-tempest-dsvm-f20
+      - gate-devstack-publish-docs
     gate:
       - gate-devstack-bashate
       - gate-devstack-dsvm-cells
@@ -2787,6 +2790,8 @@ projects:
       - gate-grenade-dsvm-partial-ncpu
       - gate-neutron-dsvm-functional
       - gate-swift-dsvm-functional
+    post:
+      - devstack-publish-docs
     experimental:
       - check-tempest-dsvm-cells-full
       - check-tempest-dsvm-zaqar