Change name and add comments

Author: Uncommon

Sources/Testing/Traits/ConditionTrait.swift

@@ -20,8 +20,13 @@
 /// - ``Trait/disabled(_:sourceLocation:_:)``
 public struct ConditionTrait: TestTrait, SuiteTrait {
   /// The result of evaluating the condition.
-  public typealias Evaluation = (Bool, comment: Comment?)
-  
+  ///
+  /// - Parameters:
+  ///   - wasMet: Whether or not the condition was met.
+  ///   - comment: Optionally, a comment describing the result of evaluating the condition.
+  @_spi(Experimental)
+  public typealias EvaluationResult = (wasMet: Bool, comment: Comment?)
+
   /// An enumeration describing the kinds of conditions that can be represented
   /// by an instance of this type.
   enum Kind: Sendable {
@@ -33,7 +38,7 @@ public struct ConditionTrait: TestTrait, SuiteTrait {
     ///     `false` and a comment is also returned, it is used in place of the
     ///     value of the associated trait's ``ConditionTrait/comment`` property.
     ///     If this function returns `true`, the returned comment is ignored.
-    case conditional(_ body: @Sendable () async throws -> Evaluation)
+    case conditional(_ body: @Sendable () async throws -> EvaluationResult)
 
     /// Create an instance of this type associated with a trait that is
     /// conditional on the result of calling a function.
@@ -44,7 +49,7 @@ public struct ConditionTrait: TestTrait, SuiteTrait {
     ///
     /// - Returns: An instance of this type.
     static func conditional(_ body: @escaping @Sendable () async throws -> Bool) -> Self {
-      conditional { () -> Evaluation in
+      conditional { () -> EvaluationResult in
         return (try await body(), nil)
       }
     }
@@ -83,9 +88,14 @@ public struct ConditionTrait: TestTrait, SuiteTrait {
   /// The source location where this trait was specified.
   public var sourceLocation: SourceLocation
 
-  /// Returns the result of evaluating the condition.
+  /// Evaluate this instance's underlying condition.
+  ///
+  /// - Returns: The result of evaluating this instance's underlying condition.
+  ///
+  /// The evaluation is performed each time this function is called, and is not
+  /// cached.
   @_spi(Experimental)
-  public func evaluate() async throws -> Evaluation {
+  public func evaluate() async throws -> EvaluationResult {
     switch kind {
     case let .conditional(condition):
       try await condition()