diff --git a/README.rst b/README.rst
index 2c98b688d2..90e00a56f3 100644
--- a/README.rst
+++ b/README.rst
@@ -6,6 +6,11 @@ Zuul is a project gating system developed for the OpenStack Project.
 Contributing
 ------------
 
+We are currently engaged in a significant development effort in
+preparation for the third major version of Zuul.  We call this effort
+`Zuul v3`_ and it is described in this file in the `feature/zuulv3`
+branch of this repo.
+
 To browse the latest code, see: https://git.openstack.org/cgit/openstack-infra/zuul/tree/
 To clone the latest code, use `git clone git://git.openstack.org/openstack-infra/zuul`