Add deprecation advice to developer guide.

I think we need to "avoid **using** the deprecated API".