Improve example documentation and some code documentation.

* models/messages.py: Mention "Abstain" option for radio buttons.

* modules/ballot.py (ballot2form): Document `readonly` parameter.