Fix PDF build

With newer sphinx the pdf build fails and gives the following error:

! Dimension too large.

This could be memory issue, that can be fixed by not generating the
sample_policy file as that can be large.

This patch also sets back the tox-docs job as voting.

Closes-Bug: #1918707
Change-Id: I4f22fe7b45394045f672d5bbd3b46c4e5e4b2fd3

doc/source/configuration/shared-file-systems/samples/sample_policy.rst

@@ -20,6 +20,13 @@ instance, if you want to change the default value of "share:create", you only
 need to keep this single rule in your policy config
 file (**/etc/manila/policy.yaml**).
 
-.. literalinclude:: ../../../_static/manila.policy.yaml.sample
+.. only:: html
-   :language: ini
+
+   .. literalinclude:: ../../../_static/manila.policy.yaml.sample
+      :language: ini
+
+.. only:: latex
+
+   See the online version of this documentation for the sample file
+   (``manila.policy.yaml.sample``).
 

zuul.d/project.yaml

@@ -9,9 +9,6 @@
       - periodic-stable-jobs
     check:
       jobs:
-        # see https://launchpad.net/bugs/1918707
-        - openstack-tox-docs:
-            voting: false
         - manila-tox-genconfig
         - openstack-tox-pylint:
             voting: false
@@ -44,9 +41,6 @@
     gate:
       queue: manila
       jobs:
-        # see https://launchpad.net/bugs/1918707
-        - openstack-tox-docs:
-            voting: false
         - manila-tempest-plugin-dummy-no-dhss
         - manila-tempest-plugin-dummy-dhss
         - manila-tempest-plugin-lvm