Updates per doc review

libraries/audio/src/Sound.h

@@ -124,7 +124,7 @@ typedef QSharedPointer<Sound> SharedSoundPointer;
  * An audio resource, created by {@link SoundCache.getSound}, to be played back using {@link Audio.playSound}.
  * <p>Supported formats:</p>
  * <ul>
- *   <li>WAV: 16-bit uncompressed WAV at any sample rate, with 1 (mono), 2(stereo), or 4 (ambisonic) channels.</li>
+ *   <li>WAV: 16-bit uncompressed WAV at any sample rate, with 1 (mono), 2 (stereo), or 4 (ambisonic) channels.</li>
  *   <li>MP3: Mono or stereo, at any sample rate.</li>
  *   <li>RAW: 48khz 16-bit mono or stereo. File name must include <code>".stereo"</code> to be interpreted as stereo.</li>
  * </ul>

libraries/image/src/image/Image.h

@@ -26,7 +26,7 @@ namespace image {
 namespace TextureUsage {
 
 /**jsdoc
- * <p>Signifies what type of texture a texture is.</p>
+ * <p>Describes the type of texture.</p>
  * <p>See also: {@link Material} and 
  * {@link https://docs.highfidelity.com/create/3d-models/pbr-materials-guide.html|PBR Materials Guide}.</p>
  * <table>
@@ -39,14 +39,14 @@ namespace TextureUsage {
  *     <tr><td><code>2</code></td><td>Albedo</td><td>Color for PBR.</td></tr>
  *     <tr><td><code>3</code></td><td>Normal</td><td>Normal map.</td></tr>
  *     <tr><td><code>4</code></td><td>Bump</td><td>Bump map.</td></tr>
- *     <tr><td><code>5</code></td><td>Specular / Metallic</td><td>Metallic or not.</td></tr>
- *     <tr><td><code>6</code></td><td>Roughness</td><td>Rough / matte.</td></tr>
- *     <tr><td><code>7</code></td><td>Gloss</td><td>Gloss / shine.</td></tr>
+ *     <tr><td><code>5</code></td><td>Specular or metallic</td><td>Metallic or not.</td></tr>
+ *     <tr><td><code>6</code></td><td>Roughness</td><td>Rough or matte.</td></tr>
+ *     <tr><td><code>7</code></td><td>Gloss</td><td>Gloss or shine.</td></tr>
  *     <tr><td><code>8</code></td><td>Emissive</td><td>The amount of light reflected.</td></tr>
  *     <tr><td><code>9</code></td><td>Cube</td><td>Cubic image for sky boxes.</td></tr>
- *     <tr><td><code>10</code></td><td>Occlusion / Scattering</td><td>How objects / human skin interact with light.</td></tr>
+ *     <tr><td><code>10</code></td><td>Occlusion or scattering</td><td>How objects or human skin interact with light.</td></tr>
  *     <tr><td><code>11</code></td><td>Lightmap</td><td>Light map.</td></tr>
- *     <tr><td><code>12</code></td><td>Unused</td><td>Texture is not used.</td></tr>
+ *     <tr><td><code>12</code></td><td>Unused</td><td>Texture is not currently used.</td></tr>
  *   </tbody>
  * </table>
  * @typedef {number} TextureCache.TextureType

libraries/material-networking/src/material-networking/TextureCacheScriptingInterface.h

@@ -50,6 +50,7 @@ public:
     /**jsdoc
      * Prefetches a texture resource of specific type.
      * @function TextureCache.prefetch
+     * @variation 0
      * @param {string} url - The URL of the texture to prefetch.
      * @param {TextureCache.TextureType} type - The type of the texture.
      * @param {number} [maxNumPixels=67108864] - The maximum number of pixels to use for the image. If the texture has more 

libraries/networking/src/ResourceCache.h

@@ -116,9 +116,9 @@ public:
      * @typedef {object} Resource.State
      * @property {number} QUEUED - The resource is queued up, waiting to be loaded.
      * @property {number} LOADING - The resource is downloading.
-     * @property {number} LOADED - The resource has finished downloaded but is not complete.
+     * @property {number} LOADED - The resource has finished downloading but is not complete.
      * @property {number} FINISHED - The resource has completely finished loading and is ready.
-     * @property {number} FAILED - Downloading the resource has failed.
+     * @property {number} FAILED - The resource has failed to download.
      */
     enum State {
         QUEUED,
@@ -325,7 +325,7 @@ public:
      * @function ResourceCache.getResourceList
      * @returns {string[]} The URLs of all resources in the cache.
      * @example <caption>Report cached resources.</caption>
-     * // Replace AnimationCache with ModelCache, SoundCache, or TextureCache as wanted.
+     * // Replace AnimationCache with ModelCache, SoundCache, or TextureCache as appropriate.
      *
      * var cachedResources = AnimationCache.getResourceList();
      * print("Cached resources: " + JSON.stringify(cachedResources));

libraries/script-engine/src/ScriptEngine.cpp

@@ -589,7 +589,7 @@ static void scriptableResourceFromScriptValue(const QScriptValue& value, Scripta
  * @hifi-server-entity
  * @hifi-assignment-client
  *
- * @property {Resource.State} State - The possible loading states of a resource. <em>Read-inly.</em>
+ * @property {Resource.State} State - The possible loading states of a resource. <em>Read-only.</em>
  */
 static QScriptValue createScriptableResourcePrototype(ScriptEnginePointer engine) {
     auto prototype = engine->newObject();