Default docusaurus site. Add github workflows for deployment of documentation to github pages on push. Restructure project. Nice monorepo.

Author: aureateAnatidae

.github/workflows/deploy-docsite.yml

@@ -0,0 +1,61 @@
+name: Deploy documentation site to GitHub Pages
+
+on:
+    push:
+        branches:
+            - main
+    workflow_dispatch:
+
+
+defaults:
+    run:
+        working-directory: website
+
+jobs:
+    build:
+        name: Build Docusaurus
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v4
+              with:
+                  fetch-depth: 0
+            - uses: pnpm/action-setup@v4
+              name: Install pnpm
+              with:
+                  version: 10
+                  run_install: false
+            - uses: actions/setup-node@v4
+              with:
+                  cache-dependency-path: website/pnpm-lock.yaml
+                  node-version: 20
+                  cache: pnpm
+
+            - name: Install dependencies
+              run: pnpm i
+            - name: Build website
+              run: pnpm run build
+
+            - name: Upload Build Artifact
+              uses: actions/upload-pages-artifact@v3
+              with:
+                  path: build
+
+    deploy:
+        name: Deploy to GitHub Pages
+        needs: build
+
+        # Grant GITHUB_TOKEN the permissions required to make a Pages deployment
+        permissions:
+            pages: write # to deploy to Pages
+            id-token: write # to verify the deployment originates from an appropriate source
+
+        # Deploy to the github-pages environment
+        environment:
+            name: github-pages
+            url: ${{ steps.deployment.outputs.page_url }}
+
+        runs-on: ubuntu-latest
+        steps:
+            - name: Deploy to GitHub Pages
+              id: deployment
+              uses: actions/deploy-pages@v4

.github/workflows/test-deploy-docsite.yml

@@ -0,0 +1,34 @@
+name: Test documentation site deployment
+
+on:
+    pull_request:
+        branches:
+            - main
+
+defaults:
+    run:
+        working-directory: ./website
+
+jobs:
+    test-deploy:
+        name: Test deployment
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v4
+              with:
+                  fetch-depth: 0
+            - uses: pnpm/action-setup@v4
+              name: Install pnpm
+              with:
+                  version: 10
+                  run_install: false
+            - uses: actions/setup-node@v4
+              with:
+                  cache-dependency-path: website/pnpm-lock.yaml
+                  node-version: 20
+                  cache: npm
+
+            - name: Install dependencies
+              run: npm ci
+            - name: Test build website
+              run: npm run build