Fixup issues in documentation

Sources/Hummingbird/Environment.swift

@@ -42,20 +42,20 @@ public struct Environment: Sendable, Decodable, ExpressibleByDictionaryLiteral {
 
     var values: [String: String]
 
-    /// initialize from environment variables
+    /// Initialize from environment variables
     public init() {
         self.values = Self.getEnvironment()
     }
 
-    /// initialize from dictionary
+    /// Initialize from dictionary
     public init(values: [String: String]) {
         self.values = Self.getEnvironment()
         for (key, value) in values {
             self.values[key.lowercased()] = value
         }
     }
 
-    /// initialize from dictionary literal
+    /// Initialize from dictionary literal
     public init(dictionaryLiteral elements: (String, String)...) {
         self.values = Self.getEnvironment()
         for element in elements {
@@ -88,6 +88,9 @@ public struct Environment: Sendable, Decodable, ExpressibleByDictionaryLiteral {
     }
 
     /// Set environment variable
+    ///
+    /// This sets the variable within this type and also calls `setenv` so future versions
+    /// of this type will also have this variable set.
     /// - Parameters:
     ///   - s: Environment variable name
     ///   - value: Environment variable name value

Sources/Hummingbird/Server/ChildRequestContext.swift

@@ -13,8 +13,18 @@
 //===----------------------------------------------------------------------===//
 import Logging
 
-/// A RequestContext that can be initialized from another RequestContext where initialization
-/// can throw errors which will be passed back up the middleware stack
+/// A RequestContext that can be initialized from another RequestContext.
+/// 
+/// The init for the context is marked throwing as it is allowed to fail. If
+/// it fails then the error is passed back up the middleware stack
+/// 
+/// ```
+/// struct MyRequestContext: ChildRequestContext {
+///     init(context: MyParentRequestContext) throws {
+///         self.coreContext = context.coreContext
+///     } 
+/// }
+/// ```
 public protocol ChildRequestContext<ParentContext>: RequestContext where Source == Never {
     associatedtype ParentContext: RequestContext
     /// Initialise RequestContext from source

Sources/Hummingbird/Utils/InitializableFromSource.swift

@@ -15,6 +15,6 @@
 /// A type that can be initialized from another type
 public protocol InitializableFromSource<Source>: Sendable {
     associatedtype Source
-    /// Initialise RequestContext from source
+    /// Initialise from source type
     init(source: Source)
 }