update reversion doc

Mention the new settings option. Add warning about potential issues.