📖 Add npm verb to quickly demo docs (#2516)

Co-authored-by: Rowan Cockett <[email protected]>

Author: choldgraf

docs/developer.md

@@ -309,6 +309,14 @@ The build process uses unix commands that might not work properly on Windows.
 When building on Windows, use either WSL or a unix-like shell (such as Git Bash or MSYS2), and make sure that npm is set to use these by default (`npm config set script-shell path/to/shell.exe`).
 ```
 
+### Local docs workflows (preview/build)
+
+To run a MyST server with your local changes and a preview of the documentation, run:
+
+```shell
+$ npm run docs
+```
+
 ## Local development: myst-theme
 
 The [`myst-theme` README](https://github.com/jupyter-book/myst-theme/) provides a more detailed overview of the components of that package.

package.json

@@ -7,6 +7,8 @@
   "scripts": {
     "build": "turbo run build",
     "dev": "turbo run dev --parallel",
+    "docs": "npm-run-all -l build --parallel dev docs:run",
+    "docs:run": "cd docs && node ../packages/mystmd/dist/myst.cjs start",
     "clean": "turbo run clean --parallel && find . -name '.turbo' -type d -prune -exec rimraf '{}' +",
     "link": "turbo run link",
     "lint": "turbo run lint",