update Open Source Docs from Roblox internal teams

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

content/common/navigation/avatar/guides.yaml

@@ -95,7 +95,7 @@ navigation:
         path: /art/accessories/automatic-skinning-transfer
       - title: Thumbnails
         path: /marketplace/custom-thumbnails
-  - title: Validation Errors
+  - title: Validation errors
     path: /art/validation-errors
   - title: 3rd party add-ons
     section:

content/common/navigation/engine/reference.yaml

@@ -4994,6 +4994,11 @@ navigation:
         type: engineapi
         source: /reference/engine/enums/PositionAlignmentMode.yaml
         ignoreTranslation: true
+      - title: PredictionMode
+        path: /reference/engine/enums/PredictionMode
+        type: engineapi
+        source: /reference/engine/enums/PredictionMode.yaml
+        ignoreTranslation: true
       - title: PreferredInput
         path: /reference/engine/enums/PreferredInput
         type: engineapi

content/en-us/art/accessories/accessory-fitting-tool.md

@@ -23,7 +23,7 @@ The AFT automatically handles the conversion of the custom `Class.Model` or `Cla
 If you are intending to sell your accessory on the Marketplace, make sure your accessory model design adheres to the [Marketplace Requirements](../../marketplace/marketplace-policy.md).
 </Alert>
 
-## Setting up Accessories
+## Set up accessories
 
 The first stage of the Accessory Fitting Tool allows you to configure the type of accessory to correctly populate the correct fitting tools and generate the appropriate accessory object. When selecting the type of accessory, the following options are available:
 
@@ -59,17 +59,17 @@ To setup your accessories:
 
    <img src="../../assets/accessories/accessory-fitting-tool/Preview-Display.png" />
 
-## Testing Accessories
+## Test accessories
 
 After you provide the initial accessory details, the tool displays a preview panel. With the preview panel, you can test how your accessory looks on different combinations of character bodies, clothing items, animations, or even custom assets in your experience.
 
 <Alert severity = 'info'>
 At any point of the testing process, you can start a [Play test](../../studio/testing-modes.md#playtest-options) to launch an instance of your experience where your avatar is replaced with the currently selected character body and accessories from the AFT.
 </Alert>
 
-If you notice any fitting issues with your accessory, you can use the [Editing](#editing-accessory-fit) tools to make minor adjustments to your accessory.
+If you notice any fitting issues with your accessory, you can use the [edit](#edit-accessory-fit) tools to make minor adjustments to your accessory.
 
-### With Different Bodies
+### With different bodies
 
 You can select different bodies to test the fit and wear of your accessories. The AFT supplies several default character models you can use to ensure your accessories fit as expected.
 
@@ -91,7 +91,7 @@ To test your accessory with a different body:
    1. If two character tiles are selected, click a selected tile to deselect it.
    2. In the character preview, **click** and **drag** to rotate and **right-click** to pan to inspect your character.
 
-### With Different Clothing
+### With different clothing
 
 You can select different clothing accessories to test the fit and layering of your caged accessories. The AFT supplies several default character models you can use to ensure your accessories fit as expected.
 
@@ -114,7 +114,7 @@ To test your accessory with a different accessory:
    2. In the character preview, **drag** and **drop** the accessory boxes to change the layer order.
    3. In the character preview, **click** and **drag** to rotate and **right-click** to pan to inspect your character.
 
-### With Animations
+### With animations
 
 You can select different animations to test the movement of your accessory asset. The AFT supplies several default animation assets you can use to ensure your accessories fit as expected when a model is performing various movements.
 
@@ -136,7 +136,7 @@ To test your accessory with different animations:
    1. In the catalog, press the play and pause icon to control the playback.
    2. In the character preview, **click** and **drag** to rotate and **right-click** to pan to inspect your character.
 
-### With Custom Assets
+### With custom assets
 
 You can add custom character models, clothing accessories, and animations that are part of your workspace to the AFT preview catalog. Use this functionality to verify that your accessory works with any other custom models or accessories they may interact with in your experience.
 
@@ -152,11 +152,11 @@ To add custom assets:
 
    <img src="../../assets/accessories/accessory-fitting-tool/Custom-Asset.png" />
 
-## Editing Accessory Fit
+## Edit accessory fit
 
 The Accessory Fitting Tool populates different fitting tools depending on the type of accessory being created.
 
-### Layered Clothing
+### Layered clothing
 
 When editing clothing items, the following tools populate in the viewport:
 
@@ -188,7 +188,7 @@ When editing clothing items, the following tools populate in the viewport:
 </tbody>
 </table>
 
-#### Cage Editing
+#### Cage editing
 
 When the Cage Editing interface is enabled, additional tools display in the viewport. The viewport also displays the vertices of the selected cage over the mannequin, allowing you to make positional edits to the cage and change how a clothing item can fit on a body.
 
@@ -238,7 +238,7 @@ To make changes to the vertices of the currently selected cage:
    2. Set the **Falloff Distance** depending on the number of vertices being adjusted at once.
       <img src="../../assets/accessories/accessory-fitting-tool/Edit-Vertex-Example.png" />
 
-### Rigid Accessories
+### Rigid accessories
 
 When fitting rigid accessories, a bounding box appears around the mannequin indicating the possible placement of that specific type of accessory. You can **position**, **rotate**, and **scale** objects within this bounding box to ensure your accessory fits on different character models.
 
@@ -253,13 +253,13 @@ When fitting rigid accessories, a bounding box appears around the mannequin indi
   </figure>
 </GridContainer>
 
-#### Generate Legacy Accessory
+#### Generate legacy accessory
 
 At this time, if you intend to sell your rigid accessory on the Marketplace, you must select **Generate Legacy Accessory** instead of **Generate MeshPart Accessory**. PBR textures are not yet supported for legacy accessories and the tool automatically applies your colormap to your mesh's textureID.
 
 <img src="../../assets/accessories/accessory-fitting-tool/Generate-Legacy-Accessory.png" alt="A dropdown appears above the GenerateMeshPartAccessory when expanded, displaying a Generate Legacy Accessory option."/>
 
-## Creating Accessory
+## Creating accessory
 
 You can create the accessory at any time. The tool applies any fit changes and generates the appropriate Accessory instance in the workspace depending on the type of accessory selected and any configurations applied.
 

content/en-us/art/accessories/from-existing.md

@@ -41,7 +41,7 @@ Using a provided reference 3D asset, this tutorial covers the following rigid ac
 While this content covers the Blender workflow with a provided reference example, you can apply the same concepts to other third-party modeling applications and custom assets.
 </Alert>
 
-## Modeling setup
+## Setup model
 
 Whether you are using an existing shape or creating your own 3D object, it's important to consider [technical requirements](../../art/accessories/specifications.md), such as keeping your geometry within a polycount budget, and [policy requirements](../../marketplace/marketplace-policy.md), such as ensuring your design does not infringe on other creator's IP both within and outside of the Roblox ecosystem.
 
@@ -72,7 +72,7 @@ You've completed the modeling section of this tutorial. If desired, download a [
 There are many tools and workflows to create your own unique asset. For additional suggestions, try creating different asset types, such as shoulder pads or belts, or importing a reference model into Blender as a mannequin to sculpt and shape your cosmetics from scratch.
 </Alert>
 
-## Texturing
+## Apply texture
 
 **Texturing** is the process of applying a surface appearance to a 3D object. Blender provides various tools and features to create and connect your own texture maps to your asset, allowing you to preview your model's final appearance and link the texture images to your exported file.
 
@@ -159,38 +159,17 @@ To freeze your transforms:
 
    <img src="../../assets/art/accessories/creating-rigid/Blender-Apply-Transforms.png" />
 
-## Export
+## Export from modeling tool
 
 After modeling and texturing your asset, you can begin the process of **exporting** your Blender project as a `.fbx`. The start of this process includes cleaning up your project, which can involve deleting or removing any extra objects, such as lights, cameras, or mannequins, to ensure you only export the accessory mesh, and applying any modifiers to your mesh object.
 
-Along with deleting your extra objects and mannequins, an often forgotten cleanup step involves **applying your transformations**, also known as **freezing your transforms**, by setting your orientation, rotation, and scale deltas to zero. Failure to apply any transformations can result in unexpected behavior and orientation when importing the mesh in Studio.
-
-To freeze your transforms:
-
-1. In Object mode, select your mesh object.
-2. Navigate to **Object** > **Apply** > **All Transforms**.
-
-   <img src="../../assets/art/accessories/creating-rigid/Blender-Apply-Transforms.png" />
-
-To export your model as a `.fbx`:
-
-1. In the topbar, click **File**.
-2. Select **Export**, then **FBX (.fbx)**.
-3. On the right-hand side of the file view window, change the **Path Mode** property to **Copy**, then toggle the **Embed Textures** button.
-
-   <img src="../../assets/modeling/skinned-meshes/Blender-Export-Settings-1.png" width="320" />
-
-4. Set the **Transform** > **Scale** to `.01`. This is required to maintain scale size for `.fbx` exports.
-
-   <img src="../../assets/modeling/skinned-meshes/Blender-Export-Settings-2.png" width="320" />
-
-5. Click the **Export FBX** button.
+For the latest export settings for Blender, see [rigid accessory export settings](./export-settings.md).
 
 <Alert severity = 'success'>
 You've completed the exporting section of this tutorial. If desired, download a [reference sample](../../assets/art/accessories/creating-rigid/Rigid_Mask_Export.fbx) of this exported file for comparison. You can use this reference in the next importing step.
 </Alert>
 
-## Import
+## Import to Studio
 
 Studio's 3D Importer provides a quick and easy way to import third-party 3D assets into your projects. The importer provides object previews and error-checking to ensure that your asset meets Studio's general 3D requirements.
 
@@ -276,41 +255,11 @@ After successful fitting and converting, your 3D model should populate in your p
 
 </Alert>
 
-## Validation
+## Upload and publish
 
 After generating your `Class.Accessory` item, you can now begin the process of **publishing** the asset to the Marketplace. This step is optional and only applicable for creators who intend to sell their asset.
 
-The publishing process involves three major steps:
-
-1. **Validation** - Validation occurs locally at the start of the upload process. This ensures that the accessory meets all of the technical requirements before uploading.
-2. **Moderation** - After uploading, Studio sends the asset to the Moderation queue. Moderation typically completes within 24 hours.
-3. **Ready-for-sale** - Once the asset clears moderation, you can set your marketplace settings and enable the asset for sale.
-
-If you intend to sell the asset on the Marketplace, use the following steps to begin the validation and upload process:
-
-1. In the **Explorer** window, right-click your accessory object and select **Save to Roblox…** from the contextual menu.
-2. In the **Asset Configuration** window, set the **Content Type** to **Avatar Item**.
-3. Complete the following fields (you can adjust them later):
-
-   1. **Title**: The name of your accessory.
-   2. **Description**: A short description of your asset.
-   3. **Asset Category**: The type of accessory. This should match the Accessory Type selected during the [Fitting and conversion](../../art/accessories/creating-rigid/converting.md) process.
-   4. **Creator**: Use the dropdown to select if you'd like to publish this asset as an individual or as part of an associated group.
-
-      <img src="../../assets/art/accessories/creating-rigid/Validation-Successful.png" />
-
-4. After you select the **Asset Category**, Studio begins validating the asset to ensure that it matches Roblox's accessory technical requirements.
-   1. If set up correctly, the window displays a green Validation Successful confirmation.
-   2. If you see an error `Could not find a Part called Handle...`, you may have published your accessory as a MeshPart instead of a legacy accessory. See [Use the Accessory Fitting tool](#convert) step 6 for more information.
-   3. If other errors appear, see the error messages for specific details. Some errors may require going back to the modeling software and adjusting the asset.
-5. If the validation is successful, you can submit the asset to the upload and moderation queue for a fee. See [Fees and commissions](../../marketplace/marketplace-fees-and-commissions.md) for current fee information.
-
-## Publish
-
-After uploading your asset for moderation, you can check your asset's current moderation status in the **Avatar Items** tab of your [Creator Dashboard](https://create.roblox.com/dashboard/creations). Moderation can take up to 24 hours during which a placeholder icon is used on the creation page.
-
-After moderation completes, your item's publishing details become available to edit and enable for sale. See the following for an overview on the various sale options available:
-
+For additional information and instructions on this process, see [uploading and publishing instructions](../../marketplace/publish-to-marketplace.md).
 <iframe width="800" height="450" src="https://www.youtube-nocookie.com/embed/swQW2VS9ZMA" title="YouTube video player" frameborder="0" allow="accelerometer; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
 <br />
 

content/en-us/production/promotion/rewarded-video-ads.md

@@ -143,8 +143,6 @@ requestShowAdEvent.OnServerEvent:Connect(function(player)
 end)
 ```
 
