diff --git a/zuul.d/pipelines.yaml b/zuul.d/pipelines.yaml
index 925864b7e8..76c3f3d12c 100644
--- a/zuul.d/pipelines.yaml
+++ b/zuul.d/pipelines.yaml
@@ -60,7 +60,8 @@
     description: |
       Changes that have been approved by core reviewers are enqueued
       in order in this pipeline, and if they pass tests, will be
-      merged.
+      merged. For documentation on how gating with Zuul works, please see
+      https://zuul-ci.org/docs/zuul/user/gating.html
     success-message: Build succeeded (gate pipeline).
     failure-message: |
       Build failed (gate pipeline).  For information on how to proceed, see