Cherry pick Swift 5.5 doc changes in TaskSleep.swift

Author: amartini51

stdlib/public/Concurrency/TaskSleep.swift

@@ -15,6 +15,10 @@ import Swift
 @available(SwiftStdlib 5.1, *)
 extension Task where Success == Never, Failure == Never {
   @available(*, deprecated, renamed: "Task.sleep(nanoseconds:)")
+  /// Suspends the current task for at least the given duration
+  /// in nanoseconds.
+  ///
+  /// This function doesn't block the underlying thread.
   public static func sleep(_ duration: UInt64) async {
     return await Builtin.withUnsafeContinuation { (continuation: Builtin.RawUnsafeContinuation) -> Void in
       let job = _taskCreateNullaryContinuationJob(
@@ -39,10 +43,10 @@ extension Task where Success == Never, Failure == Never {
     /// The sleep has finished.
     case finished
 
-    /// The sleep was cancelled.
+    /// The sleep was canceled.
     case cancelled
 
-    /// The sleep was cancelled before it even got started.
+    /// The sleep was canceled before it even got started.
     case cancelledBeforeStarted
 
     /// Decode sleep state from the word of storage.
@@ -100,7 +104,7 @@ extension Task where Success == Never, Failure == Never {
   }
 
   /// Called when the sleep(nanoseconds:) operation woke up without being
-  /// cancelled.
+  /// canceled.
   private static func onSleepWake(
       _ wordPtr: UnsafeMutablePointer<Builtin.Word>
   ) {
@@ -143,7 +147,7 @@ extension Task where Success == Never, Failure == Never {
     }
   }
 
-  /// Called when the sleep(nanoseconds:) operation has been cancelled before
+  /// Called when the sleep(nanoseconds:) operation has been canceled before
   /// the sleep completed.
   private static func onSleepCancel(
       _ wordPtr: UnsafeMutablePointer<Builtin.Word>
@@ -189,11 +193,13 @@ extension Task where Success == Never, Failure == Never {
     }
   }
 
-  /// Suspends the current task for _at least_ the given duration
-  /// in nanoseconds, unless the task is cancelled. If the task is cancelled,
-  /// throws \c CancellationError without waiting for the duration.
+  /// Suspends the current task for at least the given duration
+  /// in nanoseconds.
+  ///
+  /// If the task is canceled before the time ends,
+  /// this function throws `CancellationError`.
   ///
-  /// This function does _not_ block the underlying thread.
+  /// This function doesn't block the underlying thread.
   public static func sleep(nanoseconds duration: UInt64) async throws {
     // Allocate storage for the storage word.
     let wordPtr = UnsafeMutablePointer<Builtin.Word>.allocate(capacity: 1)