update Open Source Docs from Roblox internal teams

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

content/common/navigation/assets.yaml

@@ -49,6 +49,8 @@ navigation:
         path: /art/modeling/export-requirements
       - title: 3D Importer
         path: /art/modeling/3d-importer
+      - title: glTF Export
+        path: /art/modeling/gltf-export
       - title: Roblox Blender plugin
         path: /art/modeling/roblox-blender-plugin
 

content/en-us/art/accessories/creating-rigid/modeling-setup.md

@@ -37,12 +37,12 @@ Create the rounded lid shape using segmentation:
 
 1. Near the Edit mode dropdown, select the Line selection.
 2. Holding <kbd>Shift</kbd>, click the top front and back lines of your chest.
-3. With both lines selected, press <kbd>Ctrl</kbd>/<kbd>Cmd</kbd>+<kbd>B</kbd> to Bevel.
+3. With both lines selected, press <kbd>Ctrl</kbd><kbd>B</kbd>/<kbd>⌘</kbd><kbd>B</kbd> to bevel.
 4. In the context menu at the bottom right, set the number of segments to `6` and enable **Clamp Overlap**.
 
 ### Merge vertices
 
-Sometimes tools like the Bevel tool may move vertices very close to each other without merging them. Use the Merge Vertices function to ensure that your object shares vertices wherever possible.
+Sometimes tools like the **Bevel** tool may move vertices very close to each other without merging them. Use the Merge Vertices function to ensure that your object shares vertices wherever possible.
 
 1. Near the Edit mode dropdown, select the Vertices selection.
 2. Press <kbd>A</kbd> to select all vertices.
@@ -74,7 +74,7 @@ To create your vertical loop cuts:
 
 1. Near the Edit mode dropdown, select the Line selection.
 2. Press <kbd>A</kbd> to select the entire chest.
-3. Use <kbd>Ctrl</kbd>/<kbd>Cmd</kbd>+<kbd>R</kbd> to create a Loop Cut.
+3. Use <kbd>Ctrl</kbd><kbd>R</kbd>/<kbd>⌘</kbd><kbd>R</kbd> to create a loop cut.
 4. Using your mouse, hover over the object until the highlighted cut is vertical. Click to confirm.
 5. In the context menu, set the number of cuts to `2`.
 6. With the new lines selected, press <kbd>S</kbd> to scale and <kbd>Y</kbd> to scale within the y-axis.
@@ -86,7 +86,7 @@ To create your vertical loop cuts:
 
 To create your horizontal loop cuts:
 
-1. Select the chest, and press <kbd>Ctrl</kbd>/<kbd>Cmd</kbd>+<kbd>R</kbd> to loop cut.
+1. Select the chest, and press <kbd>Ctrl</kbd><kbd>R</kbd>/<kbd>⌘</kbd><kbd>R</kbd> to loop cut.
 2. Using the mouse, click to confirm a horizontal cut.
 3. Using the context menu, set the number of cuts to `2`.
 4. To straighten each line across your object, select the one of your new lines:
@@ -103,7 +103,7 @@ To create your horizontal loop cuts:
 Create the extrusions for the front, top, and back of the chest.
 
 1. Near the Edit mode dropdown, select the Face selection.
-2. Hold <kbd>Alt</kbd>/<kbd>Option</kbd> and click on your front faces to select the front, top, and back faces.
+2. Hold <kbd>Alt</kbd>/<kbd>⌥</kbd> and click on your front faces to select the front, top, and back faces.
 3. With the faces selected, hold <kbd>Shift</kbd> and click on the metal borders to deselect them. The front and back faces, and the top segmentations, should remain selected.
 4. Right click and select **Extrude Faces Along Normals**. Drag the mouse to extrude the faces about the same width as the metal borders.
 

content/en-us/art/accessories/creating-rigid/texturing.md

@@ -59,7 +59,7 @@ Switch to Texture Paint mode and use the paintbrush to track the "wood" parts of
 2. Switch to **Texture Paint** mode. A side-by-side panel displays with your 2D atlas on the left and the 3D object on the right.
 3. Expand the Tool submenu in the top-right of either window.
 4. Select your brush settings and mark the wooden areas of your chest.
