Add doucmentation for executors

docs/source/executors/executors.rst

@@ -0,0 +1,42 @@
+.. _ref_executors:
+=========
+Executors
+=========
+
+All executors can be loaded using YAML tags using the (`!Tag`) syntax. More details are available in the
+`PyYAML documentation`_
+
+.. _PyYAML documentation: https://pyyaml.org/wiki/PyYAMLDocumentation
+
+Shell Executor
+--------------
+
+The shell executor is used to execute shell commands asynchronously.
+
+Example configuration
+~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: yaml
+
+  !ShellExecutor
+
+SSH Executor
+------------
+
+The ssh executor is used to asynchronously execute shell commands remotely via ssh. All parameters specified in the
+configuration are directly passed as keyword arguments to `asyncssh` `connect` call. You can find all available
+parameters in the `asyncssh documentation`_
+
+.. _asyncssh documentation: https://asyncssh.readthedocs.io/en/latest/api.html#connect
+
+Example configuration
+~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: yaml
+
+  !SSHExecutor
+    host: login.dorie.somewherein.de
+    username: clown
+    client_keys:
+      - /opt/tardis/ssh/tardis
+

docs/source/index.rst

@@ -12,6 +12,7 @@ Welcome to the TARDIS documentation!
 
    adapters/batchsystem
    adapters/site
+   executors/executors
    plugins/plugins
    contribute/contribute
    Module Index <api/modules>