docs: automate generated docs commits and add docs site structure

.github/workflows/generate-docs.yml

@@ -7,12 +7,14 @@ on:
       - "docs/generated/**"
       - "docs/diagrams/**"
       - "docs/public/**"
+      - "site/**"
   pull_request:
     branches: [main]
     paths-ignore:
       - "docs/generated/**"
       - "docs/diagrams/**"
       - "docs/public/**"
+      - "site/**"
   workflow_dispatch:
     inputs:
       commit_generated_docs:
@@ -30,6 +32,8 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
       - name: Install tooling
         run: |
           sudo apt-get update
@@ -55,7 +59,9 @@ jobs:
             docs/diagrams
             docs/public
       - name: Commit generated docs
-        if: github.event_name == 'workflow_dispatch' && inputs.commit_generated_docs == 'true'
+        if: >
+          github.event_name == 'push' ||
+          (github.event_name == 'workflow_dispatch' && inputs.commit_generated_docs == 'true')
         uses: stefanzweifel/git-auto-commit-action@v5
         with:
           commit_message: "docs: regenerate environment documentation"