Add deprecation advice to developer guide.

The removed public API suddenly becomes "the deprecated API". It would be nice to explicitly connect this expression to the "deprecation [that] occurs when you need to remove a public API". I thought this might not be a huge thing but having taken a look at the built docs it feels like the link could do with being made still...