docs: refresh docs and add tunnel usage guide (#666)

Add a new tunnels page with verified, up-to-date CLI examples
Remove deprecated `--daemon` usage and clarify QR/password behavior
Add docs validation tooling and docs-source workflow for packaging and sync

packages/docs/DEPLOYMENT.md

@@ -0,0 +1,42 @@
+# Docs Source Deployment
+
+This repo publishes docs **source artifacts**.
+
+Rendering and hosting still happen in `openchamber-website` (`apps/docs`).
+
+## Workflow
+
+Use `.github/workflows/docs-source.yml`.
+
+Triggers:
+
+- push to `main` when docs source changes
+- release published
+- manual `workflow_dispatch`
+
+Outputs:
+
+- validates docs (`bun run docs:validate`)
+- creates `openchamber-docs-source-<sha>.tar.gz`
+- uploads archive as workflow artifact
+- on release/manual with tag, uploads archive to release assets
+
+## Optional cross-repo sync trigger
+
+The workflow can trigger a `repository_dispatch` event in `openchamber-website`.
+
+Set secret in this repo:
+
+- `OPENCHAMBER_WEBSITE_REPO_TOKEN` (token with access to `openchamber/openchamber-website`)
+
+Event sent:
+
+- `event_type: docs_source_updated`
+
+Payload includes:
+
+- `source_repo`
+- `source_ref`
+- `archive_name`
+
+`openchamber-website` can listen for this event and pull docs source from release artifacts.