Add deprecation advice to developer guide.

The bullet list in the section "Changing defaults" has an introduction sentence followed by a ':'. It would be nice if there was similar here (in fact, reading the rst that's here I completely missed there was a bullet list at all!)