move python documentation script into separate file
yet more README tweaks
add CONTRIBUTING.md