more documentation on the new test and pyflakes on file I touched