Doc improvements.

dom/src/main/scala/org/scalajs/dom/AudioBufferSourceNodeOptions.scala

@@ -12,8 +12,8 @@ trait AudioBufferSourceNodeOptions extends js.Object {
   /** An instance of [[AudioBuffer]] to be played. */
   var buffer: js.UndefOr[AudioBuffer] = js.undefined
 
-  /** Indicates whether the audio should play in a loop. The default is false. If the loop is dynamically
-    * modified during playback, the new value will take effect on the next processing block of audio.
+  /** Indicates whether the audio should play in a loop. The default is false. If the loop is dynamically modified
+    * during playback, the new value will take effect on the next processing block of audio.
     */
   var loop: js.UndefOr[Boolean] = js.undefined
 

dom/src/main/scala/org/scalajs/dom/AudioScheduledSourceNode.scala

@@ -8,13 +8,10 @@ package org.scalajs.dom
 import scala.scalajs.js
 
 @js.native
-/** A parent interface for several types of audio source node
-  * interfaces which share the ability to be started and stopped,
-  * optionally at specified times. Unless stated otherwise, nodes
-  * based upon AudioScheduledSourceNode output silence when not
-  * playing (that is, before start() is called and after stop() is
-  * called). Silence is represented, as always, by a stream of samples
-  * with the value zero (0).
+/** A parent interface for several types of audio source node interfaces which share the ability to be started and
+  * stopped, optionally at specified times. Unless stated otherwise, nodes based upon AudioScheduledSourceNode output
+  * silence when not playing (that is, before start() is called and after stop() is called). Silence is represented, as
+  * always, by a stream of samples with the value zero (0).
   */
 trait AudioScheduledSourceNode extends AudioNode {
 

dom/src/main/scala/org/scalajs/dom/AudioTimestamp.scala

@@ -8,6 +8,16 @@ package org.scalajs.dom
 import scala.scalajs.js
 
 trait AudioTimestamp extends js.Object {
+
+  /** The time of the sample frame currently being rendered by the audio output device (i.e., output audio stream
+    * position), in the same units and origin as the context's AudioContext.currentTime. Basically, this is the time
+    * after the audio context was first created.
+    */
   var contextTime: Double
+
+  /** An estimation of the moment when the sample frame corresponding to the stored contextTime value was rendered by
+    * the audio output device, in the same units and origin as performance.now(). This is the time after the document
+    * containing the audio context was first rendered.
+    */
   var performanceTime: Double
 }

dom/src/main/scala/org/scalajs/dom/AudioWorklet.scala

@@ -9,6 +9,14 @@ package org.scalajs.dom
 import scala.scalajs.js
 import scala.scalajs.js.annotation._
 
+/** Used to supply custom audio processing scripts that execute in a separate thread to provide very low latency audio
+  * processing.
+  *
+  * The worklet's code is run in the AudioWorkletGlobalScope global execution context, using a separate Web Audio thread
+  * which is shared by the worklet and other audio nodes.
+  *
+  * Access the audio context's instance of AudioWorklet through the BaseAudioContext.audioWorklet property.
+  */
 @JSGlobal
 @js.native
 abstract class AudioWorklet extends Worklet {}

dom/src/main/scala/org/scalajs/dom/AudioWorkletGlobalScope.scala

@@ -9,15 +9,34 @@ package org.scalajs.dom
 import scala.scalajs.js
 import scala.scalajs.js.annotation._
 
+/** Represents a global execution context for user-supplied code, which defines custom AudioWorkletProcessor-derived
+  * classes.
+  *
+  * Each BaseAudioContext has a single AudioWorklet available under the audioWorklet property, which runs its code in a
+  * single AudioWorkletGlobalScope.
+  *
+  * As the global execution context is shared across the current BaseAudioContext, it's possible to define any other
+  * variables and perform any actions allowed in worklets — apart from defining AudioWorkletProcessor derived classes.
+  */
 @js.native
 trait AudioWorkletGlobalScope extends WorkletGlobalScope {
 
+  /** Returns an integer that represents the ever-increasing current sample-frame of the audio block being processed. It
+    * is incremented by 128 (the size of a render quantum) after the processing of each audio block.
+    */
   def currentFrame: Int
 
+  /** Returns a double that represents the ever-increasing context time of the audio block being processed. It is equal
+    * to the currentTime property of the BaseAudioContext the worklet belongs to.
+    */
   def currentTime: Double
 
+  /** Returns a float that represents the sample rate of the associated BaseAudioContext. */
   def sampleRate: Float
 
+  /** Registers a class derived from the AudioWorkletProcessor interface. The class can then be used by creating an
+    * AudioWorkletNode, providing its registered name.
+    */
   def registerProcessor(name: String, processorCtor: js.Dynamic): Unit = js.native
 }