Pls monitoriz over game

.github/workflows/calibreapp-image-actions.yml

@@ -44,6 +44,9 @@ jobs:
           # For non-Pull Requests, run in compressOnly mode and we'll PR after.
           compressOnly: ${{ github.event_name != 'pull_request' }}
           ignorePaths: 'docs/es/**,docs/de/**,docs/fr/**,docs/ru/**,docs/sl/**'
+          # Avoid progressive degradation of quality
+          pngQuality: '100'
+          minPctChange: '30'
       - name: Create Pull Request
         # If it's not a Pull Request then commit any changes as a new PR.
         if: |

.github/workflows/improve-docs.yml

@@ -0,0 +1,115 @@
+# ============================================================================
+# Improve Documentation (AI-driven)
+# ============================================================================
+# Runs daily (or on demand). Pulls the GDevelop repo, reads what has already
+# been improved in automated_updates_data.json, and uses an AI agent to
+# improve a DIFFERENT aspect of the documentation each run.
+#
+# To switch from Claude Code to Codex:
+#   1. Change AI_PROVIDER to "codex"
+#   2. Comment out the "Install Claude Code" step and uncomment "Install Codex"
+#   3. Swap the API key secrets (comment ANTHROPIC_API_KEY, uncomment OPENAI_API_KEY)
+# ============================================================================
+
+name: "Auto: Improve documentation"
+
+on:
+  schedule:
+    - cron: "0 10 * * *" # Every day at 10:00 UTC (offset from the other workflow)
+  workflow_dispatch: # Manual trigger
+  # pull_request: # For testing in PRs
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  improve-docs:
+    runs-on: ubuntu-latest
+    if: github.repository == 'GDevelopApp/GDevelop-documentation'
+    timeout-minutes: 20
+
+    steps:
+      # ── Checkout this documentation repo ──────────────────────────────
+      - name: Checkout documentation repo
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      # ── Node.js ───────────────────────────────────────────────────────
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      # ── Install AI CLI ────────────────────────────────────────────────
+      - name: Install Claude Code
+        run: npm install -g @anthropic-ai/claude-code
+
+      # Uncomment below (and comment above) to use Codex instead:
+      # - name: Install Codex
+      #   run: npm install -g @openai/codex
+
+      # ── Generate a random suffix for the branch name ─────────────────
+      - name: Generate branch suffix
+        id: suffix
+        run: echo "value=$(openssl rand -hex 2)" >> "$GITHUB_OUTPUT"
+
+      # ── Run the improvement script ────────────────────────────────────
+      - name: Improve documentation
+        id: improve
+        env:
+          AI_PROVIDER: "claude" # Change to "codex" to use Codex
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+          # OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+        run: |
+          node scripts/improve-docs.js
+
+          # Pass the AI summary to subsequent steps
+          if [ -f /tmp/ai_summary.txt ]; then
+            delimiter="EOF_$(openssl rand -hex 8)"
+            {
+              echo "summary<<${delimiter}"
+              cat /tmp/ai_summary.txt
+              echo ""
+              echo "${delimiter}"
+            } >> "$GITHUB_OUTPUT"
+          fi
+
+          # Pass the AI-generated PR title to subsequent steps
+          if [ -f /tmp/ai_pr_title.txt ]; then
+            delimiter="EOF_$(openssl rand -hex 8)"
+            {
+              echo "pr_title<<${delimiter}"
+              cat /tmp/ai_pr_title.txt
+              echo ""
+              echo "${delimiter}"
+            } >> "$GITHUB_OUTPUT"
+          else
+            echo "pr_title=[Auto] [Improve] Documentation improvement" >> "$GITHUB_OUTPUT"
+          fi
+
+      # ── Create Pull Request ───────────────────────────────────────────
+      - name: Create Pull Request
+        uses: peter-evans/create-pull-request@v7
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          commit-message: ${{ steps.improve.outputs.pr_title }}
+          title: ${{ steps.improve.outputs.pr_title }}
+          body: |
+            This PR was automatically generated by the **Improve documentation** workflow.
+
+            An AI coding agent inspected the [GDevelop](https://github.com/4ian/GDevelop) codebase
+            and the existing documentation, then chose an aspect to improve.
+
+            The AI agent summary is:
+            > ${{ steps.improve.outputs.summary }}
+
+            The updated `automated_updates_data.json` tracks what was improved so future
+            runs will pick a different area.
+
+            **Please review the changes carefully before merging.**
+          base: main
+          branch: auto/improve-docs-${{ steps.suffix.outputs.value }}
+          delete-branch: true
+          labels: automated,improvement

.github/workflows/update-docs-from-commits.yml

@@ -0,0 +1,126 @@
+# ============================================================================
+# Update Documentation from GDevelop Commits
+# ============================================================================
+# Runs daily (or on demand). Pulls the GDevelop repo, inspects recent commits
+# since the last tracked commit, and uses an AI agent (Claude Code by default,
+# Codex as an alternative) to update the docs accordingly.
+#
+# To switch from Claude Code to Codex:
+#   1. Change AI_PROVIDER to "codex"
+#   2. Comment out the "Install Claude Code" step and uncomment "Install Codex"
+#   3. Swap the API key secrets (comment ANTHROPIC_API_KEY, uncomment OPENAI_API_KEY)
+# ============================================================================
+
+name: "Auto: Update docs from GDevelop commits"
+
+on:
+  schedule:
+    - cron: "0 8 * * *" # Every day at 08:00 UTC
+  workflow_dispatch: # Manual trigger
+  # pull_request: # For testing in PRs
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  update-docs:
+    runs-on: ubuntu-latest
+    if: github.repository == 'GDevelopApp/GDevelop-documentation'
+    timeout-minutes: 20
+
+    steps:
+      # ── Checkout this documentation repo ──────────────────────────────
+      - name: Checkout documentation repo
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      # ── Node.js ───────────────────────────────────────────────────────
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      # ── Install AI CLI ────────────────────────────────────────────────
+      - name: Install Claude Code
+        run: npm install -g @anthropic-ai/claude-code
+
+      # Uncomment below (and comment above) to use Codex instead:
+      # - name: Install Codex
+      #   run: npm install -g @openai/codex
+
+      # ── Generate a random suffix for the branch name ─────────────────
+      - name: Generate branch suffix
+        id: suffix
+        run: echo "value=$(openssl rand -hex 2)" >> "$GITHUB_OUTPUT"
+
+      # ── Run the update script ─────────────────────────────────────────
+      - name: Update documentation from recent commits
+        id: update
+        env:
+          AI_PROVIDER: "claude" # Change to "codex" to use Codex
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+          # OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+        run: |
+          node scripts/update-docs-from-commits.js
+
+          # Pass the AI summary and commit log to subsequent steps
+          if [ -f /tmp/ai_summary.txt ]; then
+            delimiter="EOF_$(openssl rand -hex 8)"
+            {
+              echo "summary<<${delimiter}"
+              cat /tmp/ai_summary.txt
+              echo ""
+              echo "${delimiter}"
+            } >> "$GITHUB_OUTPUT"
+          fi
+          if [ -f /tmp/commit_log.txt ]; then
+            delimiter="EOF_$(openssl rand -hex 8)"
+            {
+              echo "commits<<${delimiter}"
+              cat /tmp/commit_log.txt
+              echo ""
+              echo "${delimiter}"
+            } >> "$GITHUB_OUTPUT"
+          fi
+
+          # Pass the AI-generated PR title to subsequent steps
+          if [ -f /tmp/ai_pr_title.txt ]; then
+            delimiter="EOF_$(openssl rand -hex 8)"
+            {
+              echo "pr_title<<${delimiter}"
+              cat /tmp/ai_pr_title.txt
+              echo ""
+              echo "${delimiter}"
+            } >> "$GITHUB_OUTPUT"
+          else
+            echo "pr_title=[Auto] [Update] Documentation update from commits" >> "$GITHUB_OUTPUT"
+          fi
+
+      # ── Create Pull Request ───────────────────────────────────────────
+      - name: Create Pull Request
+        uses: peter-evans/create-pull-request@v7
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          commit-message: ${{ steps.update.outputs.pr_title }}
+          title: ${{ steps.update.outputs.pr_title }}
+          body: |
+            This PR was automatically generated by the **Update docs from GDevelop commits** workflow.
+
+            An AI coding agent analysed recent commits in [4ian/GDevelop](https://github.com/4ian/GDevelop)
+            and updated the documentation to reflect user-facing changes.
+
+            ### GDevelop commits covered
+            ```
+            ${{ steps.update.outputs.commits }}
+            ```
+
+            ### The AI agent summary is:
+            ${{ steps.update.outputs.summary }}
+
+            **Please review the changes carefully before merging.**
+          base: main
+          branch: auto/update-docs-from-commits-${{ steps.suffix.outputs.value }}
+          delete-branch: true
+          labels: automated,update

.gitignore

@@ -1,3 +1,4 @@
 dokuwiki2wikijs/__pycache__
 .DS_Store
-site
+site
+scripts/node_modules/

AGENTS.md

@@ -0,0 +1 @@
+CLAUDE.md

CLAUDE.md

@@ -0,0 +1,10 @@
+# Important Writing Style And Architecture Constraints
+
+- Do NOT document non-user-facing implementation details. Focus only on information
+  that is relevant to users creating games with GDevelop, not internal engine behavior.
+- Do NOT list all actions/conditions in a list or table: the reference documentations are already
+  automatically generated for this.
+- Do not specify the default values. Don't feel forced to list all the properties of a
+  behavior/object/condition/action: prefer to explain use cases, examples and how it's useful
+  for the end user which will create a game with it.
+- Do not explain standard default/shortcuts (the UI is supposed to make this clear already).

CONTRIBUTE.md

@@ -2,17 +2,17 @@
 
 Thank you for investing your time in contributing to GDevelop's documentation! Any contribution you make will be reflected on wiki.gdevelop.io ✨.
 
-In this guide you will get an overview of the contribution workflow.
+In this guide, you will get an overview of the contribution workflow.
 
 ## Make a contribution
 
-To make a contribution, you shall follow those steps:
+To make a contribution, follow those steps:
 
 1. [Fork this repository](https://docs.github.com/fr/get-started/quickstart/fork-a-repo)
 2. [Install the project](#installation)
 3. [Find an issue that you can resolve](https://github.com/GDevelopApp/GDevelop-documentation/issues)
 4. [Open a Pull Request](https://docs.github.com/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork)
-5. Once your Pull Request is merged, the documentation will be automatically be updated with your changes (a few minutes for changes to take effect)
+5. Once your Pull Request is merged, the documentation will automatically be updated with your changes (a few minutes for changes to take effect)
 
 ## Installation
 
@@ -27,15 +27,15 @@ First install:
 Run:
 
 ```sh
-poetry install
+poetry install --no-root
 ```
 
 ### Run the project
 
 ```sh
-mkdocs serve
+poetry run mkdocs serve
 # Or, for faster reload after changes:
-mkdocs serve --dirtyreload
+poetry run mkdocs serve --dirtyreload
 ```
 
 This will run the documentation on http://localhost:8000.

README.md

@@ -6,7 +6,17 @@ This repository holds [the official documentation](https://wiki.gdevelop.io) for
 
 ## Getting Started
 
-| ❔ I want to...                              | 🚀 What to do                                                                     |
-| -------------------------------------------- | --------------------------------------------------------------------------------- |
-| Improve or add articles to the documentation | Head over to [this README](./SYNTAX.md) to understand the syntax of the documentation.|
-| Bring improvements to the documentation interface | Head over to [this README](./CONTRIBUTE.md) to understand how this repository works. |
+| ❔ I want to...                                   | 🚀 What to do                                                                          |
+| ------------------------------------------------- | -------------------------------------------------------------------------------------- |
+| Improve or add articles to the documentation      | Head over to [this README](./SYNTAX.md) to understand the syntax of the documentation. |
+| Bring improvements to the documentation interface | Head over to [this README](./CONTRIBUTE.md) to understand how this repository works.   |
+
+## Contribute to this repository
+
+Install [uv](https://github.com/astral-sh/uv) for Python. Then:
+
+```bash
+uv sync
+uv run mkdocs serve # To run the documentation locally and see changes.
+uv run mkdocs build # To build for deployment on a static hosting.
+```