Updated README and added new Choices test.

* Updated README file to use MarkDown syntax and include examples of the
  available methods.
* Added one more test to test_choices.py