update Open Source Docs from Roblox internal teams

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

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

@@ -39,10 +39,10 @@ To implement a referral system, [set up a referral event](#set-up-a-referral-eve
 ```lua
 function onPlayerAdded(player)
 
-	local referredByPlayerId = player:GetJoinData().ReferredByPlayerId
+    local referredByPlayerId = player:GetJoinData().ReferredByPlayerId
 
-	local referrerEvent: RemoteEvent = ReplicatedStorage:FindFirstChild("ReferralReceivedEvent")
-	referrerEvent:FireClient(player, referredByPlayerId)
+    local referrerEvent: RemoteEvent = ReplicatedStorage:FindFirstChild("ReferralReceivedEvent")
+    referrerEvent:FireClient(player, referredByPlayerId)
 end
 
 Players.PlayerAdded:Connect(onPlayerAdded)
@@ -159,23 +159,45 @@ You can implement safeguards to prevent players from exploiting the friend refer
 - Monitor unusual activity and implement corrective measures like banning users or canceling rewards.
 
 ```lua
--- Table to track players who have already been referred
-local referredPlayers = {}
+local DataStoreService = game:GetService("DataStoreService")
+local Players = game:GetService("Players")
 
-function onPlayerAdded(player)
+-- Create or get the datastore for referrals
+local referralDataStore = DataStoreService:GetDataStore("ReferralDataStore")
+
+-- Function to check and mark referral
+local function onPlayerAdded(player)
     local joinData = player:GetJoinData()
     local referredByPlayerId = joinData.ReferredByPlayerId
 
-    -- Check if the player was invited and has not already used a referral
-    if referredByPlayerId and referredByPlayerId ~= 0 and not referredPlayers[player.UserId] then
-        -- Mark the player as referred
-        referredPlayers[player.UserId] = true
+    -- Load player's referral data
+    local success, alreadyReferred = pcall(function()
+        return referralDataStore:GetAsync(tostring(player.UserId))
+    end)
+
+    if not success then
+        warn("Failed to get referral data for player:", player.UserId)
+        return
+    end
 
+    if referredByPlayerId and not alreadyReferred then
         -- Reward inviter and invitee
         rewardReferrer(referredByPlayerId)
         rewardInvitee(player)
+
+        -- Mark the player as referred in DataStore
+        local saveSuccess, err = pcall(function()
+            referralDataStore:SetAsync(tostring(player.UserId), true)
+        end)
+
+        if not saveSuccess then
+            warn("Failed to save referral status for player:", player.UserId, err)
+        end
     end
 end
+
+-- Connect the function to the player joining
+Players.PlayerAdded:Connect(onPlayerAdded)
 ```
 
 ## Best practices

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

@@ -21,7 +21,7 @@ description: |
   Note: If there are two matching `Attachments`, the resulting `Class.Weld` is a
   child of the Accessory's Handle. This differs from the legacy behavior of Hats
   where the Weld is always a child of the Head of the character.
-code_samples:
+code_samples: []
 inherits:
   - Accoutrement
 tags: []
@@ -37,7 +37,7 @@ properties:
       `Class.Humanoid:ApplyDescription()`. If available on the Marketplace, you
       can set `Enum.AccessoryType` to categorize the Accessory item (for
       example, "Hat" or "Face").
-    code_samples:
+    code_samples: []
     type: AccessoryType
     tags: []
     deprecation_message: ''

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

@@ -22,7 +22,7 @@ description: |
   accoutrement welds to another part that is massless or one if its parts
   otherwise becomes root. This also doesn't apply for the root part, and it has
   mass like a normal part.
-code_samples:
+code_samples: []
 inherits:
   - Instance
 tags: []
@@ -33,7 +33,7 @@ properties:
       Sets the offset position of the object on the Player.
     description: |
       Sets the offset position of the object on the Player.
-    code_samples:
+    code_samples: []
     type: Vector3
     tags:
       - Hidden
@@ -55,7 +55,7 @@ properties:
       The exact CFrame of the Accoutrement.
     description: |
       The exact CFrame of the Accoutrement.
-    code_samples:
+    code_samples: []
     type: CFrame
     tags: []
     deprecation_message: ''
@@ -75,7 +75,7 @@ properties:
       Sets the position of the object on the Player.
     description: |
       Sets the position of the object on the Player.
-    code_samples:
+    code_samples: []
     type: Vector3
     tags:
       - Hidden
@@ -97,7 +97,7 @@ properties:
       Sets the offset position of the object on the Player.
     description: |
       Sets the offset position of the object on the Player.
-    code_samples:
+    code_samples: []
     type: Vector3
     tags:
       - Hidden
@@ -119,7 +119,7 @@ properties:
       Sets the offset position of the object on the Player.
     description: |
       Sets the offset position of the object on the Player.
-    code_samples:
+    code_samples: []
     type: Vector3
     tags:
       - Hidden

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

@@ -12,7 +12,7 @@ description: |
 
   To learn more about using multiple Actors to optimize script performance, see
   [Parallel Luau](../../../scripting/multithreading.md).
-code_samples:
+code_samples: []
 inherits:
   - Model
 tags: []
@@ -43,7 +43,7 @@ methods:
         print("Received Greeting Message:", message)
       end)
       ```
-    code_samples:
+    code_samples: []
     parameters:
       - name: topic
         type: string
@@ -89,7 +89,7 @@ methods:
         print("Received Greeting Message:", message)
       end)
       ```
-    code_samples:
+    code_samples: []
     parameters:
       - name: topic
         type: string
@@ -129,7 +129,7 @@ methods:
       -- Assume `actor` is a local variable referring to an Actor instance
       actor:SendMessage("Greeting", "Hello World")
       ```
