diff --git a/zuul.yaml b/zuul.yaml
index cda9a53c..a9ab431f 100644
--- a/zuul.yaml
+++ b/zuul.yaml
@@ -1,9 +1,12 @@
+# Shared jobs specific to the OpenStack Project
+# imports jobs from:
+#    https://git.openstack.org/cgit/openstack-infra/project-config
+#    https://git.openstack.org/cgit/openstack-infra/zuul-jobs
+
 - job:
     name: openstack-doc-build
     parent: tox-docs
     run: playbooks/tox/docs
-    roles:
-      - zuul: openstack-infra/openstack-zuul-jobs
 
 - job:
     name: tox-py35-on-zuul