Add deprecation advice to developer guide.

I think this sentence needs to be tied more strongly to the concept of including more detail in the docstring. How about:

> Feel free to include more detail on the change **in the updated docstring** than in...