proposed 1.0 release

more docs, added contributors list, incorporated #10, lots of style tweaks including extracting anonymous callbacks, started a test suite (needs work!)

1.0, because semver <0 sucks and we need to escape.