storyboard/doc/source/index.rst
Michael Krotscheck 65c2c4418c Plugins may now register cron workers.
This adds a crontab plugin hook to StoryBoard, allowing a plugin
developer to run periodic events. Example use cases include:
- Summary emails.
- Periodic report generation.
- Synchronization check points.

Plugins are expected to provide their own execution interval and
configuration indicator. The management of cron workers is
implemented as its own cron plugin as a sample, and unit tests
for all components are provided.

Change-Id: I3aa466e183f1faede9493123510ee11feb55e7aa
2014-12-17 13:20:54 -08:00

75 lines
1.5 KiB
ReStructuredText

======================================
Welcome to Storyboard's documentation!
======================================
Introduction
============
StoryBoard is a web application for task tracking across inter-related projects.
It is meant to be suitable for OpenStack task tracking.
StoryBoard consists of two components:
* `Storyboard API service`_ - is a Python application leveraging
`Pecan`_/`WSME`_ for REST API layer
* `Storyboard Web Client`_ - is an all-javascript webclient for the
Storyboard API
.. _Pecan: http://pecan.readthedocs.org/en/latest/
.. _WSME: http://wsme.readthedocs.org/en/latest/
.. _Storyboard API service: https://git.openstack.org/cgit/openstack-infra/storyboard/
.. _Storyboard Web Client: https://git.openstack.org/cgit/openstack-infra/storyboard-webclient
This documentation offers information on how Storyboard works and how to
contribute to the project.
Table of contents
=================
Installation guides
-------------------
.. toctree::
:maxdepth: 1
install/manual
install/development
Developer docs
--------------
.. toctree::
:maxdepth: 1
contributing
webclient
Extending StoryBoard
--------------------
.. toctree::
:maxdepth: 1
Overview <extending/index>
Plugins: Cron Workers <extending/plugin_cron>
Client API Reference
--------------------
.. toctree::
:maxdepth: 1
webapi/v1
Indices and tables
==================
* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`