Update documentation

Author: nolinmcfarland

Sources/Mocking/Macros/Mocked.swift

@@ -16,9 +16,12 @@
 /// public final class DependencyMock: Dependency { ... }
 /// ```
 ///
-/// - Parameter compilationCondition: The compilation condition to apply to the
-///   `#if` compiler directive used to wrap the generated mock.
-// TODO: Docs
+/// - Parameters:
+///   - compilationCondition: The compilation condition to apply to the
+///     `#if` compiler directive used to wrap the generated mock.
+///     (default: `.swiftMockingEnabled`)
+///   - sendableConformance: The `Sendable` conformance to apply to
+///     the generated mock. (default: `.checked`)
 @attached(peer, names: suffixed(Mock))
 public macro Mocked(
     compilationCondition: MockCompilationCondition = .swiftMockingEnabled,

Sources/Mocking/Models/MacroArguments/MockSendableConformance.swift

@@ -4,12 +4,13 @@
 //  Copyright © 2025 Fetch.
 //
 
-// TODO: Docs
+/// A `Sendable` conformance that can be applied to a mock declaration.
 public enum MockSendableConformance {
 
-    // TODO: Docs
+    /// The mock adheres to the `Sendable` conformance of the original
+    /// implementation.
     case checked
 
-    // TODO: Docs
+    /// The mock conforms to `@unchecked Sendable`.
     case unchecked
 }

Sources/MockingMacros/Extensions/InheritedTypeSyntax/InheritedTypeSyntax+UncheckedSendable.swift

@@ -8,8 +8,13 @@ import SwiftSyntax
 
 extension InheritedTypeSyntax {
 
-    // TODO: Docs
-    // @unchecked Sendable
+    /// An `InheritedTypeSyntax` representing unchecked sendable conformance
+    /// with a trailing comma.
+    ///
+    /// ```swift
+    /// // Represents
+    /// @unchecked Sendable,
+    /// ```
     static let uncheckedSendable = InheritedTypeSyntax(
         type: AttributedTypeSyntax(
             specifiers: [],

Sources/MockingMacros/Macros/MockedMacro/MockedMacro+MacroArguments.swift

@@ -19,7 +19,7 @@ extension MockedMacro {
         /// The compilation condition with which to wrap the generated mock.
         let compilationCondition: MockCompilationCondition
 
-        // TODO: Docs
+        /// The sendable conformance to apply to the generated mock.
         let sendableConformance: MockSendableConformance
 
         // MARK: Initializers

Sources/MockingMacros/Macros/MockedMacro/MockedMacro.swift

@@ -178,10 +178,13 @@ extension MockedMacro {
     /// final class DependencyMock: Dependency {}
     /// ```
     ///
-    /// - Parameter protocolDeclaration: The protocol to which the mock must
-    ///   conform.
+    /// - Parameters:
+    ///   - protocolDeclaration: The protocol to which the mock must
+    ///     conform.
+    ///   - sendableConformance: The sendable conformance the mock should have.
+    ///     If `.unchecked`, the clause will include `@unchecked Sendable`.
+    ///
     /// - Returns: The inheritance clause to apply to the mock declaration.
-    // TODO: Docs
     private static func mockInheritanceClause(
         from protocolDeclaration: ProtocolDeclSyntax,
         sendableConformance: MockSendableConformance

Sources/MockingMacros/Models/MacroArguments/MacroArgument.swift

@@ -6,7 +6,13 @@
 
 import SwiftSyntax
 
-// TODO: Docs
+/// A protocol for arguments that can be parsed from a macro's argument
+/// syntax.
 protocol MacroArgument {
+    
+    /// Creates a macro argument from the provided `argument`.
+    ///
+    /// - Parameter argument: The argument syntax from which to parse the
+    ///   macro argument.
     init?(argument: LabeledExprSyntax)
 }

Sources/MockingMacros/Models/MacroArguments/MockSendableConformance.swift

@@ -6,16 +6,20 @@
 
 import SwiftSyntax
 
-// TODO: Docs
+/// A `Sendable` conformance that can be applied to a mock declaration.
 enum MockSendableConformance: String, MacroArgument {
 
-    // TODO: Docs
+    /// The mock adheres to the `Sendable` conformance of the original
+    /// implementation.
     case checked
 
-    // TODO: Docs
+    /// The mock conforms to `@unchecked Sendable`.
     case unchecked
-    
-    // TODO: Docs
+
+    /// Creates a sendable conformance from the provided `argument`.
+    ///
+    /// - Parameter argument: The argument syntax from which to parse a
+    ///   sendable conformance.
     init?(argument: LabeledExprSyntax) {
         guard
             let memberAccessExpression = argument.expression.as(