diff --git a/.exrc b/.exrc
new file mode 100644
index 00000000000..966076b65f9
--- /dev/null
+++ b/.exrc
@@ -0,0 +1,20 @@
+" QGIS Documentation Project Configuration
+" Source the Lua config for full functionality
+if has('nvim')
+  lua dofile('.nvim.lua')
+endif
+
+" Basic settings for RST/Sphinx development
+set expandtab
+set tabstop=3
+set shiftwidth=3
+set softtabstop=3
+set textwidth=79
+set colorcolumn=80
+
+" RST file settings
+autocmd FileType rst setlocal spell spelllang=en_us
+autocmd FileType rst setlocal foldmethod=expr
+
+" Recognize .rst files
+autocmd BufRead,BufNewFile *.rst set filetype=rst
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index ce2d6ba7014..34d2ceacf41 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -1,6 +1,6 @@
 <!---
 Include a few sentences describing the overall goals for this Pull Request.
- 
+
 A list of issues is at https://github.com/qgis/QGIS-Documentation/issues.
 Add "fix #issuenumber" for each issue the PR fixes. The ticket(s) will be closed automatically.
 If your PR doesn't fix entirely the ticket, only add the ticket(s) reference preceded by # character.
diff --git a/.github/workflows/builds.yml b/.github/workflows/builds.yml
index 14587bcda00..bf10aee7592 100644
--- a/.github/workflows/builds.yml
+++ b/.github/workflows/builds.yml
@@ -4,7 +4,7 @@ concurrency:
   group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
   cancel-in-progress: true
 
-on: 
+on:
   push:
     paths-ignore:
       - 'locale/**'
diff --git a/.github/workflows/doctest.yml b/.github/workflows/doctest.yml
index 90652a25f87..22a48379ddd 100644
--- a/.github/workflows/doctest.yml
+++ b/.github/workflows/doctest.yml
@@ -42,7 +42,7 @@ jobs:
           qgis.org:443
           raw.githubusercontent.com:443
           registry-1.docker.io:443
-  
+
     - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
       with:
         fetch-depth: 1
diff --git a/.github/workflows/optimize-images.yml b/.github/workflows/optimize-images.yml
new file mode 100644
index 00000000000..e447208ca72
--- /dev/null
+++ b/.github/workflows/optimize-images.yml
@@ -0,0 +1,143 @@
+name: Optimize Images
+
+on:
+  # Manual trigger
+  workflow_dispatch:
+    inputs:
+      mode:
+        description: 'Compression mode'
+        required: true
+        default: 'lossless'
+        type: choice
+        options:
+          - lossless
+          - lossy
+      path:
+        description: 'Path to optimize (default: build/html/)'
+        required: false
+        default: 'build/html/'
+
+  # Run on PRs that add/modify images
+  pull_request:
+    paths:
+      - '**.png'
+      - '**.PNG'
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  optimize:
+    runs-on: ubuntu-latest
+    name: Optimize PNG images
+
+    steps:
+    - name: Harden Runner
+      uses: step-security/harden-runner@58077d3c7e43986b6b15fba718e8ea69e387dfcc # v2.15.1
+      with:
+        egress-policy: audit
+
+    - name: Check out repository
+      uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      with:
+        ref: ${{ github.head_ref || github.ref }}
+        fetch-depth: 0
+
+    - name: Install optimization tools
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y optipng pngquant
+
+    - name: Get changed images (PR only)
+      if: github.event_name == 'pull_request'
+      id: changed-images
+      run: |
+        # Get list of changed PNG files
+        CHANGED=$(git diff --name-only origin/${{ github.base_ref }}...HEAD -- '*.png' '*.PNG' | tr '\n' ' ')
+        echo "files=$CHANGED" >> $GITHUB_OUTPUT
+        if [ -z "$CHANGED" ]; then
+          echo "No PNG files changed"
+          echo "has_changes=false" >> $GITHUB_OUTPUT
+        else
+          echo "Changed files: $CHANGED"
+          echo "has_changes=true" >> $GITHUB_OUTPUT
+        fi
+
+    - name: Optimize images (PR - changed files only)
+      if: github.event_name == 'pull_request' && steps.changed-images.outputs.has_changes == 'true'
+      run: |
+        for file in ${{ steps.changed-images.outputs.files }}; do
+          if [ -f "$file" ]; then
+            echo "Optimizing: $file"
+            BEFORE=$(stat -c%s "$file")
+            optipng -o2 -quiet "$file" || true
+            AFTER=$(stat -c%s "$file")
+            if [ "$AFTER" -lt "$BEFORE" ]; then
+              SAVED=$((BEFORE - AFTER))
+              echo "  Saved: $SAVED bytes"
+            fi
+          fi
+        done
+
+    - name: Optimize images (Manual trigger)
+      if: github.event_name == 'workflow_dispatch'
+      run: |
+        MODE_FLAG=""
+        if [ "${{ inputs.mode }}" == "lossy" ]; then
+          MODE_FLAG="--lossy"
+        fi
+        ./scripts/optimize_images.sh $MODE_FLAG "${{ inputs.path }}"
+
+    - name: Check for changes
+      id: git-check
+      run: |
+        git diff --exit-code || echo "has_changes=true" >> $GITHUB_OUTPUT
+
+    - name: Commit optimized images (PR)
+      if: github.event_name == 'pull_request' && steps.git-check.outputs.has_changes == 'true'
+      run: |
+        git config --local user.email "github-actions[bot]@users.noreply.github.com"
+        git config --local user.name "github-actions[bot]"
+        git add -A
+        git commit -m "Optimize PNG images
+
+        Automated image optimization using optipng."
+        git push
+
+    - name: Create PR with optimized images (Manual trigger)
+      if: github.event_name == 'workflow_dispatch' && steps.git-check.outputs.has_changes == 'true'
+      run: |
+        BRANCH="optimize-images-$(date +%Y%m%d-%H%M%S)"
+        git config --local user.email "github-actions[bot]@users.noreply.github.com"
+        git config --local user.name "github-actions[bot]"
+        git checkout -b "$BRANCH"
+        git add -A
+        git commit -m "Optimize PNG images (${{ inputs.mode }} mode)
+
+        Automated image optimization using optipng${{ inputs.mode == 'lossy' && ' and pngquant' || '' }}."
+        git push -u origin "$BRANCH"
+
+        gh pr create \
+          --title "Optimize PNG images (${{ inputs.mode }} mode)" \
+          --body "## Summary
+
+        Automated image optimization run.
+
+        - **Mode**: ${{ inputs.mode }}
+        - **Path**: ${{ inputs.path }}
+
+        This PR contains optimized PNG images to reduce repository size and improve page load times." \
+          --base ${{ github.ref_name }}
+      env:
+        GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+    - name: Summary
+      run: |
+        echo "## Image Optimization Complete" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        if [ "${{ steps.git-check.outputs.has_changes }}" == "true" ]; then
+          echo "Images were optimized and changes committed." >> $GITHUB_STEP_SUMMARY
+        else
+          echo "No optimization improvements found." >> $GITHUB_STEP_SUMMARY
+        fi
diff --git a/.github/workflows/pofiles.yml b/.github/workflows/pofiles.yml
index 7cf1d19673c..7b05ad96279 100644
--- a/.github/workflows/pofiles.yml
+++ b/.github/workflows/pofiles.yml
@@ -56,7 +56,7 @@ jobs:
           # Remove obsolete strings from the generated *.po files
           find locale/en/LC_MESSAGES/ -type f -name '*.po' -exec sed -i '/^#~ /,/^$/d' {} \;
 
-    - name: Commit the changes in the PO files      
+    - name: Commit the changes in the PO files
       id: "auto-commit-action"
       uses: stefanzweifel/git-auto-commit-action@04702edda442b2e678b25b537cec683a1493fcb9 # v7.1.0
       with:
