From 9e848c27a874ad98d74f15ca6765afbb183343eb Mon Sep 17 00:00:00 2001
From: Earl Warren <contact@earl-warren.org>
Date: Sun, 5 Nov 2023 00:02:27 +0100
Subject: [PATCH] add the forgejo dependency graph in the README

---
 .forgejo/workflows/integration.yml |  2 +-
 README.md                          | 27 +++++++++++++++++++++++++--
 2 files changed, 26 insertions(+), 3 deletions(-)

diff --git a/.forgejo/workflows/integration.yml b/.forgejo/workflows/integration.yml
index 1701f08..d053931 100644
--- a/.forgejo/workflows/integration.yml
+++ b/.forgejo/workflows/integration.yml
@@ -18,7 +18,7 @@ jobs:
           user: root
           password: admin1234
           image: codeberg.org/forgejo-integration/forgejo
-          image-version: 1.21.0-5-rc2
+          image-version: 1.21.0-6-rc2
           lxc-ip-prefix: 10.1.15
 
       - name: tests cascading-pr
diff --git a/README.md b/README.md
index c851bc4..4150694 100644
--- a/README.md
+++ b/README.md
@@ -78,7 +78,30 @@ not exist, it is created.
 | debug | if true print debug information | `false` | false |
 <!-- action-docs-inputs -->
 
-# Example
+# Forgejo dependencies
+
+The [Forgejo](https://codeberg.org/forgejo/forgejo/) repositories that depend on each other are
+linked with workflows using `cascading-pr` as follows.
+
+```mermaid
+flowchart TD
+    lxc-helper(lxc-helper) --> act(act)
+    act --> runner(Forgejo runner)
+    runner --> setup-forgejo(setup-forgejo)
+    setup-forgejo --> e2e(end-to-end)
+    forgejo-curl(forgejo-curl.sh) --> setup-forgejo
+    forgejo(forgejo) --> e2e
+
+    click lxc-helper "https://code.forgejo.org/forgejo/lxc-helpers/src/branch/main/.forgejo/workflows/cascade-act.yml"
+    click act "https://code.forgejo.org/forgejo/act/src/branch/main/.forgejo/workflows/cascade-runner.yml"
+    click runner "https://code.forgejo.org/forgejo/runner/src/branch/main/.forgejo/workflows/cascade-setup-forgejo.yml"
+    click setup-forgejo "https://code.forgejo.org/actions/setup-forgejo/src/branch/main/.forgejo/workflows/cascade-end-to-end.yml"
+    click e2e "https://code.forgejo.org/actions/end-to-end"
+    click forgejo-curl "https://code.forgejo.org/forgejo/forgejo-curl/src/branch/main/.forgejo/workflows/cascade-setup-forgejo.yml"
+    click forgejo "https://codeberg.org/forgejo/forgejo/src/branch/forgejo/.forgejo/workflows/cascade-setup-end-to-end.yml"
+```
+
+# Example workflow
 
 ```yaml
 on:
@@ -100,7 +123,7 @@ jobs:
           origin-token: ${{ secrets.ORIGIN_TOKEN }}
           origin-pr: ${{ github.event.pull_request.number }}
           destination-url: https://code.forgejo.org
-          destination-repo: forgejo/actd
+          destination-repo: forgejo/act
           destination-branch: main
           destination-token: ${{ secrets.DESTINATION_TOKEN }}
           update: ./upgrade-lxc-helpers