[Documentation] Add technical concepts and Mermaid diagrams to documentation

.ci_support/environment-docs.yml

@@ -9,6 +9,7 @@ dependencies:
 - numpy
 - openmpi
 - sphinx
+- sphinxcontrib-mermaid
 - sphinx_rtd_theme
 - cloudpickle =3.1.2
 - h5py =3.16.0

.readthedocs.yml

@@ -15,7 +15,6 @@ build:
       - pip install . --no-deps --no-build-isolation
       - "cp README.md docs"
       - "cp notebooks/*.ipynb docs"
-      - "cp -r notebooks/images docs"
       - "jupyter-book config sphinx docs/"
 
 # Build documentation in the docs/ directory with Sphinx

README.md

@@ -160,6 +160,7 @@ as hierarchical job scheduler within the allocations.
   * [License](https://executorlib.readthedocs.io/en/latest/5-developer.html#license)
   * [Modules](https://executorlib.readthedocs.io/en/latest/5-developer.html#modules)
   * [Interface Class Hierarchy](https://executorlib.readthedocs.io/en/latest/5-developer.html#interface-class-hierarchy)
+  * [Execution Flow](https://executorlib.readthedocs.io/en/latest/5-developer.html#execution-flow)
   * [Test Environment](https://executorlib.readthedocs.io/en/latest/5-developer.html#test-environment)
   * [Communication](https://executorlib.readthedocs.io/en/latest/5-developer.html#communication)
   * [External Libraries](https://executorlib.readthedocs.io/en/latest/5-developer.html#external-libraries)

docs/_config.yml

@@ -15,6 +15,7 @@ launch_buttons:
 
 sphinx:
   extra_extensions:
+  - 'sphinxcontrib.mermaid'
   - 'sphinx.ext.autodoc'
   - 'sphinx.ext.napoleon'
   - 'sphinx.ext.viewcode'