update Open Source Docs from Roblox internal teams

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

content/en-us/characters/pathfinding.md

@@ -131,13 +131,14 @@ local path = PathfindingService:CreatePath({
 This section uses the following pathfinding script for the player's character. To test while reading:
 
 1. Copy the code into a `Class.LocalScript` within `Class.StarterCharacterScripts`.
-1. Edit line 11 to a `Datatype.Vector3` destination that the player character can reach.
+1. Set the `TEST_DESTINATION` variable to a `Datatype.Vector3` destination in your 3D world that the player character can reach.
 1. Proceed through the following sections to learn about path computation and character movement.
 
 ```lua title='LocalScript - Character Pathfinding' highlight='11'
 local PathfindingService = game:GetService("PathfindingService")
 local Players = game:GetService("Players")
 local RunService = game:GetService("RunService")
+local Workspace = game:GetService("Workspace")
 
 local path = PathfindingService:CreatePath()
 
@@ -206,6 +207,7 @@ After you've created a valid path with `Class.PathfindingService:CreatePath()|Cr
 local PathfindingService = game:GetService("PathfindingService")
 local Players = game:GetService("Players")
 local RunService = game:GetService("RunService")
+local Workspace = game:GetService("Workspace")
 
 local path = PathfindingService:CreatePath()
 
@@ -238,6 +240,7 @@ Once the `Class.Path` is computed, it will contain a series of **waypoints** tha
 local PathfindingService = game:GetService("PathfindingService")
 local Players = game:GetService("Players")
 local RunService = game:GetService("RunService")
+local Workspace = game:GetService("Workspace")
 
 local path = PathfindingService:CreatePath()
 
@@ -279,6 +282,7 @@ Each waypoint consists of both a **position** (`Datatype.Vector3`) and **action*
 local PathfindingService = game:GetService("PathfindingService")
 local Players = game:GetService("Players")
 local RunService = game:GetService("RunService")
+local Workspace = game:GetService("Workspace")
 
 local path = PathfindingService:CreatePath()
 
@@ -344,13 +348,14 @@ end
 Many Roblox worlds are dynamic; parts might move or fall and floors may collapse. This can block a computed path and prevent the character from reaching its destination. To handle this, you can connect the `Class.Path.Blocked` event and re-compute the path around whatever blocked it.
 
 <Alert severity="warning">
-Paths may also become blocked somewhere **behind** the agent, such as a pile of rubble falling on a path as the agent runs away, but that doesn't mean the agent should stop moving. The conditional statement on line&nbsp;31 makes sure that the path is re-computed only if the blocked waypoint is **ahead** of the current waypoint.
+Paths may also become blocked somewhere **behind** the agent, such as a pile of rubble falling on a path as the agent runs away, but that doesn't mean the agent should stop moving. The <Typography noWrap>`if blockedWaypointIndex >= nextWaypointIndex`</Typography> check makes sure that the path is re-computed only if the blocked waypoint is **ahead** of the current waypoint.
 </Alert>
 
 ```lua title='LocalScript - Character Pathfinding' highlight='16, 29-37'
 local PathfindingService = game:GetService("PathfindingService")
 local Players = game:GetService("Players")
 local RunService = game:GetService("RunService")
+local Workspace = game:GetService("Workspace")
 
 local path = PathfindingService:CreatePath()
 
@@ -411,6 +416,7 @@ Keys in the `Costs` table should be string names representing `Enum.Material` na
 local PathfindingService = game:GetService("PathfindingService")
 local Players = game:GetService("Players")
 local RunService = game:GetService("RunService")
+local Workspace = game:GetService("Workspace")
 
 local path = PathfindingService:CreatePath({
 	Costs = {
@@ -441,6 +447,7 @@ In some cases, [material preference](#set-material-costs) is not enough. For exa
    local PathfindingService = game:GetService("PathfindingService")
    local Players = game:GetService("Players")
    local RunService = game:GetService("RunService")
+   local Workspace = game:GetService("Workspace")
 
    local path = PathfindingService:CreatePath({
    	Costs = {
@@ -498,6 +505,7 @@ To create a `Class.PathfindingLink` using this example:
    local PathfindingService = game:GetService("PathfindingService")
    local Players = game:GetService("Players")
    local RunService = game:GetService("RunService")
+   local Workspace = game:GetService("Workspace")
 
    local path = PathfindingService:CreatePath({
    	Costs = {
@@ -513,6 +521,7 @@ To create a `Class.PathfindingLink` using this example:
    local PathfindingService = game:GetService("PathfindingService")
    local Players = game:GetService("Players")
    local RunService = game:GetService("RunService")
+   local Workspace = game:GetService("Workspace")
 
    local path = PathfindingService:CreatePath({
    	Costs = {
@@ -582,7 +591,7 @@ To create a `Class.PathfindingLink` using this example:
    end
 
    function useBoat()
-   	local boat = workspace.BoatModel
+   	local boat = Workspace.BoatModel
 
    	humanoid.Seated:Connect(function()
    		-- Start boat moving if agent is seated

content/en-us/characters/r6-to-r15-adapter.md

@@ -27,12 +27,12 @@ The adapter parts perform the following:
 
 ## Enable the R6 to R15 Adapter
 
-You can enable the R6 to R15 Adapter by setting the `Class.Workspace.AvatarUnificationMode` property in Workspace. You can only access this property if **Avatar Type** is set to `R6` in your **Game Settings**. At this time, the **Default** setting disables the `Class.Workspace.AvatarUnificationMode|AvatarUnificationMode`.
+You can enable the R6 to R15 Adapter by setting the `Class.Workspace.AvatarUnificationMode|AvatarUnificationMode` property in `Class.Workspace`. You can only access this property if **Avatar Type** is set to `R6` in your **Game Settings**. At this time, the **Default** setting disables unification mode.
 
 To enable the R6 to R15 Adapter:
 
-1. In the Explorer, navigate to **Workspace**.
-2. In the Properties window, set **AvatarUnificationMode** to **Enabled**.
+1. In the **Explorer**, navigate to **Workspace**.
+2. In the **Properties** window, set **AvatarUnificationMode** to **Enabled**.
 
 ## Known limitations
 

content/en-us/chat/bubble-chat.md

@@ -449,8 +449,9 @@ Display chat bubbles for non-player characters (NPCs) by calling `Class.TextChat
 
 ```lua
 local TextChatService = game:GetService("TextChatService")
+local Workspace = game:GetService("Workspace")
 
-local prompt = workspace.SomeNPC.ProximityPrompt
+local prompt = Workspace.SomeNPC.ProximityPrompt
 local head = prompt.Parent:WaitForChild("Head")
 
 prompt.Triggered:Connect(function()

content/en-us/chat/chat-window.md

@@ -591,6 +591,7 @@ You can also stylize non-player dialogue and add [chat bubbles](../chat/bubble-c
 
 ```lua title='Client Script'
 local TextChatService = game:GetService("TextChatService")
+local Workspace = game:GetService("Workspace")
 
 local generalChannel: TextChannel = TextChatService:WaitForChild("TextChannels").RBXGeneral
 
@@ -604,7 +605,7 @@ TextChatService.OnIncomingMessage = function(textChatMessage: TextChatMessage)
 		properties.PrefixText = string.format("<font color='#%s'>%s: </font>", "#50C999", textChatMessage.Metadata)
 
 		-- Add bubble chat
-		TextChatService:DisplayBubble(workspace.Statue, textChatMessage.Text)
+		TextChatService:DisplayBubble(Workspace.Statue, textChatMessage.Text)
 	end
 
 	return properties

content/en-us/chat/legacy/legacy-chat-system.md

@@ -140,11 +140,13 @@ Command functions are often used to implement [Admin Commands](../../chat/legacy
 In this example a **ChatModule** is used to create a `Class.Part` if a user types `/part` in the chat. Note that this function returns true if a part was created which will stop the message from proceeding and no message will be displayed. If a part is not created, this function needs to return false so that the message can continue working through the system.
 
 ```lua
+local Workspace = game:GetService("Workspace")
+
 local function Run(ChatService)
 	local function createPart(speakerName, message, channelName)
 		if string.sub(message, 1, 5) == "/part" then
 			local newPart = Instance.new("Part")
-			newPart.Parent = workspace
+			newPart.Parent = Workspace
 			return true
 		end
 		return false

content/en-us/luau/enums.md

@@ -44,12 +44,14 @@ print(Enum.PartType.Cylinder.EnumType) -- PartType
 To assign an `Datatype.EnumItem` as the value of a property, use the full `Datatype.Enum` declaration. You can also use its `Value` or `EnumType`.
 
 ```lua
+local Workspace = game:GetService("Workspace")
+
 local part = Instance.new("Part")		-- Create a new part
 part.Shape = Enum.PartType.Cylinder  -- By EnumItem (best practice)
 part.Shape = Enum.PartType.Cylinder.Value -- By EnumItem Value
 part.Shape = 2  -- By EnumItem Value
 part.Shape = Enum.PartType.Cylinder.Name -- By EnumItem Name
 part.Shape = "Cylinder"  -- By EnumItem Name
 
-part.Parent = workspace
+part.Parent = Workspace
 ```

content/en-us/luau/functions.md

@@ -78,16 +78,18 @@ Methods are functions that are members of an object, such as a [class](/referenc
 All objects in Roblox descend from `Class.Instance` and have commonly used methods including `Class.Instance:Destroy()`, `Class.Instance:Clone()`, and `Class.Instance:FindFirstChild()`.
 
 ```lua
--- Destroying a Part with dot notation (function)
+local Workspace = game:GetService("Workspace")
+
+-- Destroying a part with dot notation (function)
 local firstPart = Instance.new("Part")
-firstPart.Parent = workspace
+firstPart.Parent = Workspace
 print(firstPart.Parent) -- Workspace
 firstPart.Destroy(firstPart)
 print(firstPart.Parent) -- nil
 
--- Destroying a Part with colon notation (method)
+-- Destroying a part with colon notation (method)
 local secondPart = Instance.new("Part")
-secondPart.Parent = workspace
+secondPart.Parent = Workspace
 print(secondPart.Parent) -- Workspace
 secondPart:Destroy()
 print(secondPart.Parent) -- nil

content/en-us/luau/nil.md

@@ -29,16 +29,18 @@ print(dictionaryTable.Tuesday) -- nil
 You can use `nil` to clear some properties of objects. For example, you can set the `Parent` of an object to `nil` to effectively remove the object from the experience. To return the object to the experience after you remove it, reassign the `Parent`. The following example demonstrates how to use `nil` to remove a `Class.Part`:
 
 ```lua
+local Workspace = game:GetService("Workspace")
+
 -- Create a new brick
 local part = Instance.new("Part")
--- Parent new Part to the workspace, making it viewable
-part.Parent = workspace
+-- Parent new part to the workspace, making it viewable
+part.Parent = Workspace
 task.wait(1)
--- Remove the Part from view, but not from memory
+-- Remove the part from view but not from memory
 part.Parent = nil
 task.wait(1)
--- Part still exists because it's referenced by the variable 'part', so it can be returned to view
-part.Parent = workspace
+-- Part still exists because it's referenced by the variable "part", so it can be returned to view
+part.Parent = Workspace
 task.wait(1)
 -- Remove the part from view again
 part.Parent = nil

content/en-us/luau/tables.md

@@ -25,7 +25,7 @@ To create an array using a Luau table, declare the values in sequential order, s
 
 ```lua
 -- Construct an array with three items
-local testArray = {"A string", 3.14159, workspace.Camera}
+local testArray = {"A string", 3.14159, true}
 print(testArray)
 ```
 
@@ -35,23 +35,23 @@ To read from an array, add a pair of square brackets after its reference and spe
 
 ```lua
 -- Construct an array with three items
-local testArray = {"A string", 3.14159, workspace.Camera}
+local testArray = {"A string", 3.14159, true}
 
 print(testArray[1]) -- A string
 print(testArray[2]) -- 3.14159
-print(testArray[3]) -- Camera
+print(testArray[3]) -- true
 ```
 
 <Alert severity="warning">
-Unlike some languages, Luau uses 1-based indexing for arrays, so the first item in the array is <InlineCode>[1]</InlineCode>, not <InlineCode>[0]</InlineCode>.
+Unlike some languages, Luau uses 1-based indexing for arrays, so the first item in the array is `[1]`, not `[0]`.
 </Alert>
 
 ### Write to arrays
 
 To define or rewrite the value of an array at an index, declare the index number in square brackets (`[index]`) followed by `=` and the value:
 
 ```lua
-local testArray = {"A string", 3.14159, workspace.Camera}
+local testArray = {"A string", 3.14159, true}
 
 testArray[2] = 12345
 testArray[4] = "New string"
@@ -62,10 +62,10 @@ print(testArray[4]) -- New string
 
 ### Iterate over arrays
 
-To iterate over an array, you can use a `for` loop. Because the arrays have numerical indices, you can also use a numeric `for` loop from **1** to the length of the array (`#array`).
+To iterate over an array, you can use a `for` loop. Because the arrays have numerical indices, you can also use a numeric `for` loop from `1` to the length of the array (`#array`).
 
 ```lua
-local testArray = {"A string", 3.14159, workspace.Camera, "New string"}
+local testArray = {"A string", 3.14159, true, "New string"}
 
 -- Loop using general iteration
 for index, value in testArray do
@@ -76,17 +76,6 @@ end
 for index = 1, #testArray do
 	print(index, testArray[index])
 end
-
---[[ Resulting output:
-1 A string
-2 3.14159
-3 Camera
-4 New string
-1 A string
-2 3.14159
-3 Camera
-4 New string
-]]
 ```
 
 ### Insert items

content/en-us/luau/type-coercion.md

@@ -38,20 +38,22 @@ Some properties expect certain data types, such as an [Enum](#enums) or string,
 Luau coerces numbers and strings of enum values into the full enum name. For example, you can name the value of the `Class.Part.Material` property using a number, string, or full enum name, and the `print()` function always prints the full enum name. It's best practice to be explicit and use the full enum name. For more information on Enums, see [Enums](./enums.md).
 
 ```lua
+local Workspace = game:GetService("Workspace")
+
 local part1 = Instance.new("Part")
 part1.Material = 816
-part1.Parent = workspace
+part1.Parent = Workspace
 print(part1.Material) -- Enum.Material.Concrete
 
 local part2 = Instance.new("Part")
 part2.Material = "Concrete"
-part2.Parent = workspace
+part2.Parent = Workspace
 print(part2.Material) -- Enum.Material.Concrete
 
 -- This is best practice because it's the most explicit
 local part3 = Instance.new("Part")
 part3.Material = Enum.Material.Concrete
-part3.Parent = workspace
+part3.Parent = Workspace
 print(part3.Material) -- Enum.Material.Concrete
 ```