chore: migrate documentation from website/ to docs/ directory

- Update .gitignore to reflect new docs directory structure.
- Modify CONTRIBUTING.md and README.md to point to the new docs location.
- Adjust GitHub workflows for Docusaurus build and deployment to use the docs directory.
- Remove old website files including package.json, package-lock.json, and docusaurus.config.js.
- Update references in various files to ensure consistency with the new documentation structure.

Author: rithulkamesh

.github/workflows/docs-deploy.yml

@@ -1,5 +1,6 @@
-# When you push a version tag (e.g. v1.6.0), create a GitHub Release, push versioned docs to main, and publish to PyPI.
-# Note: Creating a release with GITHUB_TOKEN does NOT trigger other workflows, so we run versioned-docs and PyPI here.
+# When you push a version tag (e.g. v1.6.0), create a GitHub Release and publish to PyPI.
+# Note: Creating a release with GITHUB_TOKEN does NOT trigger other workflows.
+# Docs versioning and deploy live in the docs repo.
 #
 # Usage:
 #   git tag v1.6.0
@@ -52,48 +53,4 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
-  push-version-docs:
-    needs: release
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-    steps:
-      - name: Checkout main
-        uses: actions/checkout@v4
-        with:
-          ref: main
-          fetch-depth: 0
-
-      - name: Set up Node
-        uses: actions/setup-node@v4
-        with:
-          node-version: "20"
-          cache: "npm"
-          cache-dependency-path: website/package-lock.json
-
-      - name: Get version from tag
-        id: version
-        run: |
-          V="${GITHUB_REF#refs/tags/v}"
-          echo "version=$V" >> $GITHUB_OUTPUT
-
-      - name: Install and add docs version
-        run: |
-          cd website
-          npm ci
-          V="${{ steps.version.outputs.version }}"
-          if [ -d "versioned_docs/version-$V" ]; then
-            echo "Docs version $V already exists, skipping."
-          else
-            npx docusaurus docs:version "$V"
-          fi
-
-      - name: Push versioned docs to main
-        run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-          git add website/versioned_docs website/versioned_sidebars website/versions.json
-          git diff --staged --quiet || git commit -m "chore(docs): add version ${{ steps.version.outputs.version }}"
-          git push origin HEAD:main
-
 

.github/workflows/release-on-tag.yml

@@ -33,12 +33,6 @@ examples/output/
 # MkDocs build output
 site/
 
-# Docusaurus (website/)
-website/node_modules/
-website/build/
-website/.docusaurus/
-website/.cache/
-
 # System
 .DS_Store
 Thumbs.db

.gitignore

@@ -36,7 +36,7 @@ Run a subset: `uv run python -m pytest tests/test_swarm.py -v`. Version-specific
 
 - Keep PRs focused (one feature or fix when possible).
 - Ensure all tests pass and lint/format checks succeed.
-- Update docs in `website/docs/` if you change user-facing behavior or add features (site: [docs.devsper.com](https://docs.devsper.com)).
+- Update docs in the **docs** repo if you change user-facing behavior or add features (site: [docs.devsper.com](https://docs.devsper.com)).
 - For new tools or providers, add a short note in the relevant doc (e.g. [tools](https://docs.devsper.com/docs/tools), [providers](https://docs.devsper.com/docs/providers)).
 
 ## Adding tools or features

CONTRIBUTING.md

@@ -246,7 +246,7 @@ Outputs under `examples/output/`. Run from project root when using script paths.
 
 ## Documentation
 
-Full docs (with versioning and dark mode): **[docs.devsper.com](https://docs.devsper.com)**. Source lives in `website/docs/` and is built with [Docusaurus](https://docusaurus.io).
+Full docs (with versioning and dark mode): **[docs.devsper.com](https://docs.devsper.com)**. Source and deploy live in the **docs** repo.
 
 | Doc | Description |
 |-----|-------------|

README.md

@@ -2,8 +2,8 @@
 
 The documentation site is built with [Docusaurus](https://docusaurus.io) and deployed at **https://docs.devsper.com**.
 
-- **Source:** `website/docs/` in this repo
-- **Local dev:** From repo root run `cd website && npm install && npm run start`
-- **Build:** `cd website && npm run build`
+- **Source and deploy:** the **docs** repo (Docusaurus site; CI and deploy live there).
+- **Local dev:** In the docs repo run `npm install && npm run start`.
+- **Build:** In the docs repo run `npm run build`.
 
 The table in the main [README](../README.md) links to the deployed docs.