Publish *-specs better

Do not include doc/build/html in the URL.

Thus, instead of publishing keystone-specs to:
http://specs.openstack.org/openstack/keystone-specs/doc/build/html/
publish instead to:
http://specs.openstack.org/openstack/keystone-specs/

Since the scp plugin does not allow removal of the path, we have to
copy the content up and publish from there.

Change-Id: I09f4654648f9da74f2e485d1c90082cfc835ab89

modules/openstack_project/files/jenkins_job_builder/config/specs-jobs.yaml

@@ -4,20 +4,27 @@
     name: '{name}-publish-specs'
     node: 'bare-precise || bare-trusty'
 
+    # We want to publish to {github-org}/{name} but the scp publisher
+    # cannot remove paths, so use a shell builder to move the content
+    # in the right place and publish from there.
     builders:
       - revoke-sudo
       - gerrit-git-prep
       - docs:
           github-org: '{github-org}'
           project: '{name}'
+      - shell: |
+          mkdir {github-org}
+          mv doc/build/html {github-org}/{name}
 
     publishers:
       - scp:
           site: 'static.openstack.org'
           files:
-            - target: 'specs/{github-org}/{name}'
+            - target: 'specs/'
-              source: 'doc/build/html/**'
+              source: '{github-org}/{name}/**'
               keep-hierarchy: true
+              copy-after-failure: false
       - console-log
 
 - job-group: