update README with more information on how the rewrite works