chore: refine documentation.

Author: scottmarchant

README.md

@@ -48,7 +48,7 @@ function. This reduces potential issues that can arise from wait being a thread-
 
 If you've scrolled this far, you probably saw the warning. But just to make sure…
 
-> ⚠️ WARNING - This is an 🧪experimental🧪 repository and should not be adopted at large.
+> ⚠️ WARNING - This is an 🧪experimental🧪 repository and should not be adopted at large at the present time.
 
 PassiveLogic is [actively working](https://github.com/PassiveLogic/swift-web-examples/issues/1) to mainstream this into the SwiftWasm
 toolchain. But if you can't wait, here are some tips.
@@ -69,15 +69,14 @@ import Dispatch
 
 ## 2. If you really want to use DispatchAsync as a pure Swift Dispatch alternative for non-wasm targets
 
-Stop. Are you sure? If you do this, you'll need to be '
+Stop. Are you sure? If you do this, you'll need to be careful with all `import Dispatch`, `import Foundation`, and many other issues.
 
 1. Add the dependency to your package:
 
 ```swift
 let package = Package(
     name: "MyPackage",
     products: [
-        // Products define the executables and libraries a package produces, making them visible to other packages.
         .library(
             name: "MyPackage",
             targets: [
@@ -95,7 +94,7 @@ let package = Package(
         .target(
             name: "MyPackage"
             dependencies: [
-                "DispatchAsync"
+                .product(name: "DispatchAsync", package: "swift-dispatch-async", condition: .when(platforms: [.wasi])),
             ]
         ),
     ]

Sources/DispatchAsync/DispatchGroup.swift

@@ -29,8 +29,7 @@ extension DispatchAsync {
     ///
     /// The primary goal of this implementation is to enable WASM support for Dispatch.
     ///
-    /// Refer to documentation for the original [DispatchGroup](https://developer.apple.com/documentation/dispatch/dispatchgroup)
-    /// for more details,
+    /// For more details, refer to the original [DispatchGroup](https://developer.apple.com/documentation/dispatch/dispatchgroup)
     #if !os(WASI)
     @_spi(DispatchAsync)
     #endif

Sources/DispatchAsync/DispatchQueue.swift

@@ -27,8 +27,7 @@ extension DispatchAsync {
     ///
     /// The primary goal of this implementation is to enable WASM support for Dispatch.
     ///
-    /// Refer to documentation for the original [DispatchQueue](https://developer.apple.com/documentation/dispatch/dispatchqueue)
-    /// for more details,
+    /// For more details, refer to the original [DispatchQueue](https://developer.apple.com/documentation/dispatch/dispatchqueue)
     #if !os(WASI)
     @_spi(DispatchAsync)
     #endif

Sources/DispatchAsync/DispatchSemaphore.swift

@@ -33,7 +33,7 @@ extension DispatchAsync {
     /// For safety, this class is only defined for WASI platforms.
     ///
     /// Most wasm executables are single-threaded. Calling DispatchSemaphore.wait
-    /// when it's value is 0 or lower would be likely cause a frozen main thread,
+    /// when its value is 0 or lower would be likely cause a frozen main thread,
     /// because that would block the calling thread. And there is usually
     /// only one thread in the wasm world (right now).
     ///

Sources/DispatchAsync/DispatchTime.swift

@@ -46,7 +46,7 @@ extension DispatchAsync {
         private static let uptimeBeginning: ContinuousClock.Instant = ContinuousClock.Instant.now
 
         /// See documentation for ``uptimeBeginning``. We intentionally
-        /// use this to guarantee a capture of `now` to uptimeBeginnin BEFORE
+        /// use this to guarantee a capture of `now` to `uptimeBeginning` BEFORE
         /// any DispatchTime instances are initialized.
         private let durationSinceUptime = uptimeBeginning.duration(to: ContinuousClock.Instant.now)