Add docs

Author: bbqsrc

.github/workflows/docs.yml

@@ -0,0 +1,36 @@
+name: Documentation
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'docs/**'
+      - '.github/workflows/docs.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/configure-pages@v5
+      - uses: actions/checkout@v5
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.x
+      - run: pip install zensical
+      - run: |
+          cd docs
+          zensical build --clean
+      - uses: actions/upload-pages-artifact@v4
+        with:
+          path: docs/site
+      - uses: actions/deploy-pages@v4

.gitignore

@@ -4,3 +4,6 @@ user.toml
 
 Session.vim
 .DS_Store
+
+# Zensical build output
+/docs/site

README.md

@@ -4,12 +4,38 @@ Pronounced `gʉːt`.
 
 [![](https://divvun-tc.thetc.se/api/github/v1/repository/divvun/gut/main/badge.svg)](https://divvun-tc.thetc.se/api/github/v1/repository/divvun/gut/main/latest)
 
-This is a Git(Hub) multirepo maintenance tool, designed specifically for Divvun. But it should be quite useful to others needing to maintain tens (or hundreds) of similarly structured github repositories.
+This is a Git(Hub) multirepo maintenance tool, designed specifically for Divvun. But it should be quite useful to others needing to maintain tens (or hundreds) of similarly structured GitHub repositories.
 
 Using the `gut apply -s <script>` command, one can in practice run any git command on all repos (or a suitable subset, regex-selected on the repo names), not only the commands directly provided by `gut`.
 
 We think it's pretty cool.
 
+## Documentation
+
+**📚 [Full Documentation](docs/)** - Complete guides and references
+
+Quick links:
+- [Get Started](docs/docs/get-started.md) - Installation and setup
+- [Common Commands](docs/docs/usage/common-commands.md) - Most frequently used commands
+- [Command Overview](docs/docs/usage/overview.md) - All available commands
+- [Architecture](docs/docs/architecture.md) - Technical details
+- [Contributing](docs/docs/contributing.md) - Development guide
+
+### Viewing Documentation Locally
+
+The documentation is built with [Zensical](https://zensical.org/). To view it locally:
+
+```bash
+# Install Zensical
+pip install zensical
+
+# Serve documentation
+cd docs
+zensical serve
+```
+
+Then open http://localhost:8000 in your browser.
+
 
 ## Installation
 

doc/template/delta.toml

@@ -0,0 +1,28 @@
+name: Documentation
+on:
+  push:
+    branches:
+      - master
+      - main
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/configure-pages@v5
+      - uses: actions/checkout@v5
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.x
+      - run: pip install zensical
+      - run: zensical build --clean
+      - uses: actions/upload-pages-artifact@v4
+        with:
+          path: site
+      - uses: actions/deploy-pages@v4