docs: Further cleanup

Author: epage

src/builder.rs

@@ -125,9 +125,8 @@ enum SourceType {
 impl BuilderState for DefaultState {}
 impl BuilderState for AsyncState {}
 
+/// Operations allowed in any state
 impl<St: BuilderState> ConfigBuilder<St> {
-    // operations allowed in any state
-
     /// Set a default `value` at `key`
     ///
     /// This value can be overwritten by any [`Source`], [`AsyncSource`] or override.
@@ -183,9 +182,8 @@ impl<St: BuilderState> ConfigBuilder<St> {
     }
 }
 
+/// Operations allowed in sync state
 impl ConfigBuilder<DefaultState> {
-    // operations allowed in sync state
-
     /// Registers new [`Source`] in this builder.
     ///
     /// Calling this method does not invoke any I/O. [`Source`] is only saved in internal register for later use.
@@ -273,9 +271,8 @@ impl ConfigBuilder<DefaultState> {
     }
 }
 
+/// Operations allowed in async state
 impl ConfigBuilder<AsyncState> {
-    // operations allowed in async state
-
     /// Registers new [`Source`] in this builder.
     ///
     /// Calling this method does not invoke any I/O. [`Source`] is only saved in internal register for later use.

src/config.rs

@@ -11,8 +11,9 @@ use crate::ser::ConfigSerializer;
 use crate::source::Source;
 use crate::value::{Table, Value};
 
-/// A prioritized configuration repository. It maintains a set of
-/// configuration sources, fetches values to populate those, and provides
+/// A prioritized configuration repository.
+///
+/// It maintains a set of configuration sources, fetches values to populate those, and provides
 /// them according to the source's priority.
 #[derive(Clone, Debug)]
 pub struct Config {

src/value.rs

@@ -9,8 +9,8 @@ use crate::map::Map;
 
 /// Underlying kind of the configuration value.
 ///
-/// Standard operations on a `Value` by users of this crate do not require
-/// knowledge of `ValueKind`. Introspection of underlying kind is only required
+/// Standard operations on a [`Value`] by users of this crate do not require
+/// knowledge of [`ValueKind`]. Introspection of underlying kind is only required
 /// when the configuration values are unstructured or do not have known types.
 #[derive(Debug, Clone, PartialEq)]
 pub enum ValueKind {