diff --git a/doc/source/creators.rst b/doc/source/creators.rst
index 065c6d9..06b04bd 100644
--- a/doc/source/creators.rst
+++ b/doc/source/creators.rst
@@ -4,6 +4,13 @@
  Project Creator's Guide
 ========================
 
+.. warning::
+
+   The information in this chapter about ``zuul/layout.yaml`` and
+   ``jenkins/jobs/`` files are all outdated, they refer to Zuul v2.
+   OpenStack CI uses Zuul v3 now. Read the :doc:`Zuul v3 Migration
+   Guide <zuulv3>` for more information.
+
 Before You Start
 ================