-For more information, see the [`AdService` API reference documentation](../../reference/engine/classes/AdService.yaml).
-
 ## Placements
 
 Use placements to track the performance of individual rewarded video ads inside your experience.

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

@@ -4,8 +4,8 @@ memory_category: Instances
 summary: |
   A class that allows the display of mobile video ads.
 description: |
-  A service for displaying mobile video ads as a form
-  of monetization. Use it to implement rewarded video ads in your experience.
+  A service for displaying mobile video ads as a form of monetization. Use it to
+  implement rewarded video ads in your experience.
 code_samples: []
 inherits:
   - Instance
@@ -16,14 +16,17 @@ deprecation_message: ''
 properties: []
 methods:
   - name: AdService:CreateAdRewardFromDevProductId
-    summary: 'Creates a reward to give users who watch an entire video ad.'
-    description: 'Creates a reward to give users who watch an entire video ad.'
+    summary: |
+      Creates a reward to give users who watch an entire video ad.
+    description: |
+      Creates a reward to give users who watch an entire video ad.
     code_samples: []
     parameters:
       - name: devProductId
         type: int64
-        default:
-        summary: 'The ID of the developer product you want to grant as a reward.'
+        default: ''
+        summary: |
+          The ID of the developer product you want to grant as a reward.
     returns:
       - type: AdReward
         summary: ''
