update Open Source Docs from Roblox internal teams

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

.github/workflows/content-checks.yml

@@ -50,7 +50,7 @@ jobs:
       - name: Set up Node.js
         uses: actions/setup-node@v3
         with:
-          node-version: 18.17.1
+          node-version: 22.10.0
 
       - name: Install Node.js dependencies
         shell: bash

.nvmrc

@@ -1 +1 @@
-v18.17.1
+v22.10.0

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

@@ -119,11 +119,11 @@ properties:
     type: AudioSimulationFidelity
     tags: []
     deprecation_message: ''
-    security: 
+    security:
       read: None
       write: None
     thread_safety: ReadSafe
-    category: Emission
+    category: Simulation
     serialization:
       can_load: true
       can_save: true

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

@@ -113,7 +113,7 @@ properties:
 
       `Class.AudioListener|AudioListeners` and
       `Class.AudioEmitter|AudioEmitters` which disagree on the necessary level
-      of detail will use the less-detailed option. 
+      of detail will use the less-detailed option.
     code_samples: []
     type: AudioSimulationFidelity
     tags: []
@@ -122,7 +122,7 @@ properties:
       read: None
       write: None
     thread_safety: ReadSafe
-    category: Listening
+    category: Simulation
     serialization:
       can_load: true
       can_save: true

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

@@ -264,7 +264,8 @@ properties:
       with audio simulation, similar to `Class.BasePart.CastShadow|CastShadow`
       for lighting.
 
-       When disabled, audio passes through the part; it is not occluded or reflected.
+      When disabled, audio passes through the part; it is not occluded or
+      reflected.
     code_samples: []
     type: boolean
     tags: []

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

@@ -16,11 +16,11 @@ description: |
   necessary; for example, you might want to create an `EditableMesh` just to
   raycast without ever displaying it.
 
-  An `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` `Datatype.Content`, or link to an existing
-  `Class.MeshPart` through `Class.MeshPart:ApplyMesh()`.
+  An `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`
+  `Datatype.Content`, or link to an existing `Class.MeshPart` through
+  `Class.MeshPart:ApplyMesh()`.
 
   To recalculate collision and fluid geometry after editing, you can again call
   `Class.AssetService:CreateMeshPartAsync()` and `Class.MeshPart:ApplyMesh()` to
