Fix docs

Author: Anton3

changelog/13228.feature.rst

@@ -1 +1,3 @@
-``pytest.HIDDEN_PARAM`` can now be used in ``id`` of ``pytest.param`` or in ``ids`` of ``parametrize``. It hides the parameter set from the test name.
+:ref:`pytest.HIDDEN_PARAM` can now be used in ``id`` of :func:`pytest.param` or in
+``ids`` of :py:func:`Metafunc.parametrize <pytest.Metafunc.parametrize>`.
+It hides the parameter set from the test name.

doc/en/reference/reference.rst

@@ -20,6 +20,16 @@ The current pytest version, as a string::
  >>> pytest.__version__
  '7.0.0'
 
+.. _`pytest.HIDDEN_PARAM ref`:
+
+pytest.HIDDEN_PARAM
+~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 8.4
+
+Can be passed to ``ids`` of :py:func:`Metafunc.parametrize <pytest.Metafunc.parametrize>`
+or to ``id`` of :func:`pytest.param` to hide a parameter set from the test name.
+Can only be used at most 1 time, as test names need to be unique.
 
 .. _`version-tuple`:
 

src/_pytest/mark/__init__.py

@@ -12,6 +12,7 @@
 
 from .expression import Expression
 from .expression import ParseError
+from .structures import _HiddenParam
 from .structures import EMPTY_PARAMETERSET_OPTION
 from .structures import get_empty_parameterset_mark
 from .structures import HIDDEN_PARAM
@@ -50,7 +51,7 @@
 def param(
  *values: object,
  marks: MarkDecorator | Collection[MarkDecorator | Mark] = (),
- id: str | None = None,
+ id: str | _HiddenParam | None = None,
 ) -> ParameterSet:
  """Specify a parameter in `pytest.mark.parametrize`_ calls or
  :ref:`parametrized fixtures <fixture-parametrize-marks>`.
@@ -75,6 +76,12 @@ def test_eval(test_input, expected):
  :ref:`pytest.mark.usefixtures <pytest.mark.usefixtures ref>` cannot be added via this parameter.
 
  :param id: The id to attribute to this parameter set.
+
+ .. versionadded: 8.4
+
+ :ref:`pytest.HIDDEN_PARAM` means to hide the parameter set
+ from the test name. Can only be used at most 1 time, as
+ test names need to be unique.
  """
  return ParameterSet.param(*values, marks=marks, id=id)
 

src/_pytest/python.py

@@ -1209,8 +1209,12 @@ def parametrize(
  ``bool``, or ``None``.
  They are mapped to the corresponding index in ``argvalues``.
  ``None`` means to use the auto-generated id.
- ``pytest.HIDDEN_PARAM`` means to hide the parameter set
- from the test name.
+
+ .. versionadded: 8.4
+
+ :ref:`pytest.HIDDEN_PARAM` means to hide the parameter set
+ from the test name. Can only be used at most 1 time, as
+ test names need to be unique.
 
  If it is a callable it will be called for each entry in
  ``argvalues``, and the return value is used as part of the