-   1. Use <kbd>Ctrl</kbd>/<kbd>Cmd</kbd>+<kbd>Z</kbd> to undo any accidental brushes on the metal border.
+   1. Use <kbd>Ctrl</kbd><kbd>Z</kbd>/<kbd>⌘</kbd><kbd>Z</kbd> to undo any accidental brushes on the metal border.
    2. Hold <kbd>F</kbd> and drag the mouse to adjust brush size.
 
 ### Paint 2D map
@@ -72,7 +72,7 @@ With all of the wooden areas of your chest marked, you can now quickly texture y
    1. Set the **Falloff** shape to the flattest icon to ensure the edges are sharp.
    2. Set the color or any other brush settings here.
 2. In the left window, begin coloring in each island of your texture. You can quickly preview the changes on your 3D object on the right side.
-   1. Use <kbd>Ctrl</kbd>/<kbd>Cmd</kbd>+<kbd>Z</kbd> to undo any accidental brushes on the metal border.
+   1. Use <kbd>Ctrl</kbd><kbd>Z</kbd>/<kbd>⌘</kbd><kbd>Z</kbd> to undo any accidental brushes on the metal border.
    2. Hold <kbd>F</kbd> and drag the mouse to adjust brush size.
 3. After completion, navigate to **Image** > **Save** to save your image file.
 

content/en-us/art/blender.md

@@ -395,7 +395,7 @@ The **Grab** tool lets you move objects, vertices, edges, and faces from the 3D
 To use the Grab tool:
 
 1. In either **Object** or **Edit** mode, select one or multiple objects, vertices, edges, or faces.
-1. Press the <kbd>G</kbd> hotkey to activate the tool.
+1. Press <kbd>G</kbd> to activate the tool.
 1. Move the mouse to reposition your selection. For further precision:
    - Press <kbd>X</kbd>, <kbd>Y</kbd>, or <kbd>Z</kbd> after you press <kbd>G</kbd> to constrain movement to the **X**, **Y**, or **Z** axis, respectively.
    - Double-press an axis key to slide vertices or edges along their natural path.
@@ -437,7 +437,7 @@ To use the Snap tool:
       - **Move** - Snaps while moving the selection.
       - **Rotate** - Snaps while rotating the selection.
       - **Scale** - Snaps while scaling the selection.
-1. Press <kbd>Shift</kbd> + <kbd>Tab</kbd> to activate the tool.
+1. Press <kbd>Shift</kbd><kbd>Tab</kbd> to activate the tool.
 1. For further precision, hold <kbd>Shift</kbd> to snap the selection in finer increments.
 1. Move, rotate, or scale an object or mesh element according to your settings.
 
@@ -454,7 +454,7 @@ The **Inset** tool lets you create an inset with adjustable thickness and depth
 To use the Inset tool:
 
 1. In **Edit** mode, select one or multiple faces.
-1. Press the <kbd>I</kbd> hotkey to activate the tool.
+1. Press <kbd>I</kbd> to activate the tool.
 1. Move the mouse to adjust your inset's size. For further precision:
    - Hold <kbd>Ctrl</kbd> to adjust the depth of the inset.
    - Hold <kbd>Shift</kbd> while moving your mouse to slow down movement for fine adjustments.
@@ -474,7 +474,7 @@ The **Extrude** tool lets you create new geometry by pulling out new faces, edge
 To use the Extrude tool:
 
 1. In **Edit** mode, select one or multiple vertices, edges, or faces.
-1. Press the <kbd>E</kbd> hotkey to activate the tool.
+1. Press <kbd>E</kbd> to activate the tool.
 1. Move the mouse to adjust your extrusion's length. For further precision, press <kbd>X</kbd>, <kbd>Y</kbd>, or <kbd>Z</kbd> after you press <kbd>E</kbd> to constrain movement to the **X**, **Y**, or **Z** axis, respectively.
 1. Left-click or press <kbd>Enter</kbd> to confirm your extrusion(s).
 
