Merge branch 'main' into patch-4

Author: IgnisRBX

content/common/navigation/cloud/reference.yaml

@@ -32,98 +32,117 @@ navigation:
         path: /cloud/auth/oauth2-sample
       - title: Reference
         path: /cloud/auth/oauth2-reference
-  - heading: Use Case Reference
-  - title: All features
-    section:
-      - title: Accounts
-        path: /cloud/features/accounts
-      - title: Assets
-        path: /cloud/features/assets
-      - title: Avatars
-        path: /cloud/features/avatars
-      - title: Badges
-        path: /cloud/features/badges
-      - title: Bans and blocks
-        path: /cloud/features/bans-and-blocks
-      - title: Chats
-        path: /cloud/features/chats
-      - title: Creator Store
-        path: /cloud/features/creator-store
-      - title: Developer products
-        path: /cloud/features/developer-products
-      - title: Friends
-        path: /cloud/features/friends
-      - title: Game passes
-        path: /cloud/features/game-passes
-      - title: Groups
-        path: /cloud/features/groups
-      - title: Interactions
-        path: /cloud/features/interactions
-      - title: Inventories
-        path: /cloud/features/inventories
-      - title: Localization
-        path: /cloud/features/localization
-      - title: Luau execution
-        path: /cloud/features/luau-execution
-      - title: Metadata
-        path: /cloud/features/metadata
-      - title: Notifications
-        path: /cloud/features/notifications
-      - title: Places
-        path: /cloud/features/places
-      - title: Private servers
-        path: /cloud/features/private-servers
-      - title: Sponsored campaigns
-        path: /cloud/features/sponsored-campaigns
-      - title: Storage
-        path: /cloud/features/storage
-      - title: Team Create
-        path: /cloud/features/team-create
-      - title: Thumbnails
-        path: /cloud/features/thumbnails
-      - title: Trades
-        path: /cloud/features/trades
-      - title: Universes
-        path: /cloud/features/universes
-      - title: User profiles
-        path: /cloud/features/user-profiles
-      - title: Users
-        path: /cloud/features/users
-  - heading: Open Cloud v2
-  - title: All Cloud API # doesn't show anywhere
-    path: /cloud/reference/
-    type: cloudapi2
-    source: /reference/cloud/cloud.docs.json
-  - heading: Open Cloud v1
+  - heading: Features
+  - title: Accounts
+    path: /cloud/features/accounts
   - title: Assets
-    type: cloudapi
-    versions:
-      - name: v1
-        path: /reference/cloud/assets/v1
-  - title: Standard data stores
-    type: cloudapi
-    versions:
-      - name: v1
-        path: /reference/cloud/datastores-api/v1
-  - title: Ordered data stores
-    type: cloudapi
-    versions:
-      - name: v1
-        path: /reference/cloud/datastores-api/ordered-v1
-  - title: Messaging
-    type: cloudapi
-    versions:
-      - name: v1
-        path: /reference/cloud/messaging-service/v1
-  - title: Place publishing
-    type: cloudapi
-    versions:
-      - name: v1
-        path: /reference/cloud/universes-api/v1
-  - heading: Legacy
-  - title: Overview
-    path: /cloud/legacy
-  - title: All legacy APIs
+    path: /cloud/features/assets
+  - title: Avatars
+    path: /cloud/features/avatars
+  - title: Badges
+    path: /cloud/features/badges
+  - title: Bans and blocks
+    path: /cloud/features/bans-and-blocks
+  - title: Chats
+    path: /cloud/features/chats
+  - title: Creator Store
+    path: /cloud/features/creator-store
+  - title: Developer products
+    path: /cloud/features/developer-products
+  - title: Friends
+    path: /cloud/features/friends
+  - title: Game passes
+    path: /cloud/features/game-passes
+  - title: Groups
+    path: /cloud/features/groups
+  - title: Interactions
+    path: /cloud/features/interactions
+  - title: Inventories
+    path: /cloud/features/inventories
+  - title: Localization
+    path: /cloud/features/localization
+  - title: Luau execution
+    path: /cloud/features/luau-execution
+  - title: Metadata
+    path: /cloud/features/metadata
+  - title: Notifications
+    path: /cloud/features/notifications
+  - title: Places
+    path: /cloud/features/places
+  - title: Private servers
+    path: /cloud/features/private-servers
+  - title: Sponsored campaigns
+    path: /cloud/features/sponsored-campaigns
+  - title: Storage
+    path: /cloud/features/storage
+  - title: Team Create
+    path: /cloud/features/team-create
+  - title: Thumbnails
+    path: /cloud/features/thumbnails
+  - title: Trades
+    path: /cloud/features/trades
+  - title: Universes
+    path: /cloud/features/universes
+  - title: User profiles
+    path: /cloud/features/user-profiles
+  - title: Users
+    path: /cloud/features/users
+  - heading: Open Cloud API Reference
+  - title: Cloud
+    section:
+    - title: Asset delivery
+      path: /cloud/api/asset-delivery
+    - title: Badges
+      path: /cloud/api/badges
+    - title: Develop
+      path: /cloud/api/develop
+    - title: Followings
+      path: /cloud/api/followings
+    - title: Game internationalization
+      path: /cloud/api/game-internationalization
+    - title: Groups
+      path: /cloud/api/groups
+    - title: Localization tables
+      path: /cloud/api/localization
+    - title: Publish
+      path: /cloud/api/publish
+    - title: Toolbox service
+      path: /cloud/api/toolbox-service
+  - title: Open Cloud v2
+    section:
+    - title: All Cloud API # doesn't show anywhere
+      path: /cloud/reference/
+      type: cloudapi2
+      source: /reference/cloud/cloud.docs.json
+  - title: Open Cloud v1
+    section:
+    - title: Assets
+      type: cloudapi
+      versions:
+        - name: v1
+          path: /reference/cloud/assets/v1
+    - title: Standard data stores
+      type: cloudapi
+      versions:
+        - name: v1
+          path: /reference/cloud/datastores-api/v1
+    - title: Ordered data stores
+      type: cloudapi
+      versions:
+        - name: v1
+          path: /reference/cloud/datastores-api/ordered-v1
+    - title: Messaging
+      type: cloudapi
+      versions:
+        - name: v1
+          path: /reference/cloud/messaging-service/v1
+    - title: Place publishing
+      type: cloudapi
+      versions:
+        - name: v1
+          path: /reference/cloud/universes-api/v1
+  - heading: Cookie-based API Reference
+  - title: Legacy APIs
     section:
     - title: Account information
       type: cloudlegacy

