diff --git a/doc/source/drivers.rst b/doc/source/drivers.rst
index c83e0f4..58b1e96 100644
--- a/doc/source/drivers.rst
+++ b/doc/source/drivers.rst
@@ -611,6 +611,8 @@ executable after package installation. The script has ``sudo`` access
 and can set up the test environment as needed. For example, it should
 be used to set up the ``openstack_citest`` databases for testing.
 
+.. _v3_naming:
+
 Consistent Naming for Jobs with Zuul v3
 =======================================
 
diff --git a/doc/source/zuulv3.rst b/doc/source/zuulv3.rst
index 1bc878d..1d226f1 100644
--- a/doc/source/zuulv3.rst
+++ b/doc/source/zuulv3.rst
@@ -60,7 +60,7 @@ job that can be used for every project.  So when Zuul reports on your
 changes, the job name will now be `openstack-py27` rather than
 `gate-project-python27`.
 
-.. TODO: xref job naming guide
+For details about job names, see :ref:`v3_naming`.
 
 Most jobs will be migrated automatically
 ----------------------------------------