Tightened the source code and README documentations in the library.

Sources/PlaydateKit/Sound/Effect/Classes/DelayLineTap.swift

@@ -1,12 +1,11 @@
 internal import CPlaydate
 
 extension Sound {
-    /// A tap into a delay line; produces audio and can be added to a channel
-    /// as a source. Wraps `DelayLineTap`.
+    /// A read point on a delay line, playable as a channel source. Wraps `DelayLineTap`.
     public final class DelayLineTap: Source {
         private static var api: UnsafePointer<playdate_sound_effect_delayline> { Playdate.delayLineAPI.unsafelyUnwrapped }
 
-        /// The delay line is retained so the tap stays valid.
+        /// Kept alive: the tap reads from its buffer.
         private let delayLine: DelayLine
         private var retainedDelayModulator: SignalValue?
 
@@ -19,12 +18,12 @@ extension Sound {
             DelayLineTap.api.pointee.freeTap.unsafelyUnwrapped(pointer)
         }
 
-        /// The tap's position in the delay line, in frames.
+        /// In frames, up to the delay line's length.
         public func setDelay(frames: Int) {
             DelayLineTap.api.pointee.setTapDelay.unsafelyUnwrapped(pointer, Int32(frames))
         }
 
-        /// Modulates the tap's delay.
+        /// A continuous signal speeds up or slows down playback.
         public var delayModulator: SignalValue? {
             get { SignalValue.wrap(DelayLineTap.api.pointee.getTapDelayModulator.unsafelyUnwrapped(pointer)) }
             set {
@@ -33,7 +32,7 @@ extension Sound {
             }
         }
 
-        /// For stereo delay lines: swaps the left and right channels.
+        /// Stereo delay lines only.
         public func setChannelsFlipped(_ flipped: Bool) {
             DelayLineTap.api.pointee.setTapChannelsFlipped.unsafelyUnwrapped(pointer, flipped ? 1 : 0)
         }