From 4e64f3b78f9e06dc1494440cd94eb278f072abd5 Mon Sep 17 00:00:00 2001
From: bbhtt <bbhtt.zn0i8@slmail.me>
Date: Wed, 17 Jul 2024 20:47:50 +0530
Subject: [PATCH] external-data-checker: Add workflow for running on multiple
 branches

---
 .../11-external-data-checker.md               | 45 +++++++++++++++++++
 1 file changed, 45 insertions(+)

diff --git a/docs/02-for-app-authors/11-external-data-checker.md b/docs/02-for-app-authors/11-external-data-checker.md
index 6a051b9..99de00e 100644
--- a/docs/02-for-app-authors/11-external-data-checker.md
+++ b/docs/02-for-app-authors/11-external-data-checker.md
@@ -51,3 +51,48 @@ You can opt out of External Data Checker by creating a `flathub.json` file in th
   "disable-external-data-checker": true
 }
 ```
+
+
+### Run on multiple branches
+
+By default, the Flathub provided External Data checker workflow runs
+only on the default branch of the GitHub repository, but a custom
+workflow can be defined to run it on multiple branches. This is useful
+for extensions or baseapps which have multiple branches - one for each
+runtime version.
+
+This uses the docker image published by External Data Checker upstream.
+
+First [opt out](#disable) of the default Flathub provided workflow.
+
+Then, this needs to be committed to the Github repo at
+`.github/workflows/update.yaml`.
+
+```yaml
+name: Check for updates
+on:
+  schedule:
+    - cron: '0 14 * * 1' # Run once a week, on Monday, at 14:00
+  workflow_dispatch: {}
+jobs:
+  flatpak-external-data-checker:
+    runs-on: ubuntu-latest
+    if: github.repository_owner == 'flathub'
+    strategy:
+      matrix:
+        branch: [ branch/23.08, branch/24.08, beta ]
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ matrix.branch }}
+      - uses: docker://ghcr.io/flathub/flatpak-external-data-checker:latest
+        env:
+          GIT_AUTHOR_NAME: Flatpak External Data Checker
+          GIT_COMMITTER_NAME: Flatpak External Data Checker
+          GIT_AUTHOR_EMAIL: 41898282+github-actions[bot]@users.noreply.github.com
+          GIT_COMMITTER_EMAIL: 41898282+github-actions[bot]@users.noreply.github.com
+          EMAIL: 41898282+github-actions[bot]@users.noreply.github.com
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          args: --update --never-fork <MANIFEST FILENAME>
+```