Add deprecation advice to developer guide.

Hmm I checked dictionary.com for the lack of "short" as a synonym for "brief". Thanks for pointing that out @QuLogic