rearrange model definition, no real change
add some real documentation
fix typos in README markdown
update license info
fix name in licensing information
version bump to 1.0.0
add pypi install instructions to README
drop TODO