Merge branch 'main' into main

Author: IgnisRBX

.github/workflows/content-checks.yml

@@ -1,5 +1,10 @@
 name: Content Checks
 on:
+  # Use `pull_request_target` to run the workflow on the PR base branch (e.g. `origin/main`)
+  # Avoid using `pull_request` because it runs the workflow on the PR head branch (e.g. `origin/pr-branch`)
+  # Don't run any code from the PR head branch because it's untrusted and could be malicious.
+  # See: https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#pull_request_target
+  # See: https://securitylab.github.com/resources/github-actions-preventing-pwn-requests/
   pull_request_target:
     types:
       - opened
@@ -28,6 +33,7 @@ jobs:
         with:
           fetch-depth: 2
 
+      # Avoid checking out any code outside of content/
       - name: Sparse checkout of content directory from fork to temp directory
         if: ${{ github.event_name == 'pull_request_target' }}
         uses: actions/checkout@v3
@@ -50,7 +56,7 @@ jobs:
       - name: Set up Node.js
         uses: actions/setup-node@v3
         with:
-          node-version: 18.17.1
+          node-version: 22.10.0
 
       - name: Install Node.js dependencies
         shell: bash
@@ -61,14 +67,18 @@ jobs:
           echo "Event name: ${{ github.event_name }}"
           echo "Pull request number: ${{ github.event.pull_request.number }}"
           echo "Pull request user login: ${{ github.event.pull_request.user.login }}"
-          echo "Base ref: ${{ github.event.pull_request.base.ref }}"
-          echo "Head sha: ${{ github.event.pull_request.head.sha }}"
+          echo "Base (target) ref: ${{ github.event.pull_request.base.ref }}"
+          echo "Base (target) sha: ${{ github.event.pull_request.base.sha }}"
+          echo "Head (source) ref: ${{ github.event.pull_request.head.ref }}"
+          echo "Head (source) sha: ${{ github.event.pull_request.head.sha }}"
           git status
           git remote -v
           git log --oneline -n 10
 
       - name: Run quality checks
-        # Don't run local code for security reasons
+        # The local code is untrusted and could be malicious. Don't run it.
+        # See: https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#pull_request_target
+        # See: https://securitylab.github.com/resources/github-actions-preventing-pwn-requests/
         uses: Roblox/creator-docs/.github/actions/quality-checks@main
         with:
           GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/triage.yml

@@ -6,6 +6,9 @@ on:
   # https://github.com/actions/labeler#permissions
   pull_request_target:
     types: [labeled, unlabeled, opened, ready_for_review, reopened, synchronize]
+concurrency:
+  group: '${{ github.workflow }}-${{ github.event.pull_request.number }}'
+  cancel-in-progress: true
 
 jobs:
   label-pull-request:
@@ -15,6 +18,12 @@ jobs:
       pull-requests: write
     runs-on: ubuntu-latest
     steps:
+      - name: Print concurrency key
+        run: |
+          echo "github.workflow == ${{ github.workflow }}"
+          echo "github.event.pull_request.number == ${{ github.event.pull_request.number }}"
+          echo "concurrency key == ${{ github.workflow }}-${{ github.event.pull_request.number }}"
+
       - uses: actions/labeler@v4 # https://github.com/actions/labeler
         with:
           repo-token: '${{ secrets.GITHUB_TOKEN }}'
@@ -27,6 +36,12 @@ jobs:
       pull-requests: write
     runs-on: ubuntu-latest
     steps:
+      - name: Print concurrency key
+        run: |
+          echo "github.workflow == ${{ github.workflow }}"
+          echo "github.event.pull_request.number == ${{ github.event.pull_request.number }}"
+          echo "concurrency key == ${{ github.workflow }}-${{ github.event.pull_request.number }}"
+
       - uses: actions/first-interaction@v1 # https://github.com/actions/first-interaction
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}

.nvmrc

@@ -1 +1 @@
-v18.17.1
+v22.10.0

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: Toolbox service
+      path: /cloud/api/toolbox-service
+    - 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: 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/common/navigation/engine/guides.yaml

@@ -337,6 +337,16 @@ navigation:
         path: /audio/objects
       - title: Effects
         path: /audio/effects
+      - title: Legacy
+        section:
+          - title: Sound
+            path: /sound/index
+          - title: Objects
+            path: /sound/objects
+          - title: Groups
+            path: /sound/groups
+          - title: Dynamic effects
+            path: /sound/dynamic-effects
   - title: User interface
     path: /ui/
     section:
@@ -386,6 +396,16 @@ navigation:
         path: /ui/size-modifiers
       - title: UI animation/tweens
         path: /ui/animation
+      - title: UI styling
+        section:
+          - title: Overview
+            path: /ui/styling/
+          - title: Style Editor
+            path: /ui/styling/editor
+          - title: Compatibility
+            path: /ui/styling/compatibility
+          - title: CSS comparisons
+            path: /ui/styling/css-comparisons
       - title: 9-slice design
         path: /ui/9-slice
       - title: Rich text markup