Create Clicxey

.gitattributes

@@ -11,3 +11,6 @@ content/zh-tw/assets/** filter=lfs diff=lfs merge=lfs -text
 
 # Git will always convert line endings to LF on checkout
 * text eol=lf
+
+# But treat tarballs as binary (no line ending conversion)
+*.tgz binary

.github/workflows/Clicxey

@@ -0,0 +1 @@
+

.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,25 +56,37 @@ 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
         run: npm ci
 
       - name: Print workflow information
+        env:
+          EVENT_NAME: ${{ github.event_name }}
+          PR_NUMBER: ${{ github.event.pull_request.number }}
+          PR_USER_LOGIN: ${{ github.event.pull_request.user.login }}
+          BASE_REF: ${{ github.event.pull_request.base.ref }}
+          BASE_SHA: ${{ github.event.pull_request.base.sha }}
+          HEAD_REF: ${{ github.event.pull_request.head.ref }}
+          HEAD_SHA: ${{ github.event.pull_request.head.sha }}
         run: |
-          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 "Event name: $EVENT_NAME"
+          echo "Pull request number: $PR_NUMBER"
+          echo "Pull request user login: $PR_USER_LOGIN"
+          echo "Base (target) ref: $BASE_REF"
+          echo "Base (target) sha: $BASE_SHA"
+          echo "Head (source) ref: $HEAD_REF"
+          echo "Head (source) sha: $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/stale.yml

@@ -19,12 +19,9 @@ jobs:
           days-before-issue-close: -1
           # Pull Requests
           stale-pr-message: >-
-            This pull request has been inactive for 14 days. If it remains
-            inactive for another 7 days, it will close. Please 
-            update or comment on this pull request to keep it open. 🙏
+            This pull request has been inactive for 14 days. If there's no activity in the next 7 days, it will be automatically closed. To keep it open, please comment or push new commits. Alternatively, add the label `do-not-close` to exempt it from auto-closing. 🫡 🙏
           close-pr-message: >-
-            This pull request has been inactive for 21 days. It's closing now. 
-            Please feel free to reopen it if you still need it. 🙏
+            This pull request has been inactive for 21 days and is now being closed automatically. If it's still relevant, feel free to reopen it or start a new one. To prevent this in the future, you can add the `do-not-close` label to exempt it from automatic closure. Thank you! 🫡 🙏
           stale-pr-label: 'stale'
           days-before-pr-stale: 14
           days-before-pr-close: 7
@@ -34,3 +31,4 @@ jobs:
           operations-per-run: 500
           # For debugging
           debug-only: false
+          exempt-pr-labels: 'do-not-close'

.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

README.md

@@ -2,7 +2,7 @@
 
 This repository holds source code for the creator documentation at [create.roblox.com/docs](https://create.roblox.com/docs).
 
-**Note**: Currently, the repository has guides, tutorials, educational content, and the Engine API reference. Code samples are coming soon.
+**Note**: Currently, the repository has guides, tutorials, educational content, and a read-only version of the Engine API reference.
 
 If you're unfamiliar with the GitHub contribution process, see [About pull requests](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) and the following video.
 
@@ -77,14 +77,14 @@ The Roblox documentation has three main document types:
 
   Guides benefit massively from practical, real-world use cases, images, code snippets, and diagrams. Most task-based content should include a numbered list.
 
-- API reference docs in `.yaml` files in [content/en-us/reference](./content/en-us/reference)
-
-  APIs are entirely reference content and should use functional descriptions, linking to guides where appropriate. More than other content types, reference content should be terse and direct; summaries for properties, methods, events, and callbacks don't need to be full sentences.
-
 - Tutorials in `.md` files in [content/en-us/tutorials](./content/en-us/tutorials)
 
   Compared to task-based guides, tutorials are more self-contained and take you from _nothing_ to _something_. This focus on creating something specific means they're typically much more prescriptive than guides. Tutorials often touch multiple features and concepts at the same time, demonstrating the connections between tools and strategies.
 
+- API reference docs in `.yaml` files in [content/en-us/reference](./content/en-us/reference)
+
+  We provide these files so that you can view the source and use them in your own projects, but we **no longer** accept pull requests on the reference `.yaml` files.
+
 If your contribution doesn't fit within these categories or covers a particularly narrow subject, it might not be a good fit for the documentation. Consider posting it to the [Roblox developer forum](https://devforum.roblox.com/c/resources/71).
 
 ## Contribution Basics
@@ -103,4 +103,3 @@ To view a page fully formatted per what we see on the `main` branch, replace the
 ## Code of Conduct
 
 To maintain an open, welcoming, diverse, inclusive, and healthy community, this project enforces an adapted version of the Contributor Covenant. For more information, see [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).
-

STYLE.md

@@ -137,7 +137,7 @@ To link to a page in the Roblox Engine API, use the following syntax patterns. T
 
   - `` `Enum.Name` ``
 
-- **Lua/Roblox Globals**
+- **Luau and Roblox Globals**
 
   - `` `Global.LuaGlobals.Function()` ``
   - `` `Global.RobloxGlobals.Function()` ``
@@ -241,8 +241,8 @@ The reference documentation files come in five types:
 - Classes — core classes such as `BasePart`, `Model`, `Humanoid`, `DataStoreService`, etc.
 - Data types — data types such as `Color3`, `CFrame`, `UDim2`, `Vector3`, etc.
 - Enums — Enums such as `CameraType`, `FontSize`, `ScreenInsets`, etc.
-- Globals — Lua and Roblox globals.
-- Libraries — Lua libraries such as `math`, `string`, and `table`.
+- Globals — Luau and Roblox globals.
+- Libraries — Luau libraries such as `math`, `string`, and `table`.
 
 Internal tooling generates the structure of most files. Don't add new constructors, properties, methods, or events—just fill in the details. In most situations, you should only edit `summary`, `description`, and `deprecation_message`.
 

content/common/navigation/assets.yaml

@@ -0,0 +1,70 @@
+navigation:
+  - heading: Overview
+  - title: Overview
+    path: /assets
+  - title: Assets
+    path: /projects/assets/
+  - title: Manage
+    path: /projects/assets/manager
+    section:
+      - title: Asset Manager
+        path: /projects/assets/manager
+      - title: Toolbox
+        path: /projects/assets/toolbox
+      - title: External catalog queries
+        path: /projects/assets/api
+  - title: Packages
+    path: /projects/assets/packages
+  - title: Asset privacy
+    path: /projects/assets/privacy
+  - title: Creator Store
+    path: /production/creator-store
+  - heading: Creation tools
+  - title: Studio
+    path: /art/overview-studio
+  - title: Third-party software
+    section:
+      - title: Overview
+        path: /art/overview-dcc
+      - title: Blender
+        path: /art/blender
+      - title: Reaper
+        path: /art/reaper        
+  - title: In-experience
+    path: /projects/assets/in-experience-asset-creation
+  - heading: 3D Art
+  - title: Overview
+    path: /art/
+  - title: Modeling
+    section:
+      - title: Overview
+        path: /art/modeling/
+      - title: Modeling specifications
+        path: /art/modeling/specifications
+      - title: Reference assets
+        path: /art/modeling/project-files
+      - title: Rigging and skinning
+        path: /art/modeling/rigging
+      - title: Blender and Maya export settings
+        path: /art/modeling/export-requirements
+      - title: 3D Importer
+        path: /art/modeling/3d-importer
+      - title: Roblox Blender plugin
+        path: /art/modeling/roblox-blender-plugin
+
+  - title: Texturing
+    section:
+      - title: Texture specifications
+        path: /art/modeling/texture-specifications
+      - title: Physically-based rendering (PBR)
+        path: /art/modeling/surface-appearance
+      - title: PBR material references
+        path: /art/modeling/material-reference
+
+  - title: Animation
+    section:
+      - title: Export from Maya
+        path: /art/characters/export-avatar-animations-from-maya
+      - title: Head animation
+        path: /art/characters/facial-animation/animate-heads
+