From 19d239430a760b329d4ed45a1846880d9ae8d3fb Mon Sep 17 00:00:00 2001
From: Patrick Kollitsch <davidsneighbourdev+gh@gmail.com>
Date: Fri, 20 Nov 2026 01:29:19 +0000
Subject: [PATCH] feat(dev): add shared documentation preview

---
 CONTRIBUTING.md |    4 ++--
 package.json    |    1 +
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index f5a7ed7..a2f2a36 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -41,10 +41,10 @@
 1. Run a local preview via `npm run` instead of just calling `hugo server`:
 
 ```bash
-npm run server
+npm run dev
 ```
 
- This runs the documentation site from `site/` using contents from `docs/` with local configuration.
+ This runs the sibling `documentation/` site with the local Ananke working tree. Keep both repositories next to each other, install the documentation dependencies, and use Node.js 22.18 or later. The calling repository stays on its branch: `main` selects the companion's `main`, `development` selects `development`, and other named branches select the same local branch in the companion when it exists. Otherwise, they select `development`. The launcher prints both branches and any switch it makes, and stops if the companion needs switching but has uncommitted or untracked changes (excluding `scratch/`). Stop the server before selecting another branch pair. You can run the same command from either repository; see the [documentation development guide](https://github.com/gohugo-ananke/documentation#running-locally).
 
 1. Follow the coding style and format commit messages as described in the conventional commits specification (for example: `docs: add troubleshooting section` or `fix: correct hero image path`).
 
diff --git a/package.json b/package.json
index 0b63757..79eb41b 100644
--- a/package.json
+++ b/package.json
@@ -43,6 +43,7 @@
     "yaml": "2.9.1"
   },
   "scripts": {
+    "dev": "node ../documentation/scripts/dev.ts",
     "hook:commit": "lint-staged",
     "hook:push": "node -e \"process.exit(require('child_process').execSync('git branch --show-current').toString().trim() === 'main' ? 0 : 1)\" && node scripts/test-hugo-quickstart.ts || true",
     "lint:links": "lychee --config lychee.toml public",

--
Gitblit v1.10.0