docs update; small rules fix