update Open Source Docs from Roblox internal teams

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

content/common/navigation/cloud/reference.yaml

@@ -299,12 +299,6 @@ navigation:
         versions:
           - name: v1
             path: /cloud/legacy/badges/v1
-      - title: Chat
-        type: cloudlegacy
-        ignoreTranslation: true
-        versions:
-          - name: v2
-            path: /cloud/legacy/chat/v2
       - title: Develop v2
         type: cloudlegacy
         ignoreTranslation: true

content/en-us/art/accessories/clothing-export-settings.md

@@ -9,11 +9,42 @@ Export your mesh or model as a `.fbx` or `.gltf` to take advantage of all of Stu
 - If you are creating an avatar character model, ensure that your model follows [character specifications](../../art/characters/specifications.md) and use the [character body export settings](../../art/characters/export-settings.md).
 - If you are creating a generic mesh, ensure that your model follows Roblox's [general specifications](../../art/modeling/specifications.md) and use the [general export settings](../../art/modeling/export-requirements.md).
 
+## Before exporting
+
+Before exporting, ensure that you are only exporting the Roblox supported objects related to your model. If you have any modifiers to your mesh or project objects, make sure to apply or delete them before export.
+
+You can export layered clothing models with the following object structure:
+
+<img src="../../assets/modeling/skinned-meshes/Clothing-Data-Model.png" width="60%" alt="Blender clothing data model example" />
+
+- Armature parent
+  - Bones / joints
+  - Primary mesh object
+- Cage parent object
+
+  - Inner cage mesh object
+  - Outer cage mesh object
+
+You can also export shoes together. Even though left and right shoes are separate accessories, you can either export the left and right shoe individually, or export both shoes at the same time using the following structure:
+
+<img src="../../assets/modeling/skinned-meshes/Shoe-Data-Model.png" width="60%" alt="Shoe clothing data model example"/>
+
+- Armature parent
+  - Bones / joints
+  - Left shoe mesh object
+  - Right shoe mesh object
+- Cage parent object
+  - Left shoe inner cage
+  - Left shoe outer cage
+  - Right shoe inner cage
+  - Right shoe outer cage
+
 <Alert severity = 'warning'>
-If you have any modifiers to your mesh or project objects, make sure to apply
-or delete them before export.
+Each shoe must include their own inner and outer cage.
 </Alert>
 
+## Software specific export settings
+
 <Tabs>
   <TabItem label="Blender">
 

content/en-us/art/accessories/clothing-specifications.md

