add a note to [patch.crates-io] in the workspace Cargo.toml

Add a note to the`[patch.crates-io]` located in the top-level
`Cargo.toml` file that explains when this should be preferred
over replicating the git-source in every dependency declaration.

Author: aalexandrov

Cargo.lock

@@ -82,6 +82,11 @@ rustc-demangle = { opt-level = 3 }
 # production installations, but we still want useful crash reports.
 debug = 1
 
+# Use this section only to change the source of dependencies that might
+# also appear as transitive dependencies of other external dependencies in
+# the dependency graph. For everything else (e.g. rust-postgres, rdkafka,
+# differential-dataflow, proptest, timely) set the `git` sourcce
+# direclty in each dependency entry.
 [patch.crates-io]
 # Until https://github.com/jorgecarleitao/parquet-format-rs/pull/2 is merged and released
 parquet-format-async-temp = { git = "https://github.com/MaterializeInc/parquet-format-rs", branch = "main" }

Cargo.toml

@@ -152,7 +152,7 @@ allow-git = [
     "https://github.com/MaterializeInc/parquet-format-rs.git",
 
     # Waiting on https://github.com/AltSysrq/proptest/pull/264.
-    "https://github.com/materializeInc/proptest.git",
+    "https://github.com/MaterializeInc/proptest.git",
 
     # Dependencies that we control upstream whose official releases we don't
     # care about.

deny.toml

@@ -46,8 +46,8 @@ sha-1 = "0.10.0"
 sha2 = "0.10.2"
 uncased = "0.9.6"
 uuid = "0.8.2"
-proptest = { git = "https://github.com/materializeInc/proptest.git", default-features = false, features = ["std"], optional = true }
-proptest-derive = { git = "https://github.com/materializeInc/proptest.git", optional = true }
+proptest = { git = "https://github.com/MaterializeInc/proptest.git", default-features = false, features = ["std"], optional = true }
+proptest-derive = { git = "https://github.com/MaterializeInc/proptest.git", optional = true }
 
 [dev-dependencies]
 criterion = { git = "https://github.com/MaterializeInc/criterion.rs.git" }

src/expr/Cargo.toml

@@ -40,8 +40,8 @@ serde_json = { version = "1.0.79", features = ["arbitrary_precision"] }
 serde_regex = "1.1.0"
 smallvec = { version = "1.8.0", features = ["serde", "union"] }
 uuid = "0.8.2"
-proptest = { git = "https://github.com/materializeInc/proptest.git", default-features = false, features = ["std"], optional = true }
-proptest-derive = { git = "https://github.com/materializeInc/proptest.git", optional = true }
+proptest = { git = "https://github.com/MaterializeInc/proptest.git", default-features = false, features = ["std"], optional = true }
+proptest-derive = { git = "https://github.com/MaterializeInc/proptest.git", optional = true }
 
 [dev-dependencies]
 criterion = { git = "https://github.com/MaterializeInc/criterion.rs.git" }