Add docs.

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

@@ -8,13 +8,58 @@ package org.scalajs.dom
 import scala.scalajs.js
 
 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.
+    */
   var loop: js.UndefOr[Boolean] = js.undefined
+
+  /** An optional value in seconds, where looping should begin if the loop attribute is true. The default is 0. It's
+    * sensible to set this to a value between 0 and the duration of the buffer. If loopStart is less than 0, looping
+    * will begin at 0. If loopStart is greater than the duration of the buffer, looping will begin at the end of the
+    * buffer. This attribute is converted to an exact sample frame offset within the buffer, by multiplying by the
+    * buffer's sample rate and rounding to the nearest integer value. Thus, its behavior is independent of the value of
+    * the playbackRate parameter.
+    */
   var loopStart: js.UndefOr[Double] = js.undefined
+
+  /** An optional value, in seconds, where looping should end if the loop attribute is true. The default is 0. Its value
+    * is exclusive to the content of the loop. The sample frames, comprising the loop, run from the values loopStart to
+    * loopEnd-(1/sampleRate). It's sensible to set this to a value between 0 and the duration of the buffer. If loopEnd
+    * is less than 0, looping will end at 0. If loopEnd is greater than the duration of the buffer, looping will end at
+    * the end of the buffer. This attribute is converted to an exact sample frame offset within the buffer, by
+    * multiplying by the buffer's sample rate and rounding to the nearest integer value. Thus, its behavior is
+    * independent of the value of the playbackRate parameter.
+    */
   var loopEnd: js.UndefOr[Double] = js.undefined
+
+  /** A value in cents to modulate the speed of audio stream rendering. Its nominal range is (-∞ to +∞). The default is
+    * 0.
+    */
   var detune: js.UndefOr[Double] = js.undefined
+
+  /** The speed at which to render the audio stream. Its default value is 1. This parameter is k-rate. This is a
+    * compound parameter with detune. Its nominal range is (-∞ to +∞).
+    */
   var playbackRate: js.UndefOr[Double] = js.undefined
+
+  /** Represents an integer used to determine how many channels are used when up-mixing and down-mixing connections to
+    * any inputs to the node. (See AudioNode.channelCount for more information.) Its usage and precise definition depend
+    * on the value of channelCountMode.
+    */
   var channelCount: js.UndefOr[Int] = js.undefined
+
+  /** Represents an enumerated value describing the way channels must be matched between the node's inputs and outputs.
+    * (See AudioNode.channelCountMode for more information including default values.)
+    */
   var channelCountMode: js.UndefOr[AudioNodeChannelCountMode] = js.undefined
+
+  /** Represents an enumerated value describing the meaning of the channels. This interpretation will define how audio
+    * up-mixing and down-mixing will happen. The possible values are "speakers" or "discrete". (See
+    * AudioNode.channelCountMode for more information including default values.)
+    */
   var channelInterpretation: js.UndefOr[AudioNodeChannelInterpretation] = js.undefined
 }

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

