From 9f24d45f252ca0ed6f55a7b92ff36fed7a222602 Mon Sep 17 00:00:00 2001
From: Jamie Hardt <jamiehardt@me.com>
Date: Sat, 19 Nov 2022 19:02:47 -0800
Subject: [PATCH] Documentation

---
 docs/source/dev/theory.rst | 22 ++++++++++++++++++++++
 docs/source/index.rst      |  1 +
 2 files changed, 23 insertions(+)
 create mode 100644 docs/source/dev/theory.rst

diff --git a/docs/source/dev/theory.rst b/docs/source/dev/theory.rst
new file mode 100644
index 0000000..23bc8f2
--- /dev/null
+++ b/docs/source/dev/theory.rst
@@ -0,0 +1,22 @@
+Theory of Operation
+===================
+
+Execution Flow When Producing "doc" Output
+------------------------------------------
+
+#. The command line argv is read in `__main__.main()`, 
+   which calls `commands.convert()`
+#. `commands.convert()` reads the input with `docparser.doc_parser_visitor()`,
+   which uses the `parsimonious` library to parse the input into an abstract
+   syntax tree, which the parser visitor uses to convert into a 
+   `docparser.doc_entity.SessionDescriptor`, which structures all of the data
+   in the session output.
+#. The next action based on the output format. In the 
+   case of the "doc" output format, it runs some validations
+   on the input, and calls `commands.generate_documents()`.
+#. `commands.generate_documents()` creates the output folder, creates the
+   Continuity report with `pdf.continuity.output_continuity()` (this document 
+   requires some special-casing), and at the tail calls...
+#. `commands.create_adr_reports()`, which creates folders for 
+
+(FIXME finish this)
\ No newline at end of file
diff --git a/docs/source/index.rst b/docs/source/index.rst
index 7e82b01..38ddacb 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -26,6 +26,7 @@ exports into JSON documents for processing by other applications.
    :caption: Developer Documentation
 
    dev/contributing
+   dev/theory
    dev/parsing
    dev/modules