Enhance Option class documentation

Some awkward wording in the docstrings was fixed up.

The summary of render_text() was also made a little bit clearer.