@@ -515,7 +515,7 @@ The **Bridge Edge Loops** tool lets you connect multiple edge loops with faces.
 To use the Bridge Edge Loops tool:
 
 1. In **Edit** mode, select two or more edge loops that you want to connect.
-1. Press the <kbd>Ctrl</kbd> + <kbd>E</kbd> hotkey to display a contextual menu for your active edge loops, then select **Bridge Edge Loops** to activate the tool.The **Bridge Edge Loops** panel displays.
+1. Press <kbd>Ctrl</kbd><kbd>E</kbd>/<kbd>⌘</kbd><kbd>E</kbd> to display a contextual menu for your active edge loops, then select **Bridge Edge Loops** to activate the tool.The **Bridge Edge Loops** panel displays.
 1. Set **Number of Cuts** to the number of subdivisions you want for your new bridge.
 1. **(Optional)** For further precision for curved bridges, increase **Smoothness** to create a more rounded bridge.
 1. Left-click to confirm your bridge.
@@ -533,7 +533,7 @@ The **Fill** tool lets you create triangular faces between any active edges or v
 To use the Fill tool:
 
 1. In **Edit** mode, select at least three vertices or two or more edges that form at least one complete perimeter.
-1. Press <kbd>Alt</kbd> + <kbd>F</kbd> to activate the tool.
+1. Press <kbd>Alt</kbd><kbd>F</kbd>/<kbd>⌥</kbd><kbd>F</kbd> to activate the tool.
 1. **(Optional)** In the **Fill** panel, enable **Beauty** to arrange the triangles nicely.
 1. Left-click to confirm your new face.
 
@@ -550,7 +550,7 @@ The **New Faces from Edges** tool lets you either create an edge if only two ver
 To use the New Faces from Edges tool:
 
 1. In **Edit** mode, select at least three vertices, or two or more edges that form one or more complete perimeters.
-1. Press the <kbd>F</kbd> hotkey to activate the tool.
+1. Press <kbd>F</kbd> to activate the tool.
 1. Left-click to confirm your new face.
 
 <Alert severity="info">
@@ -584,7 +584,7 @@ The **Delete** tool lets you completely remove geometry from your meshes, leavin
 To use the Delete tool:
 
 1. In **Edit** mode, select the vertices, edges, or faces that you want to remove from your mesh.
-1. Press the <kbd>X</kbd> hotkey to display a contextual menu for your selection.
+1. Press <kbd>X</kbd> to display a contextual menu for your selection.
 1. Choose one of the following menu items:
    1. Select **Vertices** to delete all active vertices, removing any faces or edges they are connected to.
    1. Select **Edges** to delete all active edges, removing any faces that the edge shares with it.
@@ -698,7 +698,7 @@ To use the Mark Seam tool:
 
 1. Open the **UV Editing** workspace. The UV Editor displays on the lefthand side of the screen, and the 3D viewport displays on the righthand side of the screen in Edit mode.
 1. In the **3D Viewport**, navigate to your 3D object, then select the edges where you want to create seams.
-1. Press the <kbd>Ctrl</kbd> + <kbd>E</kbd> hotkey to open the **Edge** contextual menu.
+1. Press <kbd>Ctrl</kbd><kbd>E</kbd>/<kbd>⌘</kbd><kbd>E</kbd> to open the **Edge** contextual menu.
 1. Select **Mark Seam**. The seam turns red and is ready for the Unwrap tool.
 
 When you are ready to unwrap your object, Blender will unwrap the enclosed faces of the seam as its own island.
@@ -728,7 +728,7 @@ To use the Unwrap tool:
 
 1. Open the **UV Editing** workspace. The UV Editor displays on the lefthand side of the screen, and the 3D viewport displays on the righthand side of the screen in Edit mode.
 1. In the **3D Viewport**, navigate to your 3D object, then either use the **Mark Seam** tool to create seams, and/or select the specific faces you want to texture.
