Merge pull request #1159 from swiftlang/revert-1142-main

Revert "Update outdated Suite macro documentation"

Author: grynspan

Sources/Testing/Test+Macro.swift

@@ -53,8 +53,9 @@ public typealias __XCTestCompatibleSelector = Never
 /// - Parameters:
 ///   - traits: Zero or more traits to apply to this test suite.
 ///
-/// A test suite is a type that contains one or more test functions. 
-/// Any type may be a test suite.
+/// A test suite is a type that contains one or more test functions. Any
+/// escapable type (that is, any type that is not marked `~Escapable`) may be a
+/// test suite.
 ///
 /// The use of the `@Suite` attribute is optional; types are recognized as test
 /// suites even if they do not have the `@Suite` attribute applied to them.
@@ -80,8 +81,9 @@ public macro Suite(
 ///     from the associated type's name.
 ///   - traits: Zero or more traits to apply to this test suite.
 ///
-/// A test suite is a type that contains one or more test functions.
-/// Any type may be a test suite.
+/// A test suite is a type that contains one or more test functions. Any
+/// escapable type (that is, any type that is not marked `~Escapable`) may be a
+/// test suite.
 ///
 /// The use of the `@Suite` attribute is optional; types are recognized as test
 /// suites even if they do not have the `@Suite` attribute applied to them.