update Open Source Docs from Roblox internal teams

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

content/en-us/luau/tables.md

@@ -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/production/promotion/referral-system.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/production/publishing/thumbnails.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/reference/engine/classes/AnimationConstraint.yaml

@@ -2,8 +2,13 @@ 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 +18,8 @@ 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 +42,8 @@ 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 +65,11 @@ 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 +87,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 +109,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 +132,8 @@ 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 +156,8 @@ 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 +179,24 @@ 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/reference/engine/classes/EditableMesh.yaml

@@ -234,7 +234,8 @@ methods:
           ID of the third vertex of the triangle.
     returns:
       - type: int64
-        summary: ''
+        summary: |
+          Stable face ID of the new face.
     tags: []
     deprecation_message: ''
     security: None
@@ -392,7 +393,8 @@ methods:
         summary: ''
     returns:
       - type: Array
-        summary: ''
+        summary: |
+          List of face IDs adjacent to the given face.
     tags: []
     deprecation_message: ''
     security: None
@@ -430,7 +432,8 @@ methods:
     parameters: []
     returns:
       - type: Vector3
-        summary: ''
+        summary: |
+          Center of the bounding box of the `EditableMesh`.
     tags: []
     deprecation_message: ''
     security: None
@@ -569,8 +572,10 @@ methods:
     capabilities: []
     writeCapabilities: []
   - name: EditableMesh:GetFaceVertices
-    summary: ''
-    description: ''
+    summary: |
+      Returns the face's vertex IDs.
+    description: |
+      Returns the face's vertex IDs.
     code_samples: []
     parameters:
       - name: faceId
@@ -579,7 +584,8 @@ methods:
         summary: ''
     returns:
       - type: Array
-        summary: ''
+        summary: |
+          List of vertex IDs around the given face.
     tags:
       - CustomLuaState
     deprecation_message: ''
@@ -596,7 +602,8 @@ methods:
     parameters: []
     returns:
       - type: Array
-        summary: ''
+        summary: |
+          List of stable face IDs.
     tags:
       - CustomLuaState
     deprecation_message: ''
@@ -696,7 +703,8 @@ methods:
     parameters: []
     returns:
       - type: Vector3
-        summary: ''
+        summary: |
+          Size of the `EditableMesh`.
     tags: []
     deprecation_message: ''
     security: None

tools/checks/utils/allowedHttpLinks.txt

@@ -575,3 +575,4 @@ https://impactacademies.cz/
 https://impactacademies.de/
 https://impactacademies.me/
 https://www.youtube-nocookie.com/embed/5NvGzKVyKxg
+https://www.youtube-nocookie.com/embed/qfWKYgO63OI