Add deprecation advice to developer guide.

If this approach to deprecation has only just been introduced, is it still the "normal" way? You could instead refer to it as something like:

 > the same way as introduced in :ref:\`removing-a-public-api\`