preparing the ground for rewrites
docs