Document all features related to serde1 (#329)

git-actor/Cargo.toml

@@ -12,6 +12,7 @@ include = ["src/**/*"]
 doctest = false
 
 [features]
+## Data structures implement `serde::Serialize` and `serde::Deserialize`.
 serde1 = ["serde", "bstr/serde1"]
 
 ## Make `Signature` initializers use the local time (with UTC offset) available.

git-commitgraph/Cargo.toml

@@ -13,6 +13,7 @@ include = ["src/**/*", "CHANGELOG.md"]
 doctest = false
 
 [features]
+## Data structures implement `serde::Serialize` and `serde::Deserialize`
 serde1 = ["serde", "git-hash/serde1", "bstr/serde1"]
 
 [dependencies]

git-hash/Cargo.toml

@@ -13,6 +13,7 @@ doctest = false
 test = false
 
 [features]
+## Data structures implement `serde::Serialize` and `serde::Deserialize`.
 serde1 = ["serde"]
 
 [dependencies]

git-index/Cargo.toml

@@ -22,6 +22,7 @@ path = "tests/index-single-threaded.rs"
 required-features = ["internal-testing-to-avoid-being-run-by-cargo-test-all"]
 
 [features]
+## Data structures implement `serde::Serialize` and `serde::Deserialize`.
 serde1 = ["serde", "smallvec/serde", "git-hash/serde1"]
 
 internal-testing-git-features-parallel = ["git-features/parallel"]

git-object/Cargo.toml

@@ -12,6 +12,7 @@ include = ["src/**/*"]
 doctest = false
 
 [features]
+## Data structures implement `serde::Serialize` and `serde::Deserialize`.
 serde1 = ["serde", "bstr/serde1", "smallvec/serde", "git-hash/serde1", "git-actor/serde1"]
 verbose-object-parsing-errors = ["nom/std"]
 

git-odb/Cargo.toml

@@ -13,6 +13,7 @@ doctest = false
 
 [features]
 internal-testing-git-features-parallel = ["git-features/parallel"]
+## Data structures implement `serde::Serialize` and `serde::Deserialize`.
 serde1 = ["serde", "git-hash/serde1", "git-object/serde1", "git-pack/serde1" ]
 
 [[test]]

git-pack/Cargo.toml

@@ -15,6 +15,7 @@ doctest = false
 pack-cache-lru-static = ["uluru"]
 pack-cache-lru-dynamic = ["clru"]
 object-cache-dynamic = ["clru"]
+## Data structures implement `serde::Serialize` and `serde::Deserialize`.
 serde1 = ["serde", "git-object/serde1"]
 internal-testing-git-features-parallel = ["git-features/parallel"]
 internal-testing-to-avoid-being-run-by-cargo-test-all = []

git-packetline/Cargo.toml

@@ -13,6 +13,7 @@ doctest = false
 
 [features]
 default = []
+## Data structures implement `serde::Serialize` and `serde::Deserialize`.
 serde1 = ["serde", "bstr/serde1"]
 async-io = ["futures-io", "futures-lite", "pin-project-lite"]
 blocking-io = []

git-protocol/Cargo.toml

@@ -12,6 +12,7 @@ include = ["src/**/*", "CHANGELOG.md", "!**/tests/**/*"]
 doctest = false
 
 [features]
+## Data structures implement `serde::Serialize` and `serde::Deserialize`.
 serde1 = ["serde", "bstr/serde1", "git-transport/serde1", "git-hash/serde1"]
 blocking-client = ["git-transport/blocking-client", "maybe-async/is_sync"]
 async-client = ["git-transport/async-client", "async-trait", "futures-io", "futures-lite"]

git-ref/Cargo.toml

@@ -13,6 +13,7 @@ doctest = false
 test = true
 
 [features]
+## Data structures implement `serde::Serialize` and `serde::Deserialize`.
 serde1 = ["serde", "git-hash/serde1", "git-actor/serde1", "git-object/serde1"]
 internal-testing-git-features-parallel = ["git-features/parallel"] # test sorted parallel loose file traversal
 

git-repository/Cargo.toml

@@ -15,6 +15,7 @@ test = true
 [features]
 default = ["max-performance", "one-stop-shop"]
 unstable = ["git-index"]
+## Data structures implement `serde::Serialize` and `serde::Deserialize`.
 serde1 = ["git-pack/serde1", "git-object/serde1", "git-protocol/serde1", "git-transport/serde1", "git-ref/serde1", "git-odb/serde1", "git-index/serde1"]
 # enable when https://github.com/RustCrypto/asm-hashes/issues/17 is fixed
 # max-performance = ["git-features/parallel", "git-features/zlib-ng-compat", "git-features/fast-sha1"]

git-transport/Cargo.toml

@@ -13,6 +13,7 @@ doctest = false
 
 [features]
 default = []
+## Data structures implement `serde::Serialize` and `serde::Deserialize`.
 serde1 = ["serde"]
 http-client-curl = ["curl", "base64", "git-features/io-pipe", "blocking-client"]
 blocking-client = ["git-packetline/blocking-io"]

git-url/Cargo.toml

@@ -12,6 +12,7 @@ include = ["src/**/*", "CHANGELOG.md"]
 doctest = false
 
 [features]
+## Data structures implement `serde::Serialize` and `serde::Deserialize`.
 serde1 = ["serde", "bstr/serde1"]
 
 # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html

gitoxide-core/Cargo.toml

@@ -13,6 +13,7 @@ test = false
 
 [features]
 default = []
+## Data structures implement `serde::Serialize` and `serde::Deserialize`.
 serde1 = ["git-commitgraph/serde1", "git-repository/serde1", "serde_json", "serde"]
 
 # async or blocking tooling