Merge zensical branch: Complete migration to Zensical documentation platform

This merge completes the migration from MkDocs Material to Zensical, including:
- New zensical.toml configuration replacing mkdocs.yml
- Updated GitHub Actions workflow for Zensical builds
- Updated README.md with Zensical instructions
- Enhanced documentation content and organization
- Updated dependencies in requirements.txt

Co-Authored-By: Claude Sonnet 4.5 (1M context) <noreply@anthropic.com>

Author: tyson-swetnam

.github/workflows/gh-actions.yml

@@ -12,10 +12,14 @@ jobs:
       - uses: actions/checkout@v3
       - uses: actions/setup-python@v4
         with:
-          python-version: 3.9
-      - name: run requirements file
-        run:  pip install -r requirements.txt 
-      - name: Deploy docs
-        run: mkdocs gh-deploy --force
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          python-version: 3.11
+      - name: Install dependencies
+        run: pip install -r requirements.txt
+      - name: Build documentation
+        run: zensical build
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./site
+          force_orphan: true

.gitignore

@@ -126,4 +126,8 @@ venv.bak/
 dmypy.json
 
 # Pyre type checker
-.pyre/
+.pyre/
+
+# Claude Code
+CLAUDE.md
+.claude/

README.md

@@ -1,38 +1,47 @@
-A special thanks to [Mojib Wali](https://github.com/mb-wali) of [CyVerse-Austria](https://www.tugraz.at/sites/cyverse/home), Graz University of Technology, Austria, for creating these Material MkDocs pages for the global CyVerse developer and maintainer community!
+A special thanks to [Mojib Wali](https://github.com/mb-wali) of [CyVerse-Austria](https://www.tugraz.at/sites/cyverse/home), Graz University of Technology, Austria, for creating the initial Material MkDocs pages for the global CyVerse developer and maintainer community!
 
 CyVerse Core Software Documentation
 ===================================
 
-These documents are for the deployment and maintenence of  [CyVerse](https://cyverse.org)
+These documents are for the deployment and maintenance of [CyVerse](https://cyverse.org)
 
-## MkDocs deploy GitHub Action
+## Zensical Static Site Generator
 
-The `main` branch uses [deploy-mkdocs](https://github.com/marketplace/actions/deploy-mkdocs) GitHub Action.
+This documentation is built using [Zensical](https://zensical.com), a modern static site generator from the team behind Material for MkDocs. The site uses Zensical's "classic" theme which provides the familiar Material for MkDocs appearance with enhanced features.
 
-Do not commit changes directly to the `main` branch unless necessary. Please commit your updates to the `mkdocs` branch, test on CodeSpaces or locally, and then commit those merges back to `main`.
+## GitHub Actions Deployment
 
-Commits to `main` will trigget the Action which re-builds and deploys the website to https://docs.cyverse.org -- which is publicly available. 
+The `main` branch uses GitHub Actions to automatically build and deploy the documentation.
 
-## Rendered with the Material Theme
+Do not commit changes directly to the `main` branch unless necessary. Please commit your updates to the `mkdocs` branch, test on CodeSpaces or locally, and then commit those merges back to `main`.
 
-To change to [MkDocs Material](https://squidfunk.github.io/mkdocs-material/) theme, change [Action](./github/workflows/main.yml) to `@master` and set `theme: material` in the [mkdocs.yml](./mkdocs.yml):
+Commits to `main` will trigger the Action which re-builds and deploys the website to https://docs.cyverse.org -- which is publicly available.
 
-```
-theme:
-  name: material
-```
+## Configuration
 
-## Build
+The documentation is configured using `zensical.toml` (TOML format) instead of the traditional `mkdocs.yml`. This provides better configuration management and access to Zensical-specific features.
 
-```
+## Local Development
+
+```bash
 git clone https://github.com/cyverse/docs
 cd docs
 pip install -r requirements.txt
-python -m mkdocs serve
+zensical serve
 ```
 
-After compiling the new pages the service will open on `http://localhost:8000/docs` 
+After starting the development server, the site will open at `http://localhost:8000`
 
 Open in browser and view
 
-Recommended: two monitors for easier display while working on docs. 
+Recommended: two monitors for easier display while working on docs.
+
+## Building
+
+To build the static site:
+
+```bash
+zensical build
+```
+
+Output will be in the `./site` directory.