@@ -19,7 +19,9 @@ import scala.scalajs.js.annotation._
 @JSGlobal
 class AudioContext extends BaseAudioContext {
 
-  // Returns the number of seconds of processing latency incurred by the AudioContext passing the audio from the AudioDestinationNode to the aud  io subsystem.
+  /** Returns the number of seconds of processing latency incurred by the AudioContext passing the audio from the
+    * AudioDestinationNode to the audio subsystem.
+    */
   def baseLatency: Double = js.native
 
   /** Returns an estimation of the output latency of the current audio context. */
@@ -57,6 +59,7 @@ class AudioContext extends BaseAudioContext {
   /** Closes the audio context, releasing any system audio resources that it uses. */
   def close(): js.Promise[Unit] = js.native
 
-  // TODO docs
+  /** Returns a new AudioTimestamp object containing two audio timestamp values relating to the current audio context.
+    */
   def getOutputTimestamp: AudioTimestamp = js.native
 }

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

@@ -51,8 +51,6 @@ trait AudioNode extends EventTarget {
 
   /** Represents an enumerated value describing the meaning of the channels. This interpretation will define how audio
     * up-mixing and down-mixing will happen.
-    *
-    * The possible values are "speakers" or "discrete".
     */
   var channelInterpretation: AudioNodeChannelInterpretation = js.native
 

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

@@ -8,10 +8,23 @@ package org.scalajs.dom
 import scala.scalajs.js
 
 @js.native
+/** Represents an enumerated value describing the way channels must be matched between the AudioNode's inputs and
+  * outputs.
+  */
 sealed trait AudioNodeChannelCountMode extends js.Any
 
 object AudioNodeChannelCountMode {
+
+  /** The number of channels is equal to the maximum number of channels of all connections. In this case, channelCount
+    * is ignored and only up-mixing happens.
+    */
   val max: AudioNodeChannelCountMode = "max".asInstanceOf[AudioNodeChannelCountMode]
+
+  /** The number of channels is equal to the maximum number of channels of all connections, clamped to the value of
+    * channelCount.
+    */
   val `clamped-max`: AudioNodeChannelCountMode = "clamped-max".asInstanceOf[AudioNodeChannelCountMode]
+
+  /** The number of channels is defined by the value of channelCount. */
   val explicit: AudioNodeChannelCountMode = "explicit".asInstanceOf[AudioNodeChannelCountMode]
 }

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

@@ -8,9 +8,21 @@ package org.scalajs.dom
 import scala.scalajs.js
 
 @js.native
+/** Represents an enumerated value describing how input channels are mapped to output channels when the number of
+  * inputs/outputs is different. For example, this setting defines how a mono input will be up-mixed to a stereo or 5.1
+  * channel output, or how a quad channel input will be down-mixed to a stereo or mono output.
+  */
 sealed trait AudioNodeChannelInterpretation extends js.Any
 
 object AudioNodeChannelInterpretation {
+
+  /** Use set of "standard" mappings for combinations of common speaker input and outputs setups (mono, stereo, quad,
+    * 5.1). For example, with this setting a mono channel input will output to both channels of a stereo output.
+    */
   val speakers: AudioNodeChannelInterpretation = "speakers".asInstanceOf[AudioNodeChannelInterpretation]
+
+  /** Input channels are mapped to output channels in order. If there are more inputs that outputs the additional inputs
+    * are dropped; if there are fewer than the unused outputs are silent.
+    */
   val discrete: AudioNodeChannelInterpretation = "discrete".asInstanceOf[AudioNodeChannelInterpretation]
 }

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

@@ -36,8 +36,10 @@ trait AudioParam extends AudioNode {
   /** Represents the initial value of the attributes as defined by the specific AudioNode creating the AudioParam. */
   val defaultValue: Double = js.native
 
+  /** Represents the maximum possible value for the parameter's nominal (effective) range. */
   val maxValue: Double = js.native
 
+  /** Represents the minimum possible value for the parameter's nominal (effective) range. */
   val minValue: Double = js.native
 
   /** Schedules an instant change to the value of the AudioParam at a precise time, as measured against

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

@@ -8,15 +8,29 @@ package org.scalajs.dom
 
 import scala.scalajs.js
 
+/** Specifies properties for AudioParam objects.
+  *
+  * It is used to create custom AudioParams on an AudioWorkletNode. If the underlying AudioWorkletProcessor has a
+  * parameterDescriptors static getter, then the returned array of objects based on this dictionary is used internally
+  * by AudioWorkletNode constructor to populate its parameters property accordingly.
+  */
 trait AudioParamDescriptor extends js.Object {
 
   /** The string which represents the name of the [[AudioParam]]. Under this name the [[AudioParam]] will be available
     * in the parameters property of the node, and under this name the [[AudioWorkletProcessor#process]] method will
     * acquire the calculated values of this [[AudioParam]].
     */
   var name: String
+
+  /** Defaults to -3.4028235e38. */
   var minValue: js.UndefOr[Double] = js.undefined
+
+  /** Defaults to 3.4028235e38. */
   var maxValue: js.UndefOr[Double] = js.undefined
+
+  /** Represents initial value of the AudioParam. Defaults to 0. */
   var defaultValue: js.UndefOr[Double] = js.undefined
+
+  /** Represents an automation rate of this AudioParam. Defaults to "a-rate". */
   var automationRate: js.UndefOr[AudioParamAutomationRate] = js.undefined
 }