Merge branch 'Roblox:main' into main

Author: ManHatos

content/common/navigation/engine/reference.yaml

@@ -2505,6 +2505,11 @@ navigation:
         type: engineapi
         source: /reference/engine/classes/Teams.yaml
         ignoreTranslation: true
+      - title: TelemetryService
+        path: /reference/engine/classes/TelemetryService
+        type: engineapi
+        source: /reference/engine/classes/TelemetryService.yaml
+        ignoreTranslation: true
       - title: TeleportAsyncResult
         path: /reference/engine/classes/TeleportAsyncResult
         type: engineapi
@@ -3348,6 +3353,16 @@ navigation:
         type: engineapi
         source: /reference/engine/enums/AnnotationEditingMode.yaml
         ignoreTranslation: true
+      - title: AnnotationRequestResult
+        path: /reference/engine/enums/AnnotationRequestResult
+        type: engineapi
+        source: /reference/engine/enums/AnnotationRequestResult.yaml
+        ignoreTranslation: true
+      - title: AnnotationRequestType
+        path: /reference/engine/enums/AnnotationRequestType
+        type: engineapi
+        source: /reference/engine/enums/AnnotationRequestType.yaml
+        ignoreTranslation: true
       - title: AppLifecycleManagerState
         path: /reference/engine/enums/AppLifecycleManagerState
         type: engineapi
@@ -3878,11 +3893,6 @@ navigation:
         type: engineapi
         source: /reference/engine/enums/EasingStyle.yaml
         ignoreTranslation: true
-      - title: EditableStatus
-        path: /reference/engine/enums/EditableStatus
-        type: engineapi
-        source: /reference/engine/enums/EditableStatus.yaml
-        ignoreTranslation: true
       - title: ElasticBehavior
         path: /reference/engine/enums/ElasticBehavior
         type: engineapi

content/en-us/art/modeling/avatar-setup.md

