let's put this before the option.

And it shouldn't be a version added, it's a bit strange to see "New in 2.5: The ... has been deprecated". Use a caution directive (`.. caution::`) instead. Also note that in that directive, there should be an empty line between the start and the content.

At last, the single backticks should be double backticks.