some more work on states and the rules doc