document rule updates
v2.7