update Open Source Docs from Roblox internal teams

Author: rbx-open-source-docs[bot]

content/common/navigation/education.yaml

@@ -35,19 +35,6 @@ navigation:
     section:
       - title: Game design and coding
         path: /education/lesson-plans/intro-to-game-and-coding
-      - title: Roblox developer 101
-        path: /education/lesson-plans/roblox-developer/landing
-        section:
-          - title: Roblox Studio basics
-            path: /education/lesson-plans/roblox-developer/roblox-developer-1
-          - title: Coding fundamentals
-            path: /education/lesson-plans/roblox-developer/roblox-developer-2
-          - title: Adventure game 1
-            path: /education/lesson-plans/roblox-developer/roblox-developer-3
-          - title: Adventure game 2
-            path: /education/lesson-plans/roblox-developer/roblox-developer-4
-          - title: Adventure game 3
-            path: /education/lesson-plans/roblox-developer/roblox-developer-5
       - title: Digital citizenship
         path: /education/lesson-plans/digital-citizenship/landing
         section:
@@ -67,14 +54,10 @@ navigation:
             path: /education/lesson-plans/digital-citizenship/finishing-projects
   - title: Activity lessons
     section:
-      - title: Galactic Speedway
-        path: /education/lesson-plans/galactic-speedway-lesson
       - title: Roblox animations
         path: /education/lesson-plans/animate-in-roblox-lesson
       - title: Story games
         path: /education/lesson-plans/story-games-lesson
-      - title: Create and Destroy
-        path: /education/lesson-plans/create-and-destroy-lesson
   - title: Resources
     path: /education/resources/resources-landing
     section:

content/en-us/assets/education/story-games/CloseToolbox.png

@@ -3,19 +3,43 @@ title: Errors
 description: Defines the errors that are returned by Open Cloud APIs
 ---
 
-The following sections describe the error model for Open Cloud APIs.
+The following sections describe the error handling for Open Cloud APIs. Due to implementation differences across endpoints and validation layers, error responses can vary significantly in format.
+
+## Gateway errors
+
+For authentication or routing issues, both Open Cloud v1 and v2 APIs may return errors in this format:
+
+```json title="Example gateway error"
+{
+  "errors": [
+    {
+      "code": 0,
+      "message": "Invalid API Key"
+    }
+  ]
+}
+```
 
 ## Open Cloud v2
 
-By default, endpoints respond with a 200 OK status. When requests are
-unsuccessful, Open Cloud returns standard error codes. All error responses have
-the same format, which include:
+Open Cloud v2 APIs generally follow a consistent error format when the error occurs within the API endpoint itself.
+
+### Standard v2 error format
+
+Open Cloud v2 APIs return errors in this format:
 
-- `code` - Represents the HTTP status code.
-- `message` - A message that explains the error.
-- `details` - An object that contains more information specific to the error.
+- `code` - A string representing the error type (e.g. `INVALID_ARGUMENT`, `NOT_FOUND`).
+- `message` - A human-readable message explaining the error.
+- `details` - An optional array containing additional error-specific information.
 
-```json title="Example Error"
+```json title="Example v2 error"
+{
+  "code": "INVALID_ARGUMENT",
+  "message": "Invalid User ID in the request."
+}
+```
+
+```json title="Example v2 error with details"
 {
   "code": "INVALID_ARGUMENT",
   "message": "The provided filter is invalid.",
@@ -27,9 +51,9 @@ the same format, which include:
 }
 ```
 
-### Codes
+### v2 error codes
 
-The following table describes possible values for `code`.
+The following table describes possible values for `code` in v2 API responses.
 
 <table>
   <thead>
@@ -90,15 +114,11 @@ The following table describes possible values for `code`.
 
 ## Open Cloud v1
 
-Open Cloud v1 APIs share a standard format:
-
-- An `error` field, which is a high-level cause that is applicable to all Open Cloud endpoints.
-- An explanatory error `message`, which further explains the error.
-- An `errorDetails` object, which covers more information of the error that is specific to each API.
+Open Cloud v1 APIs have inconsistent error response formats. The format depends on the specific endpoint, the type of error, and where the error occurs in the request processing pipeline.
 
-To analyze the root cause of an error, refer to the value of the `error` field and the `errorDetails` field. Use the `message` field as a supplementary for error handling, as sometimes it might not cover the same level of details as the `errorDetails` field.
+Most v1 endpoints return errors in one of these three formats:
 
-```json title="Example Standard DataStores Error Response"
+```json title="Example v1 error with error field"
 {
   "error": "INVALID_ARGUMENT",
   "message": "Invalid cursor.",
@@ -111,22 +131,30 @@ To analyze the root cause of an error, refer to the value of the `error` field a
 }
 ```
 
