move version generation to _version.py

try to generate VERSION with post-commit before throwing an error.
simplifies grabbing the version number for install and docs
DOC: reduce overlap between docs and readme
DOC: update installation instructions
remove unused os import for init
add status message to docs