Add deprecation advice to developer guide.

Your section headings aren't consistent - they're varying between the singular and the plural...