Adds an API migration and docs generation tool, fairy-slipper

- Migrates from WADL to Swagger-ish
- Runs a server to display the docs

Needed-By: I057cf0c0ebe404c78ecbb21140257b2516de1202
Change-Id: Ia8e69427b09d36da2fc2011dee7c043dad014402

gerrit/acls/openstack/fairy-slipper.config

@@ -0,0 +1,14 @@
+[access "refs/heads/*"]
+abandon = group fairy-slipper-core
+label-Code-Review = -2..+2 group fairy-slipper-core
+label-Workflow = -1..+1 group fairy-slipper-core
+
+[access "refs/tags/*"]
+pushSignedTag = group library-release
+
+[receive]
+requireChangeId = true
+requireContributorAgreement = true
+
+[submit]
+mergeContent = true

gerrit/projects.yaml

@@ -1134,6 +1134,11 @@
   acl-config: /home/gerrit2/acls/openstack/evoque.config
 - project: openstack/faafo
   description: First App Application for OpenStack
+- project: openstack/fairy-slipper
+  description: API documentation generator and builder for OpenStack
+  upstream: https://github.com/russell/fairy-slipper
+  groups:
+     - openstack-api-site
 - project: openstack/flame
   description: Automatic Heat template generation
 - project: openstack/freezer

gerritbot/channels.yaml

@@ -472,6 +472,7 @@ openstack-doc:
     - openstack/api-site
     - openstack/clouddocs-maven-plugin
     - openstack/docs-specs
+    - openstack/fairy-slipper
     - openstack/ha-guide
     - openstack/openstack-doc-tools
     - openstack/openstack-manuals
@@ -1492,6 +1493,7 @@ openstack-sdks:
   projects:
     - openstack/api-wg
     - openstack/cliff
+    - openstack/fairy-slipper
     - openstack/golang-client
     - openstack/keystoneauth
     - openstack/os-client-config

jenkins/jobs/projects.yaml

@@ -1352,6 +1352,15 @@
       - gate-{name}-docs
       - gate-{name}-pep8
 
+- project:
+    name: fairy-slipper
+    node: bare-trusty
+    tarball-site: tarballs.openstack.org
+
+    jobs:
+      - python-jobs
+      - pypi-jobs
+
 - project:
     name: flame
     node: bare-trusty

zuul/layout.yaml

@@ -4742,6 +4742,13 @@ projects:
       - gate-faafo-docs
       - gate-faafo-pep8
 
+  - name: openstack/fairy-slipper
+    template:
+      - name: merge-check
+      - name: python-jobs
+      - name: python3-jobs
+      - name: publish-to-pypi
+
   - name: openstack/flame
     template:
     - name: merge-check