update

Author: ymc9

versioned_docs/version-3.x/modeling/_category_.yml

@@ -1,4 +1,4 @@
-position: 2
+position: 3
 label: Data Modeling
 collapsible: true
 collapsed: true

versioned_docs/version-3.x/orm/_category_.yml

@@ -1,4 +1,4 @@
-position: 3
+position: 4
 label: ORM
 collapsible: true
 collapsed: true

versioned_docs/version-3.x/orm/errors.md

@@ -0,0 +1,20 @@
+---
+sidebar_position: 16
+description: ORM Errors
+---
+
+# Errors
+
+The ORM uses the following error classes from `@zenstackhq/runtime` to represent different types of failures:
+
+## `ValidationError`
+
+This error is thrown when the argument passed to the ORM methods is invalid, e.g., missing required fields, or containing unknown fields. The `cause` property is set to the original error thrown during validation.
+
+## `NotFoundError`
+
+This error is thrown when a requested record is not found in the database, e.g., when calling `findUniqueOrThrow`, `update`, etc.
+
+## `QueryError`
+
+This error is used to encapsulate all other errors thrown from the underlying database driver. The `cause` property is set to the original error thrown.

versioned_docs/version-3.x/orm/migration.md

@@ -1,9 +1,8 @@
 ---
-sidebar_position: 16
-description: Schema migration introduction
+sidebar_position: 17
 ---
 
-# Database Schema Migration
+# Database Migration
 
 Database schema migration is a crucial aspect of application development. It helps you keep your database schema in sync with your data model and ensures deployments are smooth and predictable. ZenStack provides migration tools that create migration scripts based on the ZModel schema and apply them to the database.
 

versioned_docs/version-3.x/prerequisite.md

@@ -0,0 +1,21 @@
+---
+sidebar_position: 2
+---
+
+# Prerequisite
+
+## Node.js
+
+Node.js v20 or above.
+
+## TypeScript
+
+TypeScript v5.8.0 or above.
+
+## IDE Extension
+
+If you use VSCode, please install the [ZenStack VSCode Extension](https://marketplace.visualstudio.com/items?itemName=zenstack.zenstack) for syntax highlighting, auto-completion, and error reporting. Make sure you switch to the prerelease version that's compatible with v3.
+
+![VSCode Extension](./vscode.png)
+
+Other IDEs are not supported at this time.

versioned_docs/version-3.x/recipes/_category_.yml

@@ -10,3 +10,4 @@ sidebar_position: 11
 - [ ] Performance benchmark
 - [ ] Query-as-a-Service (automatic CRUD API)
 - [ ] Json filter
+- [ ] Custom procedures