-1. Press the <kbd>U</kbd> hotkey to open the **UV Mapping** contextual menu.
+1. Press <kbd>U</kbd> to open the **UV Mapping** contextual menu.
 1. Select **Unwrap**. Your selection's UV islands display neatly in the UV Editor.
 1. In the **UV Editor**, move, scale, or rotate UV islands to the appropriate position, orientation, and scale on your texture.
 
@@ -749,11 +749,11 @@ To use the Follow Active Quads tool:
 1. Open the **UV Editing** workspace. The UV Editor displays on the lefthand side of the screen, and the 3D viewport displays on the righthand side of the screen in Edit mode.
 1. In the **3D Viewport**, navigate to your 3D object, then unwrap every face you want to texture using an active face.
 1. **(Optional)** Configure your active face.
-   1. In the **UV Editor**, select the face you want to be your active face, then press <kbd>Option</kbd> + <kbd>M</kbd> hotkey to open the **Split** contextual menu.
+   1. In the **UV Editor**, select the face you want to be your active face, then press <kbd>Alt</kbd><kbd>M</kbd>/<kbd>⌥</kbd><kbd>M</kbd>  to open the **Split** contextual menu.
    1. Select **Selection**. The active face separates from the UV island.
    1. Move, scale, or rotate your active face to the appropriate position, orientation, and scale that you want other faces in the UV map to follow.
 1. In the **UV Editor**, select all faces you want to follow the active face. Make sure to select your active face last so that Blender knows to use its layout as the guide.
-1. Press the <kbd>U</kbd> hotkey to open the **Unwrap** contextual menu, then select **Follow Active Quads**. Blender aligns your selection's UV coordinates to match the active face's shape and orientation.
+1. Press <kbd>U</kbd> to open the **Unwrap** contextual menu, then select **Follow Active Quads**. Blender aligns your selection's UV coordinates to match the active face's shape and orientation.
 
 <Alert severity="info">
 For more information on this tool, see Blender's official [UV Operators - Follow Active Quads](https://docs.blender.org/manual/en/latest/modeling/meshes/editing/uv.html#follow-active-quads) documentation.
@@ -786,7 +786,7 @@ To use a projection tool:
 
 1. Open the **UV Editing** workspace. The UV Editor displays on the lefthand side of the screen, and the 3D viewport displays on the righthand side of the screen in Edit mode.
 1. In the **3D Viewport**, navigate to your 3D object, then select every face.
-1. Press the <kbd>U</kbd> hotkey to open the **UV Mapping** contextual menu, then select one of the following options:
+1. Press <kbd>U</kbd> to open the **UV Mapping** contextual menu, then select one of the following options:
    - **Cube Projection**
    - **Sphere Projection**
    - **Cylinder Projection**
@@ -855,10 +855,10 @@ To vertex paint:
 1. Apply color to your object.
    1. To apply color to individual vertices:
       1. In the **3D Viewport**, click and drag over your object's vertices to apply your color with a smooth gradient.
-      1. For further precision, press the <kbd>[</kbd> or <kbd>]</kbd> hotkey to increase or decrease the brush size, respectively.
+      1. For further precision, press <kbd>[</kbd> or <kbd>]</kbd> to increase or decrease the brush size, respectively.
    1. To flood fill your color,
       1. In **Edit** mode, select the vertices or faces that you want to apply your color.
-      1. In **Vertex Paint** mode, press the <kbd>Ctrl</kbd> + <kbd>X</kbd> hotkey. Your selected vertices or faces display the new color.
+      1. In **Vertex Paint** mode, press <kbd>Ctrl</kbd><kbd>X</kbd>/<kbd>⌘</kbd><kbd>X</kbd>. Your selected vertices or faces display the new color.
 
 <Alert severity="info">
 For more information on this process, see Blender's official [Vertex Paint](https://docs.blender.org/manual/en/latest/sculpt_paint/vertex_paint/index.html) documentation.

content/en-us/art/modeling/gltf-export.md

