Add deprecation advice to developer guide.

OK, I'll stick to my guns. Yes - they should know what "API" means. Otherwise they shouldn't be messing around trying to deprecate things!