diff --git a/.github/workflows/qa.yml b/.github/workflows/qa.yml
new file mode 100644
index 00000000000..c87376506a2
--- /dev/null
+++ b/.github/workflows/qa.yml
@@ -0,0 +1,247 @@
+name: QA Checks
+
+on:
+  push:
+    branches: [master, main]
+    paths-ignore:
+      - 'locale/**'
+  pull_request:
+    paths-ignore:
+      - 'locale/**'
+  # Allow manual trigger
+  workflow_dispatch:
+  # Weekly link check
+  schedule:
+    - cron: '0 3 * * 0'  # Every Sunday at 3am UTC
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  # ============================================================================
+  # Pre-commit checks (linting, formatting, etc.)
+  # ============================================================================
+  pre-commit:
+    name: Pre-commit Checks
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Harden Runner
+        uses: step-security/harden-runner@58077d3c7e43986b6b15fba718e8ea69e387dfcc # v2.15.1
+        with:
+          egress-policy: audit
+
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+      - name: Install Nix
+        uses: cachix/install-nix-action@v30
+        with:
+          nix_path: nixpkgs=channel:nixos-unstable
+
+      - name: Cache Nix store
+        uses: actions/cache@5a3ec84eff668545956fd18022155c47e93e2684 # v4.2.3
+        with:
+          path: |
+            ~/.cache/nix
+            /nix/store
+          key: ${{ runner.os }}-nix-${{ hashFiles('flake.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-nix-
+
+      - name: Cache pre-commit
+        uses: actions/cache@5a3ec84eff668545956fd18022155c47e93e2684 # v4.2.3
+        with:
+          path: ~/.cache/pre-commit
+          key: ${{ runner.os }}-pre-commit-${{ hashFiles('.pre-commit-config.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pre-commit-
+
+      - name: Run pre-commit checks
+        run: |
+          nix develop --command pre-commit run --all-files --show-diff-on-failure
+        continue-on-error: false
+
+  # ============================================================================
+  # Build documentation with Nix environment
+  # ============================================================================
+  build-nix:
+    name: Build Documentation (Nix)
+    runs-on: ubuntu-latest
+    needs: pre-commit
+
+    strategy:
+      fail-fast: false
+      matrix:
+        build-type: [fasthtml, html]
+
+    steps:
+      - name: Harden Runner
+        uses: step-security/harden-runner@58077d3c7e43986b6b15fba718e8ea69e387dfcc # v2.15.1
+        with:
+          egress-policy: audit
+
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+      - name: Install Nix
+        uses: cachix/install-nix-action@v30
+        with:
+          nix_path: nixpkgs=channel:nixos-unstable
+
+      - name: Cache Nix store
+        uses: actions/cache@5a3ec84eff668545956fd18022155c47e93e2684 # v4.2.3
+        with:
+          path: |
+            ~/.cache/nix
+            /nix/store
+          key: ${{ runner.os }}-nix-${{ hashFiles('flake.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-nix-
+
+      - name: Cache Sphinx doctrees
+        uses: actions/cache@5a3ec84eff668545956fd18022155c47e93e2684 # v4.2.3
+        with:
+          path: build/.doctrees
+          key: ${{ runner.os }}-doctrees-${{ matrix.build-type }}-${{ hashFiles('docs/**/*.rst') }}
+          restore-keys: |
+            ${{ runner.os }}-doctrees-${{ matrix.build-type }}-
+
+      - name: Build documentation (${{ matrix.build-type }})
+        run: |
+          nix develop --command make ${{ matrix.build-type }}
+
+      - name: Check for build warnings (strict mode)
+        if: matrix.build-type == 'html'
+        run: |
+          # The html target uses -nW --keep-going which treats warnings as errors
+          # If we reach here, the build passed
+          echo "Build completed successfully with no errors"
+
+      - name: Upload build artifact
+        uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f # v7.0.0
+        with:
+          name: docs-${{ matrix.build-type }}
+          path: build/html/en
+          retention-days: 7
+
+  # ============================================================================
+  # RST syntax validation
+  # ============================================================================
+  rst-check:
+    name: RST Syntax Check
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Harden Runner
+        uses: step-security/harden-runner@58077d3c7e43986b6b15fba718e8ea69e387dfcc # v2.15.1
+        with:
+          egress-policy: audit
+
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+      - name: Install Nix
+        uses: cachix/install-nix-action@v30
+        with:
+          nix_path: nixpkgs=channel:nixos-unstable
+
+      - name: Cache Nix store
+        uses: actions/cache@5a3ec84eff668545956fd18022155c47e93e2684 # v4.2.3
+        with:
+          path: |
+            ~/.cache/nix
+            /nix/store
+          key: ${{ runner.os }}-nix-${{ hashFiles('flake.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-nix-
+
+      - name: Run rstcheck
+        run: |
+          nix develop --command rstcheck \
+            --report-level error \
+            --ignore-roles pyqgis,api,source,sup,sub,menuselection,guilabel,kbd,file,ref,doc,term,command,program,option,envvar,abbr,dfn,numref,download \
+            --ignore-directives toctree,include,only,ifconfig,literalinclude,index,glossary,substitution-definitions,highlight,todo,todolist,deprecated,versionadded,versionchanged,seealso,productionlist,centered,testcode,testoutput,toggle,tabs,tab,code-block \
+            --ignore-languages python,bash,sql,json,xml,yaml \
+            docs/ || echo "RST check completed with some issues"
+
+  # ============================================================================
+  # Link checking (optional, runs on schedule)
+  # ============================================================================
+  linkcheck:
+    name: Check Links
+    runs-on: ubuntu-latest
+    if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'
+
+    steps:
+      - name: Harden Runner
+        uses: step-security/harden-runner@58077d3c7e43986b6b15fba718e8ea69e387dfcc # v2.15.1
+        with:
+          egress-policy: audit
+
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+      - name: Install Nix
+        uses: cachix/install-nix-action@v30
+        with:
+          nix_path: nixpkgs=channel:nixos-unstable
+
+      - name: Run linkcheck
+        run: |
+          nix develop --command make linkcheck
+        continue-on-error: true
+
+      - name: Upload linkcheck report
+        uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f # v7.0.0
+        with:
+          name: linkcheck-report
+          path: build/linkcheck/
+          retention-days: 30
+
+  # ============================================================================
+  # Summary job
+  # ============================================================================
+  qa-summary:
+    name: QA Summary
+    runs-on: ubuntu-latest
+    needs: [pre-commit, build-nix, rst-check]
+    if: always()
+
+    steps:
+      - name: Check job results
+        run: |
+          echo "## QA Results Summary" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+
+          if [ "${{ needs.pre-commit.result }}" == "success" ]; then
+            echo "- :white_check_mark: Pre-commit checks passed" >> $GITHUB_STEP_SUMMARY
+          else
+            echo "- :x: Pre-commit checks failed" >> $GITHUB_STEP_SUMMARY
+          fi
+
+          if [ "${{ needs.build-nix.result }}" == "success" ]; then
+            echo "- :white_check_mark: Documentation build passed" >> $GITHUB_STEP_SUMMARY
+          else
+            echo "- :x: Documentation build failed" >> $GITHUB_STEP_SUMMARY
+          fi
+
+          if [ "${{ needs.rst-check.result }}" == "success" ]; then
+            echo "- :white_check_mark: RST syntax check passed" >> $GITHUB_STEP_SUMMARY
+          else
+            echo "- :warning: RST syntax check had issues" >> $GITHUB_STEP_SUMMARY
+          fi
+
+          # Fail if critical jobs failed
+          if [ "${{ needs.pre-commit.result }}" != "success" ] || [ "${{ needs.build-nix.result }}" != "success" ]; then
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo ":x: **QA checks failed. Please fix the issues above.**" >> $GITHUB_STEP_SUMMARY
+            exit 1
+          fi
+
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo ":tada: **All QA checks passed!**" >> $GITHUB_STEP_SUMMARY
diff --git a/.github/workflows/translation_statistics.yml b/.github/workflows/translation_statistics.yml
index 7256fc35488..b6faa8e317e 100644
--- a/.github/workflows/translation_statistics.yml
+++ b/.github/workflows/translation_statistics.yml
@@ -1,7 +1,7 @@
 name: Translation statistics
 # Pull statistics of translation in Transifex
 
-on: 
+on:
   schedule:
     # runs tuesday at 6:00 UTC
     - cron: '0 6 * * 2'
diff --git a/.mailmap b/.mailmap
index feb4c43157f..47eace712db 100644
--- a/.mailmap
+++ b/.mailmap
@@ -29,7 +29,7 @@ Arnaud Morvan <arnaud.morvan@camptocamp.com>  arnaud.morvan@camptocamp.com <arna
 
 Ayodele Adeyemo <christad92@gmail.com>  christad92 <christad92@gmail.com>
 
-Báthory Péter <bathory86p@gmail.com>  Péter Báthory <peter.bathory@cartographia.hu> 
+Báthory Péter <bathory86p@gmail.com>  Péter Báthory <peter.bathory@cartographia.hu>
 
 Benoit De Mezzo <benoit.de.mezzo@oslandia.com>  bdm-oslandia <benoit.de.mezzo@oslandia.com>
 Benoit De Mezzo <benoit.de.mezzo@oslandia.com>  benoitdm-oslandia <64401067+benoitdm-oslandia@users.noreply.github.com>
@@ -180,7 +180,7 @@ Patrice Pineault <TurboGraphxBeige@runbox.com>  TurboGraphxBeige <TurboGraphxBei
 Paul Blottiere <blottiere.paul@gmail.com>  Blottiere Paul <blottiere.paul@gmail.com>
 
 Philip Albrecht <albrecht@gbd-consult.de>  PhilipAlbrecht <45685457+PhilipAlbrecht@users.noreply.github.com>
-Philip Albrecht <albrecht@gbd-consult.de>  albrecht <albrecht@gbd-consult.de> 
+Philip Albrecht <albrecht@gbd-consult.de>  albrecht <albrecht@gbd-consult.de>
 
 Régis Haubourg <regis@qgis.org>  Régis Haubourg <1629853+haubourg@users.noreply.github.com>
 Régis Haubourg <regis@qgis.org>  Régis Haubourg <regis.haubourg@oslandia.com>
diff --git a/.nvim.lua b/.nvim.lua
new file mode 100644
index 00000000000..7fcb9523ec0
--- /dev/null
+++ b/.nvim.lua
@@ -0,0 +1,656 @@
+-- QGIS Documentation Project Configuration for Neovim
+-- All project shortcuts under <leader>p
+
+local ok, wk = pcall(require, "which-key")
+if not ok then
+  vim.notify("which-key not installed, project keybindings not loaded", vim.log.levels.WARN)
+  return
+end
+
+-- Helper to run terminal commands
+local function term_cmd(cmd, opts)
+  opts = opts or {}
+  return function()
+    local term_opts = {
+      direction = opts.direction or "float",
+      close_on_exit = opts.close_on_exit or false,
+      dir = vim.fn.getcwd(),
+    }
+    -- Try toggleterm first, fall back to built-in terminal
+    local tt_ok, toggleterm = pcall(require, "toggleterm.terminal")
+    if tt_ok then
+      local Terminal = toggleterm.Terminal
+      local term = Terminal:new(vim.tbl_extend("force", { cmd = cmd }, term_opts))
+      term:toggle()
+    else
+      vim.cmd("split | terminal " .. cmd)
+    end
+  end
+end
+
+-- Helper to run shell command and notify
+local function shell_cmd(cmd, msg)
+  return function()
+    vim.notify(msg or ("Running: " .. cmd), vim.log.levels.INFO)
+    vim.fn.jobstart(cmd, {
+      on_exit = function(_, code)
+        if code == 0 then
+          vim.notify("✓ " .. (msg or cmd) .. " completed", vim.log.levels.INFO)
+        else
+          vim.notify("✗ " .. (msg or cmd) .. " failed (exit " .. code .. ")", vim.log.levels.ERROR)
+        end
+      end,
+    })
+  end
+end
+
+-- Helper to open URL in browser
+local function open_url(url)
+  return function()
+    local open_cmd
+    if vim.fn.has("mac") == 1 then
+      open_cmd = "open"
+    elseif vim.fn.has("unix") == 1 then
+      open_cmd = "xdg-open"
+    else
+      open_cmd = "start"
+    end
+    vim.fn.jobstart({ open_cmd, url })
+  end
+end
+
+-- Helper to run build command and prompt to open docs after
+local function build_and_prompt(cmd, lang)
+  lang = lang or "en"
+  return function()
+    local tt_ok, toggleterm = pcall(require, "toggleterm.terminal")
+    if tt_ok then
+      local Terminal = toggleterm.Terminal
+      local term = Terminal:new({
+        cmd = cmd,
+        direction = "float",
+        close_on_exit = false,
+        on_exit = function(_, _, exit_code)
+          if exit_code == 0 then
+            vim.schedule(function()
+              vim.ui.select({ "Yes", "No" }, {
+                prompt = "Build complete! Open docs in browser?",
+              }, function(choice)
+                if choice == "Yes" then
+                  local doc_path = vim.fn.getcwd() .. "/build/html/" .. lang .. "/index.html"
+                  if vim.fn.filereadable(doc_path) == 1 then
+                    open_url("file://" .. doc_path)()
+                  else
+                    open_url("http://localhost:8000")()
+                  end
+                end
+              end)
+            end)
+          end
+        end,
+      })
+      term:toggle()
+    else
+      -- Fallback without prompt
+      vim.cmd("split | terminal " .. cmd)
+    end
+  end
+end
+
+-- ============================================================================
+-- Diagnostics / Error Navigation Helper Functions
+-- (Must be defined before wk.add() references them)
+-- ============================================================================
+
+-- Parse Sphinx build output and populate quickfix list
+local function parse_sphinx_errors(log_file)
+  local cwd = vim.fn.getcwd()
+  log_file = log_file or (cwd .. "/build/sphinx_errors.log")
+
+  -- Check if file exists
+  if vim.fn.filereadable(log_file) == 0 then
+    vim.notify("Log file not found: " .. log_file .. "\nRun a build first.", vim.log.levels.WARN)
+    return
+  end
+
+  -- Read the file directly and parse line by line
+  local lines = vim.fn.readfile(log_file)
+  local qf_items = {}
+  local seen = {}
+
+  for _, line in ipairs(lines) do
+    -- Skip lines from .direnv or .vscode
+    if not line:match("%.direnv") and not line:match("%.vscode") and line:match("/docs/") then
+      -- Match pattern: /path/to/docs/file.rst:123: WARNING: message
+      local filepath, lnum, msg = line:match("(.+%.rst):(%d+):%s*WARNING:%s*(.+)")
+
+      if filepath and lnum then
+        -- Make path relative to cwd
+        local rel_path = filepath:gsub("^" .. cwd .. "/", "")
+
+        local key = rel_path .. ":" .. lnum
+        if not seen[key] then
+          seen[key] = true
+          table.insert(qf_items, {
+            filename = rel_path,
+            lnum = tonumber(lnum),
+            col = 1,
+            text = msg or "Warning",
+            type = "W",
+          })
+        end
+      end
+    end
+  end
+
+  if #qf_items == 0 then
+    vim.notify("No project warnings found in: " .. log_file, vim.log.levels.INFO)
+    return
+  end
+
+  vim.fn.setqflist({}, 'r', {
+    title = 'Sphinx Build Warnings (' .. #qf_items .. ')',
+    items = qf_items,
+  })
+  vim.cmd("copen")
+  vim.notify(string.format("Found %d warnings. Use :cn/:cp to navigate.", #qf_items), vim.log.levels.INFO)
+end
+
+-- Run build and capture errors to quickfix
+local function build_and_capture_errors(cmd)
+  return function()
+    local cwd = vim.fn.getcwd()
+    local log_file = cwd .. "/build/sphinx_errors.log"
+
+    -- Ensure build directory exists
+    vim.fn.mkdir(cwd .. "/build", "p")
+
+    vim.notify("Building... (will parse errors when done)", vim.log.levels.INFO)
+
+    -- Run build with output captured to log file
+    local full_cmd = string.format("%s 2>&1 | tee %s", cmd, log_file)
+
+    vim.fn.jobstart({"bash", "-c", full_cmd}, {
+      cwd = cwd,
+      on_exit = function(_, exit_code)
+        vim.schedule(function()
+          vim.notify("Build finished (exit " .. exit_code .. "). Parsing warnings...", vim.log.levels.INFO)
+          -- Parse the log file for warnings
+          parse_sphinx_errors(log_file)
+        end)
+      end,
+    })
+  end
+end
+
+-- Check RST syntax and populate quickfix
+local function rstcheck_to_quickfix()
+  vim.notify("Running rstcheck...", vim.log.levels.INFO)
+
+  vim.fn.jobstart("rstcheck --report-level warning docs/ 2>&1", {
+    stdout_buffered = true,
+    on_stdout = function(_, data)
+      if not data then return end
+
+      local qf_items = {}
+
+      for _, line in ipairs(data) do
+        -- Pattern: docs/path/file.rst:123: (WARNING/2) message
+        local filepath, lnum, severity, msg = line:match("([^:]+%.rst):(%d+):%s*%((%w+)/%d+%)%s*(.+)")
+
+        if filepath and lnum then
+          table.insert(qf_items, {
+            filename = filepath,
+            lnum = tonumber(lnum),
+            col = 1,
+            text = msg or line,
+            type = severity == "ERROR" and "E" or "W",
+          })
+        end
+      end
+
+      vim.schedule(function()
+        if #qf_items > 0 then
+          vim.fn.setqflist(qf_items)
+          vim.cmd("copen")
+          vim.notify(string.format("rstcheck found %d issues", #qf_items), vim.log.levels.WARN)
+        else
+          vim.notify("rstcheck: No issues found!", vim.log.levels.INFO)
+        end
+      end)
+    end,
+  })
+end
+
+-- ============================================================================
+
+-- Helper to run i18n build and prompt to open language selector
+local function i18n_build_and_prompt(cmd)
+  return function()
+    local tt_ok, toggleterm = pcall(require, "toggleterm.terminal")
+    if tt_ok then
+      local Terminal = toggleterm.Terminal
+      local term = Terminal:new({
+        cmd = cmd,
+        direction = "float",
+        close_on_exit = false,
+        on_exit = function(_, _, exit_code)
+          if exit_code == 0 then
+            vim.schedule(function()
+              -- Get available built languages
+              local handle = io.popen("ls -d build/html/*/ 2>/dev/null | xargs -n1 basename")
+              local langs = {}
+              if handle then
+                for lang in handle:lines() do
+                  table.insert(langs, lang)
+                end
+                handle:close()
+              end
+
+              if #langs > 0 then
+                table.insert(langs, "Cancel")
+                vim.ui.select(langs, {
+                  prompt = "Build complete! Open which language?",
+                }, function(choice)
+                  if choice and choice ~= "Cancel" then
+                    local doc_path = vim.fn.getcwd() .. "/build/html/" .. choice .. "/index.html"
+                    open_url("file://" .. doc_path)()
+                  end
+                end)
+              end
+            end)
+          end
+        end,
+      })
+      term:toggle()
+    else
+      vim.cmd("split | terminal " .. cmd)
+    end
+  end
+end
+
+-- Language selector for builds
+local function select_language(callback)
+  local languages = { "en", "de", "es", "fr", "it", "ja", "ko", "nl", "pt_BR", "pt_PT", "ru", "zh_Hans" }
+  vim.ui.select(languages, {
+    prompt = "Select language:",
+    format_item = function(item)
+      local names = {
+        en = "English",
+        de = "German",
+        es = "Spanish",
+        fr = "French",
+        it = "Italian",
+        ja = "Japanese",
+        ko = "Korean",
+        nl = "Dutch",
+        pt_BR = "Portuguese (Brazil)",
+        pt_PT = "Portuguese (Portugal)",
+        ru = "Russian",
+        zh_Hans = "Chinese (Simplified)",
+      }
+      return item .. " - " .. (names[item] or item)
+    end,
+  }, function(choice)
+    if choice then
+      callback(choice)
+    end
+  end)
+end
+
+-- Register which-key mappings
+wk.add({
+  { "<leader>p", group = "Project (QGIS Docs)" },
+
+  -- Build submenu
+  { "<leader>pb", group = "Build" },
+  { "<leader>pbh", build_and_prompt("make fasthtml", "en"), desc = "Build HTML fast (English)" },
+  { "<leader>pbH", build_and_prompt("make html", "en"), desc = "Build HTML strict (English)" },
+  { "<leader>pbd", term_cmd("make draft"), desc = "Build draft (quiet)" },
+  {
+    "<leader>pbl",
+    function()
+      select_language(function(lang)
+        build_and_prompt("make LANG=" .. lang .. " html", lang)()
+      end)
+    end,
+    desc = "Build HTML (select language)",
+  },
+  { "<leader>pbp", build_and_prompt("make pdf", "en"), desc = "Build PDF (English)" },
+  {
+    "<leader>pbP",
+    function()
+      select_language(function(lang)
+        build_and_prompt("make LANG=" .. lang .. " pdf", lang)()
+      end)
+    end,
+    desc = "Build PDF (select language)",
+  },
+  { "<leader>pbf", build_and_prompt("make full", "en"), desc = "Build Full (HTML + PDF)" },
+  { "<leader>pba", i18n_build_and_prompt("make html-all"), desc = "Build All Languages" },
+  { "<leader>pbz", term_cmd("make zip"), desc = "Build ZIP archive" },
+
+  -- Preview/Serve submenu
+  { "<leader>ps", group = "Serve/Preview" },
+  {
+    "<leader>pss",
+    term_cmd("make serve", { close_on_exit = false }),
+    desc = "Live preview (autobuild)",
+  },
+  { "<leader>pso", open_url("http://localhost:8000"), desc = "Open in browser" },
+  { "<leader>psb", open_url("build/html/en/index.html"), desc = "Open built HTML" },
+
+  -- Quality/Testing submenu
+  { "<leader>pq", group = "Quality/Testing" },
+  { "<leader>pql", term_cmd("make linkcheck"), desc = "Check links" },
+  { "<leader>pqd", term_cmd("make doctest"), desc = "Run doctests" },
+  { "<leader>pqr", term_cmd("rstcheck docs/"), desc = "RST syntax check" },
+  { "<leader>pqp", term_cmd("pre-commit run --all-files"), desc = "Pre-commit (all)" },
+  { "<leader>pqP", term_cmd("pre-commit run"), desc = "Pre-commit (staged)" },
+
+  -- Translation submenu
+  { "<leader>pt", group = "Translation" },
+  { "<leader>ptg", term_cmd("make gettext"), desc = "Generate POT files" },
+  { "<leader>ptp", term_cmd("make tx_force_pull_translations"), desc = "Pull translations (tx)" },
+  { "<leader>pts", term_cmd("tx status"), desc = "Transifex status" },
+
+  -- Full i18n workflow (parallel builds)
+  { "<leader>pT", group = "i18n Full Workflow" },
+  { "<leader>pTh", i18n_build_and_prompt("./scripts/build_all_languages.sh --pull --html"), desc = "Pull + build all HTML" },
+  { "<leader>pTp", i18n_build_and_prompt("./scripts/build_all_languages.sh --pull --pdf"), desc = "Pull + build all PDF" },
+  { "<leader>pTf", i18n_build_and_prompt("./scripts/build_all_languages.sh --pull --full"), desc = "Pull + build all (full)" },
+  { "<leader>pTH", i18n_build_and_prompt("./scripts/build_all_languages.sh --html"), desc = "Build all HTML (no pull)" },
+  { "<leader>pTP", i18n_build_and_prompt("./scripts/build_all_languages.sh --pdf"), desc = "Build all PDF (no pull)" },
+  { "<leader>pTc", i18n_build_and_prompt("./scripts/build_all_languages.sh --pull --full --clean"), desc = "Clean + pull + build all" },
+  { "<leader>pTq", i18n_build_and_prompt("./scripts/build_all_languages.sh --html --languages 'en,de,fr'"), desc = "Quick build (en,de,fr)" },
+  { "<leader>pTd", term_cmd("./scripts/build_all_languages.sh --dry-run --pull --full"), desc = "Dry run (preview)" },
+  {
+    "<leader>pTl",
+    function()
+      vim.ui.input({ prompt = "Languages (comma-separated): " }, function(input)
+        if input then
+          i18n_build_and_prompt("./scripts/build_all_languages.sh --pull --html --languages '" .. input .. "'")()
+        end
+      end)
+    end,
+    desc = "Custom language selection",
+  },
+
+  -- Clean submenu
+  { "<leader>pc", group = "Clean" },
+  { "<leader>pcs", term_cmd("make springclean"), desc = "Spring clean (full)" },
+  { "<leader>pcb", shell_cmd("rm -rf build/html", "Cleaning HTML build"), desc = "Clean HTML build" },
+  { "<leader>pcl", shell_cmd("rm -rf build/latex build/pdf", "Cleaning LaTeX/PDF"), desc = "Clean LaTeX/PDF" },
+
+  -- QGIS submenu
+  { "<leader>pQ", group = "QGIS" },
+  { "<leader>pQq", term_cmd("nix run .#default"), desc = "Run QGIS" },
+  { "<leader>pQl", term_cmd("nix run .#qgis-ltr"), desc = "Run QGIS LTR" },
+  { "<leader>pQs", term_cmd("./scripts/start_qgis.sh"), desc = "Start QGIS (script)" },
+  { "<leader>pQL", term_cmd("./scripts/start_qgis_ltr.sh"), desc = "Start QGIS LTR (script)" },
+
+  -- Nix/Environment submenu
+  { "<leader>pn", group = "Nix/Environment" },
+  { "<leader>pnd", term_cmd("nix develop"), desc = "Enter dev shell" },
+  { "<leader>pnv", term_cmd("nix develop .#with-vscode"), desc = "Dev shell + VSCode" },
+  { "<leader>pnu", term_cmd("nix flake update"), desc = "Update flake inputs" },
+  { "<leader>pnc", term_cmd("nix flake check"), desc = "Check flake" },
+  { "<leader>pnl", term_cmd("nix flake lock"), desc = "Lock flake" },
+
+  -- Nix Run Apps submenu (standalone, no nix develop needed)
+  { "<leader>pr", group = "Nix Run (standalone)" },
+  -- Build apps
+  { "<leader>prh", term_cmd("nix run .#fasthtml"), desc = "Build HTML fast" },
+  { "<leader>prH", term_cmd("nix run .#html"), desc = "Build HTML strict" },
+  { "<leader>prd", term_cmd("nix run .#draft"), desc = "Build draft" },
+  { "<leader>prp", term_cmd("nix run .#pdf"), desc = "Build PDF" },
+  { "<leader>prf", term_cmd("nix run .#full"), desc = "Build full" },
+  -- Server
+  { "<leader>prs", term_cmd("nix run .#serve", { close_on_exit = false }), desc = "Live server" },
+  -- Quality
+  { "<leader>prl", term_cmd("nix run .#linkcheck"), desc = "Link check" },
+  { "<leader>prt", term_cmd("nix run .#doctest"), desc = "Doctest" },
+  { "<leader>prr", term_cmd("nix run .#rstcheck"), desc = "RST check" },
+  -- Clean
+  { "<leader>prc", term_cmd("nix run .#clean"), desc = "Clean all" },
+  { "<leader>prC", term_cmd("nix run .#clean-html"), desc = "Clean HTML" },
+  -- Translations
+  { "<leader>prg", term_cmd("nix run .#gettext"), desc = "Generate POT" },
+  { "<leader>prx", term_cmd("nix run .#tx-pull"), desc = "Pull translations" },
+  -- i18n full workflow (nix)
+  { "<leader>prI", term_cmd("nix run .#i18n-html", { close_on_exit = false }), desc = "i18n: pull + all HTML" },
+  { "<leader>prP", term_cmd("nix run .#i18n-pdf", { close_on_exit = false }), desc = "i18n: pull + all PDF" },
+  { "<leader>prF", term_cmd("nix run .#i18n-full", { close_on_exit = false }), desc = "i18n: pull + full" },
+  { "<leader>prA", term_cmd("nix run .#html-all", { close_on_exit = false }), desc = "Build all HTML" },
+
+  -- Git submenu
+  { "<leader>pg", group = "Git" },
+  { "<leader>pgs", term_cmd("git status"), desc = "Status" },
+  { "<leader>pgd", term_cmd("git diff"), desc = "Diff" },
+  { "<leader>pgD", term_cmd("git diff --staged"), desc = "Diff staged" },
+  { "<leader>pgl", term_cmd("git log --oneline -20"), desc = "Log (recent)" },
+  { "<leader>pgp", term_cmd("git pull --rebase"), desc = "Pull (rebase)" },
+  { "<leader>pgf", term_cmd("git fetch --all"), desc = "Fetch all" },
+
+  -- Utility submenu
+  { "<leader>pu", group = "Utilities" },
+  { "<leader>puc", term_cmd("./scripts/clean_unused_images.sh"), desc = "Clean unused images" },
+  { "<leader>pur", term_cmd("./scripts/rstcleanup.sh"), desc = "RST cleanup" },
+  { "<leader>puf", term_cmd("./scripts/strings_fixer.sh"), desc = "Fix strings" },
+  { "<leader>puv", term_cmd("./scripts/fix_versions.sh"), desc = "Fix versions" },
+
+  -- Image optimization submenu
+  { "<leader>pi", group = "Image Optimization" },
+  { "<leader>pid", term_cmd("./scripts/optimize_images.sh --dry-run"), desc = "Dry run (preview)" },
+  { "<leader>pil", term_cmd("./scripts/optimize_images.sh"), desc = "Lossless optimize" },
+  { "<leader>piL", term_cmd("./scripts/optimize_images.sh --lossy"), desc = "Lossy optimize" },
+  {
+    "<leader>pif",
+    function()
+      -- Get image path from current line (works in RST files)
+      local line = vim.fn.getline(".")
+      local img_path = line:match(":file:%s*([^%s]+)") or line:match("%.%.%s+image::%s*([^%s]+)")
+      if img_path then
+        -- Resolve relative to current file's directory
+        local current_dir = vim.fn.expand("%:p:h")
+        local full_path = current_dir .. "/" .. img_path
+        if vim.fn.filereadable(full_path) == 1 then
+          term_cmd("./scripts/optimize_images.sh " .. vim.fn.shellescape(full_path))()
+        else
+          vim.notify("Image not found: " .. full_path, vim.log.levels.WARN)
+        end
+      else
+        vim.notify("No image reference found on current line", vim.log.levels.WARN)
+      end
+    end,
+    desc = "Optimize image on line",
+  },
+  {
+    "<leader>piF",
+    function()
+      -- Optimize all images referenced in current RST file
+      local file = vim.fn.expand("%:p")
+      local dir = vim.fn.expand("%:p:h")
+      if not file:match("%.rst$") then
+        vim.notify("Not an RST file", vim.log.levels.WARN)
+        return
+      end
+      term_cmd("grep -oP '(?:image::|:file:)\\s*\\K[^\\s]+\\.png' " .. vim.fn.shellescape(file) ..
+        " | while read img; do ./scripts/optimize_images.sh \"" .. dir .. "/$img\"; done")()
+    end,
+    desc = "Optimize all images in file",
+  },
+  -- Nix run variants (standalone)
+  { "<leader>piD", term_cmd("nix run .#optimize-images-dry"), desc = "Dry run (nix)" },
+  { "<leader>pio", term_cmd("nix run .#optimize-images"), desc = "Lossless (nix)" },
+  { "<leader>piO", term_cmd("nix run .#optimize-images-lossy"), desc = "Lossy (nix)" },
+
+  -- Benchmarking
+  { "<leader>pB", group = "Benchmark" },
+  { "<leader>pBq", term_cmd("./scripts/benchmark_build.sh --quick"), desc = "Quick benchmark" },
+  { "<leader>pBs", term_cmd("./scripts/benchmark_build.sh --runs 3"), desc = "Standard benchmark (3 runs)" },
+  { "<leader>pBf", term_cmd("./scripts/benchmark_build.sh --full --runs 3 --output build/benchmark_results.md"), desc = "Full benchmark (clean)" },
+  {
+    "<leader>pBr",
+    function()
+      vim.cmd("edit build/benchmark_results.md")
+    end,
+    desc = "View benchmark results",
+  },
+
+  -- Diagnostics / Errors
+  { "<leader>pe", group = "Errors/Diagnostics" },
+  { "<leader>peb", build_and_capture_errors("make fasthtml"), desc = "Build + capture errors (background)" },
+  { "<leader>peB", build_and_capture_errors("make html"), desc = "Build strict + capture (background)" },
+  {
+    "<leader>pet",
+    function()
+      -- Build in terminal, then parse errors
+      local log_file = vim.fn.getcwd() .. "/build/sphinx_errors.log"
+      vim.fn.mkdir(vim.fn.getcwd() .. "/build", "p")
+      local cmd = string.format("make fasthtml 2>&1 | tee %s", log_file)
+
+      local tt_ok, toggleterm = pcall(require, "toggleterm.terminal")
+      if tt_ok then
+        local Terminal = toggleterm.Terminal
+        local term = Terminal:new({
+          cmd = cmd,
+          direction = "float",
+          close_on_exit = false,
+          on_exit = function()
+            vim.schedule(function()
+              parse_sphinx_errors(log_file)
+            end)
+          end,
+        })
+        term:toggle()
+      else
+        vim.cmd("split | terminal " .. cmd)
+        vim.notify("After build completes, use <leader>pea to parse errors", vim.log.levels.INFO)
+      end
+    end,
+    desc = "Build in terminal + parse errors",
+  },
+  { "<leader>per", rstcheck_to_quickfix, desc = "RST check to quickfix" },
+  { "<leader>pea", function() parse_sphinx_errors() end, desc = "Parse last build log" },
+  { "<leader>peo", "<cmd>copen<cr>", desc = "Open quickfix list" },
+  { "<leader>pec", "<cmd>cclose<cr>", desc = "Close quickfix list" },
+  { "<leader>pen", "<cmd>cnext<cr>", desc = "Next error" },
+  { "<leader>pep", "<cmd>cprev<cr>", desc = "Previous error" },
+  { "<leader>pef", "<cmd>cfirst<cr>", desc = "First error" },
+  { "<leader>pel", "<cmd>clast<cr>", desc = "Last error" },
+  {
+    "<leader>peL",
+    function()
+      -- Run linkcheck and parse output
+      vim.notify("Running linkcheck (this may take a while)...", vim.log.levels.INFO)
+      vim.fn.jobstart("make linkcheck 2>&1 | tee build/linkcheck.log", {
+        on_exit = function()
+          vim.schedule(function()
+            local file = io.open("build/linkcheck/output.txt", "r")
+            if not file then
+              vim.notify("No linkcheck output found", vim.log.levels.WARN)
+              return
+            end
+
+            local qf_items = {}
+            for line in file:lines() do
+              -- Pattern: file.rst:123: [broken] url: message
+              local filepath, lnum, status, url = line:match("([^:]+):(%d+):%s*%[(%w+)%]%s*(.+)")
+              if filepath and status == "broken" then
+                table.insert(qf_items, {
+                  filename = filepath,
+                  lnum = tonumber(lnum),
+                  col = 1,
+                  text = "Broken link: " .. url,
+                  type = "E",
+                })
+              end
+            end
+            file:close()
+
+            if #qf_items > 0 then
+              vim.fn.setqflist(qf_items)
+              vim.cmd("copen")
+              vim.notify(string.format("Found %d broken links", #qf_items), vim.log.levels.WARN)
+            else
+              vim.notify("No broken links found!", vim.log.levels.INFO)
+            end
+          end)
+        end,
+      })
+    end,
+    desc = "Link check to quickfix",
+  },
+
+  -- Help/Info
+  { "<leader>ph", group = "Help/Info" },
+  { "<leader>phm", term_cmd("make help"), desc = "Makefile help" },
+  {
+    "<leader>phr",
+    function()
+      vim.cmd("edit README.md")
+    end,
+    desc = "Open README",
+  },
+  {
+    "<leader>phc",
+    function()
+      vim.cmd("edit docs/documentation_guidelines/index.rst")
+    end,
+    desc = "Contribution guidelines",
+  },
+})
+
+-- Treesitter configuration for RST if available
+local ts_ok, ts_configs = pcall(require, "nvim-treesitter.configs")
+if ts_ok then
+  ts_configs.setup({
+    ensure_installed = { "rst", "python", "bash", "yaml", "json", "markdown" },
+    highlight = { enable = true },
+  })
+end
+
+-- LSP configuration for Python (used in conf.py and doctests)
+vim.api.nvim_create_autocmd("FileType", {
+  pattern = { "python" },
+  callback = function()
+    -- pyright or pylsp configuration if available
+    local lsp_ok, lspconfig = pcall(require, "lspconfig")
+    if lsp_ok and lspconfig.pyright then
+      lspconfig.pyright.setup({
+        settings = {
+          python = {
+            analysis = {
+              typeCheckingMode = "basic",
+            },
+          },
+        },
+      })
+    end
+  end,
+})
+
+-- Set up RST-specific settings
+vim.api.nvim_create_autocmd("FileType", {
+  pattern = "rst",
+  callback = function()
+    vim.opt_local.spell = true
+    vim.opt_local.spelllang = "en_us"
+    vim.opt_local.textwidth = 79
+    vim.opt_local.colorcolumn = "80"
+    vim.opt_local.expandtab = true
+    vim.opt_local.tabstop = 3
+    vim.opt_local.shiftwidth = 3
+    vim.opt_local.softtabstop = 3
+
+    -- RST-specific mappings
+    vim.keymap.set("n", "<localleader>h1", "yypVr=", { buffer = true, desc = "RST H1 underline" })
+    vim.keymap.set("n", "<localleader>h2", "yypVr-", { buffer = true, desc = "RST H2 underline" })
+    vim.keymap.set("n", "<localleader>h3", "yypVr^", { buffer = true, desc = "RST H3 underline" })
+    vim.keymap.set("n", "<localleader>h4", "yypVr~", { buffer = true, desc = "RST H4 underline" })
+  end,
+})
+
+-- Notify that project config is loaded
+vim.notify("QGIS Documentation project config loaded. Use <leader>p for project menu.", vim.log.levels.INFO)
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index b309fffb46f..836f83b599d 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -1,6 +1,71 @@
+# Pre-commit hooks for QGIS Documentation
+# Install: pre-commit install
+# Run manually: pre-commit run --all-files
+# Update hooks: pre-commit autoupdate
 
 repos:
+  # Standard pre-commit hooks
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+        args: [--markdown-linebreak-ext=md]
+        exclude: ^(locale/|_dummy/)
+      - id: end-of-file-fixer
+        exclude: ^(locale/|_dummy/)
+      - id: check-yaml
+        args: [--unsafe]
+      - id: check-json
+      - id: check-merge-conflict
+      - id: check-added-large-files
+        args: ['--maxkb=1024']
+      - id: mixed-line-ending
+        args: [--fix=lf]
+        exclude: ^(locale/|_dummy/)
+
+  # RST linting with rstcheck
+  - repo: https://github.com/rstcheck/rstcheck
+    rev: v6.2.0
+    hooks:
+      - id: rstcheck
+        args:
+          - --report-level=warning
+          - --ignore-directives=toctree,include,only,ifconfig,literalinclude,index,glossary,substitution-definitions,highlight,todo,todolist,deprecated,versionadded,versionchanged,seealso,productionlist,centered,testcode,testoutput,testsetup,tabs,tab,code-block,toggle
+          - --ignore-roles=menuselection,guilabel,file,kbd,ref,doc,term,command,program,option,envvar,index,abbr,dfn,numref,eq,download,py:mod,py:obj,py:class,py:meth,py:attr,py:func,py:exc,pyqgis,api,source,sup,sub,raw,math
+          - --ignore-languages=python,bash,sql,json,xml,yaml
+        exclude: ^(locale/|_dummy/|build/)
+        additional_dependencies:
+          - sphinx
+
+  # RST style checker (doc8)
+  - repo: https://github.com/PyCQA/doc8
+    rev: v1.1.1
+    hooks:
+      - id: doc8
+        args:
+          - --max-line-length=300
+          - --ignore=D001,D002,D004
+        exclude: ^(locale/|_dummy/|build/)
+
+  # Spell checking
+  - repo: https://github.com/codespell-project/codespell
+    rev: v2.2.6
+    hooks:
+      - id: codespell
+        args:
+          - --skip=*.po,*.pot,*.mo,*.svg,*.png,*.jpg,*.gif,*.ico,*.pyc,*.js,*.css,*.map
+          - --ignore-words-list=cange,fo,ges,hsa,ist,nd,ot,te,teh,theses,titel,ue,vertice,wil,sur,ans,rouge,ba,aas,pullrequest
+        exclude: ^(locale/|_dummy/|build/|scripts/)
+
+  # YAML formatting
+  - repo: https://github.com/adrienverge/yamllint
+    rev: v1.33.0
+    hooks:
+      - id: yamllint
+        args: [-d, "{extends: relaxed, rules: {line-length: {max: 200}}}"]
+        exclude: ^(locale/|_dummy/|build/)
 
+  # Check for broken internal references (local script)
   - repo: local
     hooks:
       - id: find_set_subst
@@ -10,6 +75,24 @@ repos:
         always_run: true
         pass_filenames: false
 
+      - id: check-image-refs
+        name: Check image references exist
+        entry: ./scripts/check_image_refs.sh
+        language: script
+        files: \.(rst)$
+        exclude: ^(locale/|_dummy/|build/)
+
+      - id: rst-lint-staged
+        name: RST syntax check (staged files)
+        entry: bash -c 'for f in "$@"; do if [[ "$f" == *.rst ]]; then rstcheck --report-level error --ignore-roles pyqgis,api,source,sup,sub --ignore-directives testcode,testoutput,toggle,tabs,tab --ignore-languages python,bash,sql "$f" 2>&1 | grep -v "Unknown" || true; fi; done'
+        language: system
+        pass_filenames: true
+        files: \.(rst)$
+        exclude: ^(locale/|_dummy/|build/)
+
 ci:
   autofix_prs: true
   autoupdate_schedule: quarterly
+  skip:
+    - check-image-refs
+    - rst-lint-staged
diff --git a/.tx/config b/.tx/config
index 58e2f0da5c3..a05e56867ab 100644
--- a/.tx/config
+++ b/.tx/config
@@ -1,4 +1,3 @@
 [main]
 host = https://app.transifex.com
 lang_map = zh-Hant: zh_Hant, zh-Hans: zh_Hans
-
diff --git a/Makefile b/Makefile
index fc457393639..3c7dfad7a0e 100644
--- a/Makefile
+++ b/Makefile
@@ -1,11 +1,14 @@
 # Minimal makefile for Sphinx documentation
 #
 
+# Use bash for shell commands (needed for echo -e color support)
+SHELL := $(shell which bash)
+
 # You can set these variables from the command line.
 LANG            = en
 # currently we are building for the following languages, if you want yours to be build: ask!
 LANGUAGES       = en # cs de es fr hu it ja ko lt nl pl pt_BR pt_PT ro ru sv zh_Hans
-SPHINXOPTS      =
+SPHINXOPTS      = -j auto
 # Use the tag i18n to filter text based on whether we are translating or not
 SPHINXINTLOPTS  = $(SPHINXOPTS) -D language=$(LANG) -t i18n
 SPHINXBUILD     ?= sphinx-build
@@ -21,6 +24,37 @@ VERSION         = testing
 # needed for Sphinx > 4.5?
 export LC_ALL=C.UTF-8
 
+# ============================================================================
+# Colors and Formatting
+# ============================================================================
+BLUE    := \033[1;34m
+GREEN   := \033[1;32m
+YELLOW  := \033[1;33m
+CYAN    := \033[1;36m
+MAGENTA := \033[1;35m
+WHITE   := \033[1;37m
+DIM     := \033[0;90m
+NC      := \033[0m
+
+# Timer helper - prints a beautiful completion message
+# Usage: $(call print_time,$(START_TIME),Target Name)
+define print_time
+	@END_TIME=$$(date +%s); \
+	ELAPSED=$$((END_TIME - $(1))); \
+	MINS=$$((ELAPSED / 60)); \
+	SECS=$$((ELAPSED % 60)); \
+	echo ""; \
+	echo -e "$(BLUE)╔══════════════════════════════════════════════════════════════════╗$(NC)"; \
+	echo -e "$(BLUE)║$(NC)  $(GREEN)✓$(NC) $(WHITE)$(2)$(NC) completed successfully"; \
+	if [ $$MINS -gt 0 ]; then \
+		printf "$(BLUE)║$(NC)  $(CYAN)⏱$(NC)  Duration: $(YELLOW)%dm %ds$(NC)\n" $$MINS $$SECS; \
+	else \
+		printf "$(BLUE)║$(NC)  $(CYAN)⏱$(NC)  Duration: $(YELLOW)%ds$(NC)\n" $$SECS; \
+	fi; \
+	echo -e "$(BLUE)╚══════════════════════════════════════════════════════════════════╝$(NC)"; \
+	echo ""
+endef
+
 # Put it first so that "make" without argument is like "make help".
 help:
 	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
@@ -28,12 +62,48 @@ help:
 .PHONY: help Makefile
 
 springclean:
-	rm -rf $(BUILDDIR)
-	# all .mo files
-	-find $(SOURCEDIR)/locale/*/LC_MESSAGES/ -type f -name '*.mo' -delete
+	@START_TIME=$$(date +%s); \
+	echo ""; \
+	echo -e "$(BLUE)━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━$(NC)"; \
+	echo -e "$(CYAN)  Spring cleaning build artifacts$(NC)"; \
+	echo -e "$(BLUE)━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━$(NC)"; \
+	echo ""; \
+	rm -rf $(BUILDDIR); \
+	find $(SOURCEDIR)/locale/*/LC_MESSAGES/ -type f -name '*.mo' -delete 2>/dev/null || true; \
+	END_TIME=$$(date +%s); \
+	ELAPSED=$$((END_TIME - START_TIME)); \
+	SECS=$$ELAPSED; \
+	echo ""; \
+	echo -e "$(BLUE)╔══════════════════════════════════════════════════════════════════╗$(NC)"; \
+	echo -e "$(BLUE)║$(NC)  $(GREEN)✓$(NC) $(WHITE)Spring clean$(NC) completed"; \
+	printf "$(BLUE)║$(NC)  $(CYAN)⏱$(NC)  Duration: $(YELLOW)%ds$(NC)\n" $$SECS; \
+	echo -e "$(BLUE)║$(NC)  $(DIM)Removed: $(BUILDDIR)/ and .mo files$(NC)"; \
+	echo -e "$(BLUE)╚══════════════════════════════════════════════════════════════════╝$(NC)"; \
+	echo ""
 
 gettext:
-	@$(SPHINXBUILD) -M gettext "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+	@START_TIME=$$(date +%s); \
+	echo ""; \
+	echo -e "$(BLUE)━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━$(NC)"; \
+	echo -e "$(CYAN)  Generating POT translation files$(NC)"; \
+	echo -e "$(BLUE)━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━$(NC)"; \
+	echo ""; \
+	$(SPHINXBUILD) -M gettext "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O); \
+	END_TIME=$$(date +%s); \
+	ELAPSED=$$((END_TIME - START_TIME)); \
+	MINS=$$((ELAPSED / 60)); \
+	SECS=$$((ELAPSED % 60)); \
+	echo ""; \
+	echo -e "$(BLUE)╔══════════════════════════════════════════════════════════════════╗$(NC)"; \
+	echo -e "$(BLUE)║$(NC)  $(GREEN)✓$(NC) $(WHITE)POT file generation$(NC) completed"; \
+	if [ $$MINS -gt 0 ]; then \
+		printf "$(BLUE)║$(NC)  $(CYAN)⏱$(NC)  Duration: $(YELLOW)%dm %ds$(NC)\n" $$MINS $$SECS; \
+	else \
+		printf "$(BLUE)║$(NC)  $(CYAN)⏱$(NC)  Duration: $(YELLOW)%ds$(NC)\n" $$SECS; \
+	fi; \
+	echo -e "$(BLUE)║$(NC)  $(DIM)Output: $(BUILDDIR)/gettext/$(NC)"; \
+	echo -e "$(BLUE)╚══════════════════════════════════════════════════════════════════╝$(NC)"; \
+	echo ""
 
 # this will build html-version of one language (defaults to english: en)
 # to build for example dutch on Linux:
@@ -45,12 +115,37 @@ gettext:
 # so if you want most up to date files, download or use 'tx' to get those first
 
 html:
-	echo "$(SPHINXOPTS) $(SPHINXINTLOPTS)"
+	@START_TIME=$$(date +%s); \
+	echo ""; \
+	echo -e "$(BLUE)━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━$(NC)"; \
+	echo -e "$(CYAN)  Building HTML documentation ($(LANG)) - strict mode$(NC)"; \
+	echo -e "$(BLUE)━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━$(NC)"; \
+	echo ""; \
 	if [ $(LANG) != "en" ]; then \
 		$(SPHINXBUILD) -b html "$(SOURCEDIR)" "$(BUILDDIR)/html/$(LANG)" $(SPHINXINTLOPTS) $(0); \
 	else \
 		$(SPHINXBUILD) -b html -nW --keep-going "$(SOURCEDIR)" "$(BUILDDIR)/html/$(LANG)" $(SPHINXOPTS) $(0); \
-	fi
+	fi; \
+	EXIT_CODE=$$?; \
+	END_TIME=$$(date +%s); \
+	ELAPSED=$$((END_TIME - START_TIME)); \
+	MINS=$$((ELAPSED / 60)); \
+	SECS=$$((ELAPSED % 60)); \
+	echo ""; \
+	echo -e "$(BLUE)╔══════════════════════════════════════════════════════════════════╗$(NC)"; \
+	if [ $$EXIT_CODE -eq 0 ]; then \
+		echo -e "$(BLUE)║$(NC)  $(GREEN)✓$(NC) $(WHITE)HTML build ($(LANG))$(NC) completed successfully"; \
+	else \
+		echo -e "$(BLUE)║$(NC)  $(YELLOW)⚠$(NC) $(WHITE)HTML build ($(LANG))$(NC) finished with warnings"; \
+	fi; \
+	if [ $$MINS -gt 0 ]; then \
+		printf "$(BLUE)║$(NC)  $(CYAN)⏱$(NC)  Duration: $(YELLOW)%dm %ds$(NC)\n" $$MINS $$SECS; \
+	else \
+		printf "$(BLUE)║$(NC)  $(CYAN)⏱$(NC)  Duration: $(YELLOW)%ds$(NC)\n" $$SECS; \
+	fi; \
+	echo -e "$(BLUE)║$(NC)  $(DIM)Output: $(BUILDDIR)/html/$(LANG)/index.html$(NC)"; \
+	echo -e "$(BLUE)╚══════════════════════════════════════════════════════════════════╝$(NC)"; \
+	echo ""
 
 latex:
 	# for LANG=ja overwrites the default latex_engine=xelatex by latex_engine=uplatex
@@ -58,7 +153,28 @@ latex:
 	# A tag -t $LANG is used in the building process to allow for dynamic
 	# settings in the conf.py. For example, for korean we need to use other
 	# latex_elements and we use a if tags.has('ko') expression to overwrite the defaults
-	$(SPHINXBUILD) -b latex -t $(LANG) "$(SOURCEDIR)" "$(BUILDDIR)/latex/$(LANG)" $(SPHINXINTLOPTS) $(0)
+	@START_TIME=$$(date +%s); \
+	echo ""; \
+	echo -e "$(BLUE)━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━$(NC)"; \
+	echo -e "$(CYAN)  Building LaTeX documentation ($(LANG))$(NC)"; \
+	echo -e "$(BLUE)━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━$(NC)"; \
+	echo ""; \
+	$(SPHINXBUILD) -b latex -t $(LANG) "$(SOURCEDIR)" "$(BUILDDIR)/latex/$(LANG)" $(SPHINXINTLOPTS) $(0); \
+	END_TIME=$$(date +%s); \
+	ELAPSED=$$((END_TIME - START_TIME)); \
+	MINS=$$((ELAPSED / 60)); \
+	SECS=$$((ELAPSED % 60)); \
+	echo ""; \
+	echo -e "$(BLUE)╔══════════════════════════════════════════════════════════════════╗$(NC)"; \
+	echo -e "$(BLUE)║$(NC)  $(GREEN)✓$(NC) $(WHITE)LaTeX build ($(LANG))$(NC) completed"; \
+	if [ $$MINS -gt 0 ]; then \
+		printf "$(BLUE)║$(NC)  $(CYAN)⏱$(NC)  Duration: $(YELLOW)%dm %ds$(NC)\n" $$MINS $$SECS; \
+	else \
+		printf "$(BLUE)║$(NC)  $(CYAN)⏱$(NC)  Duration: $(YELLOW)%ds$(NC)\n" $$SECS; \
+	fi; \
+	echo -e "$(BLUE)║$(NC)  $(DIM)Output: $(BUILDDIR)/latex/$(LANG)/$(NC)"; \
+	echo -e "$(BLUE)╚══════════════════════════════════════════════════════════════════╝$(NC)"; \
+	echo ""
 
 
 pdf: latex
@@ -74,30 +190,67 @@ pdf: latex
 	# Then we copy and rename PDF files to the pdf folder
 	# || true allows the job to continue even if one of the files is missing
 
+	@START_TIME=$$(date +%s); \
+	echo ""; \
+	echo -e "$(BLUE)━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━$(NC)"; \
+	echo -e "$(CYAN)  Compiling PDF documentation ($(LANG))$(NC)"; \
+	echo -e "$(BLUE)━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━$(NC)"; \
+	echo ""; \
 	for TEXFILE in $$(find $(BUILDDIR)/latex/$(LANG) -iname '*.tex' -exec basename {} .tex ';'); \
 		do \
 			cd $(BUILDDIR)/latex/$(LANG); \
-			echo $$TEXFILE; \
+			echo "  Compiling: $$TEXFILE"; \
 			$(LATEXCOMPILER) -interaction=batchmode -shell-escape $$TEXFILE.tex; \
 			$(LATEXCOMPILER) -interaction=batchmode -shell-escape $$TEXFILE.tex; \
 			if [ "$(LATEXCOMPILER)" != "xelatex" ]  && [ -f "$$TEXFILE.dvi" ]; then \
 				dvipdfmx -q $$TEXFILE.dvi; fi; \
 			mkdir -p ../../pdf/$(LANG); \
 			mv $$TEXFILE.pdf ../../pdf/$(LANG)/QGIS-$(VERSION)-$$TEXFILE-$(LANG).pdf || true; \
-		done
+		done; \
+	END_TIME=$$(date +%s); \
+	ELAPSED=$$((END_TIME - START_TIME)); \
+	MINS=$$((ELAPSED / 60)); \
+	SECS=$$((ELAPSED % 60)); \
+	echo ""; \
+	echo -e "$(BLUE)╔══════════════════════════════════════════════════════════════════╗$(NC)"; \
+	echo -e "$(BLUE)║$(NC)  $(GREEN)✓$(NC) $(WHITE)PDF build ($(LANG))$(NC) completed"; \
+	if [ $$MINS -gt 0 ]; then \
+		printf "$(BLUE)║$(NC)  $(CYAN)⏱$(NC)  Duration: $(YELLOW)%dm %ds$(NC)\n" $$MINS $$SECS; \
+	else \
+		printf "$(BLUE)║$(NC)  $(CYAN)⏱$(NC)  Duration: $(YELLOW)%ds$(NC)\n" $$SECS; \
+	fi; \
+	echo -e "$(BLUE)║$(NC)  $(DIM)Output: $(BUILDDIR)/pdf/$(LANG)/$(NC)"; \
+	echo -e "$(BLUE)╚══════════════════════════════════════════════════════════════════╝$(NC)"; \
+	echo ""
 
 zip:
-	mkdir -p $(BUILDDIR)/zip;
+	@START_TIME=$$(date +%s); \
+	echo ""; \
+	echo -e "$(BLUE)━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━$(NC)"; \
+	echo -e "$(CYAN)  Creating ZIP archive ($(LANG))$(NC)"; \
+	echo -e "$(BLUE)━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━$(NC)"; \
+	echo ""; \
+	mkdir -p $(BUILDDIR)/zip; \
 	(cd $(BUILDDIR)/html; \
-	zip -r QGIS-$(VERSION)-Documentation-$(LANG).zip $(LANG)/;)
-	mv $(BUILDDIR)/html/QGIS-$(VERSION)-Documentation-$(LANG).zip $(BUILDDIR)/zip/;
+	zip -r QGIS-$(VERSION)-Documentation-$(LANG).zip $(LANG)/;); \
+	mv $(BUILDDIR)/html/QGIS-$(VERSION)-Documentation-$(LANG).zip $(BUILDDIR)/zip/; \
+	END_TIME=$$(date +%s); \
+	ELAPSED=$$((END_TIME - START_TIME)); \
+	SECS=$$ELAPSED; \
+	echo ""; \
+	echo -e "$(BLUE)╔══════════════════════════════════════════════════════════════════╗$(NC)"; \
+	echo -e "$(BLUE)║$(NC)  $(GREEN)✓$(NC) $(WHITE)ZIP archive ($(LANG))$(NC) created"; \
+	printf "$(BLUE)║$(NC)  $(CYAN)⏱$(NC)  Duration: $(YELLOW)%ds$(NC)\n" $$SECS; \
+	echo -e "$(BLUE)║$(NC)  $(DIM)Output: $(BUILDDIR)/zip/QGIS-$(VERSION)-Documentation-$(LANG).zip$(NC)"; \
+	echo -e "$(BLUE)╚══════════════════════════════════════════════════════════════════╝$(NC)"; \
+	echo ""
 
 site: html zip
 	rsync -hvrzc --delete --progress $(BUILDDIR)/html/$(LANG) $(SITEDIR)/;
 
 full: html zip
 	make LANG=$(LANG) pdf;
-	
+
 # this will build ALL languages, AND tries to rsync them to the web dir on qgis2
 # to be able to run this you will need a key on the server
 all: springclean
@@ -124,7 +277,31 @@ tx_force_pull_translations:
 	$(eval space := )
 	$(eval space += )
 	$(eval comma += ,)
-	tx pull -f --parallel --mode onlytranslated -l $(subst $(space),$(comma),$(subst en$(space),,$(subst zh_,zh-,$(LANGUAGES)))) ;
+	@START_TIME=$$(date +%s); \
+	echo ""; \
+	echo -e "$(BLUE)━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━$(NC)"; \
+	echo -e "$(CYAN)  Pulling translations from Transifex$(NC)"; \
+	echo -e "$(BLUE)━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━$(NC)"; \
+	echo ""; \
+	tx pull -f --parallel --mode onlytranslated -l $(subst $(space),$(comma),$(subst en$(space),,$(subst zh_,zh-,$(LANGUAGES)))); \
+	END_TIME=$$(date +%s); \
+	ELAPSED=$$((END_TIME - START_TIME)); \
+	MINS=$$((ELAPSED / 60)); \
+	SECS=$$((ELAPSED % 60)); \
+	echo ""; \
+	echo -e "$(BLUE)╔══════════════════════════════════════════════════════════════════╗$(NC)"; \
+	echo -e "$(BLUE)║$(NC)  $(GREEN)✓$(NC) $(WHITE)Translation pull$(NC) completed"; \
+	if [ $$MINS -gt 0 ]; then \
+		printf "$(BLUE)║$(NC)  $(CYAN)⏱$(NC)  Duration: $(YELLOW)%dm %ds$(NC)\n" $$MINS $$SECS; \
+	else \
+		printf "$(BLUE)║$(NC)  $(CYAN)⏱$(NC)  Duration: $(YELLOW)%ds$(NC)\n" $$SECS; \
+	fi; \
+	echo -e "$(BLUE)║$(NC)  $(DIM)Translations saved to: locale/$(NC)"; \
+	echo -e "$(BLUE)╚══════════════════════════════════════════════════════════════════╝$(NC)"; \
+	echo ""
+
+# Alias for easier access
+pull-translations: tx_force_pull_translations
 
 doctest-gh:
 	# --system-site-packages needed to keep QGIS libs in python path
@@ -134,11 +311,155 @@ doctest-gh:
 	      "results in $(BUILDDIR)/doctest/output.txt."
 
 doctest:
-	LD_PRELOAD=/lib/x86_64-linux-gnu/libSegFault.so $(SPHINXBUILD) -b doctest . $(BUILDDIR)/doctest
-	@echo "Testing of doctests in the sources finished, look at the " \
-	      "results in $(BUILDDIR)/doctest/output.txt."
+	@START_TIME=$$(date +%s); \
+	echo ""; \
+	echo -e "$(BLUE)━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━$(NC)"; \
+	echo -e "$(CYAN)  Running doctests$(NC)"; \
+	echo -e "$(BLUE)━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━$(NC)"; \
+	echo ""; \
+	LD_PRELOAD=/lib/x86_64-linux-gnu/libSegFault.so $(SPHINXBUILD) -b doctest . $(BUILDDIR)/doctest; \
+	END_TIME=$$(date +%s); \
+	ELAPSED=$$((END_TIME - START_TIME)); \
+	MINS=$$((ELAPSED / 60)); \
+	SECS=$$((ELAPSED % 60)); \
+	echo ""; \
+	echo -e "$(BLUE)╔══════════════════════════════════════════════════════════════════╗$(NC)"; \
+	echo -e "$(BLUE)║$(NC)  $(GREEN)✓$(NC) $(WHITE)Doctests$(NC) completed"; \
+	if [ $$MINS -gt 0 ]; then \
+		printf "$(BLUE)║$(NC)  $(CYAN)⏱$(NC)  Duration: $(YELLOW)%dm %ds$(NC)\n" $$MINS $$SECS; \
+	else \
+		printf "$(BLUE)║$(NC)  $(CYAN)⏱$(NC)  Duration: $(YELLOW)%ds$(NC)\n" $$SECS; \
+	fi; \
+	echo -e "$(BLUE)║$(NC)  $(DIM)Results: $(BUILDDIR)/doctest/output.txt$(NC)"; \
+	echo -e "$(BLUE)╚══════════════════════════════════════════════════════════════════╝$(NC)"; \
+	echo ""
 
 linkcheck:
-	$(SPHINXBUILD) -b linkcheck $(SOURCEDIR) $(BUILDDIR)/linkcheck
-	@echo "Check finished. Report is in $(BUILDDIR)/linkcheck/output.txt."
+	@START_TIME=$$(date +%s); \
+	echo ""; \
+	echo -e "$(BLUE)━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━$(NC)"; \
+	echo -e "$(CYAN)  Checking links in documentation$(NC)"; \
+	echo -e "$(BLUE)━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━$(NC)"; \
+	echo ""; \
+	$(SPHINXBUILD) -b linkcheck $(SOURCEDIR) $(BUILDDIR)/linkcheck; \
+	END_TIME=$$(date +%s); \
+	ELAPSED=$$((END_TIME - START_TIME)); \
+	MINS=$$((ELAPSED / 60)); \
+	SECS=$$((ELAPSED % 60)); \
+	echo ""; \
+	echo -e "$(BLUE)╔══════════════════════════════════════════════════════════════════╗$(NC)"; \
+	echo -e "$(BLUE)║$(NC)  $(GREEN)✓$(NC) $(WHITE)Link check$(NC) completed"; \
+	if [ $$MINS -gt 0 ]; then \
+		printf "$(BLUE)║$(NC)  $(CYAN)⏱$(NC)  Duration: $(YELLOW)%dm %ds$(NC)\n" $$MINS $$SECS; \
+	else \
+		printf "$(BLUE)║$(NC)  $(CYAN)⏱$(NC)  Duration: $(YELLOW)%ds$(NC)\n" $$SECS; \
+	fi; \
+	echo -e "$(BLUE)║$(NC)  $(DIM)Report: $(BUILDDIR)/linkcheck/output.txt$(NC)"; \
+	echo -e "$(BLUE)╚══════════════════════════════════════════════════════════════════╝$(NC)"; \
+	echo ""
+
+# Fast development build - skips warnings-as-errors and uses all cores
+fasthtml:
+	@START_TIME=$$(date +%s); \
+	echo ""; \
+	echo -e "$(BLUE)━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━$(NC)"; \
+	echo -e "$(CYAN)  Building HTML documentation ($(LANG)) - fast mode$(NC)"; \
+	echo -e "$(BLUE)━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━$(NC)"; \
+	echo ""; \
+	$(SPHINXBUILD) -b html -j auto "$(SOURCEDIR)" "$(BUILDDIR)/html/$(LANG)" $(SPHINXOPTS) $(0); \
+	END_TIME=$$(date +%s); \
+	ELAPSED=$$((END_TIME - START_TIME)); \
+	MINS=$$((ELAPSED / 60)); \
+	SECS=$$((ELAPSED % 60)); \
+	echo ""; \
+	echo -e "$(BLUE)╔══════════════════════════════════════════════════════════════════╗$(NC)"; \
+	echo -e "$(BLUE)║$(NC)  $(GREEN)✓$(NC) $(WHITE)Fast HTML build ($(LANG))$(NC) completed successfully"; \
+	if [ $$MINS -gt 0 ]; then \
+		printf "$(BLUE)║$(NC)  $(CYAN)⏱$(NC)  Duration: $(YELLOW)%dm %ds$(NC)\n" $$MINS $$SECS; \
+	else \
+		printf "$(BLUE)║$(NC)  $(CYAN)⏱$(NC)  Duration: $(YELLOW)%ds$(NC)\n" $$SECS; \
+	fi; \
+	echo -e "$(BLUE)║$(NC)  $(DIM)Output: $(BUILDDIR)/html/$(LANG)/index.html$(NC)"; \
+	echo -e "$(BLUE)╚══════════════════════════════════════════════════════════════════╝$(NC)"; \
+	echo ""
+
+# Build only changed files (incremental) - useful during writing
+draft:
+	@START_TIME=$$(date +%s); \
+	echo ""; \
+	echo -e "$(BLUE)━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━$(NC)"; \
+	echo -e "$(CYAN)  Building HTML documentation ($(LANG)) - draft/quiet mode$(NC)"; \
+	echo -e "$(BLUE)━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━$(NC)"; \
+	echo ""; \
+	$(SPHINXBUILD) -b html -j auto -Q "$(SOURCEDIR)" "$(BUILDDIR)/html/$(LANG)" $(SPHINXOPTS) $(0); \
+	END_TIME=$$(date +%s); \
+	ELAPSED=$$((END_TIME - START_TIME)); \
+	MINS=$$((ELAPSED / 60)); \
+	SECS=$$((ELAPSED % 60)); \
+	echo ""; \
+	echo -e "$(BLUE)╔══════════════════════════════════════════════════════════════════╗$(NC)"; \
+	echo -e "$(BLUE)║$(NC)  $(GREEN)✓$(NC) $(WHITE)Draft build ($(LANG))$(NC) completed"; \
+	if [ $$MINS -gt 0 ]; then \
+		printf "$(BLUE)║$(NC)  $(CYAN)⏱$(NC)  Duration: $(YELLOW)%dm %ds$(NC)\n" $$MINS $$SECS; \
+	else \
+		printf "$(BLUE)║$(NC)  $(CYAN)⏱$(NC)  Duration: $(YELLOW)%ds$(NC)\n" $$SECS; \
+	fi; \
+	echo -e "$(BLUE)║$(NC)  $(DIM)Output: $(BUILDDIR)/html/$(LANG)/index.html$(NC)"; \
+	echo -e "$(BLUE)╚══════════════════════════════════════════════════════════════════╝$(NC)"; \
+	echo ""
+
+# Live reload server for development
+serve:
+	sphinx-autobuild -j auto --port 8000 --open-browser "$(SOURCEDIR)" "$(BUILDDIR)/html/$(LANG)"
+
+# ============================================================================
+# Translation Workflow Targets
+# ============================================================================
+
+# Pull translations and build all HTML in parallel
+i18n-html:
+	./scripts/build_all_languages.sh --pull --html
+
+# Pull translations and build all PDFs in parallel
+i18n-pdf:
+	./scripts/build_all_languages.sh --pull --pdf
+
+# Pull translations and build everything (HTML + PDF) in parallel
+i18n-full:
+	./scripts/build_all_languages.sh --pull --full
+
+# Build all HTML without pulling (use existing translations)
+html-all:
+	./scripts/build_all_languages.sh --html
+
+# Build all PDFs without pulling
+pdf-all:
+	./scripts/build_all_languages.sh --pdf
+
+# Full parallel build without pulling
+full-all:
+	./scripts/build_all_languages.sh --full
+
+# Clean and rebuild everything with fresh translations
+i18n-clean-rebuild:
+	./scripts/build_all_languages.sh --pull --full --clean
+
+# Quick parallel HTML build (subset of languages for testing)
+i18n-quick:
+	./scripts/build_all_languages.sh --html --languages "en,de,fr"
+
+# ============================================================================
+# Benchmarking
+# ============================================================================
+
+# Quick benchmark (single run, no clean)
+benchmark-quick:
+	./scripts/benchmark_build.sh --quick
+
+# Standard benchmark (3 runs, incremental)
+benchmark:
+	./scripts/benchmark_build.sh --runs 3
 
+# Full benchmark (3 runs, clean builds)
+benchmark-full:
+	./scripts/benchmark_build.sh --full --runs 3 --output build/benchmark_results.md
diff --git a/README.md b/README.md
index fab3cfd910e..ef939289b43 100644
--- a/README.md
+++ b/README.md
@@ -91,7 +91,7 @@ make -f venv.mk cleanall
 ### Fixing build locale error on macOS
 
 When the build on macOS fails with:
-  
+
 ```sh
 locale.Error: unsupported locale setting
 make: *** [html] Error 1
@@ -228,7 +228,7 @@ and some custom scripts:
       ```
   ---
 
-* The transifex integration bot: 
+* The transifex integration bot:
   manages pulls and pushes of the strings, in other words:
   - Tracks any changes of the English `*.po` resource files in GitHub
     and automatically sends them to the Transifex platform
@@ -357,4 +357,3 @@ which does not appear in documentation with directive ``testsetup``, for example
 
 For more information see *Sphinx* doctest extension documentation:
 https://www.sphinx-doc.org/en/master/usage/extensions/doctest.html
-
diff --git a/clean.sh b/clean.sh
index 6adc767a770..5950033e348 100755
--- a/clean.sh
+++ b/clean.sh
@@ -6,4 +6,3 @@ rm -rf .vscode-extensions
 rm -rf __pycache__
 cd ..
 cd -
-
diff --git a/docs/user_manual/map_views/3d_map_view.rst b/docs/user_manual/map_views/3d_map_view.rst
index 1804ad5c51f..233307f2883 100644
--- a/docs/user_manual/map_views/3d_map_view.rst
+++ b/docs/user_manual/map_views/3d_map_view.rst
@@ -520,9 +520,9 @@ in 3D map views. See :ref:`3D view layer properties <annotationslayer_3dview>` f
 .. |3dNavigation| image:: /static/common/mAction3DNavigation.png
    :width: 1.3em
 .. |arrowLeft| image:: /static/common/mActionArrowLeft.png
-   :width: 1.5em
+   :width: 1.2em
 .. |arrowRight| image:: /static/common/mActionArrowRight.png
-   :width: 1.5em
+   :width: 1.2em
 .. |camera| image:: /static/common/mIconCamera.png
    :width: 1.5em
 .. |checkbox| image:: /static/common/checkbox.png
@@ -570,7 +570,7 @@ in 3D map views. See :ref:`3D view layer properties <annotationslayer_3dview>` f
 .. |unchecked| image:: /static/common/unchecked.png
    :width: 1.3em
 .. |unlocked| image:: /static/common/unlocked.png
-   :width: 1.3em
+   :width: 1.5em
 .. |zoomFullExtent| image:: /static/common/mActionZoomFullExtent.png
    :width: 1.5em
 .. |zoomIn| image:: /static/common/mActionZoomIn.png
diff --git a/docs/user_manual/processing_algs/qgis/rasteranalysis.rst b/docs/user_manual/processing_algs/qgis/rasteranalysis.rst
index 161a250dbdf..c2d0211b053 100644
--- a/docs/user_manual/processing_algs/qgis/rasteranalysis.rst
+++ b/docs/user_manual/processing_algs/qgis/rasteranalysis.rst
@@ -4665,5 +4665,4 @@ Python code
    please add it also to the substitutions.txt file in the
    source folder.
 
-.. |344| replace:: ``NEW in 3.44``
 .. |400| replace:: ``NEW in 4.0``
diff --git a/docs/user_manual/processing_algs/qgis/rasterterrainanalysis.rst b/docs/user_manual/processing_algs/qgis/rasterterrainanalysis.rst
index f8945431ded..9cd095e8458 100644
--- a/docs/user_manual/processing_algs/qgis/rasterterrainanalysis.rst
+++ b/docs/user_manual/processing_algs/qgis/rasterterrainanalysis.rst
@@ -1188,5 +1188,4 @@ Python code
    please add it also to the substitutions.txt file in the
    source folder.
 
-.. |344| replace:: ``NEW in 3.44``
 .. |400| replace:: ``NEW in 4.0``
diff --git a/docs/user_manual/working_with_point_clouds/point_clouds.rst b/docs/user_manual/working_with_point_clouds/point_clouds.rst
index 78ddbbf8a31..744a3dc3480 100755
--- a/docs/user_manual/working_with_point_clouds/point_clouds.rst
+++ b/docs/user_manual/working_with_point_clouds/point_clouds.rst
@@ -933,8 +933,6 @@ After setting the attribute, value, and optional filter, digitize a selection us
    :width: 1.5em
 .. |multibandColor| image:: /static/common/multibandColor.png
    :width: 1.5em
-.. |options| image:: /static/common/mActionOptions.png
-   :width: 1em
 .. |paletted| image:: /static/common/paletted.png
    :width: 1.5em
 .. |pointCloudExtent| image:: /static/common/pointCloudExtent.png
diff --git a/doctest.dockerfile b/doctest.dockerfile
index f62dec3372b..3a566ab2b26 100644
--- a/doctest.dockerfile
+++ b/doctest.dockerfile
@@ -7,4 +7,4 @@ WORKDIR /
 RUN python3 -m venv docsenv && . docsenv/bin/activate && pip3 install -r /documentation/REQUIREMENTS.txt
 WORKDIR /documentation
 
-CMD make doctest-gh
\ No newline at end of file
+CMD make doctest-gh
diff --git a/flake.nix b/flake.nix
index ae44e63fff7..8cdfd9e7ad9 100644
--- a/flake.nix
+++ b/flake.nix
@@ -1,16 +1,22 @@
 {
-  description = "Run QGIS with extra Python packages";
+  description = "QGIS Documentation development environment";
 
-  inputs.geospatial.url = "github:imincik/geospatial-nix.repo";
-  inputs.nixpkgs.follows = "geospatial/nixpkgs";
+  inputs = {
+    geospatial.url = "github:imincik/geospatial-nix.repo";
+    nixpkgs.follows = "geospatial/nixpkgs";
+  };
 
-  outputs = { self, geospatial, nixpkgs }: 
+  outputs = { self, geospatial, nixpkgs }:
     let
-      system = "x86_64-linux";
-      pkgs = import nixpkgs {
-        inherit system;
-        config = { allowUnfree = true; };
-      };
+      supportedSystems = [
+        "x86_64-linux"
+        "aarch64-linux"
+        "x86_64-darwin"
+        "aarch64-darwin"
+      ];
+
+      forAllSystems = nixpkgs.lib.genAttrs supportedSystems;
+
       extraPythonPackages = ps: [
         ps.pyqtwebengine
         ps.jsonschema
@@ -18,29 +24,129 @@
         ps.future
         ps.psutil
       ];
-      qgisWithExtras = geospatial.packages.${system}.qgis.override {
-        inherit extraPythonPackages;
-      };
-      qgisLtrWithExtras = geospatial.packages.${system}.qgis-ltr.override {
-        inherit extraPythonPackages;
-      };
-    in {
-      packages.${system} = {
-        default = qgisWithExtras;
-        qgis-ltr = qgisLtrWithExtras;
-      };
 
-      devShells.${system}.default = pkgs.mkShell {
-        packages = [
-          pkgs.gum
-          pkgs.gource
-          pkgs.ffmpeg
-          pkgs.chafa
-          pkgs.pre-commit
-          pkgs.nixfmt-rfc-style
-          (pkgs.python3.withPackages (ps: [
-            ps.pip
-            ps.setuptools
+      mkPackages = system:
+        let
+          hasQgis = geospatial.packages ? ${system};
+        in
+        if hasQgis then {
+          default = geospatial.packages.${system}.qgis.override {
+            inherit extraPythonPackages;
+          };
+          qgis-ltr = geospatial.packages.${system}.qgis-ltr.override {
+            inherit extraPythonPackages;
+          };
+        } else { };
+
+      mkDevShell = system:
+        let
+          pkgs = import nixpkgs {
+            inherit system;
+            config = { allowUnfree = true; };
+          };
+        in
+        pkgs.mkShell {
+          packages = [
+            pkgs.gum
+            pkgs.gource
+            pkgs.ffmpeg
+            pkgs.chafa
+            pkgs.pre-commit
+            pkgs.nixfmt-rfc-style
+            pkgs.codespell
+            pkgs.yamllint
+            (pkgs.python3.withPackages (ps: [
+              ps.pip
+              ps.setuptools
+              ps.sphinx
+              ps.sphinx_rtd_theme
+              ps.recommonmark
+              ps.myst-parser
+              ps.sphinx-autobuild
+              ps.docutils
+              ps.rstcheck
+              ps.doc8
+              ps.sphinxext-rediraffe
+              ps.sphinx-togglebutton
+              ps.sphinx-copybutton
+              ps.sphinx-tabs
+            ]))
+            pkgs.transifex-cli
+            pkgs.texlive.combined.scheme-medium
+            # Image optimization tools
+            pkgs.optipng
+            pkgs.pngquant
+            pkgs.jpegoptim
+            pkgs.oxipng
+            # Parallel build tools
+            pkgs.parallel
+            # Benchmarking tools
+            pkgs.bc
+          ];
+
+          shellHook = ''
+            echo ""
+            echo -e "\033[1;34m╔══════════════════════════════════════════════════════════════════╗\033[0m"
+            echo -e "\033[1;34m║\033[0m       \033[1;33mQGIS Documentation Development Environment\033[0m              \033[1;34m║\033[0m"
+            echo -e "\033[1;34m╚══════════════════════════════════════════════════════════════════╝\033[0m"
+            echo ""
+            echo -e "\033[1;36m BUILD COMMANDS\033[0m"
+            echo -e " ───────────────────────────────────────────────────────────────────"
+            echo -e " \033[1mmake fasthtml\033[0m          Build HTML (fast, parallel)"
+            echo -e " \033[1mmake html\033[0m              Build HTML (strict, warnings as errors)"
+            echo -e " \033[1mmake pdf\033[0m               Build PDF documentation"
+            echo -e " \033[1mmake serve\033[0m             Live preview server (auto-reload)"
+            echo ""
+            echo -e "\033[1;36m TRANSLATION WORKFLOW\033[0m"
+            echo -e " ───────────────────────────────────────────────────────────────────"
+            echo -e " \033[1mmake pull-translations\033[0m Pull all translations from Transifex"
+            echo -e " \033[1mmake i18n-html\033[0m         Pull translations + build all HTML"
+            echo -e " \033[1mmake i18n-full\033[0m         Pull translations + build all formats"
+            echo -e " \033[1mmake html-all\033[0m          Build all languages (no pull)"
+            echo ""
+            echo -e "\033[1;36m QUALITY & UTILITIES\033[0m"
+            echo -e " ───────────────────────────────────────────────────────────────────"
+            echo -e " \033[1mmake linkcheck\033[0m         Check for broken links"
+            echo -e " \033[1mmake doctest\033[0m           Run documentation tests"
+            echo -e " \033[1mpre-commit run --all\033[0m   Run all pre-commit checks"
+            echo -e " \033[1m./scripts/optimize_images.sh\033[0m  Optimize built images"
+            echo ""
+            echo -e "\033[1;36m BENCHMARKING\033[0m"
+            echo -e " ───────────────────────────────────────────────────────────────────"
+            echo -e " \033[1mmake benchmark-quick\033[0m   Quick build performance test"
+            echo -e " \033[1mmake benchmark\033[0m         Standard benchmark (3 runs)"
+            echo ""
+            echo -e "\033[1;36m CLEANING\033[0m"
+            echo -e " ───────────────────────────────────────────────────────────────────"
+            echo -e " \033[1mmake springclean\033[0m       Remove all build artifacts"
+            echo ""
+            echo -e " \033[0;90mTip: Use 'nix run .#<command>' for standalone execution\033[0m"
+            echo -e " \033[0;90mTip: In Neovim, use <leader>p for project menu\033[0m"
+            echo ""
+          '';
+        };
+
+      mkDevShellWithVscode = system:
+        let
+          pkgs = import nixpkgs {
+            inherit system;
+            config = { allowUnfree = true; };
+          };
+          baseShell = mkDevShell system;
+        in
+        pkgs.mkShell {
+          inputsFrom = [ baseShell ];
+          packages = [ pkgs.vscode ];
+        };
+
+      # Helper to create app scripts with meta
+      mkApp = system: name: description: script:
+        let
+          pkgs = import nixpkgs {
+            inherit system;
+            config = { allowUnfree = true; };
+          };
+          pythonEnv = pkgs.python3.withPackages (ps: [
             ps.sphinx
             ps.sphinx_rtd_theme
             ps.recommonmark
@@ -52,16 +158,80 @@
             ps.sphinx-togglebutton
             ps.sphinx-copybutton
             ps.sphinx-tabs
-          ]))
-          pkgs.vscode
-          pkgs.transifex-cli
-          pkgs.texlive.combined.scheme-full
-        ];
-        shellHook = ''
-          
-          #source ${./scripts/shell-hook.sh}
-        '';
+          ]);
+          scriptContent = ''
+            #!${pkgs.bash}/bin/bash
+            export PATH="${pythonEnv}/bin:${pkgs.gnumake}/bin:${pkgs.coreutils}/bin:${pkgs.optipng}/bin:${pkgs.pngquant}/bin:${pkgs.findutils}/bin:${pkgs.parallel}/bin:${pkgs.gnutar}/bin:${pkgs.gzip}/bin:${pkgs.bc}/bin:$PATH"
+            cd "$(dirname "$0")/../.." 2>/dev/null || cd .
+            ${script}
+          '';
+        in
+        {
+          type = "app";
+          program = toString (pkgs.writeShellScript name scriptContent);
+          meta = {
+            description = description;
+            mainProgram = name;
+          };
+        };
+
+      mkApps = system: {
+        # Documentation builds
+        html = mkApp system "build-html" "Build HTML documentation (strict mode)" "make html";
+        fasthtml = mkApp system "build-fasthtml" "Build HTML documentation (fast mode)" "make fasthtml";
+        draft = mkApp system "build-draft" "Build HTML documentation (draft/quiet mode)" "make draft";
+        pdf = mkApp system "build-pdf" "Build PDF documentation" "make pdf";
+        full = mkApp system "build-full" "Build full documentation (HTML + PDF)" "make full";
+
+        # Development server
+        serve = mkApp system "serve" "Start live-reload documentation server" "make serve";
+
+        # Quality checks
+        linkcheck = mkApp system "linkcheck" "Check for broken links" "make linkcheck";
+        doctest = mkApp system "doctest" "Run documentation tests" "make doctest";
+
+        # Cleaning
+        clean = mkApp system "clean" "Clean all build artifacts" "make springclean";
+        clean-html = mkApp system "clean-html" "Clean HTML build directory" "rm -rf build/html && echo 'HTML build cleaned'";
+        clean-pdf = mkApp system "clean-pdf" "Clean PDF build directory" "rm -rf build/latex build/pdf && echo 'PDF build cleaned'";
+
+        # Translations
+        gettext = mkApp system "gettext" "Generate POT translation files" "make gettext";
+        tx-pull = mkApp system "tx-pull" "Pull all translations from Transifex" "make pull-translations";
+        pull-translations = mkApp system "pull-translations" "Pull all translations from Transifex" "make pull-translations";
+
+        # Utilities
+        rstcheck = mkApp system "rstcheck" "Check RST syntax" "rstcheck docs/";
+
+        # Image optimization (build output)
+        optimize-images = mkApp system "optimize-images" "Optimize built images (lossless)" "./scripts/optimize_images.sh";
+        optimize-images-lossy = mkApp system "optimize-images-lossy" "Optimize built images (lossy)" "./scripts/optimize_images.sh --lossy";
+        optimize-images-dry = mkApp system "optimize-images-dry" "Preview built image optimization" "./scripts/optimize_images.sh --dry-run";
+
+        # Translation workflow (parallel builds)
+        i18n-html = mkApp system "i18n-html" "Pull translations and build all HTML" "./scripts/build_all_languages.sh --pull --html";
+        i18n-pdf = mkApp system "i18n-pdf" "Pull translations and build all PDFs" "./scripts/build_all_languages.sh --pull --pdf";
+        i18n-full = mkApp system "i18n-full" "Pull translations and build all formats" "./scripts/build_all_languages.sh --pull --full";
+        html-all = mkApp system "html-all" "Build all languages HTML" "./scripts/build_all_languages.sh --html";
+        pdf-all = mkApp system "pdf-all" "Build all languages PDF" "./scripts/build_all_languages.sh --pdf";
+        full-all = mkApp system "full-all" "Build all languages (full)" "./scripts/build_all_languages.sh --full";
+        i18n-clean = mkApp system "i18n-clean" "Clean, pull, and rebuild all" "./scripts/build_all_languages.sh --pull --full --clean";
+
+        # Benchmarking
+        benchmark = mkApp system "benchmark" "Benchmark build performance (3 runs)" "./scripts/benchmark_build.sh --runs 3";
+        benchmark-quick = mkApp system "benchmark-quick" "Quick build benchmark" "./scripts/benchmark_build.sh --quick";
+        benchmark-full = mkApp system "benchmark-full" "Full benchmark with clean builds" "./scripts/benchmark_build.sh --full --runs 3 --output build/benchmark_results.md";
       };
+
+    in
+    {
+      packages = forAllSystems mkPackages;
+
+      devShells = forAllSystems (system: {
+        default = mkDevShell system;
+        with-vscode = mkDevShellWithVscode system;
+      });
+
+      apps = forAllSystems mkApps;
     };
 }
-
diff --git a/release_process.md b/release_process.md
index 1ceda873e96..dfe85bf62c1 100644
--- a/release_process.md
+++ b/release_process.md
@@ -1,5 +1,5 @@
 _This document is meant to explain the workflow to effectively
-and bug-freely release a new version of QGIS documentation_ 
+and bug-freely release a new version of QGIS documentation_
 
 # Versions and branch naming
 
@@ -95,7 +95,7 @@ In February, the new version is labeled as LTR, and replaces the previous one in
 <details>
   <summary>Instructions when the new LTR officially takes place</summary>
 
-### Old LTR branch 
+### Old LTR branch
 <details>
 
 - [ ] In [conf.py](conf.py) file: set the html_context `outdated` option to `True`,
@@ -105,7 +105,7 @@ In February, the new version is labeled as LTR, and replaces the previous one in
 
 </details>
 
-### New LTR branch 
+### New LTR branch
 <details>
 
 - [ ] In [conf.py](conf.py) file: set the html_context `isLtr` to `True`
@@ -148,7 +148,7 @@ is being translated. So when a new LTR is published, we disconnect the old one a
 
 ### Repository and project configuration
 <details>
-  
+
 - [ ] Update the [docs index page](https://www.qgis.org/resources/hub/#documentation).
   Source file is available [hub.md](https://github.com/qgis/QGIS-Website/blob/main/content/resources/hub.md)
   - [ ] Reference the new version as current LTR
@@ -170,7 +170,7 @@ Many parts of the process are currently manual. This sometimes results in failin
 some steps were overlooked/forgotten.
 Automating the process as much as possible would lower the risk and make it less time consuming.
 
-* Some values are somehow copy-pasted across places while they could likely be put in a variable: 
+* Some values are somehow copy-pasted across places while they could likely be put in a variable:
 
   * languages list: they are defined in docs_conf.yml, Makefile, docker-world.sh
   * version number: it is defined in conf.py, Makefile, doctest.dockerfile
diff --git a/scripts/benchmark_build.sh b/scripts/benchmark_build.sh
new file mode 100755
index 00000000000..587739103fc
--- /dev/null
+++ b/scripts/benchmark_build.sh
@@ -0,0 +1,301 @@
+#!/usr/bin/env bash
+#
+# Benchmark build performance: single-core vs optimized multi-core
+#
+# Usage:
+#   ./scripts/benchmark_build.sh [options]
+#
+# Options:
+#   --full          Run full benchmark (clean builds, multiple runs)
+#   --quick         Quick benchmark (single run each, no clean)
+#   --runs N        Number of runs for averaging (default: 3)
+#   --lang LANG     Language to build (default: en)
+#   --output FILE   Save results to file
+#
+
+set -euo pipefail
+
+# Set locale for Sphinx
+export LC_ALL=C.UTF-8
+export LANG=C.UTF-8
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+BOLD='\033[1m'
+NC='\033[0m'
+
+# Defaults
+RUNS=3
+LANG="en"
+FULL_BENCHMARK=false
+QUICK_BENCHMARK=false
+OUTPUT_FILE=""
+CPU_CORES=$(nproc 2>/dev/null || sysctl -n hw.ncpu 2>/dev/null || echo 4)
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --full)
+            FULL_BENCHMARK=true
+            shift
+            ;;
+        --quick)
+            QUICK_BENCHMARK=true
+            RUNS=1
+            shift
+            ;;
+        --runs)
+            RUNS="$2"
+            shift 2
+            ;;
+        --lang)
+            LANG="$2"
+            shift 2
+            ;;
+        --output)
+            OUTPUT_FILE="$2"
+            shift 2
+            ;;
+        --help|-h)
+            head -15 "$0" | tail -n +2 | sed 's/^#//'
+            exit 0
+            ;;
+        *)
+            echo -e "${RED}Unknown option: $1${NC}"
+            exit 1
+            ;;
+    esac
+done
+
+# Results storage
+declare -a SINGLE_CORE_TIMES
+declare -a MULTI_CORE_TIMES
+
+print_header() {
+    echo ""
+    echo -e "${BLUE}═══════════════════════════════════════════════════════════════${NC}"
+    echo -e "${BLUE}  $1${NC}"
+    echo -e "${BLUE}═══════════════════════════════════════════════════════════════${NC}"
+    echo ""
+}
+
+print_subheader() {
+    echo ""
+    echo -e "${CYAN}───────────────────────────────────────────────────────────────${NC}"
+    echo -e "${CYAN}  $1${NC}"
+    echo -e "${CYAN}───────────────────────────────────────────────────────────────${NC}"
+}
+
+# Get system info
+get_system_info() {
+    echo -e "${BOLD}System Information:${NC}"
+    echo -e "  CPU Cores:     ${YELLOW}$CPU_CORES${NC}"
+
+    if [[ -f /proc/cpuinfo ]]; then
+        cpu_model=$(grep "model name" /proc/cpuinfo | head -1 | cut -d: -f2 | xargs)
+        echo -e "  CPU Model:     ${YELLOW}$cpu_model${NC}"
+    fi
+
+    mem_total=$(free -h 2>/dev/null | awk '/^Mem:/{print $2}' || echo "unknown")
+    echo -e "  Total Memory:  ${YELLOW}$mem_total${NC}"
+
+    # Count RST files
+    rst_count=$(find docs -name "*.rst" 2>/dev/null | wc -l)
+    echo -e "  RST Files:     ${YELLOW}$rst_count${NC}"
+
+    # Count images
+    img_count=$(find docs -name "*.png" -o -name "*.jpg" 2>/dev/null | wc -l)
+    echo -e "  Image Files:   ${YELLOW}$img_count${NC}"
+    echo ""
+}
+
+# Clean build directory
+clean_build() {
+    rm -rf "build/html/$LANG" "build/doctrees" 2>/dev/null || true
+}
+
+# Run a timed build - returns only the numeric duration on the last line
+run_build() {
+    local jobs="$1"
+    local label="$2"
+
+    echo -e "  Running: ${CYAN}$label${NC} (SPHINXOPTS=\"-j $jobs\")..." >&2
+
+    local start_time=$(date +%s.%N)
+
+    # Use sphinx-build directly to control parallelism
+    # Allow warnings (they don't mean the build failed for benchmarking purposes)
+    sphinx-build -b html -j "$jobs" "." "build/html/$LANG" > "build/benchmark_${jobs}.log" 2>&1
+    local exit_code=$?
+
+    local end_time=$(date +%s.%N)
+    local duration=$(echo "$end_time - $start_time" | bc)
+
+    # Check if build actually produced output (even with warnings)
+    if [[ -f "build/html/$LANG/index.html" ]] || grep -q "build finished" "build/benchmark_${jobs}.log" 2>/dev/null; then
+        echo -e "  ${GREEN}✓ Completed in ${duration}s${NC}" >&2
+        printf "%s" "$duration"
+    else
+        echo -e "  ${RED}✗ Build failed - check build/benchmark_${jobs}.log${NC}" >&2
+        printf "0"
+    fi
+}
+
+# Calculate statistics
+calc_stats() {
+    local -n arr=$1
+    local sum=0
+    local min=${arr[0]}
+    local max=${arr[0]}
+
+    for val in "${arr[@]}"; do
+        sum=$(echo "$sum + $val" | bc)
+        if (( $(echo "$val < $min" | bc -l) )); then
+            min=$val
+        fi
+        if (( $(echo "$val > $max" | bc -l) )); then
+            max=$val
+        fi
+    done
+
+    local avg=$(echo "scale=2; $sum / ${#arr[@]}" | bc)
+    echo "$avg $min $max"
+}
+
+# Main benchmark
+print_header "QGIS Documentation Build Benchmark"
+
+get_system_info
+
+echo -e "${BOLD}Benchmark Configuration:${NC}"
+echo -e "  Language:      ${YELLOW}$LANG${NC}"
+echo -e "  Runs:          ${YELLOW}$RUNS${NC}"
+echo -e "  Mode:          ${YELLOW}$(if $FULL_BENCHMARK; then echo "Full (with clean)"; elif $QUICK_BENCHMARK; then echo "Quick"; else echo "Standard"; fi)${NC}"
+echo ""
+
+# Warm-up build (to populate caches)
+if [[ "$QUICK_BENCHMARK" != true ]]; then
+    print_subheader "Warm-up Build"
+    echo "  Running initial build to warm caches..."
+    make LANG="$LANG" SPHINXOPTS="-j auto" html > /dev/null 2>&1 || true
+fi
+
+# Single-core benchmark
+print_subheader "Single-Core Benchmark (baseline)"
+for ((i=1; i<=RUNS; i++)); do
+    echo -e "\n${BOLD}Run $i of $RUNS${NC}"
+
+    if $FULL_BENCHMARK; then
+        clean_build
+    fi
+
+    time_taken=$(run_build "1" "Single core (-j 1)")
+    SINGLE_CORE_TIMES+=("$time_taken")
+done
+
+# Multi-core benchmark
+print_subheader "Multi-Core Benchmark (optimized)"
+for ((i=1; i<=RUNS; i++)); do
+    echo -e "\n${BOLD}Run $i of $RUNS${NC}"
+
+    if $FULL_BENCHMARK; then
+        clean_build
+    fi
+
+    time_taken=$(run_build "auto" "All cores (-j auto)")
+    MULTI_CORE_TIMES+=("$time_taken")
+done
+
+# Calculate results
+print_header "Results"
+
+read -r single_avg single_min single_max <<< $(calc_stats SINGLE_CORE_TIMES)
+read -r multi_avg multi_min multi_max <<< $(calc_stats MULTI_CORE_TIMES)
+
+# Calculate speedup
+speedup=$(echo "scale=2; $single_avg / $multi_avg" | bc)
+time_saved=$(echo "scale=2; $single_avg - $multi_avg" | bc)
+percent_faster=$(echo "scale=1; (1 - $multi_avg / $single_avg) * 100" | bc)
+
+echo -e "${BOLD}Single-Core Build (-j 1):${NC}"
+echo -e "  Average:       ${YELLOW}${single_avg}s${NC}"
+if [[ $RUNS -gt 1 ]]; then
+    echo -e "  Min:           ${single_min}s"
+    echo -e "  Max:           ${single_max}s"
+fi
+echo ""
+
+echo -e "${BOLD}Multi-Core Build (-j auto, $CPU_CORES cores):${NC}"
+echo -e "  Average:       ${GREEN}${multi_avg}s${NC}"
+if [[ $RUNS -gt 1 ]]; then
+    echo -e "  Min:           ${multi_min}s"
+    echo -e "  Max:           ${multi_max}s"
+fi
+echo ""
+
+echo -e "${BOLD}Improvement:${NC}"
+echo -e "  Speedup:       ${GREEN}${speedup}x faster${NC}"
+echo -e "  Time Saved:    ${GREEN}${time_saved}s${NC}"
+echo -e "  Improvement:   ${GREEN}${percent_faster}%${NC}"
+echo ""
+
+# Visual comparison
+print_subheader "Visual Comparison"
+
+# Normalize to 50 chars max
+max_time=$single_avg
+bar_scale=$(echo "scale=4; 50 / $max_time" | bc)
+
+single_bar_len=$(echo "scale=0; $single_avg * $bar_scale" | bc | cut -d. -f1)
+multi_bar_len=$(echo "scale=0; $multi_avg * $bar_scale" | bc | cut -d. -f1)
+
+single_bar=$(printf '█%.0s' $(seq 1 $single_bar_len))
+multi_bar=$(printf '█%.0s' $(seq 1 $multi_bar_len))
+
+echo -e "Single-core: ${RED}${single_bar}${NC} ${single_avg}s"
+echo -e "Multi-core:  ${GREEN}${multi_bar}${NC} ${multi_avg}s"
+echo ""
+
+# Efficiency calculation
+efficiency=$(echo "scale=1; ($speedup / $CPU_CORES) * 100" | bc)
+echo -e "${BOLD}Parallel Efficiency:${NC} ${YELLOW}${efficiency}%${NC} (ideal: 100%)"
+echo ""
+
+# Save results if requested
+if [[ -n "$OUTPUT_FILE" ]]; then
+    cat > "$OUTPUT_FILE" << EOF
+# QGIS Documentation Build Benchmark Results
+# Generated: $(date -Iseconds)
+
+## System
+- CPU Cores: $CPU_CORES
+- RST Files: $(find docs -name "*.rst" 2>/dev/null | wc -l)
+- Language: $LANG
+- Runs: $RUNS
+
+## Results
+
+| Metric | Single-Core | Multi-Core |
+|--------|-------------|------------|
+| Average | ${single_avg}s | ${multi_avg}s |
+| Min | ${single_min}s | ${multi_min}s |
+| Max | ${single_max}s | ${multi_max}s |
+
+## Improvement
+- **Speedup**: ${speedup}x
+- **Time Saved**: ${time_saved}s
+- **Percent Faster**: ${percent_faster}%
+- **Parallel Efficiency**: ${efficiency}%
+
+## Raw Data
+Single-core times: ${SINGLE_CORE_TIMES[*]}
+Multi-core times: ${MULTI_CORE_TIMES[*]}
+EOF
+    echo -e "Results saved to: ${CYAN}$OUTPUT_FILE${NC}"
+fi
+
+print_header "Benchmark Complete"
diff --git a/scripts/build_all_languages.sh b/scripts/build_all_languages.sh
new file mode 100755
index 00000000000..b5900412345
--- /dev/null
+++ b/scripts/build_all_languages.sh
@@ -0,0 +1,274 @@
+#!/usr/bin/env bash
+#
+# Build all language versions of QGIS Documentation in parallel
+#
+# Usage:
+#   ./scripts/build_all_languages.sh [options]
+#
+# Options:
+#   --pull          Pull translations from Transifex first
+#   --html          Build HTML only (default)
+#   --pdf           Build PDF only
+#   --full          Build both HTML and PDF
+#   --jobs N        Number of parallel jobs (default: number of CPU cores)
+#   --languages L   Comma-separated list of languages (default: all configured)
+#   --clean         Clean build directory before building
+#   --dry-run       Show what would be done without executing
+#
+
+set -euo pipefail
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+# Default values
+PULL_TRANSLATIONS=false
+BUILD_HTML=true
+BUILD_PDF=false
+CLEAN_FIRST=false
+DRY_RUN=false
+JOBS=$(nproc 2>/dev/null || sysctl -n hw.ncpu 2>/dev/null || echo 4)
+
+# Languages from Makefile (excluding en for translation pull)
+ALL_LANGUAGES="en de es fr it ja ko nl pt_BR pt_PT ru zh_Hans"
+LANGUAGES=""
+
+# Timing
+START_TIME=$(date +%s)
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --pull)
+            PULL_TRANSLATIONS=true
+            shift
+            ;;
+        --html)
+            BUILD_HTML=true
+            BUILD_PDF=false
+            shift
+            ;;
+        --pdf)
+            BUILD_HTML=false
+            BUILD_PDF=true
+            shift
+            ;;
+        --full)
+            BUILD_HTML=true
+            BUILD_PDF=true
+            shift
+            ;;
+        --jobs)
+            JOBS="$2"
+            shift 2
+            ;;
+        --languages)
+            LANGUAGES="$2"
+            shift 2
+            ;;
+        --clean)
+            CLEAN_FIRST=true
+            shift
+            ;;
+        --dry-run)
+            DRY_RUN=true
+            shift
+            ;;
+        --help|-h)
+            head -20 "$0" | tail -n +2 | sed 's/^#//'
+            exit 0
+            ;;
+        *)
+            echo -e "${RED}Unknown option: $1${NC}"
+            exit 1
+            ;;
+    esac
+done
+
+# Use all languages if not specified
+if [[ -z "$LANGUAGES" ]]; then
+    LANGUAGES="$ALL_LANGUAGES"
+fi
+
+# Convert to array
+IFS=' ,' read -ra LANG_ARRAY <<< "$LANGUAGES"
+
+print_header() {
+    echo ""
+    echo -e "${BLUE}═══════════════════════════════════════════════════════════════${NC}"
+    echo -e "${BLUE}  $1${NC}"
+    echo -e "${BLUE}═══════════════════════════════════════════════════════════════${NC}"
+    echo ""
+}
+
+print_status() {
+    echo -e "${CYAN}[$1/${#LANG_ARRAY[@]}]${NC} $2"
+}
+
+log_file() {
+    echo "build/logs/$1.log"
+}
+
+# Ensure log directory exists
+mkdir -p build/logs
+
+print_header "QGIS Documentation Multi-Language Build"
+
+echo -e "Configuration:"
+echo -e "  Languages:    ${YELLOW}${LANG_ARRAY[*]}${NC}"
+echo -e "  Parallel jobs: ${YELLOW}$JOBS${NC}"
+echo -e "  Pull translations: ${YELLOW}$PULL_TRANSLATIONS${NC}"
+echo -e "  Build HTML:   ${YELLOW}$BUILD_HTML${NC}"
+echo -e "  Build PDF:    ${YELLOW}$BUILD_PDF${NC}"
+echo -e "  Clean first:  ${YELLOW}$CLEAN_FIRST${NC}"
+if [[ "$DRY_RUN" == true ]]; then
+    echo -e "  ${YELLOW}DRY RUN - No actual builds will be performed${NC}"
+fi
+echo ""
+
+# Clean if requested
+if [[ "$CLEAN_FIRST" == true ]]; then
+    print_header "Cleaning Build Directory"
+    if [[ "$DRY_RUN" == true ]]; then
+        echo "Would run: make springclean"
+    else
+        make springclean
+    fi
+fi
+
+# Pull translations
+if [[ "$PULL_TRANSLATIONS" == true ]]; then
+    print_header "Pulling Translations from Transifex"
+
+    # Build language list for tx (excluding en, replacing zh_Hans with zh-Hans)
+    TX_LANGS=""
+    for lang in "${LANG_ARRAY[@]}"; do
+        if [[ "$lang" != "en" ]]; then
+            tx_lang="${lang//_/-}"  # Replace underscore with dash for Transifex
+            if [[ -n "$TX_LANGS" ]]; then
+                TX_LANGS="$TX_LANGS,$tx_lang"
+            else
+                TX_LANGS="$tx_lang"
+            fi
+        fi
+    done
+
+    if [[ -n "$TX_LANGS" ]]; then
+        echo -e "Pulling languages: ${YELLOW}$TX_LANGS${NC}"
+        if [[ "$DRY_RUN" == true ]]; then
+            echo "Would run: tx pull -f --parallel --mode onlytranslated -l $TX_LANGS"
+        else
+            tx pull -f --parallel --mode onlytranslated -l "$TX_LANGS" || {
+                echo -e "${YELLOW}Warning: Some translations may have failed to pull${NC}"
+            }
+        fi
+    fi
+fi
+
+# Function to build a single language
+build_language() {
+    local lang=$1
+    local format=$2
+    local log=$(log_file "${lang}_${format}")
+
+    echo -e "${CYAN}Building $format for $lang...${NC}"
+
+    if [[ "$DRY_RUN" == true ]]; then
+        echo "Would run: make LANG=$lang $format > $log 2>&1"
+        return 0
+    fi
+
+    if make LANG="$lang" "$format" > "$log" 2>&1; then
+        echo -e "${GREEN}✓ $lang ($format) completed${NC}"
+        return 0
+    else
+        echo -e "${RED}✗ $lang ($format) failed - see $log${NC}"
+        return 1
+    fi
+}
+
+export -f build_language log_file
+export DRY_RUN GREEN RED CYAN YELLOW NC
+
+# Build HTML in parallel
+if [[ "$BUILD_HTML" == true ]]; then
+    print_header "Building HTML Documentation (Parallel)"
+
+    if command -v parallel &> /dev/null; then
+        # Use GNU parallel if available
+        printf '%s\n' "${LANG_ARRAY[@]}" | parallel -j "$JOBS" --progress build_language {} html
+    else
+        # Fallback to xargs
+        printf '%s\n' "${LANG_ARRAY[@]}" | xargs -P "$JOBS" -I {} bash -c 'build_language "$@"' _ {} html
+    fi
+
+    # Summary
+    echo ""
+    echo -e "${GREEN}HTML builds completed${NC}"
+    echo "Output directories:"
+    for lang in "${LANG_ARRAY[@]}"; do
+        if [[ -d "build/html/$lang" ]]; then
+            size=$(du -sh "build/html/$lang" 2>/dev/null | cut -f1)
+            echo -e "  build/html/$lang ${CYAN}($size)${NC}"
+        fi
+    done
+fi
+
+# Build PDF in parallel
+if [[ "$BUILD_PDF" == true ]]; then
+    print_header "Building PDF Documentation (Parallel)"
+
+    if command -v parallel &> /dev/null; then
+        printf '%s\n' "${LANG_ARRAY[@]}" | parallel -j "$JOBS" --progress build_language {} pdf
+    else
+        printf '%s\n' "${LANG_ARRAY[@]}" | xargs -P "$JOBS" -I {} bash -c 'build_language "$@"' _ {} pdf
+    fi
+
+    # Summary
+    echo ""
+    echo -e "${GREEN}PDF builds completed${NC}"
+    echo "Output directories:"
+    for lang in "${LANG_ARRAY[@]}"; do
+        if [[ -d "build/pdf/$lang" ]]; then
+            count=$(find "build/pdf/$lang" -name "*.pdf" 2>/dev/null | wc -l)
+            echo -e "  build/pdf/$lang ${CYAN}($count PDFs)${NC}"
+        fi
+    done
+fi
+
+# Final summary
+END_TIME=$(date +%s)
+DURATION=$((END_TIME - START_TIME))
+MINUTES=$((DURATION / 60))
+SECONDS=$((DURATION % 60))
+
+print_header "Build Complete"
+
+echo -e "Total time: ${GREEN}${MINUTES}m ${SECONDS}s${NC}"
+echo -e "Languages built: ${GREEN}${#LANG_ARRAY[@]}${NC}"
+echo ""
+
+# Show any failures
+FAILED=()
+for lang in "${LANG_ARRAY[@]}"; do
+    for format in html pdf; do
+        log=$(log_file "${lang}_${format}")
+        if [[ -f "$log" ]] && grep -q "error\|Error\|ERROR" "$log" 2>/dev/null; then
+            FAILED+=("$lang ($format)")
+        fi
+    done
+done
+
+if [[ ${#FAILED[@]} -gt 0 ]]; then
+    echo -e "${RED}Failed builds:${NC}"
+    for fail in "${FAILED[@]}"; do
+        echo -e "  ${RED}✗ $fail${NC}"
+    done
+    echo ""
+    echo "Check logs in build/logs/ for details"
+fi
diff --git a/scripts/check_image_refs.sh b/scripts/check_image_refs.sh
new file mode 100755
index 00000000000..f11fdc251a8
--- /dev/null
+++ b/scripts/check_image_refs.sh
@@ -0,0 +1,61 @@
+#!/usr/bin/env bash
+#
+# Check that image references in RST files point to existing files
+# Used by pre-commit to catch broken image references before commit
+#
+
+set -euo pipefail
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+NC='\033[0m'
+
+errors=0
+checked=0
+
+for file in "$@"; do
+    if [[ ! -f "$file" ]]; then
+        continue
+    fi
+
+    dir=$(dirname "$file")
+
+    # Extract image paths from RST directives
+    # Patterns: .. image:: path, .. figure:: path, :file:`path`
+    while IFS= read -r img_path; do
+        if [[ -z "$img_path" ]]; then
+            continue
+        fi
+
+        ((checked++)) || true
+
+        # Handle absolute paths (from docs root)
+        if [[ "$img_path" == /* ]]; then
+            full_path="docs${img_path}"
+        else
+            full_path="$dir/$img_path"
+        fi
+
+        # Normalize path
+        full_path=$(realpath -m "$full_path" 2>/dev/null || echo "$full_path")
+
+        if [[ ! -f "$full_path" ]]; then
+            echo -e "${RED}ERROR${NC}: Missing image in $file"
+            echo "       Referenced: $img_path"
+            echo "       Expected at: $full_path"
+            ((errors++)) || true
+        fi
+    done < <(grep -oP '(?:image|figure)::\s*\K[^\s]+' "$file" 2>/dev/null || true)
+done
+
+if [[ $errors -gt 0 ]]; then
+    echo ""
+    echo -e "${RED}Found $errors missing image(s) in $checked reference(s)${NC}"
+    exit 1
+fi
+
+if [[ $checked -gt 0 ]]; then
+    echo -e "${GREEN}All $checked image references valid${NC}"
+fi
+
+exit 0
diff --git a/scripts/optimize_images.sh b/scripts/optimize_images.sh
new file mode 100755
index 00000000000..61f21359510
--- /dev/null
+++ b/scripts/optimize_images.sh
@@ -0,0 +1,171 @@
+#!/usr/bin/env bash
+#
+# Optimize PNG images in the documentation
+# Uses optipng for lossless compression and pngquant for lossy (optional)
+#
+# Usage:
+#   ./scripts/optimize_images.sh [--lossy] [--dry-run] [path]
+#
+# Options:
+#   --lossy    Use pngquant for additional lossy compression (smaller but may affect quality)
+#   --dry-run  Show what would be done without making changes
+#   path       Specific path to optimize (default: docs/)
+#
+
+set -euo pipefail
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Default values
+LOSSY=false
+DRY_RUN=false
+TARGET_PATH="build/html/"
+TOTAL_SAVED=0
+FILES_PROCESSED=0
+FILES_OPTIMIZED=0
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --lossy)
+            LOSSY=true
+            shift
+            ;;
+        --dry-run)
+            DRY_RUN=true
+            shift
+            ;;
+        *)
+            TARGET_PATH="$1"
+            shift
+            ;;
+    esac
+done
+
+# Check for required tools
+check_tools() {
+    local missing=()
+
+    if ! command -v optipng &> /dev/null; then
+        missing+=("optipng")
+    fi
+
+    if [[ "$LOSSY" == true ]] && ! command -v pngquant &> /dev/null; then
+        missing+=("pngquant")
+    fi
+
+    if [[ ${#missing[@]} -gt 0 ]]; then
+        echo -e "${RED}Error: Missing required tools: ${missing[*]}${NC}"
+        echo "Install with:"
+        echo "  nix develop  # Tools are included in the dev shell"
+        echo "  # or"
+        echo "  sudo apt-get install ${missing[*]}"
+        exit 1
+    fi
+}
+
+# Format bytes to human readable
+format_bytes() {
+    local bytes=$1
+    if [[ $bytes -lt 1024 ]]; then
+        echo "${bytes}B"
+    elif [[ $bytes -lt 1048576 ]]; then
+        echo "$(( bytes / 1024 ))KB"
+    else
+        echo "$(( bytes / 1048576 ))MB"
+    fi
+}
+
+# Optimize a single PNG file
+optimize_png() {
+    local file="$1"
+    local original_size
+    local new_size
+    local saved
+
+    original_size=$(stat -c%s "$file")
+
+    if [[ "$DRY_RUN" == true ]]; then
+        echo -e "${BLUE}[DRY-RUN]${NC} Would optimize: $file ($(format_bytes $original_size))"
+        return
+    fi
+
+    # Create backup
+    cp "$file" "${file}.bak"
+
+    # Lossy compression with pngquant (if enabled)
+    if [[ "$LOSSY" == true ]]; then
+        pngquant --quality=65-80 --skip-if-larger --force --output "$file" "$file" 2>/dev/null || true
+    fi
+
+    # Lossless compression with optipng
+    optipng -o2 -quiet "$file" 2>/dev/null || true
+
+    new_size=$(stat -c%s "$file")
+
+    if [[ $new_size -ge $original_size ]]; then
+        # Restore backup if no improvement
+        mv "${file}.bak" "$file"
+        echo -e "${YELLOW}[SKIP]${NC} $file (no improvement)"
+    else
+        rm "${file}.bak"
+        saved=$((original_size - new_size))
+        TOTAL_SAVED=$((TOTAL_SAVED + saved))
+        FILES_OPTIMIZED=$((FILES_OPTIMIZED + 1))
+        local percent=$((100 - (new_size * 100 / original_size)))
+        echo -e "${GREEN}[OK]${NC} $file: $(format_bytes $original_size) → $(format_bytes $new_size) (${percent}% smaller)"
+    fi
+
+    FILES_PROCESSED=$((FILES_PROCESSED + 1))
+}
+
+# Main
+main() {
+    echo -e "${BLUE}═══════════════════════════════════════════════════════════${NC}"
+    echo -e "${BLUE}  PNG Image Optimizer for QGIS Documentation${NC}"
+    echo -e "${BLUE}═══════════════════════════════════════════════════════════${NC}"
+    echo ""
+    echo -e "Target path: ${YELLOW}$TARGET_PATH${NC}"
+    echo -e "Mode: ${YELLOW}$(if [[ "$LOSSY" == true ]]; then echo "Lossy (pngquant + optipng)"; else echo "Lossless (optipng only)"; fi)${NC}"
+    if [[ "$DRY_RUN" == true ]]; then
+        echo -e "${YELLOW}DRY RUN - No changes will be made${NC}"
+    fi
+    echo ""
+
+    check_tools
+
+    # Find and process PNG files
+    local png_files
+    png_files=$(find "$TARGET_PATH" -type f -name "*.png" -not -path "*/build/*" -not -path "*/venv/*" 2>/dev/null | sort)
+
+    local total_files
+    total_files=$(echo "$png_files" | grep -c "." || echo "0")
+
+    if [[ "$total_files" -eq 0 ]]; then
+        echo -e "${YELLOW}No PNG files found in $TARGET_PATH${NC}"
+        exit 0
+    fi
+
+    echo -e "Found ${BLUE}$total_files${NC} PNG files to process..."
+    echo ""
+
+    while IFS= read -r file; do
+        [[ -n "$file" ]] && optimize_png "$file"
+    done <<< "$png_files"
+
+    echo ""
+    echo -e "${BLUE}═══════════════════════════════════════════════════════════${NC}"
+    echo -e "  ${GREEN}Summary${NC}"
+    echo -e "${BLUE}═══════════════════════════════════════════════════════════${NC}"
+    echo -e "  Files processed: ${BLUE}$FILES_PROCESSED${NC}"
+    echo -e "  Files optimized: ${GREEN}$FILES_OPTIMIZED${NC}"
+    echo -e "  Total saved:     ${GREEN}$(format_bytes $TOTAL_SAVED)${NC}"
+    echo ""
+}
+
+main
diff --git a/scripts/rstcleanup.sh b/scripts/rstcleanup.sh
index 1ff7a173fe7..b1a94790db5 100755
--- a/scripts/rstcleanup.sh
+++ b/scripts/rstcleanup.sh
@@ -22,4 +22,4 @@ rpl -q $SPATH $IMAGES $1
 
 echo
 echo "ooo Substitutions to move to this file:"
-grep -o '|[a-z,A-Z]\+|' $1 | sort | uniq
\ No newline at end of file
+grep -o '|[a-z,A-Z]\+|' $1 | sort | uniq