doc: v3 access policy and input validation (#495)

* WIP: policy docs

* update

* update

* fix broken links

* update

* update

Author: ymc9

.gitmodules

@@ -16,3 +16,9 @@
 [submodule "code-repos/zenstackhq/v3-doc-orm-polymorphism"]
 	path = code-repos/zenstackhq/v3-doc-orm-polymorphism
 	url = https://github.com/zenstackhq/v3-doc-orm-polymorphism.git
+[submodule "code-repos/zenstackhq/v3-doc-orm-validation"]
+	path = code-repos/zenstackhq/v3-doc-orm-validation
+	url = https://github.com/zenstackhq/v3-doc-orm-validation.git
+[submodule "code-repos/zenstackhq/v3-doc-orm-policy"]
+	path = code-repos/zenstackhq/v3-doc-orm-policy
+	url = https://github.com/zenstackhq/v3-doc-orm-policy.git

README.md

@@ -1,6 +1,6 @@
 # Website
 
-This website is built using [Docusaurus 2](https://docusaurus.io/), a modern static website generator.
+This website is built using [Docusaurus 3](https://docusaurus.io/), a modern static website generator.
 
 ### Installation
 
@@ -23,19 +23,3 @@ $ pnpm build
 ```
 
 This command generates static content into the `build` directory and can be served using any static contents hosting service.
-
-### Deployment
-
-Using SSH:
-
-```
-$ USE_SSH=true pnpm deploy
-```
-
-Not using SSH:
-
-```
-$ GIT_USER=<Your GitHub username> pnpm deploy
-```
-
-If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.

blog/better-auth/index.mdx

@@ -434,7 +434,7 @@ type Auth {
 }
 ```
 
-Now, we're ready to write the policy rules. You can find more information about access polices [here](https://zenstack.dev/docs/the-complete-guide/part1/access-policy/).
+Now, we're ready to write the policy rules. You can find more information about access policies [here](https://zenstack.dev/docs/the-complete-guide/part1/access-policy/).
 
 #### 1. Tenant segregation
 

code-repos/zenstackhq/v3-doc-orm-policy

@@ -60,7 +60,7 @@ The short answer is it works in most cases. Please refer to [this guide](./guide
 
 ### Does the order in which access policies are defined matter?
 
-No. See [here](./the-complete-guide/part1/4-access-policy/4.1-model-level.md#evaluation-of-model-level-policies) for how access polices are evaluated.
+No. See [here](./the-complete-guide/part1/4-access-policy/4.1-model-level.md#evaluation-of-model-level-policies) for how access policies are evaluated.
 
 ### Is Prisma's new "prisma-client" generator supported?
 

code-repos/zenstackhq/v3-doc-orm-validation

@@ -4,7 +4,7 @@ import GithubCodeBlock from './GithubCodeBlock';
 
 interface StackBlitzGithubProps {
     repoPath: string;
-    openFile?: string;
+    openFile?: string | string[];
     codeFiles?: string[];
     startScript?: string;
 }
@@ -15,14 +15,16 @@ const StackBlitzGithub: React.FC<StackBlitzGithubProps> = ({
     codeFiles: plainCodeFiles = undefined,
     startScript,
 }) => {
+    const openFiles = Array.isArray(openFile) ? openFile : openFile ? openFile.split(',') : [];
+
     const options = {
-        openFile,
+        openFile: openFiles ? openFiles.join(',') : undefined,
         view: 'editor',
         startScript,
     } as const;
 
     if (!plainCodeFiles) {
-        plainCodeFiles = [openFile];
+        plainCodeFiles = [...openFiles];
     }
 
     return (

code-repos/zenstackhq/v3-doc-quick-start

@@ -221,7 +221,7 @@ model Mentorship {
 }
 ```
 
-## Referential Actions
+## Referential Action
 
 When defining a relation, you can use referential action to control what happens when one side of a relation is updated or deleted by setting the `onDelete` and `onUpdate` parameters in the `@relation` attribute.
 

docs/faq.md

@@ -0,0 +1,7 @@
+---
+sidebar_position: 4
+---
+
+# Field-Level Policies 🚧
+
+Coming soon.