update Open Source Docs from Roblox internal teams

rbx-open-source-docs[bot] · rbx-open-source-docs[bot] · commit 0260950bface · 2025-02-04T02:29:45.000Z
diff --git a/content/en-us/art/accessories/creating-rigid/importing.md b/content/en-us/art/accessories/creating-rigid/importing.md
@@ -37,7 +37,6 @@ If textures didn't load correctly, add them manually with the Asset Manager.
 
 </AccordionDetails>
 </BaseAccordion>
-<br />
 
 <Alert severity = 'success'>
 After successful import, your model object should populate in your project as a `Class.Model` with the appropriate textures applied. See [3D Importer](../../../art/modeling/3d-importer.md) for additional information on import settings and troubleshooting.
diff --git a/content/en-us/art/accessories/import-clothing.md b/content/en-us/art/accessories/import-clothing.md
@@ -56,8 +56,6 @@ To import your asset:
 </AccordionDetails>
 </BaseAccordion>
 
-<br />
-
 <Alert severity = 'success'>
 After successful import, your model object should populate in your project as a `Class.Model` with the appropriate textures applied. See [3D Importer](../../art/modeling/3d-importer.md) for additional information on import settings and troubleshooting.
 </Alert>
diff --git a/content/en-us/art/accessories/importing.md b/content/en-us/art/accessories/importing.md
@@ -55,7 +55,6 @@ If textures didn't load correctly, add them manually. You may need to save and p
 
 </AccordionDetails>
 </BaseAccordion>
-<br />
 
 <Alert severity = 'success'>
 After successful import, your model object should populate in your project as a `Class.Model` with the appropriate textures applied. See [3D Importer](../../art/modeling/3d-importer.md) for additional information on import settings and troubleshooting.
diff --git a/content/en-us/art/characters/import.md b/content/en-us/art/characters/import.md
@@ -60,8 +60,6 @@ To import your asset:
 </AccordionDetails>
 </BaseAccordion>
 
-<br />
-
 <Alert severity = 'success'>
 After successful import, your model object should populate in your project as a `Class.Model` with the appropriate textures applied.
 </Alert>
diff --git a/content/en-us/art/classic-clothing.md b/content/en-us/art/classic-clothing.md
@@ -126,8 +126,6 @@ Table of sizes for each template part
 </AccordionDetails>
 </BaseAccordion>
 
-<br />
-
 ## Creating classic clothing
 
 To begin creating classic clothing:
diff --git a/content/en-us/assets/game-design/introduction-to-quest-design/quest-design-3.png b/content/en-us/assets/game-design/introduction-to-quest-design/quest-design-3.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:18fdd024b224fddbcc92fc05edb6c5b1802618ec3087f5d705809859bd52b99c
-size 2580290
+oid sha256:9d340c80a98ee656137932532ba606ef9dd481e5e3f90e9f71993b680fd43771
+size 1669088
diff --git a/content/en-us/assets/game-design/introduction-to-quest-design/quest-design-7.png b/content/en-us/assets/game-design/introduction-to-quest-design/quest-design-7.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:8ffee7bcda9c18f6b3d0f065658f31b0e381b8af754817db3ac4fc987da2b4c2
-size 1933779
+oid sha256:7ba2ee2844f3b9450bfb896c21a08e8306e45a711e3807fc960df9535dda2f35
+size 1358292
diff --git a/content/en-us/assets/ui/rich-text/Example-Highlighted.png b/content/en-us/assets/ui/rich-text/Example-Highlighted.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:652bf501a3da94af91df4cdeef67cb1b246b570f83a6627c8c57dee01ed19b66
+size 14990
diff --git a/content/en-us/avatar/tutorials.md b/content/en-us/avatar/tutorials.md
@@ -26,9 +26,7 @@ Learn how to create assets with structured tutorials that walks through each cre
   and configure Roblox Studio.
 
 </AccordionDetails>
-  </BaseAccordion>
-
-<br /> <br />
+</BaseAccordion>
 
 <Card>
 <CardContent>
diff --git a/content/en-us/chat/guidelines.md b/content/en-us/chat/guidelines.md
@@ -11,7 +11,7 @@ In-experience text chat is any message created within your experience that origi
 - Chat window communication between users
 - Team-specific messages
 