@@ -34,11 +34,11 @@ description: |
 
   For security purposes, using `EditableMesh` fails by default for published
   experiences. To enable usage, `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)
+  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
@@ -148,9 +148,8 @@ description: |
 
   ##### FACS Poses
 
-  Animatable heads use the Facial Action Coding System (FACS). See the [FACS
-  poses
-  reference](../../../art/characters/facial-animation/facs-poses-reference.md)
+  Animatable heads use the Facial Action Coding System (FACS). See the
+  [FACS poses reference](../../../art/characters/facial-animation/facs-poses-reference.md)
   for helpful information when using
   `Class.EditableMesh:GetFacsPoses()|GetFacsPoses()` and similar methods.
 
@@ -163,8 +162,7 @@ description: |
   These FACS poses are blended together during animation. Sometimes, the
   blending of the base poses produces poor results. In those cases, you can
   override the blending of specific combinations of base poses with a
-  [corrective
-  pose](../../../art/characters/facial-animation/create-basic-heads.md#combination-poses)
+  [corrective pose](../../../art/characters/facial-animation/create-basic-heads.md#combination-poses)
   that is more pleasing. A corrective pose is specified by 2 or 3
   `Enum.FacsActionUnit` values. Like a base FACS pose, for a corrective pose,
   virtual bones can each have a `Datatype.CFrame` that transforms the bones'
@@ -235,11 +233,13 @@ methods:
         summary: |
           Options table containing bone parameters:
 
-          - `Name` — A string that specifies the bone name. Note that
-          all bone names in a mesh must be unique.
-          - `ParentId` — Optional bone ID of the new bone's parent. 
-          - `CFrame` — Initial `Datatype.CFrame` of the bone in the bind pose of the mesh, in the mesh's local space.
-          - `Virtual` — Boolean that specifies whether this bone is virtual. Virtual bones can only be bound to a `Class.FaceControls` instance.
+          - `Name` — A string that specifies the bone name. Note that all bone
+            names in a mesh must be unique.
+          - `ParentId` — Optional bone ID of the new bone's parent.
+          - `CFrame` — Initial `Datatype.CFrame` of the bone in the bind pose of
+            the mesh, in the mesh's local space.
+          - `Virtual` — Boolean that specifies whether this bone is virtual.
+            Virtual bones can only be bound to a `Class.FaceControls` instance.
     returns:
       - type: int64
         summary: |
@@ -543,10 +543,11 @@ methods:
     writeCapabilities: []
   - name: EditableMesh:GetBoneCFrame
     summary: |
-      Returns the initial `Datatype.CFrame` of the bone in the bind pose of the mesh.
+      Returns the initial `Datatype.CFrame` of the bone in the bind pose of the
+      mesh.
     description: |
-      Returns the initial `Datatype.CFrame` of the bone in the bind pose of the mesh, 
-      in the mesh's local space.
+      Returns the initial `Datatype.CFrame` of the bone in the bind pose of the
+      mesh, in the mesh's local space.
     code_samples: []
     parameters:
       - name: boneId
@@ -934,11 +935,13 @@ methods:
         type: Array
         default: ''
         summary: |
-          Array or 2 or 3 `Enum.FacsActionUnit` values that specify a corrective pose.
+          Array or 2 or 3 `Enum.FacsActionUnit` values that specify a corrective
+          pose.
     returns:
       - type: Tuple
         summary: |
-          Array of bone IDs and corresponding array of bone `Datatype.CFrame|CFrames`.
+          Array of bone IDs and corresponding array of bone
+          `Datatype.CFrame|CFrames`.
     tags: []
     deprecation_message: ''
     security: None
@@ -949,13 +952,15 @@ methods:
     summary: |
       Returns all FACS corrective poses that are in use.
     description: |
-      Returns all FACS corrective poses that are in use. Each corrective pose is specified by 2 or 3 `Enum.FacsActionUnit` values.
+      Returns all FACS corrective poses that are in use. Each corrective pose is
+      specified by 2 or 3 `Enum.FacsActionUnit` values.
     code_samples: []
     parameters: []
     returns:
       - type: Array
         summary: |
-          Array of corrective poses. Each corrective pose is specified by a small array of 2 or 3 `Enum.FacsActionUnit` values.
+          Array of corrective poses. Each corrective pose is specified by a
+          small array of 2 or 3 `Enum.FacsActionUnit` values.
     tags: []
     deprecation_message: ''
     security: None
@@ -999,7 +1004,8 @@ methods:
     returns:
       - type: Array
         summary: |
-          Array of `Enum.FacsActionUnit`, one for each FACS action unit that has a pose defined.
+          Array of `Enum.FacsActionUnit`, one for each FACS action unit that has
+          a pose defined.
     tags: []
     deprecation_message: ''
     security: None
@@ -1125,9 +1131,11 @@ methods:
     writeCapabilities: []
   - name: EditableMesh:GetVertexBoneWeights
     summary: |
-      Returns skinning blend weights for each bone that is associated with the vertex.
+      Returns skinning blend weights for each bone that is associated with the
+      vertex.
     description: |
-      Returns skinning blend weights for each bone that is associated with the vertex.
+      Returns skinning blend weights for each bone that is associated with the
+      vertex.
     code_samples: []
     parameters:
       - name: vertexId
@@ -1138,7 +1146,8 @@ methods:
     returns:
       - type: Array
         summary: |
-          Skinning blend weights for each bone that is associated with the vertex.
+          Skinning blend weights for each bone that is associated with the
+          vertex.
     tags: []
     deprecation_message: ''
     security: None
@@ -1574,7 +1583,8 @@ methods:
     summary: |
       Set the initial `Datatype.CFrame` for a bone in the mesh's bind pose.
     description: |
-      Set the initial `Datatype.CFrame` for a bone in the mesh's bind pose, in the mesh's local space.
+      Set the initial `Datatype.CFrame` for a bone in the mesh's bind pose, in
+      the mesh's local space.
     code_samples: []
     parameters:
       - name: boneId
@@ -1586,7 +1596,8 @@ methods:
         type: CFrame
         default: ''
         summary: |
-          Initial `Datatype.CFrame` for the bone in the mesh's bind pose, in the mesh's local space.
+          Initial `Datatype.CFrame` for the bone in the mesh's bind pose, in the
+          mesh's local space.
     returns:
       - type: ()
         summary: ''
@@ -1838,9 +1849,11 @@ methods:
     writeCapabilities: []
   - name: EditableMesh:SetFacsBonePose
     summary: |
-      Set `Datatype.CFrame` for an individual bone in a specific FACS action unit.
+      Set `Datatype.CFrame` for an individual bone in a specific FACS action
+      unit.
     description: |
-      Set `Datatype.CFrame` for an individual bone in a specific FACS action unit.
+      Set `Datatype.CFrame` for an individual bone in a specific FACS action
+      unit.
     code_samples: []
     parameters:
       - name: action
@@ -1881,7 +1894,8 @@ methods:
         type: Array
         default: ''
         summary: |
-          Array or 2 or 3 `Enum.FacsActionUnit` values to apply as a corrective pose.
+          Array or 2 or 3 `Enum.FacsActionUnit` values to apply as a corrective
+          pose.
       - name: boneIds
         type: Array
         default: ''

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

@@ -77,9 +77,9 @@ properties:
       `Class.TextChatMessage`.
     description: |
       A general purpose field for storing miscellaneous data about the
-      `TextChatMessage`. The second argument of
-      `Class.TextChannel:SendAsync()` and
-      `Class.TextChannel:DisplaySystemMessage()` is used to populate this field.
+      `TextChatMessage`. The second argument of `Class.TextChannel:SendAsync()`
+      and `Class.TextChannel:DisplaySystemMessage()` is used to populate this
+      field.
 
       Use this field to apply additional formatting for special messages within
       `Class.TextChatService.OnIncomingMessage` and
@@ -111,7 +111,8 @@ properties:
       end
       ```
 
-      As follows is a reference of the default system messages emitted by the chat system:
+      As follows is a reference of the default system messages emitted by the
+      chat system:
 
       <table size="small">
       <thead>

content/en-us/reference/engine/datatypes/PhysicalProperties.yaml

@@ -113,7 +113,7 @@ properties:
       `Class.AudioEmitter|AudioEmitters`. When using acoustic simulation,
       surfaces with higher absorption will result in less reverb than surfaces
       with lower absorption.
-      
+
       Note that this does not affect the degree to which audio transmits
       **through** surfaces; for that, see
       `Datatype.PhysicalProperties.Density|Density`.
@@ -129,7 +129,8 @@ properties:
       part is, the more force it takes to accelerate it. Acceptable range is
       `0.01` to `100.0` and values outside this range will be clamped.
 
-      When using acoustic simulation, parts with higher density will muffle occluded `Class.AudioEmitter|AudioEmitters` more.
+      When using acoustic simulation, parts with higher density will muffle
+      occluded `Class.AudioEmitter|AudioEmitters` more.
     code_samples: []
     tags: []
     deprecation_message: ''

content/en-us/reference/engine/enums/AudioSimulationFidelity.yaml

@@ -11,17 +11,17 @@ code_samples:
 tags: []
 deprecation_message: ''
 items:
-  - name: Automatic
-    summary: |
-      The audio engine simulates transmission, diffraction, and reflections at a
-      level of detail suitable to most devices.
-    value: 0
-    tags: []
-    deprecation_message: ''
   - name: None
     summary: |
       No acoustic simulation occurs; only direction and distance are taken into
       account.
     value: 0
     tags: []
     deprecation_message: ''
+  - name: Automatic
+    summary: |
+      The audio engine simulates transmission, diffraction, and reflections at a
+      level of detail suitable to most devices.
+    value: 1
+    tags: []
+    deprecation_message: ''

content/en-us/reference/engine/libraries/task.yaml

@@ -1,7 +1,8 @@
 name: task
 type: library
 summary: |
-  Allows for functions and threads to be coordinated with the engine's scheduler.
+  Allows for functions and threads to be coordinated with the engine's
+  scheduler.
 description: |
   The **task** library allows for functions and threads to be scheduled with the
   engine's scheduler.
@@ -27,8 +28,8 @@ functions:
       then the spawned function or thread is resumed in the current serial
       execution phase. If the calling script is currently running in a parallel
       execution phase, then the spawned function or thread is resumed in the
-      current parallel execution phase. For more information, see [Parallel
-      Luau](../../../scripting/multithreading.md).
+      current parallel execution phase. For more information, see
+      [Parallel Luau](../../../scripting/multithreading.md).
     parameters:
       - name: functionOrThread
         type: function | thread
@@ -63,8 +64,8 @@ functions:
       then the deferred function or thread is resumed in a serial execution
       phase. If the calling script is currently running in a parallel execution
       phase, then the deferred function or thread is resumed in a parallel
-      execution phase. For more information, see [Parallel
-      Luau](../../../scripting/multithreading.md).
+      execution phase. For more information, see
+      [Parallel Luau](../../../scripting/multithreading.md).
     parameters:
       - name: functionOrThread
         type: function | thread
@@ -107,8 +108,8 @@ functions:
       then the delayed function or thread is resumed in a serial execution
       phase. If the calling script is currently running in a parallel execution
       phase, then the delayed function or thread is resumed in a parallel
-      execution phase. For more information, see [Parallel
-      Luau](../../../scripting/multithreading.md).
+      execution phase. For more information, see
+      [Parallel Luau](../../../scripting/multithreading.md).
     parameters:
       - name: duration
         type: number
@@ -148,8 +149,8 @@ functions:
       `desynchronize()` as long as the instantiation of the module calling it
       was required by a script that is a descendant of an `Class.Actor`.
 
-      For more information, see [Parallel
-      Luau](../../../scripting/multithreading.md).
+      For more information, see
+      [Parallel Luau](../../../scripting/multithreading.md).
     parameters:
     returns:
       - type: ()
@@ -172,8 +173,8 @@ functions:
       `synchronize()` as long as the instantiation of the module calling it was
       required by a script that is a descendant of an `Class.Actor`.
 
-      For more information, see [Parallel
-      Luau](../../../scripting/multithreading.md).
+      For more information, see
+      [Parallel Luau](../../../scripting/multithreading.md).
     parameters:
     returns:
       - type: ()