Fix some documentation markup and refer to readthedocs from the README.