diff --git a/docs/html/installation.md b/docs/html/installation.md
index da975727185..e389a8fa4d4 100644
--- a/docs/html/installation.md
+++ b/docs/html/installation.md
@@ -60,6 +60,8 @@ If you face issues when using Python and pip installed using these mechanisms,
it is recommended to request for support from the relevant provider (eg: Linux
distro community, cloud provider support channels, etc).
+(compatibility-requirements)=
+
## Compatibility
The current version of pip works on:
diff --git a/docs/html/topics/authentication.md b/docs/html/topics/authentication.md
index e78aff47201..981aab5abd7 100644
--- a/docs/html/topics/authentication.md
+++ b/docs/html/topics/authentication.md
@@ -18,7 +18,7 @@ https://0123456789abcdef@pypi.company.com/simple
### Percent-encoding special characters
-```{versionaddded} 10.0
+```{versionadded} 10.0
```
Certain special characters are not valid in the credential part of a URL.
diff --git a/docs/html/user_guide.rst b/docs/html/user_guide.rst
index cfcdfc182a1..967d78aef09 100644
--- a/docs/html/user_guide.rst
+++ b/docs/html/user_guide.rst
@@ -63,17 +63,17 @@ For more information and examples, see the :ref:`pip install` reference.
Basic Authentication Credentials
================================
-This is now covered in {doc}`topics/authentication`.
+This is now covered in :doc:`topics/authentication`.
netrc Support
-------------
-This is now covered in {doc}`topics/authentication`.
+This is now covered in :doc:`topics/authentication`.
Keyring Support
---------------
-This is now covered in {doc}`topics/authentication`.
+This is now covered in :doc:`topics/authentication`.
Using a Proxy Server
====================