docs: improve README with setup and commands

Author: spicyfalafel

README.md

@@ -1,27 +1,43 @@
 # MDMbox Documentation
 
-This repository contains the documentation for [MDMbox](https://www.health-samurai.io/mdmbox) - Master data management for healthcare organizations.
+Documentation for [MDMbox](https://www.health-samurai.io/mdmbox) — Master data management for healthcare organizations.
 
-## Structure
+## Prerequisites
+
+- [Bun](https://bun.sh) installed
+
+## Setup
 
+```bash
+bun install
 ```
-mdmbox-docs/
-├── docs/           # Markdown documentation files
-├── assets/         # Images and other assets
-├── SUMMARY.md      # Navigation structure
-└── redirects.yaml  # URL redirects
+
+This installs [docs-tools](https://github.com/HealthSamurai/docs-tools) and sets up a pre-push git hook that runs lint before every push.
+
+## Commands
+
+```bash
+bun lint                       # run all doc checks
+bun lint:check broken-links    # run a single check
+bun images:check               # find unoptimized images
+bun images:optimize            # convert to AVIF + update refs
 ```
 
-## Local Development
+## Structure
 
-Documentation is rendered by the [health-samurai.io](https://health-samurai.io) portal.
+```
+docs/           # Markdown documentation files
+assets/         # Images and other assets
+SUMMARY.md      # Navigation structure
+redirects.yaml  # URL redirects
+```
 
 ## Contributing
 
-1. Edit markdown files in `docs/`
-2. Update `SUMMARY.md` if adding new pages
-3. Submit a pull request
-
-## License
+1. `bun install` (once, sets up tools + pre-push hook)
+2. Edit markdown files in `docs/`
+3. Update `SUMMARY.md` if adding new pages
+4. `bun lint` to check before pushing
+5. Submit a pull request
 
-MIT
+CI runs lint automatically on PRs. Image optimization runs on push to main.