@@ -204,7 +204,7 @@ The following assets are designed for the specific [auto-setup requirements](../
 <Card style={{height: '100%'}}>
 <CardContent>
 
-<center>Nature Girl - AutoSetup</center>
+<center>Nature Girl - Auto-Setup</center>
 <figure>
 <center> <img src="../assets/art/resources/Archer-Girl-Preview.png" width="100%" /> </center>
 </figure>
@@ -225,7 +225,7 @@ This Auto-Setup template is not compatible with the traditional avatar creation
 <Card style={{height: '100%'}}>
 <CardContent>
 
-<center>Stylish Male - AutoSetup</center>
+<center>Stylish Male - Auto-Setup</center>
 <figure>
 <center> <img src="../assets/art/resources/StylizedMale-Preview.png" width="100%" /> </center>
 </figure>

content/en-us/assets/avatar/avatar-setup/Auto-Setup-Scaling.png

@@ -292,17 +292,17 @@ To copy a more complex table with nested tables inside it, you'll need to use a
 
 ```lua
 -- The function used for deep copying a table
-local function deepCopy(original)	
+local function deepCopy(original)
 	-- Define the new table for the copy
 	local copy = {}
-	
+
 	-- Loop through the original table to clone
 	for key, value in original do
 		-- If the type of the value is a table, deep copy it to the key (index)
 		-- Else (or) the type isn't a table, assign the default value to the index instead
 		copy[key] = type(value) == "table" and deepCopy(value) or value
 	end
-	
+
 	-- Return the finalized copy of the deep cloned table
 	return copy
 end
@@ -329,7 +329,7 @@ local clone = deepCopy(original)
 
 ## Freezing Tables
 
-Freezing a table makes it read-only. This means that its keys can't be written to, but can be read. New keys can't be created after a table is frozen. You can check if a table is frozen by using the `Library.table.isfrozen()` method. This feature is used to create constant values which you don't want to change.
+Freezing a table makes it read-only, which is useful for creating constant values that you don't want to change. Freezing is permanent; there's no "unfreeze" or "thaw" method. To check if a table is frozen, use `Library.table.isfrozen()`.
 
 ### Shallow Freezes
 
@@ -348,7 +348,7 @@ target.playerID = 1 --> attempt to modify a readonly table
 
 ### Deep Freezes
 
-To freeze a more complex table with nested tables inside it, you'll need to use a recursive function similar to the following:
+To freeze a more complex table with nested tables inside it, use a recursive function similar to the following:
 
 ```lua
 local function deepFreeze(target)

content/en-us/avatar/resources.md

@@ -7,6 +7,10 @@ description: Use referral links to track and reward players that have successful
 This feature is still in beta. If you'd like to provide Roblox with feedback about this feature, join the [User Acquisition Referrals](https://www.guilded.gg/i/EwKQPZWE) Guilded group.
 </Alert>
 
+<iframe width="880" height="495" src="https://www.youtube-nocookie.com/embed/qfWKYgO63OI" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
+
+<br> </br>
+
 The friend referral system encourages existing players to bring new players into your experience, increasing player retention and overall engagement. Players can access and share referral links from [player invite prompts](./invite-prompts.md) or directly from the default in-experience invite menu.
 
 As a developer, you can use these shareable referral links to:

content/en-us/luau/tables.md

@@ -285,11 +285,3 @@ You can express your experience's theme through overall theme and colors to help
     <figcaption>Dark and stormy theme for a horror experience</figcaption>
   </figure>
 </GridContainer>
-
-### Keep Multiple Thumbnails Active
-
-To get the most out of your personalized thumbnails, always keep multiple thumbnails active instead of choosing one winner. This allows personalization to adapt to changing user trends.
-
-### Avoid Clickbait
-
-To avoid clickbait, make sure your thumbnail content reflects what users can expect from your experience.

content/en-us/production/promotion/referral-system.md

@@ -2,8 +2,14 @@ name: AnimationConstraint
 type: class
 category:
 memory_category: PhysicsParts
-summary: ''
-description: ''
+summary: |
+  Aligns two `Class.BasePart|BaseParts` with an animate-able kinematic or
+  force-based joint.
+description: |
+  An **AnimationConstraint** constrains its `Class.Attachment|Attachments` so
+  that they're offset by the `Class.AnimationConstraint.Transform|Transform`
+  `CFrame`. The `Class.AnimationConstraint.Transform|Transform` can be set
+  manually during `Class.RunService.PreSimulation` or by an `Class.Animator`.
 code_samples: []
 inherits:
   - Constraint
@@ -13,7 +19,10 @@ deprecation_message: ''
 properties:
   - name: AnimationConstraint.C0
     summary: ''
-    description: ''
+    description: |
+      The `Class.AnimationConstraint.Attachment0|Attachment0`
+      `Class.Attachment.CFrame|CFrame` for backwards compatibility with
+      `Class.Motor6D.C0`.
     code_samples: []
     type: CFrame
     tags:
@@ -36,7 +45,10 @@ properties:
     writeCapabilities: []
   - name: AnimationConstraint.C1
     summary: ''
-    description: ''
+    description: |
+      The `Class.AnimationConstraint.Attachment1|Attachment1`
+      `Class.Attachment.CFrame|CFrame` for backwards compatibility with
+      `Class.Motor6D.C1`.
     code_samples: []
     type: CFrame
     tags:
@@ -58,8 +70,16 @@ properties:
       - Animation
     writeCapabilities: []
   - name: AnimationConstraint.IsKinematic
-    summary: ''
-    description: ''
+    summary: |
+      Toggles whether the `Class.AnimationConstraint` is kinematic or physically
+      simulated.
+    description: |
+      When true, the connected parts follow the
+      `Class.AnimationConstraint.Transform|Transform` perfectly without
+      participating in physics simulation. When false, the connected parts
+      follow the trajectory using forces and torques limited by
+      `Class.AnimationConstraint.MaxForce` and
+      `Class.AnimationConstraint.MaxTorque`.
     code_samples: []
     type: bool
     tags: []
@@ -77,8 +97,11 @@ properties:
       - Animation
     writeCapabilities: []
   - name: AnimationConstraint.MaxForce
-    summary: ''
-    description: ''
+    summary: |
+      Maximum force magnitude the constraint can apply to achieve its goal.
+    description: |
+      Maximum force magnitude the constraint can apply to achieve its goal. Only
+      used if `Class.AnimationConstraint.IsKinematic|IsKinematic` is false.
     code_samples: []
     type: float
     tags: []
@@ -96,8 +119,11 @@ properties:
       - Animation
     writeCapabilities: []
   - name: AnimationConstraint.MaxTorque
-    summary: ''
-    description: ''
+    summary: |
+      Maximum torque the constraint can apply to reach its goal.
+    description: |
+      Maximum torque the constraint can use to reach its goal. Only used if
+      `Class.AnimationConstraint.IsKinematic|IsKinematic` is false.
     code_samples: []
     type: float
     tags: []
@@ -116,7 +142,10 @@ properties:
     writeCapabilities: []
   - name: AnimationConstraint.Part0
     summary: ''
-    description: ''
+    description: |
+      The `Class.AnimationConstraint.Attachment0|Attachment0`
+      `Class.Instance.Parent|Parent` for backwards compatibility with
+      `Class.Motor6D.Part0`.
     code_samples: []
     type: BasePart
     tags:
@@ -139,7 +168,10 @@ properties:
     writeCapabilities: []
   - name: AnimationConstraint.Part1
     summary: ''
-    description: ''
+    description: |
+      The `Class.AnimationConstraint.Attachment1|Attachment1`
+      `Class.Instance.Parent|Parent` for backwards compatibility with
+      `Class.Motor6D.Part1`.
     code_samples: []
     type: BasePart
     tags:
@@ -161,8 +193,25 @@ properties:
       - Animation
     writeCapabilities: []
   - name: AnimationConstraint.Transform
-    summary: ''
-    description: ''
+    summary: |
+      Describes the current animation offset of the `Class.AnimationConstraint`
+      joint.
+    description: |
+      The internal `Datatype.CFrame` that is manipulated when a
+      `Class.AnimationConstraint` is being animated.
+
+      ##### Timing
+
+      `Class.AnimationConstraint` transforms are not applied immediately, but
+      rather as a batch in a parallel job after
+      `Class.RunService.PreSimulation`, immediately before physics steps. The
+      deferred batch update is much more efficient than many immediate updates.
+
+      If the `Class.AnimationConstraint` is part of an animated model with an
+      `Class.Animator`, then `Class.AnimationConstraint.Transform` is usually
+      overwritten every frame by the `Class.Animator` after
+      `Class.RunService.PreAnimation` and before
+      `Class.RunService.PreSimulation`.
     code_samples: []
     type: CFrame
     tags: []

content/en-us/production/publishing/thumbnails.md

@@ -10,6 +10,62 @@ inherits:
 tags: []
 deprecation_message: ''
 properties: []
-methods: []
-events: []
+methods:
+  - name: Annotation:GetRequests
+    summary: ''
+    description: ''
+    code_samples: []
+    parameters: []
+    returns:
+      - type: Dictionary
+        summary: ''
+    tags: []
+    deprecation_message: ''
+    security: RobloxScriptSecurity
+    thread_safety: Unsafe
+    capabilities: []
+    writeCapabilities: []
+events:
+  - name: Annotation.RequestCompleted
+    summary: ''
+    description: ''
+    code_samples: []
+    parameters:
+      - name: requestId
+        type: string
+        default:
+        summary: ''
+      - name: requestType
+        type: AnnotationRequestType
+        default:
+        summary: ''
+      - name: result
+        type: AnnotationRequestResult
+        default:
+        summary: ''
+    tags: []
+    deprecation_message: ''
+    security: RobloxScriptSecurity
+    thread_safety: Unsafe
+    capabilities: []
+    writeCapabilities: []
+  - name: Annotation.RequestInitiated
+    summary: ''
+    description: ''
+    code_samples: []
+    parameters:
+      - name: requestId
+        type: string
+        default:
+        summary: ''
+      - name: requestType
+        type: AnnotationRequestType
+        default:
+        summary: ''
+    tags: []
+    deprecation_message: ''
+    security: RobloxScriptSecurity
+    thread_safety: Unsafe
+    capabilities: []
+    writeCapabilities: []
 callbacks: []

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

@@ -116,8 +116,9 @@ methods:
     description: |
       Returns the frequency spectrum of the last audio buffer, as an array of
       numbers. The elements of the array are root-mean-square volume levels,
-      evenly spaced from 0 hertz to 24,000 hertz.
-      If any of the analyzer's inputs come from an `Class.AudioDeviceInput`, this method returns an empty array.
+      evenly spaced from 0 hertz to 24,000 hertz. If any of the analyzer's
+      inputs come from an `Class.AudioDeviceInput`, this method returns an empty
+      array.
     code_samples: []
     parameters: []
     returns: