marked deprecated checkers with :deprecated metadata; also added 'use xyz instead' to 2 out of 4 docs.
marked deprecated checkers with :deprecated metadata; also added 'use xyz instead' to 2 out of 4 docs.

yfractal/Midje,aeriksson/Midje,bens/Midje,marick/Midje