From 059e997535b6220d109034e44ed3ec500dab8c81 Mon Sep 17 00:00:00 2001
From: Monty Taylor <mordred@inaugust.com>
Date: Wed, 30 Aug 2017 08:09:00 -0500
Subject: [PATCH] Add comment to top of zuul.yaml pointing to other files

Zuul v3 config is spread across a bunch of repos, so figuring out where
somethig is defined may be daunting for a newcommer. Add a comment
to the top of the file pointing people at other repos they should be
aware of.

Also remove self-referencing roles declaration since job repos
automatically get their own roles now.

Change-Id: Ib9f966ff96f6617e8a7ce3b1e9aa4862f9e12a75
---
 zuul.yaml | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/zuul.yaml b/zuul.yaml
index bd292deb..edb219c1 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