improve summary descriptions of prettypretty's abstractions

src/core/difference.rs

@@ -103,7 +103,8 @@ fn prepare_coordinate_interpolation(
     intermediate
 }
 
-/// A strategy for interpolating hues.
+/// A strategy for interpolating hues used by
+/// [`Color::interpolate`](crate::Color::interpolate).
 ///
 /// Since hues are expressed as angles, the same perceptual hue has an infinite
 /// number of representations modulo 360. Furthermore, there are two ways of

src/term_color.rs

@@ -1145,7 +1145,7 @@ impl TryFrom<TerminalColor> for Color {
 // ====================================================================================================================
 // Layer and Fidelity
 
-/// The layer for rendering to the terminal: Foreground or background.
+/// The targeted display layer: Foreground or background.
 #[cfg_attr(feature = "pyffi", pyclass(eq, eq_int, frozen, hash))]
 #[derive(Copy, Clone, Debug, PartialEq, Eq, Hash)]
 pub enum Layer {

src/translation.rs

@@ -80,7 +80,7 @@ impl TryFrom<usize> for ThemeEntry {
     }
 }
 
-/// An iterator over theme entries.
+/// A helper for iterating over the slot names of theme entries.
 ///
 /// This iterator is fused, i.e., after returning `None` once, it will keep
 /// returning `None`. This iterator also is exact, i.e., its `size_hint()`