content/en-us/art/validation-errors.md

@@ -93,7 +93,7 @@ The following is a table of all possible validation error codes, as well as any
     <td>Failed to execute similarity mesh vertex check for `%s`. Make sure mesh exists and try again.</td>
     <td></td>
   </tr>
-  <tr>
+  <tr id = "cageDensity">
     <td>`%s` has `%d` % of vertices too close to each other. Please edit the vertices to have at most `%d` % coincident or close to one another.</td>
     <td>Your accessory cage has too many vertices close together. This may cause the system to treat them as repeated vertices, or zero area triangles. You need to [edit and move](../art/accessories/caging-best-practices.md) the vertices away from each other in the region(s) they are almost coincident.</td>
   </tr>
@@ -136,7 +136,7 @@ The following is a table of all possible validation error codes, as well as any
     <td>WrapTarget `%s` found under `%s` has a CageOrigin position greater than %. You need to set `CageOrigin.Position` to `0`,`0`,`0`.</td>
     <td>Cage origin must be zero to properly align with its corresponding body or accessory.</td>
   </tr>
-  <tr>
+  <tr id = "cageMeshDistance">
     <td>Average distance between outer cage to mesh is too high. Mesh seems to be outside of the outer cage.<br/><br/>Average distance between outer cage to mesh is too high %. Make adjustment to cage to fit the mesh better.</td>
     <td>The outer cage is too far away from its corresponding body or accessory model mesh. You need to [remodel the outer cage](../art/accessories/caging-best-practices.md) and bring its vertices closer to the model mesh.</td>
   </tr>
@@ -192,7 +192,7 @@ The following is a table of all possible validation error codes, as well as any
     <td>Failed to execute cage relevancy detection for `%s`. Make sure the cage mesh exists and try again.</td>
     <td></td>
   </tr>
-  <tr>
+  <tr id = "cageRelevancy">
     <td>Validation detected `%d` % of the outer cage edits do not cover the accessory. Make sure you are moving the outer cage only where needed.</td>
     <td>This validation has detected that you moved out many vertices of your outer cage that weren't in the same region as your model geometry. <br/><br/>You need to verify your outer cage is modified only enough to envelop the accessory model mesh, and stays consistent with the inner cage everywhere else.</td>
   </tr>
@@ -204,7 +204,7 @@ The following is a table of all possible validation error codes, as well as any
     <td>Failed to load UVs for Inner cage of `%s`. Make sure the UV map exists and try again.</td>
     <td></td>
   </tr>
