Add deprecation advice to developer guide.
Review changes
Merge pull request #1456 from rhattersley/deprecation-docs

Add deprecation advice to developer guide.