Merge branch 'main' into ui-ux-design-patch1

Author: IgnisRBX

content/en-us/cloud/open-cloud/index.md

@@ -5,15 +5,29 @@ description: In addition to using Engine and Studio tools to create experiences
 
 With Open Cloud, you can access Roblox resources through standard REST APIs, which lets you build everything from command line automation tools to complex web apps. The Open Cloud APIs support HTTPS and let you update experiences, restart servers, work with your data stores and memory stores, manage user restrictions, list inventory items, and much, much more.
 
-For the full list of available operations, see the Open Cloud API reference.
-
 <a href="../reference/index.md">
   <Button variant="contained">Open Cloud API Reference</Button>
 </a>
 
+## About the APIs
+
+Roblox has four categories of HTTP REST API:
+
+- [Open Cloud v2](../reference/index.md)
+- [Open Cloud v1](../reference/index.md)
+- [Legacy with API key and/or OAuth 2.0 authentication](../legacy.md)
+- [Legacy with cookie authentication](../legacy.md)
+
+Whenever possible, use the Open Cloud v2 API. This API has the strongest stability guarantees and regularly adds new resources. The Open Cloud v1 API also has strong stability guarantees, but a more limited set of resources.
+
+The legacy APIs, no matter which types of authentication they support, can incorporate breaking changes without notice and have minimal stability guarantees. They are not part of the Open Cloud v1 or v2 APIs, and we don't recommend them for production applications.
+
 ## Getting Started with Open Cloud
 
-1. See the authentication documentation for how to use [API keys](api-keys.md) or [OAuth 2.0](oauth2-overview.md).
+1. Set up authentication for your application.
+
+   See the documentation for how to use [API keys](api-keys.md) or [OAuth 2.0](oauth2-overview.md). API keys are the easiest way to get started.
+
 1. Use a tool like [Postman](https://www.postman.com) or the [OAuth 2.0 sample app](oauth2-sample.md) to test API calls.
 1. Review the [resource guides](experience-notifications.md) for end-to-end walkthroughs of using certain APIs.
-1. See the Open Cloud [reference documentation](../reference/index.md) for the full list of resources, [common API patterns](../reference/patterns.md), and [types](../reference/types.md).
+1. See the Open Cloud [reference documentation](../reference/index.md) for the full list of v1 and v2 resources, [common API patterns](../reference/patterns.md), and [types](../reference/types.md).

content/en-us/projects/assets/index.md

@@ -260,6 +260,18 @@ if success then
 end
 ```
 
+### rbxgameasset
+
+`rbxgameasset` points to an asset uploaded through the [Asset Manager](../../projects/assets/manager.md). It allows access to assets by a user‑friendly name instead of ID, so if you upload an image named `Potion.png`, you can reference it as:
+
+<span><Chip label='rbxgameasset://Images/Potion' color='primary' size='large' /></span><br />
+
+In the above example, `Images` is the category/folder that appears in the [Asset Manager](../../projects/assets/manager.md) and `Potion` is the asset name, minus its extension.
+
+<Alert severity="warning">
+`rbxgameasset` only works for the current game. If you paste a parent object that utilizes the asset into another game, the asset will not load (or will load a different asset if you've uploaded one with the same name to that other game). If you need an asset to work across multiple games, use `rbxassetid` instead of `rbxgameasset`.
+</Alert>
+
 ### rbxhttp
 
 `rbxhttp` is shorthand for `Class.ContentProvider.BaseUrl`, for example:

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

@@ -4,12 +4,12 @@ category:
 memory_category: Instances
 summary: |
   A `Class.SensorBase` that outputs data about the
-  `Class.AtmosphereSensor.AirDenstiy|AirDenstiy` and
+  `Class.AtmosphereSensor.AirDensity|AirDensity` and
   `Class.AtmosphereSensor.RelativeWindVelocity|RelativeWindVelocity` at the
   sensor's position.
 description: |
   A `Class.SensorBase` that outputs data about the
-  `Class.AtmosphereSensor.AirDenstiy|AirDenstiy` and
+  `Class.AtmosphereSensor.AirDensity|AirDensity` and
   `Class.AtmosphereSensor.RelativeWindVelocity|RelativeWindVelocity` at the
   sensor's position.
 code_samples: []

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

@@ -2,8 +2,15 @@ name: FluidForceSensor
 type: class
 category:
 memory_category: Instances
-summary: ''
-description: ''
+summary: |
+  A `Class.SensorBase` that outputs `Class.FluidForceSensor.Force|Force`, `Class.FluidForceSensor.Torque|Torque` and `Class.FluidForceSensor.CenterOfPressure|CenterOfPressure`.
+description: |
+  `FluidForceSensor` is a `Class.SensorBase` which outputs the results of fluid
+  force simulation from the last physics frame for the part it is attached to.
+  The sensor outputs the `Class.FluidForceSensor.Force|Force`,
+  `Class.FluidForceSensor.Torque|Torque` and
+  `Class.FluidForceSensor.CenterOfPressure|CenterOfPressure` which were computed
+  by the fluid force simulation on the last physics frame.
 code_samples: []
 inherits:
   - SensorBase
@@ -12,8 +19,12 @@ tags:
 deprecation_message: ''
 properties:
   - name: FluidForceSensor.CenterOfPressure
-    summary: ''
-    description: ''
+    summary: |
+      Assembly center of pressure offset from its center of mass in world
+      coordinates.
+    description: |
+      Assembly center of pressure offset from its center of mass in world
+      coordinates.
     code_samples: []
     type: Vector3
     tags:
@@ -31,8 +42,10 @@ properties:
     capabilities: []
     writeCapabilities: []
   - name: FluidForceSensor.Force
-    summary: ''
-    description: ''
+    summary: |
+      Assembly fluid force in world coordinates.
+    description: |
+      Assembly fluid force in world coordinates.
     code_samples: []
     type: Vector3
     tags:
@@ -50,8 +63,10 @@ properties:
     capabilities: []
     writeCapabilities: []
   - name: FluidForceSensor.Torque
-    summary: ''
-    description: ''
+    summary: |
+      Assembly fluid torque in world coordinates.
+    description: |
+      Assembly fluid torque in world coordinates.
     code_samples: []
     type: Vector3
     tags:
@@ -70,25 +85,36 @@ properties:
     writeCapabilities: []
 methods:
   - name: FluidForceSensor:EvaluateAsync
-    summary: ''
-    description: ''
+    summary: |
+      Asynchronously computes force, torque, and center of pressure for the
+      parent part of a sensor given provided inputs.
+    description: |
+      Asynchronously computes force, torque, and center of pressure for the
+      parent part of a sensor given provided inputs.
     code_samples: []
     parameters:
       - name: linearVelocity
         type: Vector3
         default:
-        summary: ''
+        summary: |
+          Linear velocity in world coordinates.
       - name: angularVelocity
         type: Vector3
         default:
-        summary: ''
+        summary: |
+          Angular velocity in world coordinates.
       - name: cframe
         type: CFrame
         default:
-        summary: ''
+        summary: |
+          `Datatype.CFrame` to be used for evaluation.
     returns:
       - type: Tuple
-        summary: ''
+        summary: |
+          Tuple of `Class.FluidForceSensor.Force|Force`,
+          `Class.FluidForceSensor.Torque|Torque` and
+          `Class.FluidForceSensor.CenterOfPressure|CenterOfPressure` calculated
+          given the input parameters.
     tags:
       - Yields
     deprecation_message: ''