Run a job building docs and publishing them to readthedocs

Also update README with the required links.

Change-Id: I0f8e2bdeea80e49ac681eb78a1ab06b0ed7b4eae

.zuul.yaml

@@ -97,6 +97,8 @@
     run: playbooks/integration/run.yaml
 
 - project:
+    templates:
+      - docs-on-readthedocs
     check:
       jobs:
         - metalsmith-integration-glance

README.rst

@@ -10,6 +10,11 @@ Metal Service (ironic) <https://docs.openstack.org/ironic/latest/>`_,
 and `OpenStack Networking Service (neutron)
 <https://docs.openstack.org/neutron/latest/>`_.
 
+* License: Apache License, Version 2.0
+* Documentation: https://metalsmith.readthedocs.io
+* Source: https://git.openstack.org/cgit/openstack/metalsmith
+* Bugs: https://storyboard.openstack.org/#!/project/1000
+
 Installation
 ------------