Add notes about deprecated APIs, with links to milestones.
Merge pull request #59 from kwalrath/deprecation

Add notes about deprecated APIs, with links to milestones.