DOC: Add gotcha about flake8-ing diff
The `flake8`-ing the diff will not catch any import style errors.  I put an alternative check that is more comprehensive but will take longer to run since you will be checking entire files instead of the diff.