@@ -133,7 +133,7 @@ If setting attachment names manually in Studio, use the following `Class.Attachm
 
 ### Face Accessories
 
-Face accessories, such as hair, eyebrows, and eyelashes are unique accessories that you can bundle with an avatar body upload. At this time, eyebrows and eyelashes can not be uploaded as standalone accessories and must be bundled with avatar bodies. For more information on bundling your face accessories with avatar models, see [Publishing Bodies with Eyelashes and Eyebrows](../accessories/publish-eyebrows-eyelashes.md).
+Face accessories, such as hair, eyebrows, and eyelashes are unique accessories that you can bundle with an avatar body upload. At this time, eyebrows and eyelashes can not be uploaded as standalone accessories and must be bundled with avatar bodies. For more information on bundling your face accessories with avatar models, see [Publishing bodies with eyelashes and eyebrows](../accessories/publish-eyebrows-eyelashes.md).
 
 - **Naming Convention when bundled** - When including these assets with an avatar body upload, the accessory objects must use the following name conventions:
   - `EyebrowAccessory`
@@ -169,13 +169,7 @@ For more information on basic skinning in third-party modeling software, such as
 **Cage meshes**, or **cages**, are invisible meshes that define the inner and outer surfaces of your asset and are fundamental to the layerable properties of clothing items. The inner cage determines the inside surface of a clothing item while the outer cage determines the outside surface of a clothing item.
 
 <Alert severity = 'error'>
-Assets with invalid cage configurations may fail validation and are subject to moderation. This includes, but is not limited to:
-
-<ul>
-<li>**No difference between the two cages** - The outer cage needs to envelope the layered clothing item as much as possible. If the inner and outer cages are exactly the same, the layered accessory behaves like a rigid accessory and doesn't deform.</li>
-<li>**Extreme space between the two cages** - Large spaces between the inner and outer cages can make the accessory look unrealistic puffy or excessively large.</li>
-<li>**Outer cage is within the inner cage** - The outer cage needs to be outside the inner cage otherwise the asset will fail validation.</li>
-</ul>
+Assets with invalid cage configurations may fail validation and are subject to moderation. See [Caging best practices](./caging-best-practices.md) for examples and instructions.
 </Alert>
 
 For a basic overview on caging, see the [Basic Clothing Tutorial](../accessories/creating/caging-setup.md) and the relevant section of the tutorial video at [8:32](https://www.youtube.com/watch?v=C-DwGRBHvmE&t=512s):

content/en-us/art/accessories/import-clothing.md

@@ -64,6 +64,10 @@ After successful import, your model object should populate in your project as a
 
 With the `Class.Model` in your project, the last step in the process of clothing creation requires you to use the Accessory Fitting Tool to convert this object to a standard `Class.Accessory` that avatar characters can equip.
 
+<Alert severity = 'warning'>
+For shoes, you must convert the left shoe and the right shoe as separate accessories. Use the following instructions for each shoe before grouping both shoe accessories as a `Class.Model` when [saving to Roblox](../../marketplace/publish-to-marketplace.md#upload-an-asset).
+</Alert>
+
 To generate the accessory object:
 
 1. In the Avatar tab, select the [**Accessory Fitting Tool**](../accessories/accessory-fitting-tool.md). The Accessory Fitting Tool panel displays on the left side of the workspace.

content/en-us/art/characters/creating/export-character.md

@@ -24,7 +24,7 @@ To export your character:
 <img src="../../../assets/art/avatar/basic-creation/Export-Settings.png" width = "60%" />
 
 <Alert severity = 'warning'>
-After exporting your .fbx file, see [Test characters](../../../art/characters/testing/index.md) In Studio for steps on importing your character model into a test place and verifying your avatar and related components.
+After exporting your .fbx file, see [Test characters](../../../art/characters/testing/index.md) for steps on importing your character model into a test place and verifying your avatar and related components.
 </Alert>
 
 <Alert severity = 'success'>

content/en-us/art/characters/export-settings.md

@@ -3,6 +3,10 @@ title: Character body export settings
 description: Use the appropriate export settings in Maya and Blender to generate Studio-ready .fbx files.
 ---
 
+<Alert severity = 'warning'>
+It's important to test your assets multiple times at every point of the asset creation process, whether it is within your modeling application or after importing into Studio. See [Test characters](../../art/characters/testing/index.md) for more information.
+</Alert>
+
 Export your model as a `.fbx` or `.gltf` to take advantage of all of Studio's 3D import features. When rigging or skinning a layerable model, these file types contains all the mesh and texture data, including the rig and influence data, you need to later [import](../../art/modeling/3d-importer.md) into Studio.
 
 Check that your model meets Roblox's [avatar character specifications](../../art/characters/specifications.md) before exporting to ensure Studio compatibility.
@@ -15,33 +19,47 @@ Check that your model meets Roblox's [avatar character specifications](../../art
 If you are using Roblox's avatar template files, you must perform the [cleanup steps](../../art/characters/creating/combine-head-geometry.md) in order for the assets to properly validate.
 </Alert>
 
-<Tabs>
-  <TabItem label="Blender">
+## Before exporting
 
-Before exporting a mesh from Blender, make sure either your **Scene Properties** > **Unit Scale** to `.01` or your export **Transform** > **Scale** is set to `.01` (step 4) to ensure similar `.fbx` scaling within Studio.
+Before exporting, ensure that you are only exporting the Roblox supported objects related to your model. If you have any modifiers to your mesh or project objects, make sure to apply or delete them before export.
 
-To export the `.fbx` file in Blender:
+Use the following guidance before exporting:
 
-1. In the topbar, click **File**. A pop-up menu displays.
-2. Select **Export**, then **FBX (.fbx)**. The **Blender File View** window displays.
-3. On the right-hand side, change the **Path Mode** property to **Copy**, then toggle the **Embed Textures** button.
+- While your mesh objects must be parented within an armature object, you can also parent your outer cage objects to a single empty object to simplify your workspace.
+
+  <img src="../../assets/art/avatar/Character-Data-Model-Collapsed.png" width = "60%" />
+
+- In the cage parent object, ensure you have an [outer cage](../characters/specifications.md#outer-cages) for each of your 15 body parts with appropriate naming affix.
+
+  <img src="../../assets/art/avatar/Character-Data-Model-Cages.png" width = "60%" />
 
-   <img src="../../assets/modeling/skinned-meshes/Blender-Export-Settings-1.png" width="320" />
+- In the armature object, ensure that you include the all [15 mesh objects](../characters/specifications.md#body-parts) and [19 attachments](../characters/specifications.md#attachments) with the appropriate naming affix.
 
-4. If your project doesn't already have .01 scene unit scaling, set the **Transform** > **Scale** to `.01`.
+  <img src="../../assets/art/avatar/Character-Data-Model-Joints.png" width = "60%" />
 
-   <img src="../../assets/modeling/skinned-meshes/Blender-Export-Settings-2.png" width="320" />
+<Alert severity = 'info'>
+For more information on supported modeling objects and proper configuration, see [Character specifications](../characters/specifications.md).
+</Alert>
+
+## Software specific export settings
 
-5. Under the **Armature** section, disable **Add Leaf Bones**.
+Whether you are exporting your character for testing, or are performing a final export out of Blender, you must apply the appropriate export settings to ensure that Blender exports the proper character data.
 
-   <img src="../../assets/modeling/skinned-meshes/Blender-Export-Settings-3.png" width="320" />
+<Tabs>
+  <TabItem label="Blender">
 
-6. Enable **Bake Animation**. Avatar characters with [facial animation data](../../art/characters/facial-animation/index.md) require animation data.
+Before exporting a mesh from Blender, make sure either your **Scene Properties** > **Unit Scale** to `.01` or your export settings **Transform** > **Scale** is set to `.01` to ensure similar `.fbx` scaling within Studio.
 
-   <img src="../../assets/modeling/skinned-meshes/Blender-Export-Settings-4.png" width="320" /> <br />
+1. In the topbar, click **File** > **Export** > **FBX (.fbx)**. The Blender file browser window displays.
+2. Set **Path Mode** to **Copy** and enable the **Embed Textures** icon.
+3. In the Include section, enable **Custom Properties**.
+4. Expand the Armature section and uncheck **Add Leaf Bones**.
+5. Enable **Bake Animation**.
+6. Expand Bake Animation and **uncheck NLA Strips**, **All Actions**, and **Force Start/End Keyframes**.
+7. In Bake Animation, set **Simplify** to **0.0**.
+8. Click the **Export FBX** button. Save the `.fbx` to the directory of your choice.
 
-7. Click the **Export FBX** button.
-8. After exporting, use Studio's [3D importer](../../art/modeling/3d-importer.md) to import your model. See [Test characters in Studio](../../art/characters/testing/studio.md) for additional importing and testing information
+<img src="../../assets/art/avatar/basic-creation/Export-Settings.png" width = "60%" />
 
 </TabItem>
 <TabItem label="Maya">
@@ -57,10 +75,20 @@ To export a mesh in Maya as a `.fbx` file:
 8. In the **Advanced Options** section,
    - Navigate to **Units**, then enable **Automatic**.
    - Navigate to **Axis Conversion**, then set the **Up Axis** property to **Y**.
-   - Navigate to **FBX File Format**, then set the **Type** property to **Binary**, and the **Version** property to **FBX 2020**.
+   - If you have issues importing your model, navigate to **FBX File Format**, then set the **Type** property to **Binary**, and the **Version** property to **FBX 2020**.
 9. Click the **Export All** button.
    <img src="../../assets/accessories/lc-requirements-maya-settings.png" />
 10. After exporting, use Studio's [3D importer](../../art/modeling/3d-importer.md) to import your model. See [Test characters in Studio](../../art/characters/testing/studio.md) for additional importing and testing information.
 
 </TabItem>
 </Tabs>
+
+<Alert severity = 'success'>
+After importing the `Class.Model` character to Studio, you can now perform the following with this asset:
+
+- [Test your character model](../../art/characters/testing/index.md) in Studio using various tools and workflows.
+- [Upload the character](../../art/accessories/creating-rigid/publishing.md) to the Marketplace.
+- Use the humanoid character on an existing experience by applying a [HumanoidDescription](../../characters/appearance.md#humanoiddescription)to the `Class.Model` object.
+- Save the asset to your [Toolbox](../../projects/assets/toolbox.md) to share or use within any of your experiences.
+
+</Alert>

content/en-us/art/characters/testing/studio.md

@@ -2,12 +2,13 @@
 title: Test in Studio
 comments:
 description: Verify the important aspects of your character model in a custom Studio test experience.
-prev: /art/avatar/testing/blender
 ---
 
-Test your character model in Studio to understand how it looks and feels within a Roblox experience.
+Test your character model in Studio to understand how it looks and feels within a Roblox experience. To test your custom character in Studio, first [import the character model](../../characters/import.md) into your Studio project.
 
-Roblox provides an [Avatar Test experience](https://www.roblox.com/games/13176231501/Avatar-Test-Place) that you can open in Studio and import your character model in. This experience provides a wide variety of environmental and clothing tests to ensure that your character model and related components work as expected.
+You can test in Studio using the [Avatar Setup tool](../../modeling/avatar-setup.md) to preview and test various components of your avatar character.
+
+You can also playtest your character in the [Avatar Test experience](https://www.roblox.com/games/13176231501/Avatar-Test-Place). This experience provides a wide variety of environmental and clothing tests to ensure that your character model and related components work as expected.
 
 ## Set up test experience