Merge pull request #1 from jhoblitt/docs-change

add README section on API deprecations since version 1.0.0