Documentation

[Holiverh]

There is okayish docstring coverage but it could be much better.

Sphinx is the way to go. Perhaps take a look at hooking it up to readthedocs as well. Ideally the documentation should cover everything with a few examples of intended usage patterns.

[Holiverh]

Well, there's the beginnings of documentation now.

http://python-valve.readthedocs.org/