-    code_samples:
+    code_samples: []
     parameters:
       - name: topic
         type: string

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

@@ -9,7 +9,7 @@ description: |
   of monetization. It has been superseded by
   [Immersive Ads](../../../production/monetization/immersive-ads.md) which
   should be used instead to serve ad units to visitors of your experience.
-code_samples:
+code_samples: []
 inherits:
   - Instance
 tags:
@@ -42,7 +42,7 @@ methods:
       Show mobile video advertisements.
     description: |
       Show mobile video advertisements.
-    code_samples:
+    code_samples: []
     parameters: []
     returns:
       - type: ()
@@ -105,7 +105,7 @@ events:
       Fires when an `Class.AdService` video closes.
     description: |
       Fires when an `Class.AdService` video closes.
-    code_samples:
+    code_samples: []
     parameters:
       - name: adShown
         type: boolean

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

@@ -7,7 +7,7 @@ summary: |
 description: |
   An unfinished advanced variant of the `Class.Dragger` class. Internally, this
   object is an identical implementation of the Dragger class.
-code_samples:
+code_samples: []
 inherits:
   - Instance
 tags: []

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

@@ -52,7 +52,7 @@ description: |
 
   This constraint can use either **one** or **two** attachments in calculating
   its goal. See `Class.AlignOrientation.Mode|Mode` for details.
-code_samples:
+code_samples: []
 inherits:
   - Constraint
 tags: []
@@ -69,7 +69,7 @@ properties:
       `Enum.AlignType|PrimaryAxisLookAt`. The constraint will attempt to
       maintain the specified relationship, as given by the `Enum.AlignType`, by
       applying torques onto the relevant axes.
-    code_samples:
+    code_samples: []
     type: AlignType
     tags: []
     deprecation_message: ''
@@ -94,7 +94,7 @@ properties:
       `Class.Constraint.Attachment0|Attachment0`. Only used when
       `Class.AlignOrientation.Mode|Mode` is set to
       `Enum.OrientationAlignmentMode|OneAttachment`.
-    code_samples:
+    code_samples: []
     type: CFrame
     tags: []
     deprecation_message: ''
@@ -146,7 +146,7 @@ properties:
       as well as `Class.AlignOrientation.MaxTorque|MaxTorque`, are **caps** to
       the angular velocity and torque respectively. The actual scale is
       determined by `Class.AlignOrientation.Responsiveness|Responsiveness`.
-    code_samples:
+    code_samples: []
     type: float
     tags: []
     deprecation_message: ''
@@ -172,7 +172,7 @@ properties:
       `Class.AlignOrientation.MaxAngularVelocity|MaxAngularVelocity`, are
       **caps** to the torque and angular velocity respectively. The actual scale
       is determined by `Class.AlignOrientation.Responsiveness|Responsiveness`.
-    code_samples:
+    code_samples: []
     type: float
     tags: []
     deprecation_message: ''
@@ -211,7 +211,7 @@ properties:
       `Class.AlignOrientation.PrimaryAxis|PrimaryAxis` and
       `Class.AlignOrientation.SecondaryAxis|SecondaryAxis` properties
       respectively.
-    code_samples:
+    code_samples: []
     type: OrientationAlignmentMode
     tags: []
     deprecation_message: ''
@@ -234,7 +234,7 @@ properties:
       The direction of the goal's **X** axis, represented as a unit
       `Datatype.Vector3`. Only used when `Class.AlignOrientation.Mode|Mode` is
       `Enum.OrientationAlignmentMode|OneAttachment`.
-    code_samples:
+    code_samples: []
     type: Vector3
     tags:
       - NotReplicated
