Tightened the source code and README documentations in the library.

Sources/PlaydateKit/Network/Network.swift

@@ -3,29 +3,28 @@ internal import CPlaydate
 /// The cached `playdate->network` C API table.
 private var networkAPI: UnsafePointer<playdate_network> { Playdate.networkAPI.unsafelyUnwrapped }
 
-/// The network API: wifi status, HTTP, and TCP.
+/// Wifi control, HTTP, and TCP. Throwing APIs here throw `Network.NetError`.
 public enum Network {}
 
 extension Network {
-    /// Throws unless `error` is `NET_OK`.
     static func check(_ error: PDNetErr) throws(NetError) {
         if error != NET_OK {
             throw NetError(error)
         }
     }
 
-    /// Converts an error code to `nil` (OK) or a `NetError`.
     static func optionalError(_ error: PDNetErr) -> NetError? {
         error == NET_OK ? nil : NetError(error)
     }
 
-    /// The device's current wifi status.
+    /// The current wifi status; `.notConnected` for unrecognized C values.
     public static var status: WifiStatus {
         WifiStatus(rawValue: UInt32(networkAPI.pointee.getStatus.unsafelyUnwrapped().rawValue)) ?? .notConnected
     }
 
-    /// Turns the wifi radio on or off. The completion receives `nil` on
-    /// success. Completions of overlapping calls are delivered in call order.
+    /// `true` connects to the configured access point; `false` turns wifi off before
+    /// the 30 s idle timeout. `completion` (documented for `true` only) gets `nil`
+    /// on success; completions fire in call order.
     public static func setEnabled(_ enabled: Bool, completion: ((NetError?) -> Void)? = nil) {
         if let completion {
             setEnabledCompletions.append(completion)
@@ -41,7 +40,8 @@ extension Network {
 
     nonisolated(unsafe) private static var setEnabledCompletions: [(NetError?) -> Void] = []
 
-    /// Requests permission to connect to `server`. Shared by HTTP and TCP.
+    /// Shared by HTTP and TCP. Retains `completion` until the C callback, which
+    /// fires only for `.ask`.
     static func requestAccess(
         rawRequest: (UnsafePointer<CChar>?, Int32, Bool, UnsafePointer<CChar>?,
                      (@convention(c) (Bool, UnsafeMutableRawPointer?) -> Void)?,
@@ -67,7 +67,7 @@ extension Network {
             }
         }
         if reply != kAccessAsk {
-            // The callback will not be invoked; balance the retain.
+            // Only `kAccessAsk` invokes the callback; balance the retain now.
             box.release()
         }
         return AccessReply(rawValue: UInt32(reply.rawValue)) ?? .ask