-For sending and delivery, these types of communications must each go through a `Class.TextChannel` instance. This ensures messages respect privacy settings, are visible to moderators, and are properly text filtered.
+For sending and delivery, these types of communications must each go through a `Class.TextChannel` instance. This ensures messages respect privacy settings, are visible to moderators, and are properly text-filtered.
 
 Certain text is **not** considered chat:
 
@@ -40,6 +40,17 @@ For communication shared by users that can be seen by other users, even if it do
   - For more information on migrating, see the [Roblox developer forums](https://devforum.roblox.com/t/migrate-to-textchatservice-removing-support-for-legacy-chat-and-custom-chat-systems/3237100).
 - All incoming text that originates from another user must first use [Text Filtering](../ui/text-filtering.md) before your experience displays it.
 - Communication between users must respect user privacy settings.
-  - `Class.TextChannel:SendAsync` handles basic privacy and parental settings automatically.
-  - `Class.TextChannel:SetDirectChatRequester` must be used to mark `TextChannels` created for direct chat.
+  - `Class.TextChannel:SendAsync()` handles basic privacy and parental settings automatically.
+  - `Class.TextChannel:SetDirectChatRequester()` must be used to mark `TextChannels` created for direct chat.
 - In-experience communication should be [reportable for abuse](https://en.help.roblox.com/hc/en-us/articles/203312410-How-to-Report-Rule-Violations). `TextChannels` handle this automatically.
+
+## Respect privacy settings
+
+Users can have different levels of access to communication features based on their [privacy and content maturity settings](https://www.roblox.com/my/account#!/privacy/Communication/ExperienceChat) or parental controls. Some users might have additional restrictions or constraints depending on which app store they used to install Roblox or their local laws.
+
+The following methods respect these requirements. Use them within your experience to determine how to handle messaging requests:
+
+- `Class.TextChannel:SetDirectChatRequester()`
+- `Class.TextChatService:CanUserChatAsync()`
+- `Class.TextChatService:CanUsersChatAsync()`
+- `Class.TextChatService:CanUsersDirectChatAsync()`
diff --git a/content/en-us/creator-programs/index.md b/content/en-us/creator-programs/index.md
@@ -169,8 +169,8 @@ Roblox offers various programs for creators on the platform to provide additiona
     <h4>Inspire</h4>
         <figure>
     <Chip
-        color="error"
-        label="Status: Closed"
+        color="success"
+        label="Status: Open"
         size="medium"
         variant="filled"/>
     </figure>
diff --git a/content/en-us/creator-programs/inspire.md b/content/en-us/creator-programs/inspire.md
@@ -5,12 +5,12 @@ description: Inspire is an annual global online event where creators come togeth
 
 Inspire is an annual global online event where creators come together to exchange ideas, learn from workshops led by top creators, and collaborate to boost connections within the community. By participating, you can share your knowledge and host workshops for the broader creator community.
 
-See [Roblox Level Up](https://www.youtube.com/@RobloxLevelUp) for content from Inspire 2024.
+See [Roblox Learn](https://www.youtube.com/@RobloxLearnOfficial) for content from Inspire 2024.
 
 <figure>
 <Chip
-    color="error"
-    label="Status: Closed"
+    color="success"
+    label="Status: Open"
     size="medium"
     variant="filled"/>
 </figure>
@@ -23,10 +23,9 @@ See [Roblox Level Up](https://www.youtube.com/@RobloxLevelUp) for content from I
 
 ## How to participate
 
-- Fill out an application
-- Submit a workshop proposal
-- If picked, join a Zoom call where a DevRel team member can further assess expertise on your chosen topic, alongside your public speaking skills
-- Prepare workshop and present at Inspire
+- Fill out [this survey](https://survey.roblox.com/jfe/form/SV_3XbrWPyHsu4Q742) by February 28, 2025.
+- If picked, join a Zoom call where a DevRel team member can further assess expertise on your chosen topic, alongside your public speaking skills.
+- Prepare your workshop and present at Inspire.
 
 ## Contact info
 
diff --git a/content/en-us/get-started.md b/content/en-us/get-started.md
@@ -202,7 +202,7 @@ Learn, share, and interact with the Roblox community in the following places.
     <img src="/assets/landing/get-started/video-interviews.jpg" style={{position: "absolute", top: 0, left: 0, width: "100%", height: "100%"}}/>
   </div>
   <Typography variant='h4'>On social video channels</Typography>
-  <a href="https://www.youtube.com/@RobloxLevelUp"><Typography variant='buttonLarge' style={{marginBottom: 12}}> YouTube channel</Typography></a>
+  <a href="https://www.youtube.com/@RobloxLearnOfficial"><Typography variant='buttonLarge' style={{marginBottom: 12}}> YouTube channel</Typography></a>
   <a href="https://events.roblox.com"><Typography variant='buttonLarge' style={{marginBottom: 12}}>Content and events platform</Typography></a>
 </Grid>
 </Grid>
diff --git a/content/en-us/includes/engine-comparisons/script-locations.md b/content/en-us/includes/engine-comparisons/script-locations.md
@@ -9,7 +9,7 @@ ReplicatedFirst | Contains objects that replicate to the client before anything
 ReplicatedStorage | Contains objects that are replicated to both the client and the server. This location is ideal for `Class.ModuleScript\|ModuleScripts` that you want to use on both the server and the client. `Class.LocalScript\|LocalScripts` do not run from this location, but `Class.Script\|Scripts` with a run context of `Client` do.
 ServerScriptService | Contains server-side scripts. This location is ideal for scripts that need to access server-side functionality or objects, such as game logic and cloud storage.
 ServerStorage | Contains server-side objects. This location is ideal for large objects that don't need to be immediately replicated to clients when they join an experience. Scripts do not run from this location, but you can store server-side `Class.ModuleScript\|ModuleScripts` here.
-StarterPlayer.StarterCharacterScripts | Contains `Class.LocalScript\|LocalScripts` that run when the character first spawns. These scripts do **not** run again when the player respawns.
+StarterPlayer.StarterCharacterScripts | Contains `Class.LocalScript\|LocalScripts` that run when the character spawns.
 StarterPlayer.StarterPlayerScripts | Contains general-purpose `Class.LocalScript\|LocalScripts` that run when the player joins the experience.
 StarterGui | Contains GUI elements that the client displays when it loads the game. `Class.LocalScript\|LocalScripts` can run from this location. This location is ideal for scripts that modify the game's user interface, such as adding buttons, menus, and pop-ups.
 StarterPack | Generally only contains `Class.Tool\|Tools`, but can also include `Class.LocalScript\|LocalScripts` for setting up player backpacks.
diff --git a/content/en-us/marketplace/marketplace-fees-and-commissions.md b/content/en-us/marketplace/marketplace-fees-and-commissions.md
@@ -219,8 +219,6 @@ For an example of how the publishing advance is recouped, the following table re
 </AccordionDetails>
 </BaseAccordion>
 
-<br /><br />
-
 Rebate credits are reimbursed once per day. See the following guidelines:
 
 - Once per day, Roblox processes rebates from your sales and adds them to your transaction report.
diff --git a/content/en-us/marketplace/marketplace-policy.md b/content/en-us/marketplace/marketplace-policy.md
@@ -316,9 +316,7 @@ Modesty layers are **required** if your avatar character:
 </table>
 
 </AccordionDetails>
-  </BaseAccordion>
-
-<br /><br />
+</BaseAccordion>
 For all modesty layers, the following applies:
 
 - All modesty layers must be fully opaque. While they can include artistic highlights, shadows, or textures, modesty layers that are sheer or partially transparent are not permitted.
@@ -457,9 +455,7 @@ Avatar bodies cannot include any accessories or clothing. Accessories are items
 </tbody>
 </table>
 </AccordionDetails>
-  </BaseAccordion>
-
-<br /><br />
+</BaseAccordion>
 
 The following is an example of rejected and accepted version of the same asset:
 
diff --git a/content/en-us/projects/experience-ownership-transfer.md b/content/en-us/projects/experience-ownership-transfer.md
@@ -124,11 +124,12 @@ You can continue making changes to the experience until the new group owner acce
 **What happens to my credit card information when I transfer my experience?**
 
 Roblox removes your credit card information when you transfer an experience.
-
 <br/>
 **What happens to my revenue from private server subscriptions when I transfer my experience?**
 
-You continue to receive the revenue from existing private server subscriptions, but the new group owner receives the revenue from any new or renewed subscriptions.
+The group you transferred your experience to receives the revenue from any existing private server subscriptions. This revenue does not respect any group or experience revenue splitting.
+
+New private server subscriptions respect revenue splitting.
 <br/>
 **Does transferring an experience impact discovery?**
 
diff --git a/content/en-us/reference/engine/classes/DataStore.yaml b/content/en-us/reference/engine/classes/DataStore.yaml
@@ -113,7 +113,7 @@ methods:
         type: int
         default: 0
         summary: |
-          **(Optional)** Maximum possible number of items that can be returned.
+          **(Optional)** Number of items to be returned in each page. If no value is given, the engine sends a default value of 0 to the data store web service, which in turn defaults to 50 items per page.
       - name: cursor
         type: string
         default: ''
@@ -162,24 +162,24 @@ methods:
         type: SortDirection
         default: Ascending
         summary: |
-          Enum specifying ascending or descending sort order.
+          **(Optional)** Enum specifying ascending or descending sort order.
       - name: minDate
         type: int64
         default: 0
         summary: |
-          Unix timestamp in milliseconds after which the versions should be
+          **(Optional)** Unix timestamp in milliseconds after which the versions should be
           listed.
       - name: maxDate
         type: int64
         default: 0
         summary: |
-          Unix timestamp in milliseconds up to which the versions should be
+          **(Optional)** Unix timestamp in milliseconds up to which the versions should be
           listed.
       - name: pageSize
         type: int
         default: 0
         summary: |
-          Number of items to be returned in each page.
+          **(Optional)** Number of items to be returned in each page. If no value is given, the engine sends a default value of 0 to the data store web service, which in turn defaults to 1024 items per page.
     returns:
       - type: DataStoreVersionPages
         summary: |
diff --git a/content/en-us/reference/engine/classes/DataStoreService.yaml b/content/en-us/reference/engine/classes/DataStoreService.yaml
@@ -66,7 +66,7 @@ methods:
       data store. This function also accepts an optional
       `Class.DataStoreOptions` instance which includes options for enabling
       `Class.DataStoreOptions.AllScopes|AllScopes`. See
-      [Data Stores](../../cloud-services/data-stores) for details on scope.
+      [Data stores](../../../cloud-services/data-stores/index.md) for details on scope.
     code_samples:
     parameters:
       - name: name
@@ -190,8 +190,7 @@ methods:
         type: int
         default: 0
         summary: |
-          **(Optional)** Number of items to be returned in each page. By default
-          is 32.
+          **(Optional)** Number of items to be returned in each page. If no value is given, the engine sends a default value of 0 to the data store web service, which in turn defaults to 32 items per page.
       - name: cursor
         type: string
         default: ''
diff --git a/content/en-us/reference/engine/classes/PolicyService.yaml b/content/en-us/reference/engine/classes/PolicyService.yaml
@@ -19,21 +19,32 @@ deprecation_message: ''
 properties: []
 methods:
   - name: PolicyService:CanViewBrandProjectAsync
-    summary: ''
-    description: ''
-    code_samples: []
+    summary: |
+      Determines if a user can see brand project assets inside your experience.
+    description: |
+      Determines if a user can see brand project assets inside your experience. This method lets you work with brands to only show commercial assets to brand-compliant audiences.
+
+      To use `CanViewBrandProjectAsync`, you must use a brand project ID provided by Roblox. To request a brand project ID, <a href="mailto:brandsupport@roblox.com?subject=Request%20-%20Brand%20Project%20ID&body=Hi%20Roblox%20Team%20-%20can%20you%20please%20create%20a%20brand%20project%20ID%20for%20me%20so%20I%20can%20use%20the%20API%3F%20Please%20let%20me%20know%20if%20any%20additional%20information%20is%20needed.%20Thanks%21">contact us</a>.
+
+      You must call this method on a server-side Script and wrap it in a `Global.LuaGlobals.pcall()`.
+    code_samples:
+      - PolicyService-BrandProjectIntegrationServer
+      - PolicyService-BrandProjectIntegrationClient
     parameters:
       - name: player
         type: Player
         default:
-        summary: ''
+        summary: |
+          The `Player` object you're trying to show the brand project to.
       - name: brandProjectId
         type: string
         default:
-        summary: ''
+        summary: |
+          The brand project ID provided by Roblox. Represents all assets associated with a brand project.
     returns:
       - type: bool
-        summary: ''
+        summary: |
+          Whether or not the brand project can be shown to the specific user.
     tags:
       - Yields
     deprecation_message: ''
@@ -43,10 +54,10 @@ methods:
     writeCapabilities: []
   - name: PolicyService:GetPolicyInfoForPlayerAsync
     summary: |
-      Returns policy information about a player which is based on geolocation,
+      Returns policy information about a player based on geolocation,
       age group, and platform.
     description: |
-      Returns policy information about a player which is based on geolocation,
+      Returns policy information about a player based on geolocation,
       age group, and platform. The structure of the returned dictionary is as
       follows:
 
@@ -55,7 +66,7 @@ methods:
       <tr>
       <th>Name</th>
       <th>Type</th>
-      <th>Required For</th>
+      <th>Required for</th>
       <th>Description</th>
       </tr>
       </thead>
diff --git a/content/en-us/scripting/locations.md b/content/en-us/scripting/locations.md
@@ -20,16 +20,15 @@ Roblox has three types of scripts:
 When you create a `Class.Script`, its default run context is `Legacy`, meaning that it a) is a server-side script and b) only runs if it is in a server container, such as `Class.Workspace` or `Class.ServerScriptService`.
 
 - If you change the script's run context to `Server`, it can now also run in `Class.ReplicatedStorage`, but that's not recommended. The contents of that location are replicated to clients, so it's a poor location for server-side scripts.
-- If you change the script's run context to `Client`, it can run in `ReplicatedStorage`, but it can also run in `Class.StarterCharacterScripts` and `Class.StarterPlayerScripts`. These starter containers are copied to clients, though, so the original script **and** the copy run, which isn't desirable.
+- If you change the script's run context to `Client`, it can run in `ReplicatedStorage`. It can also run in `Class.StarterCharacterScripts` and `Class.StarterPlayerScripts`. Starter containers are copied to clients, though, so the original script **and** the copy run, which isn't desirable.
 
 To change a script run context, select it in the [Explorer](../studio/explorer.md) and change the value in the [Properties](../studio/properties.md) window.
 
 <img src="../assets/studio/properties/Script-RunContext.png" alt="RunContext property indicated for a Script." width="320 "/>
 
 ### Recommendations
 
-- Use the default `RunContext` value unless you have a specific reason not to. The `Legacy` name is meant to convey that Roblox scripts have traditionally worked this way and is not an indicator that the behavior is deprecated or suboptimal.
-- There are two good use cases for non-default `RunContext` values:
+- Using `Server` and `Client` values for `RunContext` removes ambiguity from how scripts run and can help keep your project organized. The best use cases for non-default `RunContext` values are:
 
   - Client scripts that you want to run from `Class.ReplicatedStorage` or `Class.ReplicatedFirst`.
   - Server or client scripts that you include within [models](../parts/models.md) and [packages](../projects/assets/packages.md). Explicitly setting the run context makes models and packages more likely to work properly from a variety of locations.
diff --git a/content/en-us/tutorials/curriculums/core/index.md b/content/en-us/tutorials/curriculums/core/index.md
@@ -68,8 +68,6 @@ inspect the place files if you want to see the end result of each chapter.
    </AccordionDetails>
    </BaseAccordion>
 
-   <br />
-
    <BaseAccordion>
    <AccordionSummary>
       <Typography variant="h4">Chapter 2 - Script the gameplay</Typography>
@@ -93,8 +91,6 @@ inspect the place files if you want to see the end result of each chapter.
    </AccordionDetails>
    </BaseAccordion>
 
-   <br />
-
    <BaseAccordion>
    <AccordionSummary>
       <Typography variant="h4">Chapter 3 - Polish the experience</Typography>
diff --git a/content/en-us/tutorials/curriculums/curriculum-overview.md b/content/en-us/tutorials/curriculums/curriculum-overview.md
@@ -28,8 +28,6 @@ If you've never used Roblox Studio or coded before, start here before following
 </AccordionDetails>
 </BaseAccordion>
 
-<br /> <br />
-
 <Card>
 
 <CardContent>
diff --git a/content/en-us/tutorials/curriculums/environmental-art/index.md b/content/en-us/tutorials/curriculums/environmental-art/index.md
diff --git a/content/en-us/tutorials/curriculums/gameplay-scripting/index.md b/content/en-us/tutorials/curriculums/gameplay-scripting/index.md
diff --git a/content/en-us/tutorials/curriculums/user-interface-design/index.md b/content/en-us/tutorials/curriculums/user-interface-design/index.md
diff --git a/content/en-us/tutorials/use-case-tutorials/use-case-tutorial-overview.md b/content/en-us/tutorials/use-case-tutorials/use-case-tutorial-overview.md
diff --git a/content/en-us/ui/rich-text.md b/content/en-us/ui/rich-text.md
diff --git a/tools/checks/utils/allowedHttpLinks.txt b/tools/checks/utils/allowedHttpLinks.txt
