ci: add docs-only status-check shim so docs PRs aren't blocked

.github/workflows/main-docs.yml

@@ -0,0 +1,41 @@
+name: Build & Test
+# Status-check shim for docs-only PRs. `main.yml` skips docs/media paths via
+# `paths-ignore`, which leaves required `lint`/`test` checks unsatisfiable on
+# such PRs and BLOCKED by branch protection. This workflow is the mirror
+# image: triggers ONLY on those paths and emits matching job names that
+# succeed immediately. Together with `main.yml` the two form a partition —
+# exactly one runs per push/PR.
+#
+# Job names (`lint`, `test`) MUST match the names in `main.yml` and the
+# contexts required by the `master` ruleset.
+on:
+  push:
+    branches: [master]
+    paths:
+      - '*.md'
+      - 'media/**'
+      - 'packages/melonjs/DOC_README.md'
+  pull_request:
+    types: [opened, synchronize]
+    paths:
+      - '*.md'
+      - 'media/**'
+      - 'packages/melonjs/DOC_README.md'
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - run: echo "docs-only change — skipping real lint"
+
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - run: echo "docs-only change — skipping real test"

.github/workflows/main.yml

@@ -1,11 +1,9 @@
 name: Build & Test
-# Note: docs-only PRs (markdown / media changes) skip these jobs via
-# `paths-ignore`. If branch-protection rules require `lint`/`test` as
-# checks, those PRs end up BLOCKED with no checks ever running.
-# The proper fix is a status-check shim workflow emitting matching job
-# names with `success` for the same paths — until that lands, docs PRs
-# need an admin-merge or a no-op non-md commit (like this one) to nudge
-# CI into running. (PR #1442 — Capacitor icon — needed this nudge.)
+# Docs-only PRs (markdown / media changes) skip these jobs via `paths-ignore`.
+# Required `lint`/`test` checks are satisfied for those PRs by the shim in
+# `main-docs.yml`, which mirrors this file's path filters and emits matching
+# job names that succeed immediately. Together the two form a partition —
+# exactly one runs per push/PR.
 on:
   push:
     branches: [master]