Update reference documentation for PEP 735 (#8567)

Updates the CLI and setting documentation to reflect the PEP 735 changes.
2024-10-25 13:15:32 -05:00
parent 07b6887c08
commit 8262e91e2f
4 changed files with 130 additions and 68 deletions
@@ -49,8 +49,15 @@ default-groups = ["docs"]

 ### [`dev-dependencies`](#dev-dependencies) {: #dev-dependencies }

-The project's development dependencies. Development dependencies will be installed by
-default in `uv run` and `uv sync`, but will not appear in the project's published metadata.
+The project's development dependencies.
+
+Development dependencies will be installed by default in `uv run` and `uv sync`, but will
+not appear in the project's published metadata.
+
+Use of this field is not recommend anymore. Instead, use the `dependency-groups.dev` field
+which is a standardized way to declare development dependencies. The contents of
+`tool.uv.dev-dependencies` and `dependency-groups.dev` are combined to determine the the
+final requirements of the `dev` dependency group.

 **Default value**: `[]`