-  <tr>
+  <tr id = "cageExtraUvs">
     <td>There are `%d` UV values in `%s` cage that do not belong to the template. Please correct the cage UV.</td>
     <td>The cage has an invalid UV map, possibly from using an old or third-party cage. Use the UV map and model mesh templates provided in the [official documentation resources](../avatar/resources.md#project-files).</td>
   </tr>
@@ -407,7 +407,7 @@ The following is a table of all possible validation error codes, as well as any
     <td>Failed to execute render mesh inside outer mesh check for `%s` and `%s`. Make sure the meshes exists and try again.</td>
     <td></td>
   </tr>
-  <tr>
+  <tr id ="cageInsideMesh">
     <td>Validation detected `%d`% of the accessory is outside its outer cage. Make adjustments to have more of the accessory placed between the cages.</td>
     <td>The outer cage needs to envelop the model mesh of its corresponding accessory. This check has detected a large portion of the model mesh is outside its outer cage. You need to edit the model and/or the cage to fix this issue.</td>
   </tr>

content/en-us/assets/feeds/datastores_mmo.webp

@@ -3,7 +3,7 @@ title: Open Cloud guides
 description: In addition to using Engine and Studio tools to create experiences on Roblox, you can automate your internal workflows, improve your efficiency creating content, and support your experience operation needs from the web.
 ---
 
-The Open Cloud v1 and v2 resource guides provide detailed walkthroughs for popular Open Cloud use cases, such as [retrieving user inventories](inventory.md), [sending announcements](usage-messaging.md), or [using webhooks](../webhooks/webhook-notifications.md) to notify your apps of certain events.
+The Open Cloud resource guides provide detailed walkthroughs for popular Open Cloud use cases, such as [retrieving user inventories](inventory.md), [sending announcements](usage-messaging.md), or [using webhooks](../webhooks/webhook-notifications.md) to notify your apps of certain events.
 
 Guides often include sample code in Python or Node.js and are a great way to get started, understand a resource, and spark ideas for your own usage.
 

content/en-us/assets/feeds/modulescripts_sleit.webp

@@ -3,20 +3,23 @@ title: Cloud API reference
 description: Get comprehensive API reference documentation for Open Cloud.
 ---
 
-With Open Cloud, you can access Roblox resources through standard [REST](https://en.wikipedia.org/wiki/REST) APIs, which lets you build everything from command line automation tools to complex web apps. The Open Cloud APIs support HTTPS and use [API keys](./auth/api-keys.md) or [OAuth 2.0](./auth/oauth2-overview.md) for authentication. You can update experiences, restart servers, work with your data stores and memory stores, manage user restrictions, list inventory items, and much, much more.
+With Open Cloud, you can access Roblox resources through standard [REST](https://en.wikipedia.org/wiki/REST) APIs, which lets you build everything from command line automation tools to complex web apps. You can update experiences, restart servers, work with your data stores and memory stores, manage user restrictions, list inventory items, and much, much more.
 
 ## About this reference
 
 This reference documentation is broken into two sections:
 
-- A [feature-based section](features/accounts.md) that categorizes APIs by use case (Avatars, Game Passes, Users, etc.).
-- A [section that separates endpoints by system](/cloud/reference/DataStore#Cloud_ListDataStores) (Open Cloud v2, v1, or legacy).
+- A [section that separates endpoints by feature](./features/accounts.md) (Avatars, Game Passes, Users, etc.)
+- A [section that separates endpoints by authentication type](./api/toolbox-service.md) (Open Cloud or cookie-based)
 
 **Both sections** contain the full list of available API endpoints; use whichever helps you find what you need.
 
-Whenever possible, use Open Cloud v2, Open Cloud v1, or [legacy endpoints that support API key and/or OAuth 2.0 authentication](legacy.md). These APIs have strong stability guarantees and regularly add new resources.
+Whenever possible, use the Open Cloud APIs. These APIs support HTTPS and use [API keys](./auth/api-keys.md) or [OAuth 2.0](./auth/oauth2-overview.md) for authentication. They have strong stability guarantees and regular releases.
 
-Legacy API endpoints with cookie authentication can incorporate breaking changes without notice and have minimal stability guarantees. We don't recommend them for production applications. The legacy API has been known by various names over the years, including the Roblox site API, the web API, and the classic API.
+- Open Cloud v2 APIs use certain resource-oriented design patterns. For more information, see [Patterns](./reference/patterns.md).
+- Some other Open Cloud APIs share similar resource-oriented patterns, but are not guaranteed to strictly follow all of them.
+
+Legacy APIs use cookie-based authentication, can incorporate breaking changes without notice, and have minimal stability guarantees. We don't recommend them for production applications.
 
 <Alert severity="info">
 Roblox also offers [webhooks](./webhooks/webhook-notifications.md), which can notify your applications when certain events occur, such as refunds or changes to subscriptions.
@@ -30,4 +33,4 @@ Roblox also offers [webhooks](./webhooks/webhook-notifications.md), which can no
 
 1. Test API calls using tools like [Postman](https://www.postman.com) with [OpenAPI descriptions](./reference/openapi.md) or the [OAuth 2.0 sample app](./auth/oauth2-sample.md).
 1. Review the [resource guides](./guides/index.md) for end-to-end walkthroughs of using certain APIs.
-1. Explore the left navigation for the full list of Open Cloud v2 and v1 resources, [common API patterns](./reference/patterns.md), [types](./reference/types.md), and [error codes](./reference/errors.md).
+1. Explore the left navigation for the full list of features, [common API patterns](./reference/patterns.md), [types](./reference/types.md), and [error codes](./reference/errors.md).