diff --git a/.github/dependabot.yml b/.github/dependabot.yml
new file mode 100644
index 0000000..db4e17b
--- /dev/null
+++ b/.github/dependabot.yml
@@ -0,0 +1,15 @@
+# Reference:
+# - https://docs.github.com/en/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/keeping-your-actions-up-to-date-with-dependabot
+# - https://docs.github.com/en/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    labels:
+      - "bot"
+    cooldown:
+      default-days: 7
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
new file mode 100644
index 0000000..099b958
--- /dev/null
+++ b/.github/workflows/docs.yml
@@ -0,0 +1,103 @@
+name: Documentation
+
+on:
+  push:
+    branches:
+      - main
+      - release/*
+      - feature/*
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  build:
+    if: github.repository_owner == 'MetOffice' && !contains(github.event.head_commit.message, '[skip ci]')
+    runs-on: ubuntu-latest
+
+    steps:
+      # SETUP
+      ############################
+      - name: Checkout code
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
+        with:
+          ref: ${{ github.ref_name }}  # Ensure branch is checked out, not detached state (so we can push a commit later)
+          token: ${{ secrets.GITHUB_TOKEN }}
+          persist-credentials: true  # Ensure that the token is available for pushing changes
+
+      - name: Set up Python
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97
+        with:
+          python-version: 3.x
+
+      - name: Add checkout directory to PYTHONPATH
+        run: echo "PYTHONPATH=$(pwd):$PYTHONPATH" >> $GITHUB_ENV
+
+      - name: Install dependencies
+        id: install-dependencies
+        run: |
+          pip install .[tests,dev]
+          pip uninstall dagrunner -y
+
+      # DOCUMENTATION
+      ############################
+      - name: Build documentation
+        run: |
+          rm -rf ./docs/_build
+          mkdir -p ./docs/_build
+          ./docs/gen_docs dagrunner ./docs/_build
+          git add -f docs/_build/
+
+      - name: Check if documentation has changed
+        id: check-docs
+        run: |
+          echo "changed=$(git diff --cached --quiet --exit-code || echo true)" | tee -a $GITHUB_OUTPUT
+
+      - name: Create PR
+        if: steps.check-docs.outputs.changed == 'true'
+        run: |
+          git config user.name github-actions[bot]
+          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+
+          source_branch="${GITHUB_REF_NAME}"
+          DOCS_BRANCH="docs-update/${source_branch//\//-}"
+          sha="${{ github.sha }}"
+          short_sha="${sha::8}"
+
+          git switch -c "$DOCS_BRANCH"
+          git commit -m "Automated reference documentation update for $short_sha [skip ci]"
+          git push origin "$DOCS_BRANCH" --force
+
+          # Create a PR only if one is not already open for this branch
+          if ! gh pr list --head "$DOCS_BRANCH" --json number --jq '.[0].number' | grep -q .; then
+            gh pr create \
+              --title "Automated reference documentation update for $source_branch" \
+              --body "This PR was automatically generated by the documentation workflow for commit $short_sha [skip ci]" \
+              --base "$source_branch" \
+              --head "$DOCS_BRANCH" \
+              --label "documentation" \
+              --assignee ${GITHUB_ACTOR}
+          else
+            # comment on PR to say that we have pushed a new commit to the branch
+            pr_number=$(gh pr list --head "$DOCS_BRANCH" --json number --jq '.[0].number')
+            gh pr comment "$pr_number" --body "New documentation changes have been pushed to this branch for commit $short_sha [skip ci]"
+          fi
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+
+      # # https://github.com/orgs/community/discussions/26560#discussioncomment-3531273
+      # # This must be our very final step to ensure that it runs only on condition of
+      # # success of all previous steps.  A pushed commit will not trigger the re-running
+      # # of this workflow.
+      # - name: Commit and push documentation changes
+      #   if: steps.check-docs.outputs.changed == 'true'
+      #   run: |
+      #     git config user.name github-actions[bot]
+      #     git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+      #     git add docs/.
+      #     git commit -am "Automated reference documentation update for PR ${{ github.event.number }} [skip ci]"
+      #     git push
+      #   env:
+      #     GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 06fd713..2cdf04b 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -2,6 +2,9 @@ name: Pull Request Tests
 
 on: [pull_request]
 
+permissions:
+  contents: read
+
 
 jobs:
   pre-commit:
@@ -12,10 +15,12 @@ jobs:
       # SETUP
       ############################
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
+        with:
+          persist-credentials: false
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97
         with:
           python-version: 3.x
           cache: 'pip'
@@ -35,7 +40,7 @@ jobs:
         run: echo "PYSHA=$(python -VV | sha256sum | cut -d' ' -f1)" >> $GITHUB_ENV
 
       - name: Cache pre-commit
-        uses: actions/cache@v3
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9
         id: pre-commit-cache
         with:
           path: ~/.cache/pre-commit
@@ -58,10 +63,12 @@ jobs:
       # SETUP
       ############################
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
+        with:
+          persist-credentials: false
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97
         with:
           python-version: 3.9
           cache: 'pip'
@@ -96,10 +103,12 @@ jobs:
       # SETUP
       ############################
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
+        with:
+          persist-credentials: false
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97
         with:
           python-version: 3.9
           cache: 'pip'
@@ -145,10 +154,12 @@ jobs:
       # SETUP
       ############################
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
+        with:
+          persist-credentials: false
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97
         with:
           python-version: 3.x
           cache: 'pip'
@@ -178,15 +189,16 @@ jobs:
       ############################
       - name: Cache ref branch coverage report
         id: cache-ref-coverage
-        uses: actions/cache@v4
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9
         with:
           path: ref/coverage_output.txt
           key: ref-${{ github.event.pull_request.base.sha }}
 
       - name: Checkout ref branch
         if: steps.cache-ref-coverage.outputs.cache-hit != 'true'
-        uses: actions/checkout@v4
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
         with:
+          persist-credentials: false
           path: ref
           ref: ${{ github.base_ref }}
 
@@ -203,7 +215,7 @@ jobs:
         run: |
           set -e
           # ----- USER SETTINGS -------------------------------------------------
-          CHECK_MISS_TOL=1      # 1 = evaluate the miss‑count difference, 0 = ignore it
+          CHECK_MISS_TOL=1      # 1 = evaluate the miss-count difference, 0 = ignore it
           CHECK_PERC_TOL=0      # 1 = evaluate the percentage difference, 0 = ignore it
 
           # Tolerances
@@ -252,7 +264,7 @@ jobs:
 
       - name: Upload coverage report
         if: steps.comp-coverage.outputs.coverage_decreased == 'true'
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a
         with:
           name: coverage-report-pr
           path: |
@@ -265,10 +277,17 @@ jobs:
             echo "Code coverage has decreased"
             echo "-----------------------------------------------"
             echo -e "Coverage totals\tstatements\tmissed\n\
-            PR\t${{ steps.comp-coverage.outputs.pr_tot_stmts }}\t${{ steps.comp-coverage.outputs.pr_tot_miss }}\t${{ steps.comp-coverage.outputs.pr_perc_total }}%\n\
-            Reference\t${{ steps.comp-coverage.outputs.ref_tot_stmts }}\t${{ steps.comp-coverage.outputs.ref_tot_miss }}\t${{ steps.comp-coverage.outputs.ref_perc_total }}%" \
+            PR\t${PR_TOT_STMTS}\t${PR_TOT_MISS}\t${PR_PERC_TOTAL}%\n\
+            Reference\t${REF_TOT_STMTS}\t${REF_TOT_MISS}\t${REF_PERC_TOTAL}%" \
             | column -t -s $'\t'
             echo "-----------------------------------------------"
             echo "Report uploaded as artifact 'coverage-report-pr'"
             echo "Test coverage failure is non-blocking, but please consider improving test coverage before merging."
-            exit 1
\ No newline at end of file
+            exit 1
+        env:
+          PR_TOT_STMTS: ${{ steps.comp-coverage.outputs.pr_tot_stmts }}
+          PR_TOT_MISS: ${{ steps.comp-coverage.outputs.pr_tot_miss }}
+          PR_PERC_TOTAL: ${{ steps.comp-coverage.outputs.pr_perc_total }}
+          REF_TOT_STMTS: ${{ steps.comp-coverage.outputs.ref_tot_stmts }}
+          REF_TOT_MISS: ${{ steps.comp-coverage.outputs.ref_tot_miss }}
+          REF_PERC_TOTAL: ${{ steps.comp-coverage.outputs.ref_perc_total }}
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 3e4cb35..a3d99ba 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -15,3 +15,8 @@ repos:
       files: '\.py$'
       language: system
       entry: ./copyright_check
+- repo: https://github.com/zizmorcore/zizmor-pre-commit
+  rev: v1.28.0
+  hooks:
+    - id: zizmor
+      args: [--fix]
diff --git a/README.md b/README.md
index 5d7e83c..2d01343 100644
--- a/README.md
+++ b/README.md
@@ -8,7 +8,7 @@
 
 # <img src="docs/logo.svg" alt="dagrunner_icon" width=200px>![](https://placehold.co/600x200/transparent/929292?text=DAGrunner)
 
-DAGrunner serves as a Directed Acyclic Graph (DAG) runner, primarily designed to ensure a clear distinction between a project's graph definition (typically in native networkx format) and its execution method. In essence, DAGrunner offers various schedulers for executing the graph, but it firmly separates these operational concepts from the scientific configuration or recipe, i.e., the graph itself. Consequently, while DAGrunner currently provides convenient scheduling options, it remains adaptable to future changes or alternative solutions, ensuring that the scientific configuration can persist regardless of the technologies or tools employed, whether DAGrunner is utilized or not.
+DAGrunner is an abstraction layer for executing Directed Acyclic Graphs (DAGs), providing portability and standardization across different schedulers. Rather than building your graph execution logic around a specific scheduler (such as Dask or Ray), DAGrunner enables you to define your graph once in networkx format and execute it with any supported scheduler without modifying your underlying graph definition. It decouples the scientific configuration and graph recipe from execution concerns, ensuring that your graph remains independent of scheduling technology choices. Additionally, DAGrunner provides a unified tooling layer that includes scheduler-agnostic graph visualization, scheduler-independent logging and monitoring, and other operational utilities—allowing you to maintain consistent workflows regardless of which backend scheduler you choose.
 
 ## Documentation
 
@@ -16,7 +16,7 @@ DAGrunner takes advantage of the native markdown rendering support provided by g
 
 ## API
 
-See [DAGrunner API](docs/dagrunner_index.md)
+See [DAGrunner API](docs/_build/dagrunner_index.md)
 
 ## License/copyright
 
@@ -52,7 +52,7 @@ See [docs/demo.ipynb](docs/demo.ipynb)
 DAGrunner concerns itself with graph execution and does not strictly require processing modules (plugins) to take any particular form.  That is, you may or may not choose to use or subclass the plugins provided by DAGrunner.
 However, for convenience, DAGrunner does define some plugins which fall into two broad categories, some abstract and some for use as they are.
 
-See [here](docs/dagrunner.plugin_framework.md) for more information.
+See [here](docs/_build/dagrunner.plugin_framework.md) for more information.
 
 ## Schedulers
 
@@ -63,7 +63,7 @@ These range from [dask](https://www.dask.org/), [ray](https://docs.ray.io/en/lat
 ## Logging and monitoring
 
 DAGrunner provides a script `dagrunner-logger` for running a TCP server.  This enables logging to function across the network.  Additionally, it will write logs to an sqlite database to aid in realtime monitoring from external tools.
-See [logger](docs/dagrunner.utils.logger.md) for more information.
+See [logger](docs/_build/dagrunner.utils.logger.md) for more information.
 
 ## Logo
 
diff --git a/dagrunner/events.py b/dagrunner/events.py
index d0fece1..5e0b634 100644
--- a/dagrunner/events.py
+++ b/dagrunner/events.py
@@ -16,8 +16,8 @@
 When a plugin returns `event.IGNORE`, the immediate descendant node filters out that
 input.
 The remaining inputs of that plugin are utilised by that node as normal.
-If all inputs to a node are `event.IGNORE`, the node's execution is skipped, and a
-`event.SKIP` event is returned instead, skipping execution through all descendants.
+If all inputs to a node are `event.IGNORE`, the node's execution is ignored, and a
+`event.IGNORE` event is returned instead, ignoring execution through all descendants.
 
 ```mermaid
 ---
@@ -25,11 +25,11 @@
 ---
 graph
     cycle1{cycleX}
-    cycle1 --> Input1 --> filepath --> Load1 --> cube1 --> Proc
-    cycle1 --> Input2 --> filepath --> Load2 --> event.IGNORE --> Proc
-    cycle1 --> Input3 --> filepath --> Load3 --> cube3 --> Proc
-    cycle1 --> Input4 --> filepath --> Load4 --> event.IGNORE --> Proc
-    Proc --> cube --> Save
+    cycle1 --> Input1 -- filepath --> Load1 --cube1 --> Proc
+    cycle1 --> Input2 -- filepath --> Load2 -- event.IGNORE --> Proc
+    cycle1 --> Input3 -- filepath --> Load3 -- cube3 --> Proc
+    cycle1 --> Input4 -- filepath --> Load4 -- event.IGNORE --> Proc
+    Proc -- cube --> Save
     Proc["Proc (cube1, cube3)"]
 ```
 Here, Input2 and Input4 return an IGNORE event, likely due to there being missing data.
@@ -47,17 +47,16 @@
 ---
 graph
     cycle1{cycleX}
-    cycle1 --> Input1 --> filepath --> Load1 --> cube --> Proc
-    cycle1 --> Input2 --> filepath --> Load2 --> event.SKIP --> Proc
-    cycle1 --> Input3 --> filepath --> Load3 --> cube --> Proc
-    cycle1 --> Input4 --> filepath --> Load4 --> event.IGNORE --> Proc
-    Proc --> event.SKIP --> Save
+    cycle1 --> Input1 -- filepath --> Load1 -- cube --> Proc
+    cycle1 --> Input2 -- filepath --> Load2 -- event.SKIP --> Proc
+    cycle1 --> Input3 -- filepath --> Load3 -- cube --> Proc
+    cycle1 --> Input4 -- filepath --> Load4 -- event.IGNORE --> Proc
+    Proc["Proc<br><sup>(not called)"] -- event.SKIP --> Save["Save<br><sup>(not called)"]
 ```
 Because `Input2` returns a SKIP event, the Proc node and everything that follows aren't
 executed and neither is the Save node since the skip is propagated along the execution
 graph.
-
-"""
+"""  # noqa: E501
 
 from dagrunner.utils import Singleton
 
diff --git a/dagrunner/execute_graph.py b/dagrunner/execute_graph.py
index 2df4ff1..bfad40f 100755
--- a/dagrunner/execute_graph.py
+++ b/dagrunner/execute_graph.py
@@ -149,10 +149,10 @@ def plugin_executor(
     call = as_iterable(call)
 
     # IGNORE_EVENT event handling
-    if len(args) > 1 and all((map(lambda x: x is events.IGNORE_EVENT, args))):
+    if len(args) > 0 and all((map(lambda x: x is events.IGNORE_EVENT, args))):
         # all args are IGNORE_EVENT, return IGNORE_EVENT (pass along)
         if verbose:
-            print(f"Retuning 'IGNORE_EVENT' event {call[0]}")
+            print(f"Returning 'IGNORE_EVENT' event {call[0]}")
         return events.IGNORE_EVENT
     args = list(filter(lambda x: x is not events.IGNORE_EVENT, args))
 
diff --git a/dagrunner/plugin_framework.py b/dagrunner/plugin_framework.py
index ba215e3..9859342 100644
--- a/dagrunner/plugin_framework.py
+++ b/dagrunner/plugin_framework.py
@@ -8,7 +8,6 @@
 import pickle
 import string
 import subprocess
-import warnings
 from abc import ABC, abstractmethod
 from glob import glob
 
@@ -133,6 +132,7 @@ def __call__(self, *args, **kwargs):
         Raises:
         - FileNotFoundError: If any of the files do not exist and `on_missing` is set
           to 'error'.
+        - ValueError: If `on_missing` is set to an invalid value.
 
         """
         args = list(map(process_path, args))
@@ -159,17 +159,14 @@ def __call__(self, *args, **kwargs):
             if self._on_missing == "error":
                 raise e
             elif self._on_missing == "ignore":
-                warnings.warn(str(e))
                 return events.IGNORE_EVENT
             elif self._on_missing == "skip":
-                warnings.warn(str(e))
                 return events.SKIP_EVENT
             else:
                 raise ValueError(
                     f"Invalid value for 'on_missing': {self._on_missing}. "
                     "Accepted values are 'error', 'ignore', and 'skip'."
                 )
-
         return self.load(*args, **kwargs)
 
 
diff --git a/dagrunner/tests/execute_graph/test_plugin_executor.py b/dagrunner/tests/execute_graph/test_plugin_executor.py
index de218f8..42591bd 100644
--- a/dagrunner/tests/execute_graph/test_plugin_executor.py
+++ b/dagrunner/tests/execute_graph/test_plugin_executor.py
@@ -109,20 +109,26 @@ def test_pass_class_arg_kwargs(plugin, init_args, call_args, target):
     assert res == target
 
 
-def test_ignore_event():
-    """Check what happens a subset of arguments and all arguments are IGNORE_EVENT."""
+@pytest.mark.parametrize(
+    "args, expected",
+    [
+        ((5, IGNORE_EVENT), 10),
+        ((IGNORE_EVENT, IGNORE_EVENT), IGNORE_EVENT),
+        ((IGNORE_EVENT,), IGNORE_EVENT),
+    ],
+)
+def test_ignore_event(args, expected):
+    """Check IGNORE_EVENT behaviour across mixed, all, and single-input cases."""
     call = tuple([lambda x: x + 5])
-    res = plugin_executor(*(5, IGNORE_EVENT), call=call)
-    assert res == 10
-
-    res = plugin_executor(*(IGNORE_EVENT, IGNORE_EVENT), call=call)
-    assert res == IGNORE_EVENT
+    res = plugin_executor(*args, call=call)
+    assert res == expected
 
 
-def test_skip_event():
-    """Check what happens a subset of arguments are SKIP_EVENT."""
+@pytest.mark.parametrize("args", [(5, SKIP_EVENT), (SKIP_EVENT,)])
+def test_skip_event(args):
+    """Check what happens when any input argument is SKIP_EVENT."""
     call = tuple([lambda x: x + 5])
-    res = plugin_executor(*(5, SKIP_EVENT), call=call)
+    res = plugin_executor(*args, call=call)
     assert res == SKIP_EVENT
 
 
diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 0000000..c4701e7
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,3 @@
+Documentation is built under `_build` automatically via github continuous integration (CI) using the [gen_docs](gen_docs) script (see [.github/workflows/docs.yml](../.github/workflows/docs.yml)).  As `main`, `release/*` or `feature/*` branches are updated, pull requests are automatically created targetting these branches with updated documentation.
+
+Whilst running this script locally yourself might be useful for building the documentation, please defer from including such changes to the built documentation to the repository.  This is to be handled by CI.
\ No newline at end of file
diff --git a/docs/dagrunner.config.md b/docs/_build/dagrunner.config.md
similarity index 88%
rename from docs/dagrunner.config.md
rename to docs/_build/dagrunner.config.md
index 266c896..db0bf6c 100644
--- a/docs/dagrunner.config.md
+++ b/docs/_build/dagrunner.config.md
@@ -1,6 +1,6 @@
 # module: `dagrunner.config`
 
-[Source](../dagrunner/config.py#L0)
+[Source](../../dagrunner/config.py#L0)
 
 This module handles the run-time configuration of the dagrunner library.
 
@@ -19,7 +19,7 @@ see [class: dagrunner.utils.Singleton](dagrunner.utils.md#class-singleton)
 
 ## class: `GlobalConfiguration`
 
-[Source](../dagrunner/config.py#L28)
+[Source](../../dagrunner/config.py#L28)
 
 ### Call Signature:
 
@@ -63,7 +63,7 @@ options::
 
 ### function: `__getitem__`
 
-[Source](../dagrunner/config.py#L172)
+[Source](../../dagrunner/config.py#L172)
 
 #### Call Signature:
 
@@ -73,7 +73,7 @@ __getitem__(self, key)
 
 ### function: `__init__`
 
-[Source](../dagrunner/config.py#L83)
+[Source](../../dagrunner/config.py#L83)
 
 #### Call Signature:
 
@@ -85,7 +85,7 @@ Initialize self.  See help(type(self)) for accurate signature.
 
 ### function: `__repr__`
 
-[Source](../dagrunner/config.py#L90)
+[Source](../../dagrunner/config.py#L90)
 
 #### Call Signature:
 
@@ -97,7 +97,7 @@ Return repr(self).
 
 ### function: `__setitem__`
 
-[Source](../dagrunner/config.py#L175)
+[Source](../../dagrunner/config.py#L175)
 
 #### Call Signature:
 
@@ -107,7 +107,7 @@ __setitem__(self, key, value)
 
 ### function: `__str__`
 
-[Source](../dagrunner/config.py#L87)
+[Source](../../dagrunner/config.py#L87)
 
 #### Call Signature:
 
@@ -119,7 +119,7 @@ Return str(self).
 
 ### function: `parse_configuration`
 
-[Source](../dagrunner/config.py#L146)
+[Source](../../dagrunner/config.py#L146)
 
 #### Call Signature:
 
diff --git a/docs/dagrunner.events.md b/docs/_build/dagrunner.events.md
similarity index 66%
rename from docs/dagrunner.events.md
rename to docs/_build/dagrunner.events.md
index 5616830..750ec9c 100644
--- a/docs/dagrunner.events.md
+++ b/docs/_build/dagrunner.events.md
@@ -1,6 +1,6 @@
 # module: `dagrunner.events`
 
-[Source](../dagrunner/events.py#L0)
+[Source](../../dagrunner/events.py#L0)
 
 ## Overview
 DAGrunner defines two special singleton events that plugins can return to control the
@@ -15,8 +15,8 @@ execution flow of their graph.
 When a plugin returns `event.IGNORE`, the immediate descendant node filters out that
 input.
 The remaining inputs of that plugin are utilised by that node as normal.
-If all inputs to a node are `event.IGNORE`, the node's execution is skipped, and a
-`event.SKIP` event is returned instead, skipping execution through all descendants.
+If all inputs to a node are `event.IGNORE`, the node's execution is ignored, and a
+`event.IGNORE` event is returned instead, ignoring execution through all descendants.
 
 ```mermaid
 ---
@@ -24,11 +24,11 @@ title: event.IGNORE (filtering some)
 ---
 graph
     cycle1{cycleX}
-    cycle1 --> Input1 --> filepath --> Load1 --> cube1 --> Proc
-    cycle1 --> Input2 --> filepath --> Load2 --> event.IGNORE --> Proc
-    cycle1 --> Input3 --> filepath --> Load3 --> cube3 --> Proc
-    cycle1 --> Input4 --> filepath --> Load4 --> event.IGNORE --> Proc
-    Proc --> cube --> Save
+    cycle1 --> Input1 -- filepath --> Load1 --cube1 --> Proc
+    cycle1 --> Input2 -- filepath --> Load2 -- event.IGNORE --> Proc
+    cycle1 --> Input3 -- filepath --> Load3 -- cube3 --> Proc
+    cycle1 --> Input4 -- filepath --> Load4 -- event.IGNORE --> Proc
+    Proc -- cube --> Save
     Proc["Proc (cube1, cube3)"]
 ```
 Here, Input2 and Input4 return an IGNORE event, likely due to there being missing data.
@@ -46,11 +46,11 @@ title: event.SKIP
 ---
 graph
     cycle1{cycleX}
-    cycle1 --> Input1 --> filepath --> Load1 --> cube --> Proc
-    cycle1 --> Input2 --> filepath --> Load2 --> event.SKIP --> Proc
-    cycle1 --> Input3 --> filepath --> Load3 --> cube --> Proc
-    cycle1 --> Input4 --> filepath --> Load4 --> event.IGNORE --> Proc
-    Proc --> event.SKIP --> Save
+    cycle1 --> Input1 -- filepath --> Load1 -- cube --> Proc
+    cycle1 --> Input2 -- filepath --> Load2 -- event.SKIP --> Proc
+    cycle1 --> Input3 -- filepath --> Load3 -- cube --> Proc
+    cycle1 --> Input4 -- filepath --> Load4 -- event.IGNORE --> Proc
+    Proc["Proc<br><sup>(not called)"] -- event.SKIP --> Save["Save<br><sup>(not called)"]
 ```
 Because `Input2` returns a SKIP event, the Proc node and everything that follows aren't
 executed and neither is the Save node since the skip is propagated along the execution
diff --git a/docs/dagrunner.execute_graph.md b/docs/_build/dagrunner.execute_graph.md
similarity index 93%
rename from docs/dagrunner.execute_graph.md
rename to docs/_build/dagrunner.execute_graph.md
index 1a03168..544089d 100644
--- a/docs/dagrunner.execute_graph.md
+++ b/docs/_build/dagrunner.execute_graph.md
@@ -1,6 +1,6 @@
 # module: `dagrunner.execute_graph`
 
-[Source](../dagrunner/execute_graph.py#L0)
+[Source](../../dagrunner/execute_graph.py#L0)
 
 see [GlobalConfiguration: dagrunner.config.CONFIG](dagrunner.config.md#globalconfiguration-config)
 
@@ -16,13 +16,15 @@ see [module: dagrunner.events](dagrunner.events.md#module-dagrunnerevents)
 
 see [function: dagrunner.utils.function_to_argparse_parse_args](dagrunner.utils.md#function-function_to_argparse_parse_args)
 
+see [function: dagrunner.utils.get_object_dot_module_path](dagrunner.utils.md#function-get_object_dot_module_path)
+
 see [module: dagrunner.utils.logger](dagrunner.utils.logger.md#module-dagrunnerutilslogger)
 
 see [function: dagrunner.utils.networkx.visualise_graph](dagrunner.utils.networkx.md#function-visualise_graph)
 
 ## class: `ExecuteGraph`
 
-[Source](../dagrunner/execute_graph.py#L274)
+[Source](../../dagrunner/execute_graph.py#L318)
 
 ### Call Signature:
 
@@ -32,7 +34,7 @@ ExecuteGraph(networkx_graph: str, networkx_graph_kwargs: dict = None, <function
 
 ### function: `__call__`
 
-[Source](../dagrunner/execute_graph.py#L399)
+[Source](../../dagrunner/execute_graph.py#L443)
 
 #### Call Signature:
 
@@ -44,7 +46,7 @@ Call self as a function.
 
 ### function: `__init__`
 
-[Source](../dagrunner/execute_graph.py#L275)
+[Source](../../dagrunner/execute_graph.py#L319)
 
 #### Call Signature:
 
@@ -101,7 +103,7 @@ Args:
 
 ### function: `visualise`
 
-[Source](../dagrunner/execute_graph.py#L396)
+[Source](../../dagrunner/execute_graph.py#L440)
 
 #### Call Signature:
 
@@ -113,7 +115,7 @@ visualise(self, **kwargs)
 
 ## function: `main`
 
-[Source](../dagrunner/execute_graph.py#L410)
+[Source](../../dagrunner/execute_graph.py#L454)
 
 ### Call Signature:
 
@@ -126,7 +128,7 @@ Parses command line arguments and executes the graph using the ExecuteGraph clas
 
 ## function: `plugin_executor`
 
-[Source](../dagrunner/execute_graph.py#L47)
+[Source](../../dagrunner/execute_graph.py#L83)
 
 ### Call Signature:
 
diff --git a/docs/dagrunner.md b/docs/_build/dagrunner.md
similarity index 94%
rename from docs/dagrunner.md
rename to docs/_build/dagrunner.md
index 3078169..b5d64b2 100644
--- a/docs/dagrunner.md
+++ b/docs/_build/dagrunner.md
@@ -1,6 +1,6 @@
 # module: `dagrunner`
 
-[Source](../dagrunner/__init__.py#L0)
+[Source](../../dagrunner/__init__.py#L0)
 
 see [class: plugin_framework.DataPolling](dagrunner.plugin_framework.md#class-datapolling)
 
diff --git a/docs/dagrunner.plugin_framework.md b/docs/_build/dagrunner.plugin_framework.md
similarity index 87%
rename from docs/dagrunner.plugin_framework.md
rename to docs/_build/dagrunner.plugin_framework.md
index 94028b5..1397ef1 100644
--- a/docs/dagrunner.plugin_framework.md
+++ b/docs/_build/dagrunner.plugin_framework.md
@@ -1,6 +1,6 @@
 # module: `dagrunner.plugin_framework`
 
-[Source](../dagrunner/plugin_framework.py#L0)
+[Source](../../dagrunner/plugin_framework.py#L0)
 
 see [function: dagrunner.utils.data_polling](dagrunner.utils.md#function-data_polling)
 
@@ -12,7 +12,7 @@ see [function: dagrunner.utils.stage_to_dir](dagrunner.utils.md#function-stage_t
 
 ## class: `DataPolling`
 
-[Source](../dagrunner/plugin_framework.py#L176)
+[Source](../../dagrunner/plugin_framework.py#L173)
 
 ### Call Signature:
 
@@ -27,7 +27,7 @@ local and remote glob patterns.
 
 ### function: `__call__`
 
-[Source](../dagrunner/plugin_framework.py#L201)
+[Source](../../dagrunner/plugin_framework.py#L198)
 
 #### Call Signature:
 
@@ -45,7 +45,7 @@ Returns:
 
 ### function: `__init__`
 
-[Source](../dagrunner/plugin_framework.py#L184)
+[Source](../../dagrunner/plugin_framework.py#L181)
 
 #### Call Signature:
 
@@ -65,7 +65,7 @@ Args:
 
 ## class: `Input`
 
-[Source](../dagrunner/plugin_framework.py#L222)
+[Source](../../dagrunner/plugin_framework.py#L219)
 
 ### Call Signature:
 
@@ -77,7 +77,7 @@ A plugin to expand filepaths using keyword arguments and environment variables.
 
 ### function: `__call__`
 
-[Source](../dagrunner/plugin_framework.py#L227)
+[Source](../../dagrunner/plugin_framework.py#L224)
 
 #### Call Signature:
 
@@ -105,7 +105,7 @@ Raises:
 
 ## class: `Load`
 
-[Source](../dagrunner/plugin_framework.py#L68)
+[Source](../../dagrunner/plugin_framework.py#L67)
 
 ### Call Signature:
 
@@ -122,7 +122,7 @@ as globbing of file paths (local or remote).
 
 ### function: `__call__`
 
-[Source](../dagrunner/plugin_framework.py#L119)
+[Source](../../dagrunner/plugin_framework.py#L118)
 
 #### Call Signature:
 
@@ -145,10 +145,11 @@ Returns:
 Raises:
 - FileNotFoundError: If any of the files do not exist and `on_missing` is set
   to 'error'.
+- ValueError: If `on_missing` is set to an invalid value.
 
 ### function: `__init__`
 
-[Source](../dagrunner/plugin_framework.py#L78)
+[Source](../../dagrunner/plugin_framework.py#L77)
 
 #### Call Signature:
 
@@ -171,7 +172,7 @@ Args:
 
 ### function: `load`
 
-[Source](../dagrunner/plugin_framework.py#L102)
+[Source](../../dagrunner/plugin_framework.py#L101)
 
 #### Call Signature:
 
@@ -193,7 +194,7 @@ Raises:
 
 ## class: `LoadJson`
 
-[Source](../dagrunner/plugin_framework.py#L261)
+[Source](../../dagrunner/plugin_framework.py#L258)
 
 ### Call Signature:
 
@@ -205,7 +206,7 @@ json file loader.
 
 ### function: `__call__`
 
-[Source](../dagrunner/plugin_framework.py#L119)
+[Source](../../dagrunner/plugin_framework.py#L118)
 
 #### Call Signature:
 
@@ -228,10 +229,11 @@ Returns:
 Raises:
 - FileNotFoundError: If any of the files do not exist and `on_missing` is set
   to 'error'.
+- ValueError: If `on_missing` is set to an invalid value.
 
 ### function: `__init__`
 
-[Source](../dagrunner/plugin_framework.py#L78)
+[Source](../../dagrunner/plugin_framework.py#L77)
 
 #### Call Signature:
 
@@ -254,7 +256,7 @@ Args:
 
 ### function: `load`
 
-[Source](../dagrunner/plugin_framework.py#L264)
+[Source](../../dagrunner/plugin_framework.py#L261)
 
 #### Call Signature:
 
@@ -276,7 +278,7 @@ Raises:
 
 ## class: `LoadPickle`
 
-[Source](../dagrunner/plugin_framework.py#L305)
+[Source](../../dagrunner/plugin_framework.py#L302)
 
 ### Call Signature:
 
@@ -288,7 +290,7 @@ pickle file loader.
 
 ### function: `__call__`
 
-[Source](../dagrunner/plugin_framework.py#L119)
+[Source](../../dagrunner/plugin_framework.py#L118)
 
 #### Call Signature:
 
@@ -311,10 +313,11 @@ Returns:
 Raises:
 - FileNotFoundError: If any of the files do not exist and `on_missing` is set
   to 'error'.
+- ValueError: If `on_missing` is set to an invalid value.
 
 ### function: `__init__`
 
-[Source](../dagrunner/plugin_framework.py#L78)
+[Source](../../dagrunner/plugin_framework.py#L77)
 
 #### Call Signature:
 
@@ -337,7 +340,7 @@ Args:
 
 ### function: `load`
 
-[Source](../dagrunner/plugin_framework.py#L308)
+[Source](../../dagrunner/plugin_framework.py#L305)
 
 #### Call Signature:
 
@@ -359,7 +362,7 @@ Raises:
 
 ## class: `NodeAwarePlugin`
 
-[Source](../dagrunner/plugin_framework.py#L42)
+[Source](../../dagrunner/plugin_framework.py#L41)
 
 ### Call Signature:
 
@@ -373,7 +376,7 @@ that are 'node aware'.
 
 ### function: `__call__`
 
-[Source](../dagrunner/plugin_framework.py#L23)
+[Source](../../dagrunner/plugin_framework.py#L22)
 
 #### Call Signature:
 
@@ -395,7 +398,7 @@ Returns:
 
 ## class: `Plugin`
 
-[Source](../dagrunner/plugin_framework.py#L20)
+[Source](../../dagrunner/plugin_framework.py#L19)
 
 ### Call Signature:
 
@@ -407,7 +410,7 @@ Abstract base class to define our plugin UI
 
 ### function: `__call__`
 
-[Source](../dagrunner/plugin_framework.py#L23)
+[Source](../../dagrunner/plugin_framework.py#L22)
 
 #### Call Signature:
 
@@ -429,7 +432,7 @@ Returns:
 
 ## class: `SaveJson`
 
-[Source](../dagrunner/plugin_framework.py#L274)
+[Source](../../dagrunner/plugin_framework.py#L271)
 
 ### Call Signature:
 
@@ -441,7 +444,7 @@ Save data to a JSON file.
 
 ### function: `__call__`
 
-[Source](../dagrunner/plugin_framework.py#L277)
+[Source](../../dagrunner/plugin_framework.py#L274)
 
 #### Call Signature:
 
@@ -467,7 +470,7 @@ Returns:
 
 ## class: `SavePickle`
 
-[Source](../dagrunner/plugin_framework.py#L316)
+[Source](../../dagrunner/plugin_framework.py#L313)
 
 ### Call Signature:
 
@@ -479,7 +482,7 @@ Save data to a Pickle file.
 
 ### function: `__call__`
 
-[Source](../dagrunner/plugin_framework.py#L319)
+[Source](../../dagrunner/plugin_framework.py#L316)
 
 #### Call Signature:
 
@@ -505,7 +508,7 @@ Returns:
 
 ## class: `Shell`
 
-[Source](../dagrunner/plugin_framework.py#L50)
+[Source](../../dagrunner/plugin_framework.py#L49)
 
 ### Call Signature:
 
@@ -517,7 +520,7 @@ Abstract base class to define our plugin UI
 
 ### function: `__call__`
 
-[Source](../dagrunner/plugin_framework.py#L51)
+[Source](../../dagrunner/plugin_framework.py#L50)
 
 #### Call Signature:
 
diff --git a/docs/dagrunner.runner.md b/docs/_build/dagrunner.runner.md
similarity index 71%
rename from docs/dagrunner.runner.md
rename to docs/_build/dagrunner.runner.md
index 99ff895..0a3a767 100644
--- a/docs/dagrunner.runner.md
+++ b/docs/_build/dagrunner.runner.md
@@ -1,6 +1,6 @@
 # module: `dagrunner.runner`
 
-[Source](../dagrunner/runner/__init__.py#L0)
+[Source](../../dagrunner/runner/__init__.py#L0)
 
 see [module: schedulers](dagrunner.runner.schedulers.md#module-dagrunnerrunnerschedulers)
 
diff --git a/docs/dagrunner.runner.schedulers.asyncmp.md b/docs/_build/dagrunner.runner.schedulers.asyncmp.md
similarity index 84%
rename from docs/dagrunner.runner.schedulers.asyncmp.md
rename to docs/_build/dagrunner.runner.schedulers.asyncmp.md
index 8853fae..c88f50a 100644
--- a/docs/dagrunner.runner.schedulers.asyncmp.md
+++ b/docs/_build/dagrunner.runner.schedulers.asyncmp.md
@@ -1,10 +1,10 @@
 # module: `dagrunner.runner.schedulers.asyncmp`
 
-[Source](../dagrunner/runner/schedulers/asyncmp.py#L0)
+[Source](../../dagrunner/runner/schedulers/asyncmp.py#L0)
 
 ## class: `AsyncMP`
 
-[Source](../dagrunner/runner/schedulers/asyncmp.py#L25)
+[Source](../../dagrunner/runner/schedulers/asyncmp.py#L25)
 
 ### Call Signature:
 
@@ -20,7 +20,7 @@ itself.
 
 ### function: `__enter__`
 
-[Source](../dagrunner/runner/schedulers/asyncmp.py#L170)
+[Source](../../dagrunner/runner/schedulers/asyncmp.py#L170)
 
 #### Call Signature:
 
@@ -32,7 +32,7 @@ Initiate the pool of workers.
 
 ### function: `__exit__`
 
-[Source](../dagrunner/runner/schedulers/asyncmp.py#L175)
+[Source](../../dagrunner/runner/schedulers/asyncmp.py#L175)
 
 #### Call Signature:
 
@@ -46,7 +46,7 @@ exit.
 
 ### function: `__init__`
 
-[Source](../dagrunner/runner/schedulers/asyncmp.py#L35)
+[Source](../../dagrunner/runner/schedulers/asyncmp.py#L35)
 
 #### Call Signature:
 
@@ -72,7 +72,7 @@ Keyword Args:
 
 ### function: `run`
 
-[Source](../dagrunner/runner/schedulers/asyncmp.py#L64)
+[Source](../../dagrunner/runner/schedulers/asyncmp.py#L64)
 
 #### Call Signature:
 
diff --git a/docs/_build/dagrunner.runner.schedulers.base.md b/docs/_build/dagrunner.runner.schedulers.base.md
new file mode 100644
index 0000000..d188e90
--- /dev/null
+++ b/docs/_build/dagrunner.runner.schedulers.base.md
@@ -0,0 +1,4 @@
+# module: `dagrunner.runner.schedulers.base`
+
+[Source](../../dagrunner/runner/schedulers/base.py#L0)
+
diff --git a/docs/dagrunner.runner.schedulers.dask.md b/docs/_build/dagrunner.runner.schedulers.dask.md
similarity index 80%
rename from docs/dagrunner.runner.schedulers.dask.md
rename to docs/_build/dagrunner.runner.schedulers.dask.md
index 84f9853..df3d618 100644
--- a/docs/dagrunner.runner.schedulers.dask.md
+++ b/docs/_build/dagrunner.runner.schedulers.dask.md
@@ -1,6 +1,6 @@
 # module: `dagrunner.runner.schedulers.dask`
 
-[Source](../dagrunner/runner/schedulers/dask.py#L0)
+[Source](../../dagrunner/runner/schedulers/dask.py#L0)
 
 Standardised UI for dask compatible schedulers (including 'dask on ray')
 
@@ -15,7 +15,7 @@ See the following useful background reading:
 
 ## class: `DaskOnRay`
 
-[Source](../dagrunner/runner/schedulers/dask.py#L217)
+[Source](../../dagrunner/runner/schedulers/dask.py#L217)
 
 ### Call Signature:
 
@@ -27,7 +27,7 @@ A class to run dask graphs using the 'dak-on-ray' scheduler.
 
 ### function: `__enter__`
 
-[Source](../dagrunner/runner/schedulers/dask.py#L225)
+[Source](../../dagrunner/runner/schedulers/dask.py#L225)
 
 #### Call Signature:
 
@@ -37,7 +37,7 @@ __enter__(self)
 
 ### function: `__exit__`
 
-[Source](../dagrunner/runner/schedulers/dask.py#L228)
+[Source](../../dagrunner/runner/schedulers/dask.py#L228)
 
 #### Call Signature:
 
@@ -47,7 +47,7 @@ __exit__(self, exc_type, exc_value, exc_traceback)
 
 ### function: `__init__`
 
-[Source](../dagrunner/runner/schedulers/dask.py#L220)
+[Source](../../dagrunner/runner/schedulers/dask.py#L220)
 
 #### Call Signature:
 
@@ -59,7 +59,7 @@ Initialize self.  See help(type(self)) for accurate signature.
 
 ### function: `run`
 
-[Source](../dagrunner/runner/schedulers/dask.py#L233)
+[Source](../../dagrunner/runner/schedulers/dask.py#L233)
 
 #### Call Signature:
 
@@ -80,7 +80,7 @@ Returns:
 
 ## class: `Distributed`
 
-[Source](../dagrunner/runner/schedulers/dask.py#L84)
+[Source](../../dagrunner/runner/schedulers/dask.py#L84)
 
 ### Call Signature:
 
@@ -92,7 +92,7 @@ A class to run dask graphs on a distributed cluster.
 
 ### function: `__enter__`
 
-[Source](../dagrunner/runner/schedulers/dask.py#L97)
+[Source](../../dagrunner/runner/schedulers/dask.py#L97)
 
 #### Call Signature:
 
@@ -104,7 +104,7 @@ Create a local cluster and connect a client to it.
 
 ### function: `__exit__`
 
-[Source](../dagrunner/runner/schedulers/dask.py#L111)
+[Source](../../dagrunner/runner/schedulers/dask.py#L111)
 
 #### Call Signature:
 
@@ -114,7 +114,7 @@ __exit__(self, exc_type, exc_value, exc_traceback)
 
 ### function: `__init__`
 
-[Source](../dagrunner/runner/schedulers/dask.py#L87)
+[Source](../../dagrunner/runner/schedulers/dask.py#L87)
 
 #### Call Signature:
 
@@ -126,7 +126,7 @@ Initialize self.  See help(type(self)) for accurate signature.
 
 ### function: `run`
 
-[Source](../dagrunner/runner/schedulers/dask.py#L115)
+[Source](../../dagrunner/runner/schedulers/dask.py#L115)
 
 #### Call Signature:
 
@@ -147,7 +147,7 @@ Returns:
 
 ## class: `SingleMachine`
 
-[Source](../dagrunner/runner/schedulers/dask.py#L140)
+[Source](../../dagrunner/runner/schedulers/dask.py#L140)
 
 ### Call Signature:
 
@@ -159,7 +159,7 @@ A class to run dask graphs on a single machine.
 
 ### function: `__enter__`
 
-[Source](../dagrunner/runner/schedulers/dask.py#L152)
+[Source](../../dagrunner/runner/schedulers/dask.py#L152)
 
 #### Call Signature:
 
@@ -169,7 +169,7 @@ __enter__(self)
 
 ### function: `__exit__`
 
-[Source](../dagrunner/runner/schedulers/dask.py#L213)
+[Source](../../dagrunner/runner/schedulers/dask.py#L213)
 
 #### Call Signature:
 
@@ -179,7 +179,7 @@ __exit__(self, exc_type, exc_value, exc_traceback)
 
 ### function: `__init__`
 
-[Source](../dagrunner/runner/schedulers/dask.py#L143)
+[Source](../../dagrunner/runner/schedulers/dask.py#L143)
 
 #### Call Signature:
 
@@ -191,7 +191,7 @@ Initialize self.  See help(type(self)) for accurate signature.
 
 ### function: `run`
 
-[Source](../dagrunner/runner/schedulers/dask.py#L155)
+[Source](../../dagrunner/runner/schedulers/dask.py#L155)
 
 #### Call Signature:
 
@@ -212,7 +212,7 @@ Returns:
 
 ## function: `add_dummy_tasks`
 
-[Source](../dagrunner/runner/schedulers/dask.py#L38)
+[Source](../../dagrunner/runner/schedulers/dask.py#L38)
 
 ### Call Signature:
 
@@ -242,7 +242,7 @@ TODO:
 
 ## function: `no_op`
 
-[Source](../dagrunner/runner/schedulers/dask.py#L30)
+[Source](../../dagrunner/runner/schedulers/dask.py#L30)
 
 ### Call Signature:
 
diff --git a/docs/dagrunner.runner.schedulers.md b/docs/_build/dagrunner.runner.schedulers.md
similarity index 89%
rename from docs/dagrunner.runner.schedulers.md
rename to docs/_build/dagrunner.runner.schedulers.md
index 7aa178d..4d36591 100644
--- a/docs/dagrunner.runner.schedulers.md
+++ b/docs/_build/dagrunner.runner.schedulers.md
@@ -1,6 +1,6 @@
 # module: `dagrunner.runner.schedulers`
 
-[Source](../dagrunner/runner/schedulers/__init__.py#L0)
+[Source](../../dagrunner/runner/schedulers/__init__.py#L0)
 
 Supackage which provides access to various schedulers through a common UI.
 
diff --git a/docs/dagrunner.utils.logger.md b/docs/_build/dagrunner.utils.logger.md
similarity index 90%
rename from docs/dagrunner.utils.logger.md
rename to docs/_build/dagrunner.utils.logger.md
index 65e042d..59f4900 100644
--- a/docs/dagrunner.utils.logger.md
+++ b/docs/_build/dagrunner.utils.logger.md
@@ -1,6 +1,6 @@
 # module: `dagrunner.utils.logger`
 
-[Source](../dagrunner/utils/logger.py#L0)
+[Source](../../dagrunner/utils/logger.py#L0)
 
 This module takes much from the Python logging cookbook:
 https://docs.python.org/3/howto/logging-cookbook.html#sending-and-receiving-logging-events-across-a-network
@@ -24,7 +24,7 @@ see [function: dagrunner.utils.function_to_argparse_parse_args](dagrunner.utils.
 
 ## class: `CustomFormatter`
 
-[Source](../dagrunner/utils/logger.py#L217)
+[Source](../../dagrunner/utils/logger.py#L217)
 
 ### Call Signature:
 
@@ -76,7 +76,7 @@ attributes in a LogRecord are described by:
 
 ### function: `__init__`
 
-[Source](../dagrunner/utils/logger.py#L218)
+[Source](../../dagrunner/utils/logger.py#L218)
 
 #### Call Signature:
 
@@ -100,7 +100,7 @@ use one of %-formatting, :meth:`str.format` (``{}``) formatting or
 
 ### function: `format`
 
-[Source](../dagrunner/utils/logger.py#L221)
+[Source](../../dagrunner/utils/logger.py#L221)
 
 #### Call Signature:
 
@@ -123,7 +123,7 @@ it is formatted using formatException() and appended to the message.
 
 ## class: `LogRecordSocketReceiver`
 
-[Source](../dagrunner/utils/logger.py#L121)
+[Source](../../dagrunner/utils/logger.py#L121)
 
 ### Call Signature:
 
@@ -138,7 +138,7 @@ log records.
 
 ### function: `__init__`
 
-[Source](../dagrunner/utils/logger.py#L131)
+[Source](../../dagrunner/utils/logger.py#L131)
 
 #### Call Signature:
 
@@ -150,7 +150,7 @@ Constructor.  May be extended, do not override.
 
 ### function: `serve_until_stopped`
 
-[Source](../dagrunner/utils/logger.py#L142)
+[Source](../../dagrunner/utils/logger.py#L142)
 
 #### Call Signature:
 
@@ -160,7 +160,7 @@ serve_until_stopped(self)
 
 ## class: `LogRecordStreamHandler`
 
-[Source](../dagrunner/utils/logger.py#L76)
+[Source](../../dagrunner/utils/logger.py#L76)
 
 ### Call Signature:
 
@@ -175,7 +175,7 @@ records and customise logging events.
 
 ### function: `handle`
 
-[Source](../dagrunner/utils/logger.py#L84)
+[Source](../../dagrunner/utils/logger.py#L84)
 
 #### Call Signature:
 
@@ -189,7 +189,7 @@ according to whatever policy is configured locally.
 
 ### function: `handle_log_record`
 
-[Source](../dagrunner/utils/logger.py#L106)
+[Source](../../dagrunner/utils/logger.py#L106)
 
 #### Call Signature:
 
@@ -199,7 +199,7 @@ handle_log_record(self, record)
 
 ### function: `unpickle`
 
-[Source](../dagrunner/utils/logger.py#L103)
+[Source](../../dagrunner/utils/logger.py#L103)
 
 #### Call Signature:
 
@@ -209,7 +209,7 @@ unpickle(self, data)
 
 ## class: `SQLiteHandler`
 
-[Source](../dagrunner/utils/logger.py#L153)
+[Source](../../dagrunner/utils/logger.py#L153)
 
 ### Call Signature:
 
@@ -221,7 +221,7 @@ Custom logging handler to write log messages to an SQLite database.
 
 ### function: `__init__`
 
-[Source](../dagrunner/utils/logger.py#L158)
+[Source](../../dagrunner/utils/logger.py#L158)
 
 #### Call Signature:
 
@@ -234,7 +234,7 @@ and the filter list to empty.
 
 ### function: `close`
 
-[Source](../dagrunner/utils/logger.py#L212)
+[Source](../../dagrunner/utils/logger.py#L212)
 
 #### Call Signature:
 
@@ -246,7 +246,7 @@ Ensure the database connection is closed cleanly.
 
 ### function: `emit`
 
-[Source](../dagrunner/utils/logger.py#L185)
+[Source](../../dagrunner/utils/logger.py#L185)
 
 #### Call Signature:
 
@@ -258,7 +258,7 @@ Emit a log record, and insert it into the database.
 
 ## function: `client_attach_socket_handler`
 
-[Source](../dagrunner/utils/logger.py#L43)
+[Source](../../dagrunner/utils/logger.py#L43)
 
 ### Call Signature:
 
@@ -288,7 +288,7 @@ Args:
 
 ## function: `main`
 
-[Source](../dagrunner/utils/logger.py#L265)
+[Source](../../dagrunner/utils/logger.py#L265)
 
 ### Call Signature:
 
@@ -302,7 +302,7 @@ Parses command line arguments and executes the logging server
 
 ## function: `start_logging_server`
 
-[Source](../dagrunner/utils/logger.py#L231)
+[Source](../../dagrunner/utils/logger.py#L231)
 
 ### Call Signature:
 
diff --git a/docs/dagrunner.utils.md b/docs/_build/dagrunner.utils.md
similarity index 83%
rename from docs/dagrunner.utils.md
rename to docs/_build/dagrunner.utils.md
index 32da463..2cd77c6 100644
--- a/docs/dagrunner.utils.md
+++ b/docs/_build/dagrunner.utils.md
@@ -1,6 +1,6 @@
 # module: `dagrunner.utils`
 
-[Source](../dagrunner/utils/__init__.py#L0)
+[Source](../../dagrunner/utils/__init__.py#L0)
 
 see [module: _doc_styles](dagrunner.utils._doc_styles.md#module-dagrunnerutils_doc_styles)
 
@@ -12,7 +12,7 @@ see [module: visualisation](dagrunner.utils.visualisation.md#module-dagrunneruti
 
 ## class: `CaptureProcMemory`
 
-[Source](../dagrunner/utils/__init__.py#L216)
+[Source](../../dagrunner/utils/__init__.py#L233)
 
 ### Call Signature:
 
@@ -26,7 +26,7 @@ See `get_proc_mem_stat` for more information.
 
 ### function: `__enter__`
 
-[Source](../dagrunner/utils/__init__.py#L197)
+[Source](../../dagrunner/utils/__init__.py#L214)
 
 #### Call Signature:
 
@@ -36,7 +36,7 @@ __enter__(self)
 
 ### function: `__exit__`
 
-[Source](../dagrunner/utils/__init__.py#L202)
+[Source](../../dagrunner/utils/__init__.py#L219)
 
 #### Call Signature:
 
@@ -46,7 +46,7 @@ __exit__(self, exc_type, exc_value, traceback)
 
 ### function: `__init__`
 
-[Source](../dagrunner/utils/__init__.py#L227)
+[Source](../../dagrunner/utils/__init__.py#L244)
 
 #### Call Signature:
 
@@ -65,7 +65,7 @@ Args:
 
 ### function: `max`
 
-[Source](../dagrunner/utils/__init__.py#L206)
+[Source](../../dagrunner/utils/__init__.py#L223)
 
 #### Call Signature:
 
@@ -80,7 +80,7 @@ Returns:
 
 ## class: `CaptureSysMemory`
 
-[Source](../dagrunner/utils/__init__.py#L268)
+[Source](../../dagrunner/utils/__init__.py#L285)
 
 ### Call Signature:
 
@@ -94,7 +94,7 @@ See `get_sys_mem_stat` for more information.
 
 ### function: `__enter__`
 
-[Source](../dagrunner/utils/__init__.py#L197)
+[Source](../../dagrunner/utils/__init__.py#L214)
 
 #### Call Signature:
 
@@ -104,7 +104,7 @@ __enter__(self)
 
 ### function: `__exit__`
 
-[Source](../dagrunner/utils/__init__.py#L202)
+[Source](../../dagrunner/utils/__init__.py#L219)
 
 #### Call Signature:
 
@@ -114,7 +114,7 @@ __exit__(self, exc_type, exc_value, traceback)
 
 ### function: `__init__`
 
-[Source](../dagrunner/utils/__init__.py#L165)
+[Source](../../dagrunner/utils/__init__.py#L182)
 
 #### Call Signature:
 
@@ -132,7 +132,7 @@ Args:
 
 ### function: `max`
 
-[Source](../dagrunner/utils/__init__.py#L206)
+[Source](../../dagrunner/utils/__init__.py#L223)
 
 #### Call Signature:
 
@@ -147,7 +147,7 @@ Returns:
 
 ## class: `KeyValueAction`
 
-[Source](../dagrunner/utils/__init__.py#L386)
+[Source](../../dagrunner/utils/__init__.py#L403)
 
 ### Call Signature:
 
@@ -206,7 +206,7 @@ Keyword Arguments:
 
 ### function: `__call__`
 
-[Source](../dagrunner/utils/__init__.py#L387)
+[Source](../../dagrunner/utils/__init__.py#L404)
 
 #### Call Signature:
 
@@ -218,7 +218,7 @@ Call self as a function.
 
 ## class: `ObjectAsStr`
 
-[Source](../dagrunner/utils/__init__.py#L280)
+[Source](../../dagrunner/utils/__init__.py#L297)
 
 ### Call Signature:
 
@@ -230,7 +230,7 @@ Hide object under a string.
 
 ### function: `__hash__`
 
-[Source](../dagrunner/utils/__init__.py#L294)
+[Source](../../dagrunner/utils/__init__.py#L311)
 
 #### Call Signature:
 
@@ -242,7 +242,7 @@ Return hash(self).
 
 ### function: `__new__`
 
-[Source](../dagrunner/utils/__init__.py#L285)
+[Source](../../dagrunner/utils/__init__.py#L302)
 
 #### Call Signature:
 
@@ -254,7 +254,7 @@ Create and return a new object.  See help(type) for accurate signature.
 
 ### function: `obj_to_name`
 
-[Source](../dagrunner/utils/__init__.py#L298)
+[Source](../../dagrunner/utils/__init__.py#L315)
 
 #### Call Signature:
 
@@ -264,13 +264,13 @@ obj_to_name(obj, cls)
 
 ## class: `Singleton`
 
-[Source](../dagrunner/utils/__init__.py#L101)
+[Source](../../dagrunner/utils/__init__.py#L118)
 
 Singleton metaclass.
 
 ### function: `__call__`
 
-[Source](../dagrunner/utils/__init__.py#L108)
+[Source](../../dagrunner/utils/__init__.py#L125)
 
 #### Call Signature:
 
@@ -282,7 +282,7 @@ Call self as a function.
 
 ## class: `TimeIt`
 
-[Source](../dagrunner/utils/__init__.py#L306)
+[Source](../../dagrunner/utils/__init__.py#L323)
 
 ### Call Signature:
 
@@ -311,7 +311,7 @@ Example as a standalone timer:
 
 ### function: `__enter__`
 
-[Source](../dagrunner/utils/__init__.py#L335)
+[Source](../../dagrunner/utils/__init__.py#L352)
 
 #### Call Signature:
 
@@ -321,7 +321,7 @@ __enter__(self)
 
 ### function: `__exit__`
 
-[Source](../dagrunner/utils/__init__.py#L339)
+[Source](../../dagrunner/utils/__init__.py#L356)
 
 #### Call Signature:
 
@@ -331,7 +331,7 @@ __exit__(self, *args)
 
 ### function: `__init__`
 
-[Source](../dagrunner/utils/__init__.py#L329)
+[Source](../../dagrunner/utils/__init__.py#L346)
 
 #### Call Signature:
 
@@ -343,7 +343,7 @@ Initialize self.  See help(type(self)) for accurate signature.
 
 ### function: `__str__`
 
-[Source](../dagrunner/utils/__init__.py#L364)
+[Source](../../dagrunner/utils/__init__.py#L381)
 
 #### Call Signature:
 
@@ -355,7 +355,7 @@ Print elapsed time in seconds.
 
 ### function: `start`
 
-[Source](../dagrunner/utils/__init__.py#L345)
+[Source](../../dagrunner/utils/__init__.py#L362)
 
 #### Call Signature:
 
@@ -365,7 +365,7 @@ start(self)
 
 ### function: `stop`
 
-[Source](../dagrunner/utils/__init__.py#L349)
+[Source](../../dagrunner/utils/__init__.py#L366)
 
 #### Call Signature:
 
@@ -375,7 +375,7 @@ stop(self)
 
 ## function: `as_iterable`
 
-[Source](../dagrunner/utils/__init__.py#L93)
+[Source](../../dagrunner/utils/__init__.py#L110)
 
 ### Call Signature:
 
@@ -385,7 +385,7 @@ as_iterable(obj)
 
 ## function: `data_polling`
 
-[Source](../dagrunner/utils/__init__.py#L487)
+[Source](../../dagrunner/utils/__init__.py#L504)
 
 ### Call Signature:
 
@@ -418,7 +418,7 @@ Returns:
 
 ## function: `docstring_parse`
 
-[Source](../dagrunner/utils/__init__.py#L369)
+[Source](../../dagrunner/utils/__init__.py#L386)
 
 ### Call Signature:
 
@@ -428,7 +428,7 @@ docstring_parse(obj)
 
 ## function: `function_to_argparse`
 
-[Source](../dagrunner/utils/__init__.py#L398)
+[Source](../../dagrunner/utils/__init__.py#L415)
 
 ### Call Signature:
 
@@ -440,7 +440,7 @@ Generate an argparse from a function signature
 
 ## function: `function_to_argparse_parse_args`
 
-[Source](../dagrunner/utils/__init__.py#L475)
+[Source](../../dagrunner/utils/__init__.py#L492)
 
 ### Call Signature:
 
@@ -448,9 +448,19 @@ Generate an argparse from a function signature
 function_to_argparse_parse_args(*args, **kwargs)
 ```
 
+## function: `get_object_dot_module_path`
+
+[Source](../../dagrunner/utils/__init__.py#L25)
+
+### Call Signature:
+
+```python
+get_object_dot_module_path(obj)
+```
+
 ## function: `get_proc_mem_stat`
 
-[Source](../dagrunner/utils/__init__.py#L134)
+[Source](../../dagrunner/utils/__init__.py#L151)
 
 ### Call Signature:
 
@@ -472,7 +482,7 @@ Returns:
 
 ## function: `get_sys_mem_stat`
 
-[Source](../dagrunner/utils/__init__.py#L242)
+[Source](../../dagrunner/utils/__init__.py#L259)
 
 ### Call Signature:
 
@@ -491,7 +501,7 @@ Returns:
 
 ## function: `in_notebook`
 
-[Source](../dagrunner/utils/__init__.py#L81)
+[Source](../../dagrunner/utils/__init__.py#L98)
 
 ### Call Signature:
 
@@ -503,7 +513,7 @@ Determine whether we are in a Jupyter notebook.
 
 ## function: `pairwise`
 
-[Source](../dagrunner/utils/__init__.py#L59)
+[Source](../../dagrunner/utils/__init__.py#L76)
 
 ### Call Signature:
 
@@ -521,7 +531,7 @@ pairwise('ABCDEFG') → AB BC CD DE EF FG
 
 ## function: `process_path`
 
-[Source](../dagrunner/utils/__init__.py#L114)
+[Source](../../dagrunner/utils/__init__.py#L131)
 
 ### Call Signature:
 
@@ -540,7 +550,7 @@ Returns:
 
 ## function: `stage_to_dir`
 
-[Source](../dagrunner/utils/__init__.py#L682)
+[Source](../../dagrunner/utils/__init__.py#L699)
 
 ### Call Signature:
 
@@ -558,7 +568,7 @@ collision with identically names files.
 
 ## function: `subset_equality`
 
-[Source](../dagrunner/utils/__init__.py#L25)
+[Source](../../dagrunner/utils/__init__.py#L42)
 
 ### Call Signature:
 
diff --git a/docs/dagrunner.utils.networkx.md b/docs/_build/dagrunner.utils.networkx.md
similarity index 95%
rename from docs/dagrunner.utils.networkx.md
rename to docs/_build/dagrunner.utils.networkx.md
index 6d8d40f..3d511b0 100644
--- a/docs/dagrunner.utils.networkx.md
+++ b/docs/_build/dagrunner.utils.networkx.md
@@ -1,6 +1,6 @@
 # module: `dagrunner.utils.networkx`
 
-[Source](../dagrunner/utils/networkx.py#L0)
+[Source](../../dagrunner/utils/networkx.py#L0)
 
 see [function: dagrunner.utils.as_iterable](dagrunner.utils.md#function-as_iterable)
 
@@ -10,7 +10,7 @@ see [module: dagrunner.utils.visualisation](dagrunner.utils.visualisation.md#mod
 
 ## function: `collapse_graph`
 
-[Source](../dagrunner/utils/networkx.py#L112)
+[Source](../../dagrunner/utils/networkx.py#L112)
 
 ### Call Signature:
 
@@ -59,7 +59,7 @@ Notes:
 
 ## function: `get_subset_with_dependencies`
 
-[Source](../dagrunner/utils/networkx.py#L50)
+[Source](../../dagrunner/utils/networkx.py#L50)
 
 ### Call Signature:
 
@@ -80,7 +80,7 @@ Args:
 
 ## function: `visualise_graph`
 
-[Source](../dagrunner/utils/networkx.py#L224)
+[Source](../../dagrunner/utils/networkx.py#L231)
 
 ### Call Signature:
 
diff --git a/docs/dagrunner.utils.visualisation.md b/docs/_build/dagrunner.utils.visualisation.md
similarity index 79%
rename from docs/dagrunner.utils.visualisation.md
rename to docs/_build/dagrunner.utils.visualisation.md
index 0d5a8a3..9687226 100644
--- a/docs/dagrunner.utils.visualisation.md
+++ b/docs/_build/dagrunner.utils.visualisation.md
@@ -1,6 +1,6 @@
 # module: `dagrunner.utils.visualisation`
 
-[Source](../dagrunner/utils/visualisation.py#L0)
+[Source](../../dagrunner/utils/visualisation.py#L0)
 
 Module responsible for scheduler independent graph visualisation
 
@@ -10,7 +10,7 @@ see [function: dagrunner.utils.in_notebook](dagrunner.utils.md#function-in_noteb
 
 ## class: `HTMLTable`
 
-[Source](../dagrunner/utils/visualisation.py#L44)
+[Source](../../dagrunner/utils/visualisation.py#L45)
 
 ### Call Signature:
 
@@ -20,7 +20,7 @@ HTMLTable(column_names)
 
 ### function: `__init__`
 
-[Source](../dagrunner/utils/visualisation.py#L53)
+[Source](../../dagrunner/utils/visualisation.py#L54)
 
 #### Call Signature:
 
@@ -32,7 +32,7 @@ Initialize self.  See help(type(self)) for accurate signature.
 
 ### function: `__str__`
 
-[Source](../dagrunner/utils/visualisation.py#L72)
+[Source](../../dagrunner/utils/visualisation.py#L73)
 
 #### Call Signature:
 
@@ -44,7 +44,7 @@ Return str(self).
 
 ### function: `add_row`
 
-[Source](../dagrunner/utils/visualisation.py#L62)
+[Source](../../dagrunner/utils/visualisation.py#L63)
 
 #### Call Signature:
 
@@ -58,7 +58,7 @@ add_row(self, *args, id=None)
 
 ## class: `MermaidGraph`
 
-[Source](../dagrunner/utils/visualisation.py#L78)
+[Source](../../dagrunner/utils/visualisation.py#L79)
 
 ### Call Signature:
 
@@ -68,7 +68,7 @@ MermaidGraph(title=None)
 
 ### function: `__init__`
 
-[Source](../dagrunner/utils/visualisation.py#L85)
+[Source](../../dagrunner/utils/visualisation.py#L86)
 
 #### Call Signature:
 
@@ -80,7 +80,7 @@ Initialize self.  See help(type(self)) for accurate signature.
 
 ### function: `__str__`
 
-[Source](../dagrunner/utils/visualisation.py#L109)
+[Source](../../dagrunner/utils/visualisation.py#L110)
 
 #### Call Signature:
 
@@ -92,7 +92,7 @@ Return str(self).
 
 ### function: `add_connection`
 
-[Source](../dagrunner/utils/visualisation.py#L106)
+[Source](../../dagrunner/utils/visualisation.py#L107)
 
 #### Call Signature:
 
@@ -102,7 +102,7 @@ add_connection(self, id1, id2)
 
 ### function: `add_node`
 
-[Source](../dagrunner/utils/visualisation.py#L92)
+[Source](../../dagrunner/utils/visualisation.py#L93)
 
 #### Call Signature:
 
@@ -112,7 +112,7 @@ add_node(self, nodeid, label=None, tooltip=None, url=None)
 
 ### function: `add_raw`
 
-[Source](../dagrunner/utils/visualisation.py#L89)
+[Source](../../dagrunner/utils/visualisation.py#L90)
 
 #### Call Signature:
 
@@ -122,7 +122,7 @@ add_raw(self, raw)
 
 ### function: `base64`
 
-[Source](../dagrunner/utils/visualisation.py#L112)
+[Source](../../dagrunner/utils/visualisation.py#L113)
 
 #### Call Signature:
 
@@ -132,7 +132,7 @@ base64(self)
 
 ### function: `display`
 
-[Source](../dagrunner/utils/visualisation.py#L130)
+[Source](../../dagrunner/utils/visualisation.py#L131)
 
 #### Call Signature:
 
@@ -142,7 +142,7 @@ display(self, output_filepath: str = None)
 
 ## class: `MermaidHTML`
 
-[Source](../dagrunner/utils/visualisation.py#L156)
+[Source](../../dagrunner/utils/visualisation.py#L157)
 
 ### Call Signature:
 
@@ -152,7 +152,7 @@ MermaidHTML(mermaid, table=None)
 
 ### function: `__init__`
 
-[Source](../dagrunner/utils/visualisation.py#L179)
+[Source](../../dagrunner/utils/visualisation.py#L180)
 
 #### Call Signature:
 
@@ -164,7 +164,7 @@ Initialize self.  See help(type(self)) for accurate signature.
 
 ### function: `__str__`
 
-[Source](../dagrunner/utils/visualisation.py#L182)
+[Source](../../dagrunner/utils/visualisation.py#L183)
 
 #### Call Signature:
 
@@ -176,7 +176,7 @@ Return str(self).
 
 ### function: `save`
 
-[Source](../dagrunner/utils/visualisation.py#L189)
+[Source](../../dagrunner/utils/visualisation.py#L190)
 
 #### Call Signature:
 
@@ -188,7 +188,7 @@ save(self, output_filepath)
 
 ## function: `visualise_graph_matplotlib`
 
-[Source](../dagrunner/utils/visualisation.py#L197)
+[Source](../../dagrunner/utils/visualisation.py#L198)
 
 ### Call Signature:
 
@@ -209,7 +209,7 @@ Args:
 
 ## function: `visualise_graph_mermaid`
 
-[Source](../dagrunner/utils/visualisation.py#L341)
+[Source](../../dagrunner/utils/visualisation.py#L342)
 
 ### Call Signature:
 
diff --git a/docs/dagrunner_index.md b/docs/_build/dagrunner_index.md
similarity index 98%
rename from docs/dagrunner_index.md
rename to docs/_build/dagrunner_index.md
index 34296f0..b43fba3 100644
--- a/docs/dagrunner_index.md
+++ b/docs/_build/dagrunner_index.md
@@ -46,6 +46,7 @@ version: {module.__version__}
       - [function: docstring_parse](dagrunner.utils.md#function-docstring_parse)
       - [function: function_to_argparse](dagrunner.utils.md#function-function_to_argparse)
       - [function: function_to_argparse_parse_args](dagrunner.utils.md#function-function_to_argparse_parse_args)
+      - [function: get_object_dot_module_path](dagrunner.utils.md#function-get_object_dot_module_path)
       - [function: get_proc_mem_stat](dagrunner.utils.md#function-get_proc_mem_stat)
       - [function: get_sys_mem_stat](dagrunner.utils.md#function-get_sys_mem_stat)
       - [function: in_notebook](dagrunner.utils.md#function-in_notebook)
diff --git a/docs/dagrunner.runner.schedulers.base.md b/docs/dagrunner.runner.schedulers.base.md
deleted file mode 100644
index 0c71b3e..0000000
--- a/docs/dagrunner.runner.schedulers.base.md
+++ /dev/null
@@ -1,4 +0,0 @@
-# module: `dagrunner.runner.schedulers.base`
-
-[Source](../dagrunner/runner/schedulers/base.py#L0)
-
diff --git a/docs/gen_docs b/docs/gen_docs
index 17f8530..5b09454 100755
--- a/docs/gen_docs
+++ b/docs/gen_docs
@@ -1,16 +1,45 @@
 #!/usr/bin/env python3
 """
-Generate reference documentation for a Python module.
+Generate markdown reference documentation for a Python package
 
 Example usage:
-    python generate_docs.py my_module /path/to/docs
+    gen_docs python.module.path /path/to/output
+
+Each module will be converted into a markdown file, and an index file will be
+generated for the package.
+`<package-name>.<module-name>` will be written to `<package-name>.<module-name>.md`,
+and the index file `<package-name>_index.md` will be extended to include a link to
+this module and its contents.
+
+Note that markdown syntax is supported in docstrings, taken without modification.
+This means that anything supported by your markdown renderer (e.g. vscode and GitHub)
+will be supported in docstrings, including links to other documentation, images,
+tables and other markdown features.
+
+Example usage:
+
+```
+def function(args1, keywarg1=default1):
+    \"""
+    Dummy function to demonstrate markdown docstrings.
+
+    Args:
+    - `args1` (str):
+      Some positional argument.
+    - `keywarg1` (int, optional):
+      Some keyword argument with a default value.
+
+    \"""
+    ...
+```
+
 """
 
+import argparse
 import importlib
 import importlib.util
 import inspect
 import os
-import sys
 
 
 def gen_source_link(obj, target_root):
@@ -281,6 +310,16 @@ def generate_markdown_recursive(module_dot_path, target_root):
 
 
 if __name__ == "__main__":
-    module_path = sys.argv[1]
-    target_root = os.path.abspath(sys.argv[2])
-    generate_markdown_recursive(module_path, target_root)
+    parser = argparse.ArgumentParser(
+        description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter
+    )
+    parser.add_argument(
+        "pymodule_path", help="Python module path, which must be on the PYTHONPATH"
+    )
+    parser.add_argument(
+        "target_root", help="Target root directory for generated markdown"
+    )
+    args = parser.parse_args()
+    pymodule_path = args.pymodule_path
+    target_root = os.path.abspath(args.target_root)
+    generate_markdown_recursive(pymodule_path, target_root)