docs: clarify rewriting