update docs

Author: amide-init

content/index.md

@@ -22,4 +22,5 @@ Analyze PostgreSQL schemas and generate NoSQL (MongoDB) design and migration scr
 ## Links
 
 - [GitHub](https://github.com/usedamru/sql2nosql)
+- [Live docs](https://usedamru.github.io/sql2nosql/) (GitHub Pages)
 - Config: `sql2nosql.config.json` at project root

docs-site/README.md

@@ -0,0 +1,40 @@
+# Damru — sql2nosql docs
+
+Documentation site for **sql2nosql** (Damru). Built with VitePress; content lives in repo root `content/`.
+
+## Develop
+
+From repo root:
+
+```bash
+yarn docs:dev
+```
+
+Or from this folder:
+
+```bash
+yarn install
+yarn dev
+```
+
+Opens at `http://localhost:5173`.
+
+## Build
+
+```bash
+yarn docs:build
+```
+
+Output: `docs-site/.vitepress/dist`.
+
+## Deploy (GitHub Pages)
+
+The workflow `.github/workflows/deploy-docs.yml` builds and deploys on every push to `main`.
+
+**One-time setup:** Repo → **Settings** → **Pages** → **Source**: **GitHub Actions**.
+
+Live site: **https://usedamru.github.io/sql2nosql/** (Damru / usedamru org).
+
+## Content
+
+Edit **repo root `content/*.md`** only. The site uses `srcDir: '../content'`—no duplication.

docs-site/content/README.md

@@ -1,5 +1,5 @@
 # Content is in repo root
 
-The docs site reads markdown from **`content/`** at the **repo root** (one level above `docs-site/`).
+The **Damru** docs site reads markdown from **`content/`** at the repo root (one level above `docs-site/`).
 
 Do not add `.md` files here. Edit `../content/*.md` instead so the docs and the site stay in sync.