docs: document new documentation

Author: moonmeister

README.md

@@ -27,7 +27,39 @@ Faust.js is a toolkit for building Next.js applications for headless WordPress s
 
 ## Documentation
 
-Visit [https://faustjs.org/docs/getting-started](https://faustjs.org/docs/getting-started) to view the full documentation.
+Visit [https://faustjs.org/docs/](https://faustjs.org/docs/getting-started) to view the full documentation.
+
+### Editing Docs
+
+Docs are MD in [`docs`](docs/). Here are a couple things you should know!
+
+1.  Our Docs support [Github Flavored Markdown](https://github.github.com/gfm/) (GFM).
+2.  Images should be stored along side the doc that uses them in an `images/` folder.
+3.  Shared Images can be stored in a shared folder @ `docs/images`
+4.  [Callouts](https://github.com/lin-stephanie/rehype-callouts?tab=readme-ov-file#rehype-callouts): These are similar to block quotes or an aside but for various warnings, info, pro times, etc.
+5.  Code Blocks:
+
+    - Required
+      1. Specify a language: ` ```js ` or `` `const inlineCode = [1,2,3];{:js}` ``
+         - Commands for a users terminal = `bash`
+         - env files = `ini`
+         - JavaScript = `js`
+         - TypeScript = `ts`
+         - GraphQL = `gql`
+         - JSON = `json`
+         - For a full list see: https://shiki.style/languages
+      2. Add [line numbers](https://rehype-pretty.pages.dev/#line-numbers) to any complex code. `ini` and `bash` don't need to show line numbers generally. ` ```js showLineNumbers`
+      3. Complete files should have a [file names](https://rehype-pretty.pages.dev/#titles) ` ```js title="pages/_app.js`
+    - Optional
+
+      1.  Lines can be [highlighted](https://rehype-pretty.pages.dev/#highlight-lines) in code blocks ` ```js {1,3-5}`. There are a variety of advanced highlighting methods, see: https://rehype-pretty.pages.dev/#highlight-lines
+      2.  Lines may be [diffed](https://shiki.style/packages/transformers#transformernotationdiff) in a code block:
+
+              ```js
+              console.log('hewwo') // [!code --]
+              console.log('hello') // [!code ++]
+              console.log('goodbye')
+              ```
 
 ## WordPress Plugin (FaustWP)