@@ -46,7 +49,8 @@ methods:
     tags:
       - Deprecated
     deprecation_message: |
-      `Class.AdService.ShowVideoAd|ShowVideoAd` has been decommissioned and is no longer operational.
+      `Class.AdService.ShowVideoAd|ShowVideoAd` has been decommissioned and is
+      no longer operational.
     security: None
     thread_safety: Unsafe
     capabilities: []
@@ -70,17 +74,22 @@ methods:
     capabilities: []
     writeCapabilities: []
   - name: AdService:GetAdAvailabilityNowAsync
-    summary: 'Checks if a video ad is available to be played to the current user inside the experience.'
-    description: 'Checks if a video ad is available to be played to the current user inside the experience.'
+    summary: |
+      Checks if a video ad is available to be played to the current user inside
+      the experience.
+    description: |
+      Checks if a video ad is available to be played to the current user inside
+      the experience.
     code_samples:
       - AdService-GetAdAvailabilityNowAsync
     parameters:
       - name: adFormat
         type: AdFormat
         default:
-        summary: 'The format of the requested ad. For example, `RewardedOnDemandVideo`.'
+        summary: |
+          The format of the requested ad. For example, `RewardedOnDemandVideo`.
     returns:
-      - type: AdAvailabilityResult
+      - type: Variant
         summary: ''
     tags:
       - Yields
