Add documentation

Created using spr 1.3.6-beta.1

Cargo.toml

@@ -370,7 +370,7 @@ static_assertions = "1.1.0"
 # harder than expected to make breaking changes (even if you specify a specific
 # SHA).  Cut a new Steno release instead.  See omicron#2117.
 steno = "0.4.0"
-strum = { version = "0.25", features = [ "derive" ] }
+strum = { version = "0.26", features = [ "derive" ] }
 subprocess = "0.2.9"
 supports-color = "2.1.0"
 swrite = "0.1.0"

clippy.toml

@@ -1,9 +1,13 @@
 disallowed-methods = [
-    # `ON CONFLICT ... WHERE ... DO UPDATE` does not work with CockroachDB --
-    # see https://github.com/oxidecomputer/omicron/issues/5047.
+    # `ON CONFLICT ... WHERE ... DO UPDATE` is easy to misuse.
     #
-    # Instead, import diesel::query_dsl::methods::FilterDsl, then use
+    # If you mean a conditional upsert, import
+    # diesel::query_dsl::methods::FilterDsl, then use
     # `do_update().set(...).filter(...)`. (This is not part of the
     # documentation as of Diesel 2.1.4, but it works.)
+    #
+    # If you mean to specify a bound on a partial index, use the
+    # `IncompleteOnConflictExt::as_partial_index` in `nexus-db-queries`.
+    # See the documentation of that method for more.
     "diesel::upsert::DecoratableTarget::filter_target",
 ]