Merge branch 'main' into patch-1

Author: IgnisRBX

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

@@ -424,9 +424,9 @@ TextChatService.OnBubbleAdded = function(message: TextChatMessage, adornee: Inst
 			-- Add a UIGradient as a child to customize the gradient
 			local uiGradient : UIGradient = Instance.new("UIGradient")
 			uiGradient.Color = ColorSequence.new(Color3.fromRGB(110, 4, 0), Color3.fromRGB(0, 0, 0))
-			uiGradient.Parent = bubbleProperties
 			uiGradient.Rotation = 90
-
+			uiGradient.Parent = bubbleProperties
+			
 			return bubbleProperties
 		end
 	end

content/en-us/discovery.md

@@ -69,6 +69,32 @@ If you have a brand new experience, you may not have enough users for recommenda
 
 Consider driving new users to your experience with [social media links](./production/promotion/social-media-links.md), [sponsored ads](./production/promotion/ads-manager.md#sponsored-experiences), and other channels so that recommendations can get enough signal. Roblox continues to add recommendations improvements to be better at discovering new experiences.
 
+## Best Practices for Discovery
+
+Your content must always adhere to our [Community Standards](https://en.help.roblox.com/hc/en-us/articles/203313410-Roblox-Community-Standards). To increase your reach and help your experience get discovered, make sure to also follow the best practices for discovery:
+
+- **Be accurate.** Avoid using irrelevant keywords in your metadata and follow the [metadata best practices](./production/publishing/publishing-experiences-and-places.md#metadata-best-practices).
+- **Build trust.** You should not rely on promotional monetary rewards to drive engagement. Instead, your metadata should reflect what your experience is about.
+- **Use unique metadata.** Focus on using original imagery and naming that you or your teammates created to help your experience stand out. Avoid publishing content with repetitive titles and images that have been previously published. When using  [thumbnail personalization](./production/publishing/thumbnails.md#thumbnail-personalization-for-the-home-page), make sure all thumbnails accurately reflect your experience.
+- **Add your own spin to existing trends** in the title, images, description, and in-experience content when you follow trends. Unique updates add value and differentiate your experience from other experiences following the same trend.
+
+### Issues that Limit Exposure
+
+The level of exposure your content receives on the homepage and in search is directly influenced by its quality. Certain issues can reduce visibility or prevent your content from being recommended, including:
+
+- **Leading with giveaways**: Metadata that implies any type of monetary reward is not prioritized for recommendations.
+    - Example: An experience titled "Robux! Play now!" receives less exposure because the title leads with monetary implications instead of in-experience content.
+- **Mismatched metadata and content**: Metadata and content that is highly mismatched is not recommended to users and is less visible in search results.
+    - Example: An experience titled "The Great Dinosaur Quest" that has a thumbnail showing dinosaurs but where the actual gameplay is a generic obstacle course with no dinosaurs or adventure elements.
+- **Non-unique experiences**: Experiences with metadata and place files that closely resemble existing experiences on Roblox are no longer prioritized for recommendations and might rank lower in search results.
+    - Example: An experience with the same title and visuals as a previously published experience.
+ 
+### Tracking and Improving Content Quality
+
+Roblox continually reclassifies content quality with every update, giving all experiences the opportunity to improve their reach. To be reassessed and improve your reach, make sure to align your experience with our [best practices](#best-practices-for-discovery). 
+
+To check if your experience is affected by quality issues, go to the **Creator Dashboard**. Experiences with reduced exposure display a banner that updates daily and provides the latest status about quality and visibility.
+
 ## Discovery for Other Surfaces
 
 Home's **Recommended For You** is not the only discovery surface that Roblox offers. Below is a primer on our other surfaces:

content/en-us/education/build-it-play-it-mansion-of-wonder/adding-scripts.md

@@ -239,8 +239,8 @@ The three scripts below will look for the particle emitter and beam objects crea
      playerBeam = beamTemplate:Clone()
      playerBeam.Attachment0 = playerBeamAttachment
      playerBeam.Attachment1 = targetBeamAttachment
-     playerBeam.Parent = humanoidRootPart
      playerBeam.Enabled = true
+     playerBeam.Parent = humanoidRootPart
    end
 
    local function setupPlayer()

content/en-us/luau/enums.md

@@ -45,11 +45,11 @@ To assign an `Datatype.EnumItem` as the value of a property, use the full `Datat
 
 ```lua
 local part = Instance.new("Part")		-- Create a new part
-part.Parent = workspace
-
 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
 ```

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

@@ -39,19 +39,19 @@ Luau coerces numbers and strings of enum values into the full enum name. For exa
 
 ```lua
 local part1 = Instance.new("Part")
-part1.Parent = workspace
 part1.Material = 816
+part1.Parent = workspace
 print(part1.Material) -- Enum.Material.Concrete
 
 local part2 = Instance.new("Part")
-part2.Parent = workspace
 part2.Material = "Concrete"
+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.Parent = workspace
 part3.Material = Enum.Material.Concrete
+part3.Parent = workspace
 print(part3.Material) -- Enum.Material.Concrete
 ```
 

content/en-us/performance-optimization/identifying.md

@@ -131,7 +131,7 @@ game.Loaded:Connect(function()
   local loadTime = os.clock() - startTime
   local roundedLoadTime = math.round(loadTime * 10000) / 10000 -- four decimal places
   print("Game loaded in " .. roundedLoadTime .. " seconds.")
-  print("Number of instances loaded: " .. #game.Workspace:GetDescendants())
+  print("Number of instances loaded: " .. #workspace:GetDescendants())
 end)
 ```
 

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

@@ -178,7 +178,7 @@ properties:
       -- Create a part and parent it to the workspace
       local part = Instance.new("Part")
       part.Parent = workspace
-      -- Instance new can also take Parent as a second parameter
+      -- Instance new can also take Parent as a second parameter, though it is not recommended
       Instance.new("NumberValue", workspace)
       ```
 

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

@@ -138,9 +138,9 @@ properties:
       partB.Parent = workspace
 
       local weld = Instance.new("WeldConstraint")
-      weld.Parent = partA
       weld.Part0 = partA
       weld.Part1 = partB
+      weld.Parent = partA
       ```
     code_samples:
     type: BasePart
@@ -175,15 +175,15 @@ properties:
       local partB = Instance.new("Part")
 
       partA.Position = Vector3.new(0, 10, 0)
-      partA.Parent = game.Workspace
+      partA.Parent = workspace
 
       partB.Position = Vector3.new(0, 10, 10)
-      partB.Parent = game.Workspace
+      partB.Parent = workspace
 
       local weld = Instance.new("WeldConstraint")
-      weld.Parent = partA
       weld.Part0 = partA
       weld.Part1 = partB
+      weld.Parent = partA
       ```
     code_samples:
     type: BasePart

content/en-us/ui/frames.md

@@ -119,8 +119,8 @@ If you want a 3D object such as a `Class.BasePart` to rotate on its own within t
 	-- Viewport camera initialization
 	local viewportCamera = Instance.new("Camera")
 	viewportCamera.FieldOfView = cameraFieldOfView
-	viewportCamera.Parent = viewportFrame
 	viewportFrame.CurrentCamera = viewportCamera
+	viewportCamera.Parent = viewportFrame
 
 	-- Viewport object initialization
 	local object = viewportFrame:FindFirstChildWhichIsA("BasePart")