fix the rule again, update docs, and prepare for next release