diff --git a/libraries/entities/src/EntityScriptingInterface.h b/libraries/entities/src/EntityScriptingInterface.h
index fb1ec56503..d1e83dccc2 100644
--- a/libraries/entities/src/EntityScriptingInterface.h
+++ b/libraries/entities/src/EntityScriptingInterface.h
@@ -1867,7 +1867,8 @@ public slots:
      * @function Entities.getMeshes
      * @param {Uuid} entityID - The ID of the <code>Model</code> or <code>PolyVox</code> entity to get the meshes of.
      * @param {Entities~getMeshesCallback} callback - The function to call upon completion.
-     * @deprecated This function is deprecated and will be removed. Use the {@link Graphics} API instead.
+     * @deprecated This function is deprecated and will be removed. It no longer works for Model entities. Use the 
+     *     {@link Graphics} API instead.
      */
      /**jsdoc
       * Called when a {@link Entities.getMeshes} call is complete.
@@ -1876,7 +1877,8 @@ public slots:
       *     <code>Model</code> or <code>PolyVox</code> entity; otherwise <code>undefined</code>. 
       * @param {boolean} success - <code>true</code> if the {@link Entities.getMeshes} call was successful, <code>false</code> 
       *     otherwise. The call may be unsuccessful if the requested entity could not be found.
-      * @deprecated This function is deprecated and will be removed. Use the {@link Graphics} API instead.
+      * @deprecated This function is deprecated and will be removed. It no longer works for Model entities. Use the 
+      *     {@link Graphics} API instead. 
       */
     // FIXME move to a renderable entity interface
     Q_INVOKABLE void getMeshes(const QUuid& entityID, QScriptValue callback);
diff --git a/libraries/shared/src/RegisteredMetaTypes.h b/libraries/shared/src/RegisteredMetaTypes.h
index 3b47bb70c6..b8c2e9b1db 100644
--- a/libraries/shared/src/RegisteredMetaTypes.h
+++ b/libraries/shared/src/RegisteredMetaTypes.h
@@ -687,7 +687,8 @@ namespace graphics {
 using MeshPointer = std::shared_ptr<graphics::Mesh>;
 
 /**jsdoc
- * A handle for a mesh in an entity, such as returned by {@link Entities.getMeshes}.
+ * A mesh, such as returned by {@link Entities.getMeshes} or {@link Model} API functions.
+ *
  * @class MeshProxy
  *
  * @hifi-interface
@@ -705,16 +706,16 @@ public:
     virtual MeshPointer getMeshPointer() const = 0;
     
     /**jsdoc
-     * Get the number of vertices in the mesh.
+     * Gets the number of vertices in the mesh.
      * @function MeshProxy#getNumVertices
      * @returns {number} Integer number of vertices in the mesh.
      */
     Q_INVOKABLE virtual int getNumVertices() const = 0;
 
     /**jsdoc
-     * Get the position of a vertex in the mesh.
+     * Gets the position of a vertex in the mesh.
      * @function MeshProxy#getPos
-     * @param {number} index - Integer index of the mesh vertex.
+     * @param {number} index - Integer index of the vertex.
      * @returns {Vec3} Local position of the vertex relative to the mesh.
      */
     Q_INVOKABLE virtual glm::vec3 getPos(int index) const = 0;