docs and stuff

this updates the README and changelog to document the changes from #4.  Also added a decorator that we can use to ease forward compatibility of the finisher deprecation cc @danielhfrank @jehiah