clarify some of the rule documentation