Add deprecation advice to developer guide.

Could this be in a `.. note::` directive instead? Given that it is a _note_, it does seem appropriate...