Revert

Author: charliermarsh

crates/uv-dev/src/generate_cli_reference.rs

@@ -101,7 +101,14 @@ fn generate() -> String {
     generate_command(&mut output, &uv, &mut parents);
 
     for (value, replacement) in REPLACEMENTS {
-        output = output.replace(value, replacement);
+        assert!(
+            value != replacement,
+            "`value` and `replacement` must be different, but both are `{value}`"
+        );
+        let before = &output;
+        let after = output.replace(value, replacement);
+        assert!(*before != after, "Could not find `{value}` in the output");
+        output = after;
     }
 
     output

crates/uv-dev/src/generate_json_schema.rs

@@ -33,8 +33,8 @@ pub(crate) struct Args {
 }
 
 pub(crate) fn main(args: &Args) -> Result<()> {
-    let schema = schema_for!(CombinedOptions);
-    let schema_string = serde_json::to_string_pretty(&schema).unwrap();
+    // Generate the schema.
+    let schema_string = generate();
     let filename = "uv.schema.json";
     let schema_path = PathBuf::from(ROOT_DIR).join(filename);
 
@@ -80,5 +80,30 @@ pub(crate) fn main(args: &Args) -> Result<()> {
     Ok(())
 }
 
+/// Generate the JSON schema for the combined options as a string.
+fn generate() -> String {
+    let schema = schema_for!(CombinedOptions);
+    let mut output = serde_json::to_string_pretty(&schema).unwrap();
+
+    for (value, replacement) in [
+        // Use the fully-resolved URL rather than the relative Markdown path.
+        (
+            "(../concepts/dependencies.md)",
+            "(https://docs.astral.sh/uv/concepts/dependencies/)",
+        ),
+    ] {
+        assert!(
+            value != replacement,
+            "`value` and `replacement` must be different, but both are `{value}`"
+        );
+        let before = &output;
+        let after = output.replace(value, replacement);
+        assert!(*before != after, "Could not find `{value}` in the output");
+        output = after;
+    }
+
+    output
+}
+
 #[cfg(test)]
 mod tests;

crates/uv-settings/src/settings.rs

@@ -86,8 +86,7 @@ pub struct Options {
     cache_keys: Option<Vec<CacheKey>>,
 
     // NOTE(charlie): These fields are shared with `ToolUv` in
-    // `crates/uv-workspace/src/pyproject.rs`. The documentation lives on that struct.
-    // They're respected in both `pyproject.toml` and `uv.toml` files.
+    // `crates/uv-workspace/src/pyproject.rs`, and the documentation lives on that struct.
     #[cfg_attr(feature = "schemars", schemars(skip))]
     pub override_dependencies: Option<Vec<Requirement<VerbatimParsedUrl>>>,
 
@@ -1552,15 +1551,13 @@ pub struct OptionsWire {
     cache_keys: Option<Vec<CacheKey>>,
 
     // NOTE(charlie): These fields are shared with `ToolUv` in
-    // `crates/uv-workspace/src/pyproject.rs`. The documentation lives on that struct.
-    // They're respected in both `pyproject.toml` and `uv.toml` files.
+    // `crates/uv-workspace/src/pyproject.rs`, and the documentation lives on that struct.
     override_dependencies: Option<Vec<Requirement<VerbatimParsedUrl>>>,
     constraint_dependencies: Option<Vec<Requirement<VerbatimParsedUrl>>>,
     environments: Option<SupportedEnvironments>,
 
     // NOTE(charlie): These fields should be kept in-sync with `ToolUv` in
-    // `crates/uv-workspace/src/pyproject.rs`. The documentation lives on that struct.
-    // They're only respected in `pyproject.toml` files, and should be rejected in `uv.toml` files.
+    // `crates/uv-workspace/src/pyproject.rs`.
     #[allow(dead_code)]
     workspace: Option<serde::de::IgnoredAny>,
     #[allow(dead_code)]

crates/uv-workspace/src/pyproject.rs

@@ -158,7 +158,7 @@ pub struct ToolUv {
     /// during development. A dependency source can be a Git repository, a URL, a local path, or an
     /// alternative registry.
     ///
-    /// See [Dependencies](https://docs.astral.sh/uv/concepts/dependencies/) for more.
+    /// See [Dependencies](../concepts/dependencies.md) for more.
     #[option(
         default = "\"[]\"",
         value_type = "dict",

docs/reference/settings.md

@@ -206,7 +206,7 @@ The sources to use when resolving dependencies.
 during development. A dependency source can be a Git repository, a URL, a local path, or an
 alternative registry.
 
-See [Dependencies](https://docs.astral.sh/uv/concepts/dependencies/) for more.
+See [Dependencies](../concepts/dependencies.md) for more.
 
 **Default value**: `"[]"`
 
@@ -215,7 +215,7 @@ See [Dependencies](https://docs.astral.sh/uv/concepts/dependencies/) for more.
 **Example usage**:
 
 ```toml title="pyproject.toml"
-[tool.uv]
+
 [tool.uv.sources]
 httpx = { git = "https://github.com/encode/httpx", tag = "0.27.0" }
 pytest =  { url = "https://files.pythonhosted.org/packages/6b/77/7440a06a8ead44c7757a64362dd22df5760f9b12dc5f11b6188cd2fc27a0/pytest-8.3.3-py3-none-any.whl" }