Sources/Internal/Protocols/KeyNameFilter.swift

@@ -10,17 +10,28 @@
 //
 //===----------------------------------------------------------------------===
 
+/// A protocol that defines filters that might contain `key` and/or `name` values.
 protocol KeyNameFilter {
     
     // MARK: Properties
     
+    /// A key to use for filtering, if any.
     var key: String? { get }
+    
+    /// A name to use for filtering, if any.
     var name: String? { get }
     
-    // MARK: Initialisers
+    // MARK: Initializers
     
+    /// Initializes this filter without key or name values.
     init()
+
+    /// Initializes this filter with a key value.
+    /// - Parameter key: A key to use for filtering.
     init(key: String)
+    
+    /// Initializes this filter with a name value.
+    /// - Parameter name: A name to use for filtering.
     init(name: String)
     
 }

Sources/Internal/Protocols/KeyNameModel.swift

@@ -10,15 +10,21 @@
 //
 //===----------------------------------------------------------------------===
 
+/// A protocol that defines decodable models containing the `key` and `name` properties.
 protocol KeyNameModel: Sendable {
     
     // MARK: Properties
     
+    /// A key value.
     var key: String { get }
+    
+    /// A name value.
     var name: String { get }
     
-    // MARK: Initialisers
+    // MARK: Initializers
     
+    /// Initializes this model from a given payload.
+    /// - Parameter payload: A payload that contains the values for the model.
     init(_ payload: Components.Schemas.Tuple)
     
 }