@@ -0,0 +1,85 @@
+---
+title: 3D Export
+description: 3D Importer imports third-party .fbx, .gltf, and .obj 3D model assets into Studio.
+---
+
+import BetaAlert from '../../includes/beta-features/beta-alert.md'
+
+<BetaAlert betaName="glTF Export" leadIn="This feature is currently in beta. Enable it through " leadOut="." components={props.components} />
+
+You can export your 3D Roblox assets as a **.glTF** ([GL Transmission Format](https://en.wikipedia.org/wiki/GlTF)) file format. This open standard format allows for efficient transfer of 3D assets and associated data between Studio and other software, such as Blender or Maya.
+
+<br />
+Some common use cases for .glTF export includes:
+
+- Running [Avatar auto setup](../../avatar-setup/index.md#auto-setup), exporting the output and finalizing the meshes, cages, or rigging in a third-party tool.
+- Exporting your entire place for high-fidelity scene renders in another 3D application.
+- Creating 3D content in Studio, such as part-based models or editable meshes and making modifications in an external application.
+
+Keep in mind that glTF supports specific 3D [components](#supported-components), has some [limitations](#limitations), and requires correct [permissions](#limitations) to export assets from Studio. Some of these specifications may change over the course of the beta.
+
+## Supported components
+
+glTF export supports the following types of 3D data:
+
+- Meshes
+- Textures
+- Rigging and skinning data
+- Vertex colors
+- Cages
+- Dynamic head FACS data.
+
+## Limitations
+
+<Alert severity = 'warning'>
+See the beta announcement for the latest information on limitations and currently known bugs.
+</Alert>
+
+At this time, glTF has the following limitations:
+
+- Does not support animation data.
+- Inconsistent support for layered clothing — clothing accessories may not always position correctly and won't deform to avatar bodies outside of Roblox.
+
+## Permissions
+
+<Alert severity = 'warning'>
+See the beta announcement for the latest information on permissions and upcoming changes.
+</Alert>
+
+You must have the correct permissions to export assets as .glTF. When exporting .glTF, Studio verifies that you have permissions to export that asset and may warn you if there are any conflicts.
+
+<br />
+You can export the following assets:
+
+- Assets directly uploaded to your account
+- Assets directly uploaded to one of your group accounts
+- Mesh and image assets that have been explicitly shared with you or your group
+
+You cannot export the following assets:
+
+- Avatar Marketplace assets
+- Acquired Creator Store assets
+- Shared collaborator assets where the underlying meshes/images have not been explicitly shared
+- Other `Open Use` (public) assets that have not been explicitly shared with you or your group
+
+## How to use .glTF export
+
+<BetaAlert betaName="glTF Export" leadIn="This feature is currently in beta. Enable it through " leadOut="." components={props.components} />
+
+You can export selected items from the Explorer, or export the entire place.
+
+<br />
+To export from the Explorer:
+
+1. Select the items you intend to export.
+2. Right-click and navigate to **Save / Export** > **Export as glTF**.
+3. Follow the prompts on screen to fine-tune your export components. Click **Export** when ready.
+   1. After clicking Export, Studio runs a permission check. If there are any permission conflicts, a permission prompt appears with additional details.
+4. In the file browser, select a location to save the .glTF file.
+
+To export an entire place:
+
+1. Navigate to **File** > **Export as glTF**.
+2. Follow the prompts on screen to fine-tune your export components. Click **Export** when ready.
+   1. After clicking Export, Studio runs a permission check. If there are any permission conflicts, a permission prompt appears with additional details.
+3. In the file browser, select a location to save the .glTF file.

content/en-us/art/test-classic-clothing.md

@@ -1,6 +1,6 @@
 ---
-title: Classic clothing
-description: Classic clothing are decals you can apply to a classic character model's surface. You can create classic clothing items on Roblox and upload them to the Marketplace.
+title: Test classic clothing
+description: How to test your classic clothing items before uploading them to the Marketplace.
 ---
 
 <Alert severity="warning">

content/en-us/art/upload-classic-clothing.md

@@ -1,6 +1,6 @@
 ---
-title: Classic clothing
-description: Classic clothing are decals you can apply to a classic character model's surface. You can create classic clothing items on Roblox and upload them to the Marketplace.
+title: Upload classic clothing
+description: How to upload your classic clothing to the Marketplace and check moderation status.
 ---
 
 <Alert severity="warning">