Agree, that would be nice. 

Lots of effort to maintain the deprecated APIs. Since we are not even version 1.0 yet, may I suggest that we put the release notes to tell client to use new APIs.