add README section on API deprecations since version 1.0.0