docs: apply suggestions

Author: 3w36zj6

website/typst-docs-web/README.md

@@ -4,7 +4,7 @@
   <img src="./images/preview.png" alt="">
 </div>
 
-A generator that builds a website from a documentation JSON file generated by typst-docs.
+Build a website from the documentation JSON file generated by [typst-docs](https://github.com/typst/typst/blob/main/docs/Cargo.toml#L2).
 
 ## Required toolchains
 
@@ -23,6 +23,9 @@ bun = "1.2.21"
 
 ## Setup
 
+> [!NOTE]
+> The JSON structure generated by typst-docs is not stable and may change at any time. This project is confirmed to be compatible with typst-docs [v0.13.1](https://github.com/typst/typst/tree/v0.13.1). Other versions are usually compatible as well, but they have not been tested carefully.
+
 The typst-docs CLI outputs the static files required for building the documentation. Place the JSON file and assets generated by typst-docs in the `/public/` directory. In most use cases, symbolic links are convenient.
 
 ```sh
@@ -40,7 +43,7 @@ Create `/public/metadata.json` and describe the metadata for the documentation w
 
 ```json
 {
-  "$schema": "/path/to/typst-docs-web/metadata.schema.json",
+  "$schema": "../metadata.schema.json",
   "language": "ja-JP",
   "version": "0.13.1",
   "typstOfficialUrl": "https://typst.app",