-The example error response shows the high-level Open Cloud `error` as `INVALID_ARGUMENT`, the error `message` as `InvalidCursor`, and the `errorDetails` specific to [data stores](../../reference/cloud/datastores-api/v1.json) with the `datastoreErrorCode` as `InvalidCursor`. From the `error` and `datastoreErrorCode` fields of the response, you can understand that you passed an invalid cursor parameter that caused the error. You can then correct your cursor parameter to resolve the issue.
-
-All ordered data stores error responses have the same format, which includes:
-
-```json title="Example Ordered DataStores Error Response"
+```json title="Example v1 error with code field"
 {
   "code": "INVALID_ARGUMENT",
   "message": "Invalid cursor."
 }
 ```
 
-The `code` will contain a string of the high-level error while the `message` will contain specific details related to the error
+```json title="Example v1 detailed validation error"
+{
+  "errors": {
+    "assetId": ["The value 'a' is not valid."]
+  },
+  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
+  "title": "One or more validation errors occurred.",
+  "status": 400,
+  "extensions": {
+    "traceId": "00-427917f0fc3b8375ee33e4603a7f0693-f3f6ad560ff1a122-00"
+  }
+}
+```
 
-### Codes
+### v1 error codes
 
-Reference the following table for a summary of all high-level Open Cloud errors.
+The following table describes possible values for `error` or `code` in v1 API responses:
 
 <table>
   <thead>

content/en-us/assets/tutorials/building-lesson/CloseToolbox.png

@@ -138,12 +138,12 @@ Try out Roblox with these stand alone lessons. Learn something new in less than
 <Grid item XSmall={6}>
 
   <div>
-  <img src="../../assets/education/legacy/WCCHero_312x200.png" />
-  <h4>Story games</h4>
+  <img src="../../assets/tutorials/coding-lesson/StoryGameThumb.png" />
+  <h4>Coding lesson</h4>
   <p>
   Use strings and variables to create your own story.
   </p>
-  <a href="../../education/lesson-plans/story-games-lesson.md">
+  <a href="../../tutorials/curriculums/coding/index.md">
   <Button variant="contained">View</Button>
   </a>
   </div>
@@ -152,12 +152,12 @@ Try out Roblox with these stand alone lessons. Learn something new in less than
 
 <Grid item XSmall={6}>
   <div>
-  <img src="../../assets/education/legacy/ccw2019_thumbnail_312x200px.png" />
-  <h4>Galactic Speedway</h4>
+  <video controls src="../../assets/tutorials/playing-character-animations/Default-Swim-Animation.mp4" width="88%"></video>
+  <h4>Animation lesson</h4>
   <p>
-  Build your own spaceship and race it with friends.
+  Create your own animation using a poseable figure.
   </p>
-  <a href="../../education/lesson-plans/galactic-speedway-lesson.md">
+  <a href="../../tutorials/curriculums/animator/index.md">
   <Button variant="contained">View</Button>
   </a>
   </div>

content/en-us/cloud/reference/errors.md

@@ -119,9 +119,8 @@ description: Learn about animation and study how the human body moves.
 ### Guided tutorial - Studio and animation basics
 
 1. Set expectations that you'll guide students through a tutorial to make their animation. Even if they're not finished, they'll have more time in the independent work time.
-2. Lead students through <a href="../../education/build-it-play-it-island-of-move/opening-the-template.md" target="_blank" rel="noopener">Opening the Template</a> to <a href="../../education/build-it-play-it-island-of-move/adding-the-second-pose.md" target="_blank" rel="noopener">Adding the Second Pose</a>.
-   - You can ignore the Challenge Checkpoint pages.
-   - At Test the Game, give students at most 2 minutes to play-test.
+2. Lead students through <a href="../../tutorials/curriculums/animator/get-started.md" target="_blank" rel="noopener">Get started</a> through <a href="../../tutorials/curriculums/animator/work-with-the-animation-editor.md" target="_blank" rel="noopener">Work with the Animation Editor</a>.
+
    - Slides are provided to help you throughout the tutorial.
 
 ### Independent work - Improve animations
@@ -130,7 +129,10 @@ description: Learn about animation and study how the human body moves.
 
 ### Guided tutorial - Add animations
 
-1. Lead students through <a href="../../education/build-it-play-it-island-of-move/exporting-animations.md" target="_blank" rel="noopener">Exporting Animations</a> to <a href="../../education/build-it-play-it-island-of-move/change-the-animation.md" target="_blank" rel="noopener">Change the Animation</a>.
+1. Lead students through <a href="../../tutorials/curriculums/animator/play-your-animation.md" target="_blank" rel="noopener">Play your animation</a> through <a href="../../tutorials/curriculums/animator/test-and-save.md" target="_blank" rel="noopener">Test and save</a>.
+
+   - At **Playtest your animation**, give students at most 2 minutes to play-test.
+
 2. Have students playtest their experience to ensure they see their animation.
 
 ### Wrap-up

content/en-us/education/educator-onboarding/5-next-steps.md

@@ -105,7 +105,7 @@ prev: /education/lesson-plans/digital-citizenship/coding-fundamentals
 
 ### Design an animation
 
-1. Lead students through <a href="../../../education/build-it-play-it-island-of-move/creating-animations.md" target="_blank" rel="noopener">Creating Animations</a> to <a href="../../../education/build-it-play-it-island-of-move/exporting-animations.md" target="_blank" rel="noopener">Exporting Animations</a>.
+1. Lead students through the following tutorial: <a href="../../../tutorials/curriculums/animator/index.md" target="_blank" rel="noopener">Animation lesson</a>.
 
    - Note that this lesson uses a template which is not needed. Students will build this in their obstacle course experience.
    - Skip any pages referring to Challenge Checkpoints.

content/en-us/education/lesson-plans/animate-in-roblox-lesson.md

@@ -124,7 +124,7 @@ prev: /education/lesson-plans/digital-citizenship/landing
 
 1. Inform student they'll be learning how to create their own experiences using Roblox Studio.
 
-2. Lead students through the following tutorial: <a href="../../../tutorials/first-experience/index.md" target="_blank" rel="noopener">Introduction to Roblox Studio</a>
+2. Lead students through the following tutorial: <a href="../../../tutorials/curriculums/building/index.md" target="_blank" rel="noopener">Building lesson</a>.
 
 3. As you teach, keep in mind the following:
 

content/en-us/education/lesson-plans/digital-citizenship/animating-characters.md

@@ -108,7 +108,7 @@ description: Learn how to build an obstacle course and code color changing block
 
 ### Guided tutorial - Intro to Studio
 
-1. Lead students through the following tutorial: <a href="../../tutorials/first-experience/index.md" target="_blank" rel="noopener">Introduction to Roblox Studio</a>.
+1. Lead students through the following tutorial: <a href="../../tutorials/curriculums/building/index.md" target="_blank" rel="noopener">Building lesson</a>.
 
 2. As you teach, keep in mind the following:
    - Remind students to rotate their camera view to get an accurate view of their project.

content/en-us/education/lesson-plans/digital-citizenship/intro-to-roblox.md

@@ -3,7 +3,7 @@ title: Code a story game
 description: Learn to code a story game as part of the Hour of Code™ initiative.
 ---
 
-<img src="../../assets/education/lesson-plans/storyGames-hero.jpg" width="100%" />
+<img src="../../assets/tutorials/coding-lesson/StoryGameThumb.png" width="80%" />
 
 **Lesson description**: Start your coding journey with Roblox while joining millions participating in the world-wide Hour of Code™ initiative.
 
@@ -106,17 +106,17 @@ description: Learn to code a story game as part of the Hour of Code™ initiativ
 ### Guided work - Create stories
 
 1. Provide students paper and pencil to write their stories.
-2. Lead students through the lessons <a href="../../education/build-it-play-it-story-games/writing-the-story.md" target="_blank" rel="noopener">Writing the Story</a>.
+2. Lead students through <a href="../../tutorials/curriculums/coding/get-started.md#brainstorm-your-story" target="_blank" rel="noopener">Brainstorm your story</a>.
    - Have students do this activity away from computers to reduce distractions.
    - Brainstorming Tip: Have students generate ideas by having one suggest a character (wizard, chef, etc), and another suggesting what that character does.
 
 ### Guided tutorial - Story games
 
-1. Lead students through the tutorials starting at <a href="../../education/build-it-play-it-story-games/opening-the-template.md" target="_blank" rel="noopener">Opening the Template.</a> and ending with <a href="../../education/build-it-play-it-story-games/finish-and-add.md" target="_blank" rel="noopener">Finish and Add</a>.
+1. Lead students through the tutorials starting at <a href="../../tutorials/curriculums/coding/get-started.md#open-template" target="_blank" rel="noopener">Open template</a> and ending with <a href="../../tutorials/curriculums/coding/customize-strings.md" target="_blank" rel="noopener">Customize strings</a>.
 
 ### Independent work - Finish student projects
 
-1. Show students the tips and tricks from <a href="../../education/build-it-play-it-story-games/finish-and-add.md#optional-additions" target="_blank" rel="noopener">Finish and Add</a>.
+1. Show students the tips and tricks from <a href="../../tutorials/curriculums/coding/customize-strings.md" target="_blank" rel="noopener">Customize strings</a>.
 2. Have students catch up on their projects. If finished, add the following challenges, have them add two or more characters (each using a different variable: name2, name3).
 
 ### Wrap up