@@ -113,23 +122,31 @@ methods:
     capabilities: []
     writeCapabilities: []
   - name: AdService:ShowRewardedVideoAdAsync
-    summary: 'Plays the video ad to the current user inside the experience.'
-    description: 'Plays the video ad to the current user inside the experience.'
+    summary: |
+      Plays the video ad to the current user inside the experience.
+    description: |
+      Plays the video ad to the current user inside the experience.
     code_samples:
       - AdService-ShowRewardedVideoAdAsync
     parameters:
       - name: player
         type: Player
         default:
-        summary: 'The `Player` object for whom you are fetching the ad for.'
+        summary: |
+          The `Player` object for whom you are fetching the ad for.
       - name: reward
         type: AdReward
         default:
-        summary: 'The reward object for the reward you want to grant the user who watches an ad to completion.'
+        summary: |
+          The reward object for the reward you want to grant the user who
+          watches an ad to completion.
       - name: placementId
         type: int64?
         default:
-        summary: 'The ID of the placement of the rewarded video ad inside the experience. Allows for reporting on the performance of individual ad placements.'
+        summary: |
+          The ID of the placement of the rewarded video ad inside the
+          experience. Allows for reporting on the performance of individual ad
+          placements.
     returns:
       - type: ShowAdResult
         summary: ''
@@ -155,7 +172,8 @@ events:
     tags:
       - Deprecated
     deprecation_message: |
-      `Class.AdService.VideoAdClosed|VideoAdClosed` has been decommissioned and is no longer operational.
+      `Class.AdService.VideoAdClosed|VideoAdClosed` has been decommissioned and
+      is no longer operational.
     security: None
     capabilities: []
     writeCapabilities: []