diff --git a/.zuul.yaml b/.zuul.yaml
index 5bf298f6..a04b2745 100644
--- a/.zuul.yaml
+++ b/.zuul.yaml
@@ -22,8 +22,17 @@
       - openstack-python3-victoria-jobs
     check:
       jobs:
+        - openstack-tox-linters
+        - openstack-tox-docs: &tripleo-docs
+            files:
+              - ^doc/.*
+              - ^README.rst
         - validations-libs-functional
     gate:
       jobs:
         - openstack-tox-linters
+        - openstack-tox-docs: *tripleo-docs
         - validations-libs-functional
+    promote:
+      jobs:
+        - promote-openstack-tox-docs: *tripleo-docs