Merge pull request #36446 from wonhee009/Result

Author: CodaFi

stdlib/public/core/Result.swift

@@ -112,8 +112,8 @@ public enum Result<Success, Failure: Error> {
   ///
   /// - Parameter transform: A closure that takes the success value of the
   ///   instance.
-  /// - Returns: A `Result` instance with the result of evaluating `transform`
-  ///   as the new failure value if this instance represents a failure.
+  /// - Returns: A `Result` instance, either from the closure or the previous
+  ///   `.failure`.
   @inlinable
   public func flatMap<NewSuccess>(
     _ transform: (Success) -> Result<NewSuccess, Failure>