@@ -261,7 +261,7 @@ properties:
 
       Enabling `Class.AlignOrientation.PrimaryAxisOnly|PrimaryAxisOnly` also
       enables the `Class.AlignOrientation.AlignType|AlignType` property.
-    code_samples:
+    code_samples: []
     type: boolean
     tags: []
     deprecation_message: |
@@ -292,7 +292,7 @@ properties:
       `Class.Constraint.Attachment1|Attachment1` remains unaffected. If true,
       the constraint applies torque to both attachments in **equal and opposite
       directions**.
-    code_samples:
+    code_samples: []
     type: boolean
     tags: []
     deprecation_message: ''
@@ -314,7 +314,7 @@ properties:
     description: |
       Controls how quickly the constraint reaches its goal. Higher values cause
       the attachment(s) to align more rapidly. Value can be between 5 and 200.
-    code_samples:
+    code_samples: []
     type: float
     tags: []
     deprecation_message: ''
@@ -341,7 +341,7 @@ properties:
       `Class.AlignOrientation.MaxAngularVelocity|MaxAngularVelocity`, and
       `Class.AlignOrientation.Responsiveness|Responsiveness`. If true, the
       physics solver reacts as quickly as possible to complete the alignment.
-    code_samples:
+    code_samples: []
     type: boolean
     tags: []
     deprecation_message: ''
@@ -364,7 +364,7 @@ properties:
       The direction of the goal's **Y** axis, represented as a unit
       `Datatype.Vector3`. Only used when `Class.AlignOrientation.Mode|Mode` is
       `Enum.OrientationAlignmentMode|OneAttachment`.
-    code_samples:
+    code_samples: []
     type: Vector3
     tags:
       - NotReplicated

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

@@ -48,7 +48,7 @@ description: |
 
   This constraint can use either **one** or **two** attachments in calculating
   its goal. See `Class.AlignPosition.Mode|Mode` for details.
-code_samples:
+code_samples: []
 inherits:
   - Constraint
 tags: []
@@ -65,7 +65,7 @@ properties:
       meaning that if the parent's center of mass is not aligned with the
       direction of the force, torque will be applied as well as force. When
       true, force is applied at the parents' center of mass.
-    code_samples:
+    code_samples: []
     type: boolean
     tags: []
     deprecation_message: ''
@@ -181,7 +181,7 @@ properties:
       `Class.AlignPosition.MaxVelocity|MaxVelocity`, are **caps** to the force
       and velocity respectively. The actual scale is determined by
       `Class.AlignPosition.Responsiveness|Responsiveness`.
-    code_samples:
+    code_samples: []
     type: float
     tags: []
     deprecation_message: ''
@@ -207,7 +207,7 @@ properties:
       `Class.AlignPosition.MaxForce|MaxForce`, are **caps** to the velocity and
       force respectively. The actual scale is determined by
       `Class.AlignPosition.Responsiveness|Responsiveness`.
-    code_samples:
+    code_samples: []
     type: float
     tags: []
     deprecation_message: ''
@@ -238,7 +238,7 @@ properties:
       disregards `Class.Constraint.Attachment1|Attachment1` and attempts to move
       `Class.Constraint.Attachment0|Attachment0` to
       `Class.AlignPosition.Position|Position`.
-    code_samples:
+    code_samples: []
     type: PositionAlignmentMode
     tags: []
     deprecation_message: ''
@@ -263,7 +263,7 @@ properties:
       `Class.AlignPosition.Mode|Mode` is set to
       `Enum.PositionAlignmentMode|OneAttachment`, in which case
       `Class.Constraint.Attachment1|Attachment1` is disregarded.
-    code_samples:
+    code_samples: []
     type: Vector3
     tags: []
     deprecation_message: ''
@@ -289,7 +289,7 @@ properties:
       `Class.Constraint.Attachment1|Attachment1` remains unaffected. If true,
       the constraint applies force to both attachments in **equal and opposite
       directions**.
-    code_samples:
+    code_samples: []
     type: boolean
     tags: []
     deprecation_message: ''
@@ -311,7 +311,7 @@ properties:
     description: |
       Controls how quickly the constraint reaches its goal. Higher values cause
       the attachment(s) to align more rapidly. Value can be between 5 and 200.
-    code_samples:
+    code_samples: []
     type: float
     tags: []
     deprecation_message: ''
@@ -338,7 +338,7 @@ properties:
       `Class.AlignPosition.MaxVelocity|MaxVelocity`, and
       `Class.AlignPosition.Responsiveness|Responsiveness`. If true, the physics
       solver reacts as quickly as possible to complete the alignment.
-    code_samples:
+    code_samples: []
     type: boolean
     tags: []
     deprecation_message: ''