DOC: List pydoc as another doc possibility in README

...and minor style change, to improve appearance in plaintext
(non-reST) viewers.