Add api-ref job

As placement-api-ref is renamed to api-ref we can use the standard job
for the doc generation. This patch adds a voting api-ref generation job
for both queues

Change-Id: I0d8a2919e6af4bf41385e7d2324cbad72f7f9a7c

.zuul.yaml

@@ -14,6 +14,7 @@
         - openstack-tox-py35
         - openstack-tox-py36
         - openstack-tox-pep8
+        - build-openstack-api-ref
     gate:
       jobs:
         - openstack-tox-functional
@@ -23,3 +24,4 @@
         - openstack-tox-py35
         - openstack-tox-py36
         - openstack-tox-pep8
+        - build-openstack-api-ref

api-ref/source/conf.py

@@ -25,7 +25,9 @@
 import os
 import sys
 
-from nova.version import version_info
+import pbr.version
+
+version_info = pbr.version.VersionInfo('placement')
 
 sys.path.insert(0, os.path.abspath('../'))
 
@@ -51,9 +53,9 @@ project = u'Placement API Reference'
 copyright = u'2010-present, OpenStack Foundation'
 
 # openstackdocstheme options
-repository_name = 'openstack/nova'
+repository_name = 'openstack/placement'
 bug_project = 'nova'
-bug_tag = 'placement-api-ref'
+bug_tag = 'api-ref'
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
@@ -97,5 +99,5 @@ latex_documents = [
 # -- Options for openstackdocstheme -------------------------------------------
 
 openstack_projects = [
-    'nova',
+    'placement',
 ]

api-ref/source/index.rst

@@ -5,8 +5,8 @@
 ===============
 
 This is a reference for the OpenStack Placement API. To learn more about
-OpenStack Placement API concepts, please refer to the :nova-doc:`Placement
-Introduction <user/placement.html>`.
+OpenStack Placement API concepts, please refer to the
+:placement-doc:`Placement Introduction <user/placement.html>`.
 
 The Placement API uses JSON for data exchange.  As such, the ``Content-Type``
 header for APIs sending data payloads in the request body (i.e. ``PUT`` and