Merge branch 'main' into patch-4

Author: karl-police

content/en-us/production/promotion/ads-manager.md

@@ -84,14 +84,18 @@ To create an ad campaign with the new Ads Manager:
 
 1. Go to **Manage Ads** and click **Create Campaign**.
 2. Under **Experience**, select the experience you want players to join when they click on your ad.
-3. Under **Goal & Name**, enter a name for the campaign. Currently, the only goal available is **Maximize plays**, which gets you the most plays at the lowest cost.
+3. Under **Goal & Name**, enter a campaign name and select one of the following goals for the campaign:
+    - **Maximize Plays** to get the most plays at the lowest cost.
+    - **Drive Retention** to turn visitors into regulars by re-engaging recent new players.
+    - **Reactivate Users** to reach players who have played your experience in the last 180 days but who haven't played in the last 30 days.
 4. Under **Budget & Schedule**:
     1. Choose between a **Daily Budget** and a **Lifetime Budget**.
     2. Select a **Payment Method**. If you're using ad credits, make sure the campaign budget does not exceed the available ad credits in your account.
     3. Set a **Duration** for your campaign.
     4. Set a **Start Date** and a **Start Time** for your campaign.
 5. Under **Creative**, choose up to 5 thumbnails to show on players' Home page.
-6. Click **Publish** and confirm submission. Your ad campaign will go live after it's approved by the moderation team.
+6. (Optional) Under **Audience Targeting**, customize the campaign's reach by only showing ads to players in specific locations and using specific devices.
+7. Click **Publish** and confirm submission. Your ad campaign will go live after it's approved by the moderation team.
 
 <Alert severity="info">
    Roblox tries to complete moderation within 24 hours for each ad submitted. Ads that do not pass moderation show the status of rejected.

content/en-us/production/promotion/content-maturity.md

@@ -10,7 +10,7 @@ Content maturity consists of two components:
 - **Content maturity label** - Indicates the level of maturity suitable for the experience according to child development research and industry standards.
 - **Content descriptors** - Indicates what type of content is within an experience, such as realistic depictions of blood or paid item trading.
 
