doc: v3 query as a service (#500)

* doc: v3 query as a service * fix doc errors * addressing PR comments * add server adapter sample * update submodules

Author: ymc9

.gitmodules

@@ -22,3 +22,6 @@
 [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
+[submodule "code-repos/zenstackhq/v3-doc-server-adapter"]
+path = code-repos/zenstackhq/v3-doc-server-adapter
+url = https://github.com/zenstackhq/v3-doc-server-adapter

code-repos/zenstackhq/v3-doc-orm

@@ -101,7 +101,7 @@ The factory function accepts an options object with the following fields:
 
 - externalIdMapping
 
- Optional. An `Record<string, string>` value that provides a mapping from model names (as defined in ZModel) to unique contraint name. This is useful when you for example want to expose natural keys in place of a surrogate keys:
+ Optional. An `Record<string, string>` value that provides a mapping from model names (as defined in ZModel) to unique constraint name. This is useful when you for example want to expose natural keys in place of a surrogate keys:
 
  ```ts
  // Expose tags by unique name and not by ID, ie. /tag/blue intead of /tag/id
@@ -112,7 +112,7 @@ The factory function accepts an options object with the following fields:
  })
  ```
 
- Currentlly it is not possible to use custom index names. This also works for compound unique contraints just like for [compound IDs](#compound-id-fields).
+ Currently it is not possible to use custom index names. This also works for compound unique constraints just like for [compound IDs](#compound-id-fields).
 
 
 ## Endpoints and Features
@@ -408,15 +408,15 @@ You can use the `filter[:selector1][:selector2][...]=value` [query parameter fam
 
 1. Filtering with multiple values
 
- Multiple filter values can be separated by comma. Items statisfying any of the values will be returned.
+ Multiple filter values can be separated by comma. Items satisfying any of the values will be returned.
 
  ```ts
  GET /api/post?filter[author]=1,2
  ```
 
 1. Multiple filters
 
- A request can carry multiple filters. Only items statisfying all filters will be returned.
+ A request can carry multiple filters. Only items satisfying all filters will be returned.
 
  ```ts
  GET /api/post?filter[author]=1&filter[published]=true
@@ -700,7 +700,7 @@ PUT /:type/:id
 PATCH /:type/:id
 ```
 
-Both `PUT` and `PATCH` do partial update and has exactly the same behavior.
+Both `PUT` and `PATCH` perform partial updates with identical behavior.
 
 :::info
 Besides plain fields, you can also include relationships in the request body. Please note that this won't update the related resource; instead if only replaces the relationships. If you update a to-many relationship, the new collection will entirely replace the old one.
@@ -836,7 +836,7 @@ PATCH /:type/:id/relationships/:relationship
 ```
 
 :::info
-`PUT` and `PATCH` has exactly the same behavior and both relace the existing relationships with the new ones entirely.
+`PUT` and `PATCH` have identical behavior and both replace the existing relationships with the new ones entirely.
 :::
 
 ##### Status codes
@@ -917,7 +917,7 @@ The JSON:API specification doesn't have a native way to represent compound IDs.
 }
 ```
 
-You can use this ID value convension in places where an ID is needed, e.g., reading a single entity.
+You can use this ID value convention in places where an ID is needed, e.g., reading a single entity.
 
 ```ts
 GET /post/1_2