reorganized repo and updated documentation visuals

Author: ltmx

.github/CONTRIBUTING.md

@@ -30,10 +30,10 @@ jobs:
         with:
           python-version: '3.12'
           cache: pip
-          cache-dependency-path: requirements-docs.txt
+          cache-dependency-path: website/requirements-docs.txt
 
       - name: Install Python docs dependencies
-        run: pip install -r requirements-docs.txt
+        run: pip install -r website/requirements-docs.txt
 
       - name: Cache DocFX global tool
         uses: actions/cache@v4
@@ -50,7 +50,7 @@ jobs:
 
       - name: Build API reference
         run: |
-          cd Documentation~
+          cd website/Documentation~
           dotnet build Mathx.Docs.csproj
           docfx metadata docfx.json
           python tools/organize_mathx_api.py
@@ -59,18 +59,19 @@ jobs:
 
       - name: Stage API into docs tree
         run: |
-          rm -rf docs~/api
-          mkdir -p docs~/api
-          cp -r Documentation~/api/_site/* docs~/api/
-          cp docs~/api-stub/index.html docs~/api/index.html
+          rm -rf website/docs~/api
+          mkdir -p website/docs~/api
+          cp -r website/Documentation~/api/_site/* website/docs~/api/
+          cp website/docs~/api-stub/index.html website/docs~/api/index.html
 
       - name: Build site
+        working-directory: website
         run: mkdocs build
 
       - name: Upload Pages artifact
         uses: actions/upload-pages-artifact@v3
         with:
-          path: site~
+          path: website/site~
 
   deploy:
     needs: build

.github/workflows/docs.yml

@@ -47,13 +47,13 @@ jobs:
           git config user.name "github-actions[bot]"
           git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
 
-          CURRENT="$(jq -r '.version' package.json)"
+          CURRENT="$(jq -r '.version' package/package.json)"
           if [ "$CURRENT" = "$VERSION" ]; then
             echo "package.json already at $VERSION"
           else
-            jq --arg version "$VERSION" '.version = $version' package.json > package.json.tmp
-            mv package.json.tmp package.json
-            git add package.json
+            jq --arg version "$VERSION" '.version = $version' package/package.json > package/package.json.tmp
+            mv package/package.json.tmp package/package.json
+            git add package/package.json
             git commit -m "chore: release $TAG [skip ci]"
           fi
 
@@ -63,17 +63,10 @@ jobs:
 
       - name: Create package archive
         run: |
-          zip -r "${{ github.event.repository.name }}.zip" . \
+          cd package
+          zip -r "../${{ github.event.repository.name }}.zip" . \
             -x "*.git*" \
-            -x ".github/*" \
-            -x ".cursorignore" \
-            -x "Tests/*" \
-            -x "Documentation~/*" \
-            -x "docs~/*" \
-            -x "overrides~/*" \
-            -x "mkdocs.yml" \
-            -x "requirements-docs.txt" \
-            -x "site~/*"
+            -x "Tests/*"
 
       - name: Create GitHub Release
         uses: softprops/action-gh-release@v2

.github/workflows/main.yml

@@ -1,21 +1,18 @@
 *.csproj
-!Documentation~/**/*.csproj
+!website/Documentation~/**/*.csproj
 *.csproj.meta
 
-# Documentation builds (~ suffix = Unity ignores folder on import)
-site~/
-docs~/api/
-docs.meta
-overrides.meta
-site.meta
-Documentation~/api/
-Documentation~/**/*.meta
-Documentation~/**/bin/
-Documentation~/**/obj/
-Documentation~/**/*.dll
-Documentation~/**/*.pdb
-Documentation~/**/*.deps.json
-Documentation~/**/obj/**/*.cs
-Documentation~/**/obj/**/*.cache
-Documentation~/**/obj/**/*.editorconfig
-Documentation~/**/obj/**/*.txt
+# Documentation builds
+website/site~/
+website/docs~/api/
+website/Documentation~/api/
+website/Documentation~/**/*.meta
+website/Documentation~/**/bin/
+website/Documentation~/**/obj/
+website/Documentation~/**/*.dll
+website/Documentation~/**/*.pdb
+website/Documentation~/**/*.deps.json
+website/Documentation~/**/obj/**/*.cs
+website/Documentation~/**/obj/**/*.cache
+website/Documentation~/**/obj/**/*.editorconfig
+website/Documentation~/**/obj/**/*.txt