update docs to reflect newest rule changes