Contributing doc WIP
Neaten up contributing.md
Update to new 1.0 API, with output and container options
Improve readme intro
Bump package and description to 1.0.0