update Open Source Docs from Roblox internal teams

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

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

@@ -272,6 +272,6 @@ When you are ready to generate your accessory, select **Generate MeshPart Access
 
 With an accessory successfully created, you can now try the following:
 
-- Equip the accessory on an avatar-ready character by drag and dropping the accessory on an existing model, or using [HumanoidDescription](../../characters/appearance.md#humanoiddescription).
+- Equip the accessory on an avatar-ready character by drag and dropping the accessory on an existing model, or using [HumanoidDescription](../../characters/appearance.md#manually-modify-appearance).
 - Save the accessory as an [avatar asset](../../projects/assets/index.md#for-avatars) for use in an experience later.
 - If you meet certain account requirements, you can [upload your asset](../../marketplace/publish-to-marketplace.md) for moderation and start selling it on the Marketplace.

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

@@ -36,7 +36,7 @@ To fit and generate your accessory:
 After successful fitting and converting, your 3D model should populate in your project as a `Class.Accessory`. With this `Class.Accessory` you can perform any of the following:
 
 - [Upload the accessory](../../../art/accessories/creating-rigid/publishing.md) to the Marketplace.
-- Use the accessory in your current experience by equipping it to character models with [HumanoidDescription](../../../characters/appearance.md#humanoiddescription), or by dragging and dropping the accessory under the appropriate character `Class.Model` object.
+- Use the accessory in your current experience by equipping it to character models with [HumanoidDescription](../../../characters/appearance.md#manually-modify-appearance), or by dragging and dropping the accessory under the appropriate character `Class.Model` object.
 - Save the accessory to your [Toolbox](../../../projects/assets/toolbox.md) to share or use within any of your experiences.
 
 </Alert>

content/en-us/art/accessories/creating/converting.md

@@ -29,7 +29,7 @@ To generate the accessory object:
 <Alert severity = 'success'>
 Congratulations, you've completed your clothing tutorial. With this accessory, you can:
 
-- Equip the accessory on an avatar-ready character by drag and dropping the accessory on an existing model, or using [HumanoidDescription](../../../characters/appearance.md#humanoiddescription).
+- Equip the accessory on an avatar-ready character by drag and dropping the accessory on an existing model, or using [HumanoidDescription](../../../characters/appearance.md#manually-modify-appearance).
 - Save the accessory as an [avatar asset](../../../projects/assets/index.md#for-avatars) for use in an experience later.
 - If you meet certain account requirements, you can [upload your asset](../../../marketplace/publish-to-marketplace.md) for moderation and start selling it on the Marketplace.
 

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

@@ -88,6 +88,6 @@ After successful fitting and converting, your 3D model should populate in your p
 
 - Begin the process of [uploading and publishing](../../marketplace/publish-to-marketplace.md#upload-an-asset) the clothing accessory to the Marketplace.
 
-- Use the accessory in your current experience by equipping it to character models with [HumanoidDescription](../../characters/appearance.md#humanoiddescription), or by dragging and dropping the accessory under the appropriate character `Class.Model` object.
+- Use the accessory in your current experience by equipping it to character models with [HumanoidDescription](../../characters/appearance.md#manually-modify-appearance), or by dragging and dropping the accessory under the appropriate character `Class.Model` object.
 
 - Save the accessory to your [Toolbox](../../projects/assets/toolbox.md) or make it public on the [Creator Store](../../production/creator-store.md) to share or use within any of your experiences.

content/en-us/art/accessories/importing.md

@@ -95,6 +95,6 @@ After successful fitting and converting, your 3D model should populate in your p
 
 - Begin the process of [uploading and publishing](../../marketplace/publish-to-marketplace.md#upload-an-asset) the accessory to the Marketplace.
 
-- Use the accessory in your current experience by equipping it to character models with [HumanoidDescription](../../characters/appearance.md#humanoiddescription), or by dragging and dropping the accessory under the appropriate character `Class.Model` object.
+- Use the accessory in your current experience by equipping it to character models with [HumanoidDescription](../../characters/appearance.md#manually-modify-appearance), or by dragging and dropping the accessory under the appropriate character `Class.Model` object.
 
 - Save the accessory to your [Toolbox](../../projects/assets/toolbox.md) or make it public on the [Creator Store](../../production/creator-store.md) to share or use within any of your experiences.

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

@@ -31,7 +31,7 @@ After exporting your .fbx file, see [Test characters](../../../art/characters/te
 After importing the `Class.Model` character to Studio, you can now perform the following with this asset:
 
 - [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.
+- Use the humanoid character on an existing experience by applying a [HumanoidDescription](../../../characters/appearance.md#manually-modify-appearance)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/export-settings.md

@@ -95,7 +95,7 @@ After importing the `Class.Model` character to Studio, you can now perform the f
 
 - [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.
+- Use the humanoid character on an existing experience by applying a [HumanoidDescription](../../characters/appearance.md#manually-modify-appearance)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/import.md

@@ -81,7 +81,7 @@ With this new character `Class.Model`, you can perform any of the following:
 
 - Begin the process of [uploading and publishing](../../marketplace/publish-to-marketplace.md#upload-an-asset) the character model to the Marketplace. This involves some additional validation and moderation steps.
 
-- Use the model in your current experience and modify the model's appearance with [HumanoidDescription](../../characters/appearance.md#humanoiddescription).
+- Use the model in your current experience and modify the model's appearance with [HumanoidDescription](../../characters/appearance.md#manually-modify-appearance).
 
   - Playtest as the character by renaming the `Class.Model` to `StarterCharacter` and moving the `Class.Model` to the StarterPlayer folder in your Explorer before play testing.
 

content/en-us/characters/appearance.md

@@ -5,17 +5,17 @@ description: Customize your in-experience character appearance and properties.
 
 Most experiences let players use their own Roblox avatar, although some implement an in-experience customization system like the [UGC Homestore](/resources/templates.md#ugc-homestore) template. Other experiences make limited [modifications](../characters/appearance.md) to player avatars such as helmets, wings, or accessories that match the genre.
 
-To create a unique experience that alters the appearance of your users, you can customize the default character properties through [avatar settings](#avatar-settings) or a [HumanoidDescription](#humanoiddescription).
+To create a unique experience that alters the appearance of your users, you can customize the default character properties through [avatar settings](#global-avatar-settings) or a [manually modify appearance](#manually-modify-appearance).
 
-## Avatar settings
+## Global avatar settings
 
-Studio's **File** ⟩ **Avatar Settings** allows you to quickly set several global player character properties in your experience. These settings apply globally to all player character models joining your experience. To modify specific characters, such as non-player character models, see [HumanoidDescription](#humanoiddescription).
+Studio's **File** ⟩ **Avatar Settings** allows you to quickly set several global player character properties in your experience. These settings apply globally to all player character models joining your experience. To modify specific characters, such as non-player character models, see [manually modify appearance](#manually-modify-appearance).
 
 In this window, you can set various presets for clothing, accessories, body parts, collision behavior, animations and more. When editing these settings, a preview of the applied settings displays in the workspace.
 
 For more information, see [Avatar Settings](../studio/avatar-settings.md).
 
-## HumanoidDescription
+## Manually modify appearance
 
 Character models contain a `Class.Humanoid` object that gives the model special characteristics, such as walking, jumping, equipping items, and interacting with the environment.
 
@@ -37,28 +37,29 @@ You can adjust the following character properties in your experience using `Clas
   </tr>
   <tr>
     <td>Accessories </td>
-    <td>The Asset IDs of  `Class.Accessory|accessories` equipped by a character. </td>
+    <td>The asset IDs of  `Class.Accessory|accessories` equipped by a character. </td>
   </tr>
   <tr>
     <td>Classic Clothing</td>
-    <td>The Asset IDs of the `Class.Shirt`, `Class.Pants`, and `Class.ShirtGraphic` image textures that you can apply to the character.</td>
+    <td>The asset IDs of the `Class.Shirt`, `Class.Pants`, and `Class.ShirtGraphic` image textures that you can apply to the character.</td>
   </tr>
   <tr>
     <td>Body Part</td>
-    <td>The Asset IDs of the `Class.HumanoidDescription.Face|Face`, `Class.HumanoidDescription.Head|Head`, `Class.HumanoidDescription.Torso|Torso`, `Class.HumanoidDescription.RightArm|RightArm`, `Class.HumanoidDescription.LeftArm|LeftArm`, `Class.HumanoidDescription.RightLeg|RightLeg` and `Class.HumanoidDescription.LeftLeg|LeftLeg` parts of a character.</td>
+    <td>The asset IDs of the `Class.HumanoidDescription.Face|Face`, `Class.HumanoidDescription.Head|Head`, `Class.HumanoidDescription.Torso|Torso`, `Class.HumanoidDescription.RightArm|RightArm`, `Class.HumanoidDescription.LeftArm|LeftArm`, `Class.HumanoidDescription.RightLeg|RightLeg` and `Class.HumanoidDescription.LeftLeg|LeftLeg` parts of a character.</td>
   </tr>
   <tr>
     <td>Body Colors</td>
     <td>The `Class.BodyColors` of the character's individual parts.</td>
   </tr>
   <tr>
     <td>Animations</td>
-    <td>The Asset IDs of `Class.Animation|Animations` you can use on a character.</td>
+    <td>The asset IDs of `Class.Animation|Animations` you can use on a character.</td>
   </tr>
 </tbody>
 </table>
+<br />
 
-You can customize a character with `Class.HumanoidDescription` using the following steps:
+Customize a character with `Class.HumanoidDescription` using the following steps:
 
 1. [Create a description](#create-humanoiddescription) from the user's character, a specific Outfit ID, or from a specific User ID.
 2. [Modify the description](#modify-humanoiddescription) to customize the properties that you want to apply to the `Class.Humanoid` character.
@@ -72,17 +73,18 @@ When updating a character's properties through `Class.HumanoidDescription`, it i
 
 You can create a new `Class.HumanoidDescription` instance directly within the Explorer hierarchy or within a `Class.Script` with the following code:
 
-```lua
+```lua title="Create new HumanoidDescription instance"
 local humanoidDescription = Instance.new("HumanoidDescription")
 ```
 
-In most cases, you should use an existing `Class.HumanoidDescription` instead of a default new `Class.HumanoidDescription` by referencing an [existing player character](#from-the-player-character), [avatar outfit](#from-an-existing-outfit), or [user ID](#from-a-specific-user).
+In most cases, you should use an existing `Class.HumanoidDescription` instead of a default new `Class.HumanoidDescription` by referencing an existing player character, avatar outfit, or user ID.
 
-#### From the player character
+<br />
+<h4> From the player character </h4>
 
 Use the following code sample to create a new `Class.HumanoidDescription` based on the player character's current properties:
 
-```lua
+```lua title="Generate a HumanoidDescription from a player character"
 local humanoid = player.Character and player.Character:FindFirstChildWhichIsA("Humanoid")
 
 local humanoidDescription = Instance.new("HumanoidDescription")
@@ -92,23 +94,23 @@ if humanoid then
 end
 ```
 
-#### From an existing outfit
+<h4> From an existing outfit </h4>
 
 Use the following sample code to create a `Class.HumanoidDescription` from an outfit ID using `Class.Players:GetHumanoidDescriptionFromOutfitId()|Players.GetHumanoidDescriptionFromOutfitID`:
 
-```lua
+```lua title="Generate a HumanoidDescription from an Outfit ID"
 local Players = game:GetService("Players")
 
 local outfitId = 480059254
 
 local humanoidDescriptionFromOutfit = Players:GetHumanoidDescriptionFromOutfitId(outfitId)
 ```
 
-#### From a specific user
+<h4> From a specific user </h4>
 
 Use the following sample code to create a `Class.HumanoidDescription` from a user ID using `Class.Players:GetHumanoidDescriptionFromUserId()`:
 
-```lua
+```lua  title="Generate a HumanoidDescription from a user ID"
 local Players = game:GetService("Players")
 
 local userId = 491243243
@@ -122,7 +124,7 @@ To customize `Class.HumanoidDescription` properties, set them directly on the `C
 
 The following code sample provides examples of setting the different types of `Class.HumanoidDescription` properties:
 
-```lua
+```lua title="Update various HumanoidDescription properties"
 local humanoidDescription = Instance.new("HumanoidDescription")
 humanoidDescription.HatAccessory = "2551510151,2535600138"
 humanoidDescription.BodyTypeScale = 0.1
@@ -132,11 +134,11 @@ humanoidDescription.GraphicTShirt = 1711661
 humanoidDescription.HeadColor = Color3.new(0, 1, 0)
 ```
 
-#### Set multiple accessories
+<h4> Set multiple accessories </h4>
 
 For layered or bulk accessory changes, you can use `Class.HumanoidDescription:SetAccessories()` to make accessory related updates. The following code sample adds a layered sweater and jacket in that order to a `Class.HumanoidDescription`:
 
-```lua
+```lua title="Change multiple accessories at once"
 local humanoidDescription = Instance.new("HumanoidDescription")
 local accessoryTable = {
 	{
@@ -162,11 +164,11 @@ Apply `Class.HumanoidDescription` to specific `Class.Humanoid` characters in you
 Changing the assets on a character while also changing `Class.HumanoidDescription` might lead to undefined behavior.
 </Alert>
 
-#### On a single character
+<h4> On a single character </h4>
 
 `Class.Humanoid:ApplyDescription()|ApplyDescription()` can target any `Class.Humanoid`. Use the following code to add a new pair of sunglasses and a new torso to the player character:
 
-```lua
+```lua title = "Update HumanoidDescription for a specific player character"
 local humanoid = player.Character and player.Character:FindFirstChildWhichIsA("Humanoid")
 if humanoid then
 	local descriptionClone = humanoid:GetAppliedDescription()
@@ -178,11 +180,11 @@ if humanoid then
 end
 ```
 
-#### On all player characters
+<h4> On all player characters </h4>
 
 Use the following sample code to apply a `Class.HumanoidDescription` to all current players in the game:
 
-```lua
+```lua title = "Update HumanoidDescription for all current player characters"
 local Players = game:GetService("Players")
 
 for _, player in Players:GetPlayers() do
@@ -201,11 +203,11 @@ for _, player in Players:GetPlayers() do
 end
 ```
 
-#### On all spawning characters
+<h4> On all spawning characters </h4>
 
 Use the following sample code to set a specific `Class.HumanoidDescription` for all spawning player characters:
 
-```lua
+```lua title = "Update HumanoidDescription for all spawning characters"
 local Players = game:GetService("Players")
 
 -- Stop automatic spawning so it can be done in the "PlayerAdded" callback

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

@@ -437,8 +437,8 @@ methods:
           - `MetalnessMap` — A `Datatype.Content` object that contains the
             metalness map. If more than one channel is present, only the red
             channel is used. Default is `nil`.
-          - `NormalMap` — A `Datatype.Content` object that contains the
-            normal map. Default is `nil`.
+          - `NormalMap` — A `Datatype.Content` object that contains the normal
+            map. Default is `nil`.
           - `RoughnessMap` — A `Datatype.Content` object that contains the
             roughness map. If more than one channel is present, only the red
             channel is used. Default is `nil`.