Add deprecation advice to developer guide.

Did you define your audience before you started writing?? :stuck_out_tongue_winking_eye: So, this document lives in the developers' guide, which to me says that the primary group of readers will at least have a concept of the existence of an API and an idea of what it means and refers to, so you could still get away with it!