You should use sphinx directives here, in case we ever autodoc this. See [django-browserid's docstrings](https://github.com/mozilla/django-browserid/blob/master/django_browserid/base.py#L114) for some examples.