Add deprecation advice to developer guide.

Are you happy with the implicit assumption that your audience will be comfortable with the definition and meaning of the abbreviation API?