Adjust comments

serde_derive/src/de.rs

@@ -168,9 +168,9 @@ impl Parameters {
         self.this_type.segments.last().unwrap().ident.to_string()
     }
 
-    /// Split a deserialized type's generics into the pieces required for impl'ing
-    /// a `Deserialize` trait for that type. Additionally appends the `'de` lifetime
-    /// to list of impl generics.
+    /// Split the data structure's generics into the pieces to use for its
+    /// `Deserialize` impl, augmented with an additional `'de` lifetime for use
+    /// as the `Deserialize` trait's lifetime.
     fn generics_with_de_lifetime(
         &self,
     ) -> (

serde_derive/src/de/enum_adjacently.rs

@@ -1,4 +1,4 @@
-//! Generator of the deserialization code for the adjacently tagged enums:
+//! Deserialization for adjacently tagged enums:
 //!
 //! ```ignore
 //! #[serde(tag = "...", content = "...")]

serde_derive/src/de/enum_externally.rs

@@ -1,4 +1,4 @@
-//! Generator of the deserialization code for the externally tagged enums:
+//! Deserialization for externally tagged enums:
 //!
 //! ```ignore
 //! enum Enum {}

serde_derive/src/de/enum_internally.rs

@@ -1,4 +1,4 @@
-//! Generator of the deserialization code for the internally tagged enums:
+//! Deserialization for internally tagged enums:
 //!
 //! ```ignore
 //! #[serde(tag = "...")]

serde_derive/src/de/enum_untagged.rs

@@ -1,4 +1,4 @@
-//! Generator of the deserialization code for the untagged enums:
+//! Deserialization for untagged enums:
 //!
 //! ```ignore
 //! #[serde(untagged)]

serde_derive/src/de/identifier.rs

@@ -1,4 +1,5 @@
-//! Contains generators of enums that represents identifiers of fields in structs or variants in enums.
+//! Deserialization of struct field identifiers and enum variant identifiers by
+//! way of a Rust enum.
 
 use crate::de::{FieldWithAliases, Parameters};
 use crate::fragment::{Fragment, Stmts};