def deprecation_in_wrong_order(self):
This docstring has the deprecation warning in the wrong order.

This is the extended summary. The correct order should be
summary, deprecation warning, extended summary.

.. deprecated:: 1.0
    This should generate an error as it needs to go before
    extended summary.