-If an experience does not have guidelines, Roblox restricts the playability of the experience on the platform for players younger than 13. In addition, experiences without guidelines cannot contain any [Restricted content](https://en.help.roblox.com/hc/en-us/articles/15869919570708-Roblox-17-Policy-Standards) without risk of moderation. For this reason, Roblox strongly recommends that you fill out the questionnaire for each of your experiences so that they're available to the largest appropriate audience as possible.
+If an experience does not have accurate or all content maturity information, Roblox restricts the playability of the experience on the platform for players younger than 13. In addition, experiences without content maturity information cannot contain any [Restricted content](https://en.help.roblox.com/hc/en-us/articles/15869919570708-Roblox-17-Policy-Standards) without risk of moderation. For this reason, Roblox strongly recommends that you fill out the questionnaire for each of your experiences so that they're available to the largest appropriate audience as possible.
 
 <Alert severity="warning">
    Content descriptors that generate content maturity labels are separate from [genres](../publishing/experience-genres.md) that classify experiences according to their core gameplay. In cases where there is overlap between genres and in-experience content or behavior, answer the Maturity & Compliance questionnaire as accurately as you can regardless of your genre selection or assignment from Roblox.
@@ -424,4 +424,14 @@ Roblox relies on the information you provide in the Maturity & Compliance Questi
 - Roblox provides a moderation action.
   - If your experience contains restricted content without a Restricted maturity label, your experience is subject to moderation consequences.
   - If your experience contains content that is prohibited by Roblox's [Community Standards](https://en.help.roblox.com/hc/en-us/articles/203313410), [Terms of Use](https://en.help.roblox.com/hc/articles/115004647846), or [Restricted Content Policy](https://en.help.roblox.com/hc/articles/15869919570708), your experience is subject to moderation consequences.
-  - If your experience otherwise has inaccurate content maturity information according to its content, Roblox may remove the maturity label (or only some or all descriptors if the maturity label is Restricted) from your experience. If an experience does not have guidelines, Roblox restricts the playability of the experience on the platform for players younger than 13.
+  - If your experience otherwise has inaccurate content maturity information according to its content, Roblox may remove the maturity label (or only some or all descriptors if the maturity label is Restricted) from your experience. If an experience does not have content maturity information, Roblox restricts the playability of the experience on the platform for players younger than 13.
+  - If you repeatedly include inaccurate content maturity information, **your experience and/or account is subject to moderation consequences**.
+
+If receive a moderation action and believe Roblox made a mistake, you can appeal the decision:
+
+   1. Navigate to [roblox.com/support](http://roblox.com/support).
+   1. After you confirm your contact information and device type,
+      1. Set **Type of help category** to **Moderation**. A new dropdown menu displays.
+      1. Set **Help Subcategory Type** to **I was wrongly moderated for other content I created**.
+      1. In the input field, describe why the moderation action was a mistake.
+   1. Click the **Continue** button to submit your appeal.

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

@@ -1,8 +1,15 @@
 name: InputAction
 type: class
 memory_category: Instances
-summary: ''
-description: ''
+summary: |
+  Defines a gameplay action mechanic. These actions are then mapped to hardware
+  inputs using `Class.InputBinding`.
+description: |
+  `InputAction` defines a gameplay action mechanic such as "Jump," "Sprint," or
+  "Shoot." These actions are then mapped to hardware inputs using
+  `Class.InputBinding`. An `InputAction` will check for its first ancestor type
+  of `Class.InputContext` and register itself to that context (if there is no
+  ancestor context, it will be registered to a default context).
 code_samples: []
 inherits:
   - Instance
@@ -11,8 +18,11 @@ tags:
 deprecation_message: ''
 properties:
   - name: InputAction.Enabled
-    summary: ''
-    description: ''
+    summary: |
+      Determines if the `InputAction` is enabled or not.
+    description: |
+      Determines if the `InputAction` is enabled or not. The action state will
+      be reset if this property is toggled to `false`.
     code_samples: []
     type: boolean
     tags: []
@@ -28,8 +38,11 @@ properties:
     capabilities: []
     writeCapabilities: []
   - name: InputAction.Type
-    summary: ''
-    description: ''
+    summary: |
+      Specifies what type of input value the action is expecting.
+    description: |
+      Specifies what type of input value the action is expecting. See
+      `Enum.InputActionType` for more details.
     code_samples: []
     type: InputActionType
     tags: []
@@ -46,14 +59,36 @@ properties:
     writeCapabilities: []
 methods:
   - name: InputAction:Fire
-    summary: ''
-    description: ''
+    summary: |
+      Updates the `InputAction` to the given state and fires the appropriate
+      signals.
+    description: |
+      Updates the `InputAction` to the given state and fires the appropriate
+      signals. This method is most useful for script‑triggered "input" where the
+      passed `state` should trigger events like
+      `Class.InputAction.Pressed|Pressed` or
+      `Class.InputAction.StateChanged|StateChanged` regardless of whether the
+      player triggered that state through normal inputs.
+      
+      This method will only accept a `state` parameter that matches the
+      `Class.InputAction.Type|Type` and attempting to call it with a mismatched
+      type will cause an error, for example passing a state of `0.5` when the
+      `Class.InputAction.Type|Type` is `Enum.InputActionType|Bool`.
+
+      Note that this method follows the conditions of
+      `Class.InputAction.Pressed|Pressed`,
+      `Class.InputAction.Released|Released`, and
+      `Class.InputAction.StateChanged|StateChanged`. For example, if you make
+      multiple consecutive calls to `Fire()` with a state of `true`,
+      `Class.InputAction.StateChanged|StateChanged` will only fire on the first
+      state change and the subsequent calls to `Fire()` will do nothing.
     code_samples: []
     parameters:
       - name: value
         type: Variant
         default: ''
-        summary: ''
+        summary: |
+          Value to which to update the `InputAction`.
     returns:
       - type: ()
         summary: ''
@@ -64,13 +99,18 @@ methods:
     capabilities: []
     writeCapabilities: []
   - name: InputAction:GetState
-    summary: ''
-    description: ''
+    summary: |
+      Returns the current state of the `Class.InputAction`.
+    description: |
+      Returns the current state of the `Class.InputAction`, for example `true`
+      for an action with `Class.InputAction.Type|Type` set to
+      `Enum.InputActionType|Bool`.
     code_samples: []
     parameters: []
     returns:
       - type: Variant
-        summary: ''
+        summary: |
+          The current state of `Class.InputAction`.
     tags: []
     deprecation_message: ''
     security: None
@@ -79,8 +119,13 @@ methods:
     writeCapabilities: []
 events:
   - name: InputAction.Pressed
-    summary: ''
-    description: ''
+    summary: |
+      Fires only when the `Class.InputAction.Type` is set to
+      `Enum.InputActionType|Bool` on a state transition from `false` to `true`.
+    description: |
+      This event fires only when the `Class.InputAction.Type|Type` is set to
+      `Enum.InputActionType|Bool`, and only when the state transitions from
+      `false` to `true`.
     code_samples: []
     parameters: []
     tags: []
@@ -89,8 +134,13 @@ events:
     capabilities: []
     writeCapabilities: []
   - name: InputAction.Released
-    summary: ''
-    description: ''
+    summary: |
+      Fires only when the `Class.InputAction.Type` is set to
+      `Enum.InputActionType|Bool` on a state transition from `true` to `false`.
+    description: |
+      This event fires only when the `Class.InputAction.Type|Type` is set to
+      `Enum.InputActionType|Bool`, and only when the state transitions from
+      `true` to `false`.
     code_samples: []
     parameters: []
     tags: []
@@ -99,14 +149,19 @@ events:
     capabilities: []
     writeCapabilities: []
   - name: InputAction.StateChanged
-    summary: ''
-    description: ''
+    summary: |
+      Fires for all `Enum.InputActionType` types whenever the state changes,
+      except if the state attempts to transition to the same state.
+    description: |
+      This event fires for all `Enum.InputActionType` types whenever the state
+      changes, except if the state attempts to transition to the same state.
     code_samples: []
     parameters:
       - name: value
         type: Variant
         default: ''
-        summary: ''
+        summary: |
+          The new state of the `Class.InputAction`.
     tags: []
     deprecation_message: ''
     security: None