Switch documentation toolchain from MkDocs 1.x to Zensical

[Copilot]

MkDocs 1.x is sunsetted and the draft docs PR (#23) pinned mkdocs<2 to avoid breakage. This replaces that setup with Zensical — a modern static site generator from the creators of Material for MkDocs — removing the version pin entirely.

Config

• Replaced mkdocs.yml (YAML) with zensical.toml (TOML) — equivalent nav, dark/light palette toggle, and feature flags (navigation.tabs, navigation.sections, content.code.copy, etc.)

CI

• Updated .github/workflows/docs.yml: installs zensical, runs zensical build --clean, deploys to GitHub Pages via upload-pages-artifact + deploy-pages

-      - run: pip install "mkdocs-material" "mkdocs<2"
-      - run: mkdocs build --strict
+      - run: pip install zensical
+      - run: zensical build --clean

Docs content

• All six pages from PR Add MkDocs Material documentation site with per-platform webhook guides and GitHub Pages deployment #23 carried over unchanged: docs/index.md, docs/api.md, and platform guides for Discord, Slack, Webex, and Microsoft Teams

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• zensical.com
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node /home/REDACTED/work/_temp/ghcca-node/node/bin/node --enable-source-maps /home/REDACTED/work/_temp/copilot-developer-action-main/dist/index.js (dns block)
• zensical.org
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node /home/REDACTED/work/_temp/ghcca-node/node/bin/node --enable-source-maps /home/REDACTED/work/_temp/copilot-developer-action-main/dist/index.js (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.