Document dependency-groups in the pyproject.toml specification

source/guides/writing-pyproject-toml.rst

@@ -6,7 +6,7 @@ Writing your ``pyproject.toml``
 
 ``pyproject.toml`` is a configuration file used by packaging tools, as
 well as other tools such as linters, type checkers, etc. There are
-three possible TOML tables in this file.
+four possible TOML tables in this file.
 
 - The ``[build-system]`` table is **strongly recommended**. It allows
   you to declare which :term:`build backend` you use and which other
@@ -15,6 +15,10 @@ three possible TOML tables in this file.
 - The ``[project]`` table is the format that most build backends use to specify
   your project's basic metadata, such as the dependencies, your name, etc.
 
+- The ``[dependency-groups]`` table specifies dependencies for development tasks
+  such as testing and linting. See the
+  :ref:`Dependency Groups specification <dependency-groups>`.
+
 - The ``[tool]`` table has tool-specific subtables, e.g., ``[tool.hatch]``,
   ``[tool.black]``, ``[tool.mypy]``. We only touch upon this table here because
   its contents are defined by each tool. Consult the particular tool's

source/specifications/pyproject-toml.rst

@@ -14,10 +14,11 @@
 The ``pyproject.toml`` file acts as a configuration file for packaging-related
 tools (as well as other tools).
 
-The ``pyproject.toml`` file is written in `TOML <https://toml.io>`_. Three
+The ``pyproject.toml`` file is written in `TOML <https://toml.io>`_. Four
 tables are currently specified, namely
 :ref:`[build-system] <pyproject-build-system-table>`,
-:ref:`[project] <pyproject-project-table>` and
+:ref:`[project] <pyproject-project-table>`,
+:ref:`[dependency-groups] <dependency-groups>` and
 :ref:`[tool] <pyproject-tool-table>`. Other tables are reserved for future
 use (tool-specific configuration should use the ``[tool]`` table).