Move the dependency specifiers specification into the reference section

docs/concepts/projects/dependencies.md

@@ -158,8 +158,7 @@ documentation for a complete enumeration of the available markers and operators.
 
 The `project.dependencies` table represents the dependencies that are used when uploading to PyPI or
 building a wheel. Individual dependencies are specified using
-[dependency specifiers](https://packaging.python.org/en/latest/specifications/dependency-specifiers/)
-syntax, and the table follows the
+[dependency specifiers](../../reference/dependency-specifiers.md) syntax, and the table follows the
 [PEP 621](https://packaging.python.org/en/latest/specifications/pyproject-toml/) standard.
 
 `project.dependencies` defines the list of packages that are required for the project, along with
@@ -520,7 +519,7 @@ requested with the `package[<extra>]` syntax, e.g., `pandas[plot, excel]`.
 
 Optional dependencies are specified in `[project.optional-dependencies]`, a TOML table that maps
 from extra name to its dependencies, following
-[dependency specifiers](#dependency-specifiers-pep-508) syntax.
+[dependency specifiers](../../reference/dependency-specifiers.md) syntax.
 
 Optional dependencies can have entries in `tool.uv.sources` the same as normal dependencies.
 
@@ -753,38 +752,3 @@ Or, to opt-out of using an editable dependency in a workspace:
 ```console
 $ uv add --no-editable ./path/foo
 ```
-
-## Dependency specifiers (PEP 508)
-
-uv uses
-[dependency specifiers](https://packaging.python.org/en/latest/specifications/dependency-specifiers/),
-previously known as [PEP 508](https://peps.python.org/pep-0508/). A dependency specifier is composed
-of, in order:
-
-- The dependency name
-- The extras you want (optional)
-- The version specifier
-- An environment marker (optional)
-
-The version specifiers are comma separated and added together, e.g., `foo >=1.2.3,<2,!=1.4.0` is
-interpreted as "a version of `foo` that's at least 1.2.3, but less than 2, and not 1.4.0".
-
-Specifiers are padded with trailing zeros if required, so `foo ==2` matches foo 2.0.0, too.
-
-A star can be used for the last digit with equals, e.g. `foo ==2.1.*` will accept any release from
-the 2.1 series. Similarly, `~=` matches where the last digit is equal or higher, e.g., `foo ~=1.2`
-is equal to `foo >=1.2,<2`, and `foo ~=1.2.3` is equal to `foo >=1.2.3,<1.3`.
-
-Extras are comma-separated in square bracket between name and version, e.g.,
-`pandas[excel,plot] ==2.2`. Whitespace between extra names is ignored.
-
-Some dependencies are only required in specific environments, e.g., a specific Python version or
-operating system. For example to install the `importlib-metadata` backport for the
-`importlib.metadata` module, use `importlib-metadata >=7.1.0,<8; python_version < '3.10'`. To
-install `colorama` on Windows (but omit it on other platforms), use
-`colorama >=0.4.6,<5; platform_system == "Windows"`.
-
-Markers are combined with `and`, `or`, and parentheses, e.g.,
-`aiohttp >=3.7.4,<4; (sys_platform != 'win32' or implementation_name != 'pypy') and python_version >= '3.10'`.
-Note that versions within markers must be quoted, while versions _outside_ of markers must _not_ be
-quoted.

docs/reference/dependency-specifiers.md

@@ -0,0 +1,34 @@
+# Dependency specifiers
+
+uv uses
+[dependency specifiers](https://packaging.python.org/en/latest/specifications/dependency-specifiers/),
+originally standardized in [PEP 508](https://peps.python.org/pep-0508/). A dependency specifier is
+composed of, in order:
+
+- The dependency name
+- The extras you want (optional)
+- The version specifier
+- An environment marker (optional)
+
+The version specifiers are comma separated and added together, e.g., `foo >=1.2.3,<2,!=1.4.0` is
+interpreted as "a version of `foo` that's at least 1.2.3, but less than 2, and not 1.4.0".
+
+Specifiers are padded with trailing zeros if required, so `foo ==2` matches foo 2.0.0, too.
+
+A star can be used for the last digit with equals, e.g. `foo ==2.1.*` will accept any release from
+the 2.1 series. Similarly, `~=` matches where the last digit is equal or higher, e.g., `foo ~=1.2`
+is equal to `foo >=1.2,<2`, and `foo ~=1.2.3` is equal to `foo >=1.2.3,<1.3`.
+
+Extras are comma-separated in square bracket between name and version, e.g.,
+`pandas[excel,plot] ==2.2`. Whitespace between extra names is ignored.
+
+Some dependencies are only required in specific environments, e.g., a specific Python version or
+operating system. For example to install the `importlib-metadata` backport for the
+`importlib.metadata` module, use `importlib-metadata >=7.1.0,<8; python_version < '3.10'`. To
+install `colorama` on Windows (but omit it on other platforms), use
+`colorama >=0.4.6,<5; platform_system == "Windows"`.
+
+Markers are combined with `and`, `or`, and parentheses, e.g.,
+`aiohttp >=3.7.4,<4; (sys_platform != 'win32' or implementation_name != 'pypy') and python_version >= '3.10'`.
+Note that versions within markers must be quoted, while versions _outside_ of markers must _not_ be
+quoted.

mkdocs.template.yml

@@ -147,6 +147,7 @@ nav:
       - Settings: reference/settings.md
       - Build Failures: reference/build_failures.md
       - Resolver: reference/resolver-internals.md
+      - Dependency specifiers: reference/dependency-specifiers.md
       - Benchmarks: reference/benchmarks.md
       - Versioning: reference/versioning.md
       - Platform support: reference/platforms.md