Update workflows

.github/workflows/README from docs.yaml

@@ -0,0 +1,38 @@
+name: Generate README
+
+on:
+  pull_request:
+    paths:
+      - "docs/**/*"
+  workflow_run:
+    workflows:
+      - "generate_help_docs"
+
+jobs:
+  make-README:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: "Fill template"
+        working-directory: "docs/"
+        timeout-minutes: 0.1
+        run: |
+          sub_doc_parts_from() {
+            template="$1"
+            directory="$2"
+
+            for file in "$directory"/*; do
+                if [ -f "$file" ]; then
+                    placeholder="{{ $(echo "${file^^}" | tr ./ _) }}"
+                    echo "Saving $file to $placeholder with expanded environment variables" >&2
+                    # Export file contents to text following a pattern in template.md, e.g.:
+                    # section/test_file.md would replace "{{ SECTION_TEST_FILE_MD }}""
+                    template="${template//"$placeholder"/"$(<"$file")"}"
+                fi
+            done
+            echo "$template"
+          }
+          sub_doc_parts_from "$(sub_doc_parts_from "$(<template.md)" "sections")" "help">../README.md

.github/workflows/generate_help_docs.yaml

@@ -0,0 +1,33 @@
+name: Generate README
+
+on:
+  pull_request:
+    paths:
+      - "src/sim_recon/cli/parsing/*"
+      - "src/sim_recon/settings/formatting.py"
+
+jobs:
+  generate-help-docs:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v3
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Copy template
+        run: cp -f docs/template.md README.md
+      - name: Install (without dependencies)
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install . --no-deps
+      - name: Ensure README exists
+        run: touch README.md
+      - name: Getting help strings from package
+        run: |
+          python -m sim_recon.cli.parsing.otf '--help' >docs/help/sim_otf.txt
+          python -m sim_recon.cli.parsing.recon '--help' >docs/help/sim_recon.txt
+          python -m sim_recon.cli.parsing.otf_view '--help' >docs/help/otf_view.txt