Update index.rst
Clean up test for version number

A new function is implemented to cleanly extract the version field from the
README.rst field list.
Improve code clarity
Fix docstring