diff --git a/doc/source/conductors.rst b/doc/source/conductors.rst index a819c8a0..efd9bf7e 100644 --- a/doc/source/conductors.rst +++ b/doc/source/conductors.rst @@ -2,6 +2,10 @@ Conductors ---------- +.. image:: img/conductor.png + :width: 97px + :alt: Conductor + Overview ======== @@ -18,14 +22,14 @@ They are responsible for the following: tasks and flows to be executed). * Dispatching the engine using the provided :doc:`persistence ` layer and engine configuration. -* Completing or abandoning the claimed job (depending on dispatching and - execution outcome). +* Completing or abandoning the claimed :doc:`job ` (depending on + dispatching and execution outcome). * *Rinse and repeat*. .. note:: They are inspired by and have similar responsibilities - as `railroad conductors`_. + as `railroad conductors`_ or `musical conductors`_. Considerations ============== @@ -76,4 +80,5 @@ Hierarchy taskflow.conductors.backends.impl_blocking :parts: 1 +.. _musical conductors: http://en.wikipedia.org/wiki/Conducting .. _railroad conductors: http://en.wikipedia.org/wiki/Conductor_%28transportation%29 diff --git a/doc/source/img/conductor.png b/doc/source/img/conductor.png new file mode 100644 index 00000000..98178c08 Binary files /dev/null and b/doc/source/img/conductor.png differ