====================
Workflow Development
====================

Workflows are our way of orchestrating work in the lab. They are written in Artificial's :doc:`Orchestration Python <orchestration_python>` (OP), a strict subset of the `Python <https://www.python.org/>`_ programming language. They take advantage of the `Workflow Libraries <Workflow SDK Reference>`_, which are built into the system and provide functionality specific to lab automation.

.. toctree::
   :maxdepth: 1

   tutorial
   op_messages
   op_assistant_return_val
   workflow_parameter_types
   op_adapter_actions
   op_spanlocks
   op_configs
   op_spawning_jobs
   workflow_debugging
   workflow_deployment
   workflow_publishing
   orchestration_python

.. toctree::


.. actor references
.. TODO: Talk about action and assistant stubs: what they're for and how to generate them.

Workflow SDK Reference
----------------------

The Workflows SDK is provided by 3 libraries, for which reference documentation is available:

* :doc:`workflows_decorators`
* :doc:`workflows_runtime`
* :doc:`workflows_util`