update Open Source Docs from Roblox internal teams

Author: rbx-open-source-docs[bot]

content/en-us/reference/engine/classes/EditableMesh.yaml

@@ -5,38 +5,42 @@ memory_category: Instances
 summary: |
   Instance which allows for the runtime creation and manipulation of meshes.
 description: |
-  `EditableMesh` changes the applied visual mesh when linked to a
+  `Class.EditableMesh` changes the applied visual mesh when linked to a
   `Class.MeshPart`, allowing for querying and modification of the mesh both in
   Studio and in experience.
 
-  An `EditableMesh` can be created from an existing `Datatype.Content` of a
+  An `Class.EditableMesh` can be created from an existing `Datatype.Content` of a
   `Class.MeshPart` or a mesh ID using
-  `Class.AssetService:CreateEditableMeshAsync()`, or a blank `EditableMesh` can
+  `Class.AssetService:CreateEditableMeshAsync()`, or a blank `Class.EditableMesh` can
   be created with `Class.AssetService:CreateEditableMesh()`. It can then be
   displayed, modified, and its collision model updated. Not all of the steps are
-  necessary; for example, you might want to create an `EditableMesh` just to
+  necessary; for example, you might want to create an `Class.EditableMesh` just to
   raycast without ever displaying it.
 
-  An `EditableMesh` is displayed when it's linked to a new `Class.MeshPart`,
+  An `Class.EditableMesh` is displayed when it's linked to a new `Class.MeshPart`,
   through `Class.AssetService:CreateMeshPartAsync()`. You can create more
-  `Class.MeshPart` instances that reference the same `EditableMesh` content, or
+  `Class.MeshPart` instances that reference the same `Class.EditableMesh` content, or
   link to an existing `Class.MeshPart` through `Class.MeshPart:ApplyMesh()`.
 
-  Calling `Class.AssetService:CreateMeshPartAsync()` will recalculate collision
-  and fluid geometry with any edits and update the existing `Class.MeshPart`. It
-  is generally recommended to do this at the end of a conceptual edit operation.
-  `Class.MeshPart:ApplyMesh()` will update the colission and fluid geometry of
-  the target `Class.MeshPart`.
+  To recalculate collision and fluid geometry after editing, you can again call
+  `Class.AssetService:CreateMeshPartAsync()` and `Class.MeshPart:ApplyMesh()`
+  to update an existing `Class.MeshPart`. It's generally recommended to do this
+  at the end of a conceptual edit, not after individual calls to methods that
+  manipulate geometry. Visual changes to the mesh will always be immediately
+  reflected by the engine, without the need to call
+  `Class.AssetService:CreateMeshPartAsync()`.
 
-  #### Enabling EditableMesh for Published Experiences
+  ##### Enabling EditableMesh for Published Experiences
+  
   For security purposes, using `Class.EditableMesh` fails by default for published
-  experiences. To enable the use
-  of `Class.EditableMesh`, you must be 13+ age verified and ID verified. After you are
-  verified, open Studio. Select **File > Game Settings > Security** and enable the
-  **Allow Mesh & Image APIs** toggle. Remember to review the Terms of Use before
-  enabling the toggle.
+  experiences. To enable usage, `Class.EditableMesh`, you must be 13+ age verified
+  and ID verified. After you are verified, open Studio's
+  [Game Settings](../../../studio/game-settings.md), select **Security**, and
+  enable the **Allow Mesh & Image APIs** toggle. Remember to
+  review the [Terms of Use](https://en.help.roblox.com/hc/en-us/articles/115004647846-Roblox-Terms-of-Use#creators-restrictions-on-use) before enabling the toggle.
 
-  #### Permissions
+  ##### Permissions
+  
   To prevent misuse, `Class.AssetService:CreateEditableMeshAsync()` will only
   allow you to load and edit mesh assets:
 
@@ -48,22 +52,30 @@ description: |
 
   The APIs throw an error if they are used to load an asset that does
   not meet the criteria above.
+  
+  ##### Fixed-Size Meshes
 
-  #### Stable Vertex/Face IDs
+  When creating an `Class.EditableMesh` from an existing mesh asset (via 
+  `Class.AssetService:CreateEditableMeshAsync()`), the resulting editable mesh
+  is fixed-size by default. Fixed-size meshes are more efficient in terms of memory
+  but you cannot change the number of vertices, faces, or attributes. Only the values
+  of vertex attributes and positions can be edited.
 
-  Many `EditableMesh` methods take **vertex**, **normal**, **UV**, **color** and
+  ##### Stable Vertex/Face IDs
+
+  Many `Class.EditableMesh` methods take **vertex**, **normal**, **UV**, **color** and
   **face** IDs. These are represented as integers in Luau but they require some
   special handling. The main difference is that IDs are stable and they remain
   the same even if other parts of the mesh change. For example, if an
-  `EditableMesh` has five vertices `{1, 2, 3, 4, 5}` and you remove vertex `4`,
+  `Class.EditableMesh` has five vertices `{1, 2, 3, 4, 5}` and you remove vertex `4`,
   the new vertices will be `{1, 2, 3, 5}`.
 
   Note that the IDs are not guaranteed to be in order and there may be holes in
   the numbering, so when iterating through vertices or faces, you should iterate
   through the table returned by `Class.EditableMesh:GetVertices()|GetVertices()`
   or `Class.EditableMesh:GetFaces()|GetFaces()`.
 
-  #### Split Vertex Attributes
+  ##### Split Vertex Attributes
 
   A **vertex** is a corner of a face, and topologically connects faces together.
   Vertices can have several attributes: position, normal, UV coordinate, color,
@@ -120,7 +132,7 @@ description: |
   end
   ```
 
-  #### Winding
+  ##### Winding
 
   Mesh faces have a front side and a back side. When drawing meshes, only the
   front of the faces are drawn by default, although you can change this by
@@ -132,9 +144,9 @@ description: |
 
   <img src="../../../assets/engine-api/classes/EditableMesh/Winding.png" alt="Order of the vertices around the face" width="550" />
 
-  #### Limitations
+  ##### Limitations
 
-  `EditableMesh` currently has a limit of 60,000 vertices and 20,000 triangles.
+  `Class.EditableMesh` currently has a limit of 60,000 vertices and 20,000 triangles.
   Attempting to add too many vertices or triangles will cause an error.
 code_samples: []
 inherits:
@@ -308,8 +320,10 @@ methods:
     capabilities: []
     writeCapabilities: []
   - name: EditableMesh:Destroy
-    summary: ''
-    description: ''
+    summary: |
+      Destroys the mesh.
+    description: |
+      Destroys the contents of the mesh, immediately reclaiming used memory.
     code_samples: []
     parameters: []
     returns: