Instead of having the considerations and best practices that should be used when developing with this library scattered across a few different links and pages combine these together into a single section in the developer documentation. As a side-effect of this change remove the documenation about the utils to use and not use and just refer those to use the modules, classes and APIs described in these documents. Change-Id: I20e1405cb6ecb654baa29812b98ada7bdc393f6c
1.7 KiB
1.7 KiB
TaskFlow
TaskFlow is a Python library for OpenStack that helps make task execution easy, consistent, and reliable.
Note
Additional documentation is also hosted on wiki: https://wiki.openstack.org/wiki/TaskFlow
Contents
atoms arguments_and_results inputs_and_outputs
patterns engines notifications persistence resumption
jobs conductors
workers
Considerations
Things to consider before (and during) development and integration with TaskFlow into your project:
- Read over the paradigm
shifts and engage the team in IRC (or
via the openstack-dev
mailing list) if these need more explanation (prefix
[TaskFlow]to your emails subject to get an even faster response). - Follow (or at least attempt to follow) some of the established best practices (feel free to add your own suggested best practices).
Warning
External usage of internal helpers and other internal utility functions and modules should be kept to a minimum as these may be altered, refactored or moved without notice. If you are unsure whether to use a function, class, or module, please ask (see above).
Miscellaneous
exceptions states examples
Indices and tables
genindexmodindexsearch