diff --git a/doc/en/goodpractices.rst b/doc/en/goodpractices.rst
index ee5674fd6..4b3c0af10 100644
--- a/doc/en/goodpractices.rst
+++ b/doc/en/goodpractices.rst
@@ -1,4 +1,4 @@
-.. highlightlang:: python
+.. highlight:: python
 .. _`goodpractices`:
 
 Good Integration Practices
diff --git a/doc/en/reference.rst b/doc/en/reference.rst
index d81ba9bc7..005014d84 100644
--- a/doc/en/reference.rst
+++ b/doc/en/reference.rst
@@ -138,7 +138,7 @@ pytest.mark.parametrize
 
 **Tutorial**: :doc:`parametrize`.
 
-.. automethod:: _pytest.python.Metafunc.parametrize
+This mark has the same signature as :py:meth:`_pytest.python.Metafunc.parametrize`; see there.
 
 
 .. _`pytest.mark.skip ref`:
diff --git a/doc/en/requirements.txt b/doc/en/requirements.txt
index 1e5e7efdc..fa37acfb4 100644
--- a/doc/en/requirements.txt
+++ b/doc/en/requirements.txt
@@ -1,5 +1,5 @@
 pallets-sphinx-themes
 pygments-pytest>=1.1.0
 sphinx-removed-in>=0.2.0
-sphinx>=1.8.2,<2.1
+sphinx>=3.1,<4
 sphinxcontrib-trio