diff --git a/zuul.d/pipelines.yaml b/zuul.d/pipelines.yaml
index 2818993dc9..84d648376a 100644
--- a/zuul.d/pipelines.yaml
+++ b/zuul.d/pipelines.yaml
@@ -10,6 +10,7 @@
     failure-message: |
       Build failed (check pipeline).  For information on how to proceed, see
       https://docs.opendev.org/opendev/infra-manual/latest/developers.html#automated-testing
+      and https://docs.openstack.org/project-team-guide/testing.html#how-to-handle-test-failures
     manager: independent
     precedence: low
     require: