update Open Source Docs from Roblox internal teams

rbx-open-source-docs[bot] · rbx-open-source-docs[bot] · commit e836a98a2bfc · 2025-03-26T20:27:31.000Z
diff --git a/content/common/navigation/cloud/reference.yaml b/content/common/navigation/cloud/reference.yaml
@@ -224,12 +224,6 @@ navigation:
             path: /cloud/legacy/avatar/v1
   - title: Localization
     section:
-      - title: Economy
-        type: cloudlegacy
-        ignoreTranslation: true
-        versions:
-          - name: v1
-            path: /cloud/legacy/economy/v1
       - title: Game internationalization v2
         type: cloudlegacy
         ignoreTranslation: true
@@ -276,24 +270,24 @@ navigation:
             path: /cloud/legacy/clientsettings/v1
   - title: Thumbnails
     section:
-      - title: Thumbnails
+      - title: Metrics
         type: cloudlegacy
         ignoreTranslation: true
         versions:
           - name: v1
-            path: /cloud/legacy/thumbnails/v1
-      - title: Thumbnails resizer
+            path: /cloud/legacy/metrics/v1
+      - title: Thumbnails
         type: cloudlegacy
         ignoreTranslation: true
         versions:
           - name: v1
-            path: /cloud/legacy/thumbnailsresizer/v1
-      - title: Metrics
+            path: /cloud/legacy/thumbnails/v1
+      - title: Thumbnails resizer
         type: cloudlegacy
         ignoreTranslation: true
         versions:
           - name: v1
-            path: /cloud/legacy/metrics/v1
+            path: /cloud/legacy/thumbnailsresizer/v1
   - title: Universes
     section:
       - title: Badges
@@ -358,6 +352,12 @@ navigation:
         versions:
           - name: v1
             path: /cloud/legacy/contacts/v1
+      - title: Economy
+        type: cloudlegacy
+        ignoreTranslation: true
+        versions:
+          - name: v1
+            path: /cloud/legacy/economy/v1
       - title: Followings v2
         type: cloudlegacy
         ignoreTranslation: true
@@ -400,30 +400,30 @@ navigation:
         versions:
           - name: v1
             path: /cloud/legacy/inventory/v1
-      - title: Presence
+      - title: Premium features
         type: cloudlegacy
         ignoreTranslation: true
         versions:
           - name: v1
-            path: /cloud/legacy/presence/v1
-      - title: Users
+            path: /cloud/legacy/premiumfeatures/v1
+      - title: Presence
         type: cloudlegacy
         ignoreTranslation: true
         versions:
           - name: v1
-            path: /cloud/legacy/users/v1
-      - title: Premium features
+            path: /cloud/legacy/presence/v1
+      - title: Trades
         type: cloudlegacy
         ignoreTranslation: true
         versions:
           - name: v1
-            path: /cloud/legacy/premiumfeatures/v1
-      - title: Trades
+            path: /cloud/legacy/trades/v1
+      - title: Users
         type: cloudlegacy
         ignoreTranslation: true
         versions:
           - name: v1
-            path: /cloud/legacy/trades/v1
+            path: /cloud/legacy/users/v1
   - title: Ad configuration
     type: cloudlegacy
     ignoreTranslation: true
diff --git a/content/common/navigation/engine/reference.yaml b/content/common/navigation/engine/reference.yaml
@@ -5552,7 +5552,7 @@ navigation:
     path: /reference/engine/globals
     source: /reference/engine/globals.md
     section:
-      - title: Luau Globals
+      - title: Lua Globals
         path: /reference/engine/globals/LuaGlobals
         type: engineapi
         source: /reference/engine/globals/LuaGlobals.yaml
diff --git a/content/en-us/art/accessories/body-scale.md b/content/en-us/art/accessories/body-scale.md
@@ -36,7 +36,7 @@ See the [accessory apecifications](../../art/accessories/specifications.md#body-
 
 Roblox represents body scale in the engine by an `AvatarPartScaleType` `Class.StringValue` object within each avatar character part and associated accessory. In most cases, asset creators do not need to directly access or modify this value object since tools, such as the [Accessory Fitting Tool](../accessories/accessory-fitting-tool.md), automatically generate the appropriate value object on accessory creation.
 
-In cases where you may need to identify the current body scale of a body part or accessory, the following table defines the `AvatarPartScaleType` value for each type of body size.
+In cases where you may need to identify the current body scale of a body part or accessory, the following table defines the `AvatarPartScaleType` value for each type of body size. When importing your model, use the 3D Importer's [Rig Scale](../modeling/3d-importer.md#rig-general) to automatically apply a scale to your icustom asset.
 
 <table>
 <thead>
diff --git a/content/en-us/art/characters/specifications.md b/content/en-us/art/characters/specifications.md
@@ -28,7 +28,7 @@ Avatar character models are made up of 15 separate mesh objects and require addi
 
 ### Body scale
 
-Roblox supports 3 standards of body scales: **Normal**, **Slender**, and **Classic**. These standards allow developers to create experiences and spaces with consistent body sizes for standardizing movement and interaction. While the minimum sizes for each body scale is the same, each body scale has a unique maximum total body size, as well as a range for each body asset.
+Roblox supports 3 standards of body scales: **Normal**, **Slender**, and **Classic**. These standards allow developers to create experiences and spaces with consistent body sizes for standardizing movement and interaction. You can select a body scale on import using [Rig Scale options](../modeling/3d-importer.md#rig-general), or modify the [body scale manually](../../art/accessories/body-scale.md). Body scale persists when the asset is [uploaded to the Marketplace](../../marketplace/publish-to-marketplace.md#upload-an-asset).
 
 <center>
 <figure>
diff --git a/content/en-us/art/modeling/3d-importer.md b/content/en-us/art/modeling/3d-importer.md
@@ -108,7 +108,7 @@ The 3D Importer provides the following settings for all meshes:
 
 #### Rig general
 
-The 3D Importer provides the following settings for meshes with rigging data:
+The 3D Importer provides the following settings for meshes with rigging data, typically character bodies or clothing accessories:
 
 <table>
 <thead>
@@ -128,7 +128,7 @@ The 3D Importer provides the following settings for meshes with rigging data:
   </tr>
   <tr>
     <td>Rig Scale</td>
-    <td>If Rig Type is set to R15, the importer provides further options to specify [body type scaling](../../art/characters/specifications.md#body-scale). The options are:<br />- **Default**<br />- **Rthro**<br />- **Rthro Narrow**</td>
+    <td>If Rig Type is set to R15, the importer provides additional options to specify [body type scaling](../../art/characters/specifications.md#body-scale). The options are:<br />- **Default**<br />- **Rthro**<br />- **Rthro Narrow**</td>
   </tr>
 </tbody>
 </table>
diff --git a/content/en-us/assets/engine-api/enums/AudioChannelLayout/Mono.jpg b/content/en-us/assets/engine-api/enums/AudioChannelLayout/Mono.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:82fda136126cf7eb9723d5f18db346178b9c9cdddb71c4faeaedc412c66b49a3
+size 196751
diff --git a/content/en-us/assets/engine-api/enums/AudioChannelLayout/Quad.jpg b/content/en-us/assets/engine-api/enums/AudioChannelLayout/Quad.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:23a023234a880eee589506733c6bb3443c97d7b2eb5220eb6707e98999c22fea
+size 222797
diff --git a/content/en-us/assets/engine-api/enums/AudioChannelLayout/Stereo.jpg b/content/en-us/assets/engine-api/enums/AudioChannelLayout/Stereo.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:9b13296c511654e74e4305d1b3deca1d6fad29b3f34c19f4d6ffefca39523411
+size 203627
diff --git a/content/en-us/assets/engine-api/enums/AudioChannelLayout/Surround_5.jpg b/content/en-us/assets/engine-api/enums/AudioChannelLayout/Surround_5.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:7df6717f66f5b521ea4bd8da1c56250aaaafd3501be39453d8ba97ef656558dd
+size 227595
diff --git a/content/en-us/assets/engine-api/enums/AudioChannelLayout/Surround_5_1.jpg b/content/en-us/assets/engine-api/enums/AudioChannelLayout/Surround_5_1.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:bc2cefe0bd786511e031a7ac66a96b3b7f02541971e913841fa4504d4f556b23
+size 230861
diff --git a/content/en-us/assets/engine-api/enums/AudioChannelLayout/Surround_7_1.jpg b/content/en-us/assets/engine-api/enums/AudioChannelLayout/Surround_7_1.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:97e3987815b364fd768867ff81cf2b3314d6eeac1f2fd4556cd4a9504e1a5540
+size 251067
diff --git a/content/en-us/assets/engine-api/enums/AudioChannelLayout/Surround_7_1_4.jpg b/content/en-us/assets/engine-api/enums/AudioChannelLayout/Surround_7_1_4.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:728f0113eee24026a02e49901bfddc532ac90fdff1fe543af59779942b690532
+size 288760
diff --git a/content/en-us/cloud/legacy.md b/content/en-us/cloud/legacy.md
@@ -18,7 +18,7 @@ This section contains documentation for Roblox's legacy REST APIs.
 | **API**                                 | **Path**                                                                  | **Scope**                |
 | :-------------------------------------- | :------------------------------------------------------------------------ | :----------------------- |
 | GetAssetById                            | `GET /v1/assetId/{assetId}`                                               | `legacy-asset:manage`    |
-| GetAssetVersionById                     | `GET /v1/assetId/{assetId}/version/{version}`                             | `legacy-asset:manage`    |
+| GetAssetVersionById                     | `GET /v1/assetId/{assetId}/version/{versionNumber}`                       | `legacy-asset:manage`    |
 
 ## Badges API
 
diff --git a/content/en-us/marketplace/publish-to-marketplace.md b/content/en-us/marketplace/publish-to-marketplace.md
@@ -63,6 +63,7 @@ To upload your asset:
    - For accessories and clothing, the item must be an `Class.Accessory` object. For information on the required specifications, see [Accessory Specifications](../art/accessories/specifications.md)
      - Upload clothing and accessories as an `Class.Accessory`. For information on converting your `Class.Model` into an `Class.Accessory`, see [Accessory Fitting Tool](../art/accessories/accessory-fitting-tool.md).
    - For bodies and heads, the item must be a `Class.Model`. For information on the required specifications, see [Avatar Character Specifications](../art/characters/specifications.md).
+     - You can add a default skin color to your body by adding a `Class.BodyColors` object to your model.
 2. In the **Explorer** window, right click the object and select **Save to Roblox**.
 3. In **Submit As**, select **Avatar Asset**.
 4. In the **Asset type** dropdown menu, select the appropriate marketplace asset type. Validation begins upon selection.
diff --git a/content/en-us/production/localization/auto-translate-dynamic-content.md b/content/en-us/production/localization/auto-translate-dynamic-content.md
@@ -132,7 +132,7 @@ The real-time translation API currently only supports RCC authentication. As a r
   <tr>
     <td>translations</td>
     <td>`Dictionary<string, string>`</td>
-    <td>A map containing the requested translations. The key is the IETF BCP-47 language code, and the value is the translated text for that language. The map will contain all requested translations.</td>
+    <td>A map containing the requested translations. The key is the IETF BCP-47 language code, and the value is the translated text for that language. The map will contain all requested translations. If the source text was filtered, this map will be empty. </td>
   </tr>
 </tbody>
 </table>
diff --git a/content/en-us/projects/activity-history.md b/content/en-us/projects/activity-history.md
@@ -45,11 +45,11 @@ Place removed from experience |  | &check;
 **Allow place to be copied as a template using Create Place API** changed | &check; | &check;
 **Allow place to be updated using Save Place API** changed | &check; | &check;
 
-### Place edits
+{/* ### Place edits
 
 Event | Shown in Studio | Shown in Creator Hub
 :--- | :---: | :---:
-Script draft committed | &check; |
+Script draft committed | &check; | */}
 
 ### Experience configuration
 
diff --git a/content/en-us/reference/cloud/cloud.docs.json b/content/en-us/reference/cloud/cloud.docs.json
diff --git a/content/en-us/reference/engine/classes/AudioChannelMixer.yaml b/content/en-us/reference/engine/classes/AudioChannelMixer.yaml
diff --git a/content/en-us/reference/engine/classes/AudioChannelSplitter.yaml b/content/en-us/reference/engine/classes/AudioChannelSplitter.yaml
diff --git a/content/en-us/reference/engine/classes/AvatarCreationService.yaml b/content/en-us/reference/engine/classes/AvatarCreationService.yaml
diff --git a/content/en-us/reference/engine/classes/EditableImage.yaml b/content/en-us/reference/engine/classes/EditableImage.yaml
diff --git a/content/en-us/reference/engine/enums/AudioChannelLayout.yaml b/content/en-us/reference/engine/enums/AudioChannelLayout.yaml
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
