Doug Hellmann af25ae6e07 remove sphinx-isms from README.rst and clean up docs
The :doc: role is only known to Sphinx, so when we publish the
README.rst to PyPI and include that role it causes the content to not
render as proper HTML.

This patch removes some of the content from the readme and moves it to
the main index page for the documentation. It then removes the
readme.rst file from the doc build because we don't need to include
the same content multiple times.

Change-Id: Ic46c7a9d8e91f01b5e6cef5d377a56856b586c70
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2018-04-12 21:18:39 +00:00

1.4 KiB

python-storyboardclient

This is the StoryBoard python client! It lets you interact with StoryBoard from the comfort of your own terminal! There is no command to run this; instead you can import it into scripts. This lets you perform complex actions on things in StoryBoard, eg: add an helpful comment on all stories with 'cannot store contact information' in the description, pointing users at the relevant docs, but only if there is no comment to this effect already. (There is an example of such a script in usage)

Some sample commands are given in usage. In general, most resources (ie: stories, tasks, projects, and so on) have a get_all() and get() method. The latter takes the resource's id as a parameter, thought it can also take other attributes (eg: tag name).

To create a new resource, use the create() method. The necessary parameters depend on the resource, and if not documented, can be worked out from the relevant .py file in the code for the StoryBoard API.

The update() method will update mutable fields of the resource (again, these vary depending on the resource).

Finally, delete() will delete things.

Happy task-tracking!

Contents:

installation usage contributing

Indices and tables

  • genindex
  • search