diff --git a/doc/source/img/engine_states.txt b/doc/source/img/engine_states.txt
new file mode 100644
index 00000000..3b33255e
--- /dev/null
+++ b/doc/source/img/engine_states.txt
@@ -0,0 +1,13 @@
+# Created using web sequence diagrams.
+#
+# https://www.websequencediagrams.com/
+
+note over RESUMING
+Running starts here
+end note
+
+RESUMING->SCHEDULING: Resumes and \nschedules initial tasks.
+SCHEDULING->WAITING: Waits for any \nfuture<task> to complete.
+WAITING->WAITING: Continue waiting for \nfuture<task> to complete.
+WAITING->ANALYZING: Analyze future<task> results.
+ANALYZING->SCHEDULING: Schedules next set of tasks.