diff --git a/doc/source/developing_drivers.rst b/doc/source/developing_drivers.rst
index 89565f1973..dff2b5d705 100644
--- a/doc/source/developing_drivers.rst
+++ b/doc/source/developing_drivers.rst
@@ -51,7 +51,7 @@ on GitHub for example, or even keeping your implementation private. We
 use `Setuptools entry points`_ to load your driver from anywhere in the
 Python path.
 
-.. _Setuptools entry points: no good resource?
+.. _Setuptools entry points: https://setuptools.readthedocs.io/en/latest/setuptools.html#dynamic-discovery-of-services-and-plugins
 
 How To Make a Driver
 --------------------
diff --git a/doc/source/federation/openidc.rst b/doc/source/federation/openidc.rst
index ce3c970020..9d72e24991 100644
--- a/doc/source/federation/openidc.rst
+++ b/doc/source/federation/openidc.rst
@@ -88,6 +88,7 @@ Tips
    with `HTTP_`, so for instance, if you set OIDCClaimPrefix to `OIDC-`, then a
    typical remote value to check for is: `HTTP_OIDC_ISS`.
 
-2. Don't forget to add oidc as an [auth] plugin in keystone.conf, see `Step 2`_
+2. Don't forget to add oidc as an [auth] plugin in keystone.conf, see
+   `Configure authentication drivers in keystone.conf`_
 
-.. _`Step 2`: federation.html
+.. _`Configure authentication drivers in keystone.conf`: federated_identity.html#configure-authentication-drivers-in-keystone-conf