Doc review

interface/src/scripting/DesktopScriptingInterface.h

@@ -65,7 +65,7 @@ public:
      * Opens a QML window within Interface: in the Interface window in desktop mode or on the HUD surface in HMD mode. If a 
      * window of the specified name already exists, it is shown, otherwise a new window is created from the QML.
      * @function Desktop.show
-     * @param {string} url - The QML file that specifies the window content
+     * @param {string} url - The QML file that specifies the window content.
      * @param {string} name - A unique name for the window.
      * @example <caption>Open the general settings dialog.</caption>
      * Desktop.show("hifi/dialogs/GeneralPreferencesDialog.qml", "GeneralPreferencesDialog");
@@ -76,7 +76,7 @@ public:
      * Creates a new window that can be displayed either within Interface or as a separate desktop window.
      * @function Desktop.createWindow
      * @param {string} url - The QML file that specifies the window content. The QML file can use a <code>WebView</code> 
-     *     control (defined by "WebView.qml" included in the Interface install) to embed an HTML Web page (complete with  
+     *     control (defined by "WebView.qml" included in the Interface install) to embed an HTML web page (complete with  
      *     <code>EventBridge</code> object).
      * @param {InteractiveWindow.Properties} [properties] - Initial window properties.
      * @returns {InteractiveWindow} A new window object.

interface/src/scripting/PlatformInfoScriptingInterface.h

@@ -59,7 +59,7 @@ public slots:
     /**jsdoc
      * Returns the total system memory in megabytes.
      * @function PlatformInfo.getTotalSystemMemoryMB
-     * @returns {number} the total system memory in megabytes.
+     * @returns {number} The total system memory in megabytes.
      */
     int getTotalSystemMemoryMB();
 

interface/src/ui/InteractiveWindow.h

@@ -66,7 +66,7 @@ using namespace InteractiveWindowEnums;
 /**jsdoc
  * An <code>InteractiveWindow</code> can display either inside Interface or in its own window separate from the Interface 
  * window. The window content is defined by a QML file, which can optionally include a <code>WebView</code> control that embeds 
- * an HTML Web page. (The <code>WebView</code> control is defined by a "WebView.qml" file included in the Interface install.)
+ * an HTML web page. (The <code>WebView</code> control is defined by a "WebView.qml" file included in the Interface install.)
  *
  * <p>Create using {@link Desktop.createWindow}.</p>
  *
@@ -170,13 +170,13 @@ public slots:
     void sendToQml(const QVariant& message);
 
     /**jsdoc
-     * Sends a message to an embedded HTML Web page. To receive the message, the HTML page's script must connect to the 
+     * Sends a message to an embedded HTML web page. To receive the message, the HTML page's script must connect to the 
      * <code>EventBridge</code> that is automatically provided to the script:
      * <pre class="prettyprint"><code>EventBridge.scriptEventReceived.connect(function(message) {
      *     ...
      * });</code></pre>
      * @function InteractiveWindow.emitScriptEvent
-     * @param {string|object} message - The message to send to the embedded HTML Web page.
+     * @param {string|object} message - The message to send to the embedded HTML web page.
      */
     // QmlWindow content may include WebView requiring EventBridge.
     void emitScriptEvent(const QVariant& scriptMessage);
@@ -223,7 +223,7 @@ signals:
     void positionChanged();
 
     /**jsdoc
-     * Triggered when the window's' size changes.
+     * Triggered when the window's size changes.
      * @function InteractiveWindow.sizeChanged
      * @returns {Signal}
      */
@@ -270,7 +270,7 @@ signals:
     void scriptEventReceived(const QVariant& message);
 
     /**jsdoc
-     * Trigged when a message from an embedded HTML Web page is received. The HTML Web page can send a message by calling:
+     * Triggered when a message from an embedded HTML web page is received. The HTML web page can send a message by calling:
      * <pre class="prettyprint"><code>EventBridge.emitWebEvent(message);</code></pre>
      * @function InteractiveWindow.webEventReceived
      * @param {string|object} message - The message received.

libraries/material-networking/src/material-networking/TextureCache.cpp

@@ -65,7 +65,7 @@ const std::string TextureCache::KTX_DIRNAME{ "ktx_cache" };
 const std::string TextureCache::KTX_EXT { "ktx" };
 
 /**jsdoc
- * <p>The views that may be displayed on the PC display.</p>
+ * <p>The views that may be visible on the PC display.</p>
  * <table>
  *   <thead>
  *     <tr>

libraries/networking/src/AddressManager.h

@@ -245,21 +245,22 @@ public slots:
      * Takes you to the specified user's location.
      * @function location.goToUser
      * @param {string} username - The user's username.
-     * @param {boolean} [matchOrientation=true] - If <code>true</code> then go to a location just in front of the user and turn to face
+     * @param {boolean} [matchOrientation=true] - If <code>true</code> then go to a location just in front of the user and turn 
-     *     them, otherwise go to the user's exact location and orientation.
+     *     to face them, otherwise go to the user's exact location and orientation.
      */
     void goToUser(const QString& username, bool shouldMatchOrientation = true);
 
     /**jsdoc
-    * Takes you to the last address tried.  This will be the last URL tried from location.handleLookupString
+     * Takes you to the last address tried. This will be the last URL tried from <code>location.handleLookupString</code>.
-    * @function location.goToLastAddress
+     * @function location.goToLastAddress
-    */
+     */
     void goToLastAddress() { handleUrl(_lastVisitedURL, LookupTrigger::AttemptedRefresh); }
 
     /**jsdoc
-    * Checks if going back is possible.
+     * Checks if going back to the previous location is possible.
-    * @function location.canGoBack
+     * @function location.canGoBack
-    */
+     * @returns <code>true</code> if going back is possible, <code>false</code> if it isn't.
+     */
     bool canGoBack() const;
 
     /**jsdoc