e46df0c464
I have attempted to make the doc more clear about the differences between the different kinds of refactors. I have also attempted to capture some of the conditions under which I think it's reasonable for refactors to introduce diagnostics. Let me know if it needs more work. Change-Id: I2307f9e5eb9d3c0daa0b584dcde65b2c3d652f81 Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/491342 Commit-Queue: Brian Wilkerson <brianwilkerson@google.com> Reviewed-by: Samuel Rawlins <srawlins@google.com>