fixed docs to explain new api.  version bump 1.0.0.