docs: add flow diagram to explain run-*

Author: creativeprojects

README.md

@@ -73,7 +73,7 @@ For the rest of the documentation, I'll be showing examples using different form
 * [Includes](#includes)
 * [Path resolution in configuration](#path-resolution-in-configuration)
 * [Run commands before, after success or after failure](#run-commands-before-after-success-or-after-failure)
-  * [run before and after order during a backup](#run-before-and-after-order-during-a-backup)
+  * [order of run\-\* during a backup](#order-of-run--during-a-backup)
 * [Warnings from restic](#warnings-from-restic)
   * [no\-error\-on\-warning](#no-error-on-warning)
 * [Locks](#locks)
@@ -688,7 +688,7 @@ Additionally, for the `run-after-fail` commands, these environment variables wil
 The commands of `run-finally` get the environment of `run-after-fail` when `run-before`, `run-after` or `restic` failed. 
 Failures in `run-finally` are logged but do not influence environment or return code.
 
-## run before and after order during a backup
+## order of `run-*` during a backup
 
 The commands will be running in this order **during a backup**:
 - `run-before` from the profile - if error, go to `run-after-fail`
@@ -700,6 +700,10 @@ The commands will be running in this order **during a backup**:
 - `run-finally` from the backup section - if error, log and continue with next
 - `run-finally` from the profile - if error, log and continue with next
 
+Maybe it's easier to understand with a flow diagram:
+
+![run flow diagram](https://github.com/creativeprojects/resticprofile/raw/master/run-flow.svg)
+
 # Warnings from restic
 
 Until version 0.13.0, resticprofile was always considering a restic warning as an error. This will remain the **default**.

run-flow.md

@@ -0,0 +1,20 @@
+
+```mermaid
+graph TD
+    PRB('run-before' from profile) -->|Success| BRB('run-before' from backup section)
+    PRB -->|Error| FAIL('run-after-fail')
+    BRB -->|Error| FAIL('run-after-fail')
+    BRB -->|Success| RUN(run restic backup with check and/or retention if configured)
+    RUN -->|Success| BRA
+    RUN -->|Error| FAIL('run-after-fail')
+    BRA('run-after' from backup section)
+    BRA -->|Success| PRA
+    BRA -->|Error| FAIL('run-after-fail')
+    PRA('run-after' from profile)
+    PRA -->|Success| BRF
+    PRA -->|Error| FAIL('run-after-fail')
+    BRF('run-finally' from backup section)
+    BRF --> PRF
+    PRF('run-finally' from profile)
+    FAIL --> BRF
+```