some docs for tests
look up while comments in code quality test and ignore empty blocks
more documentation where blackbox tests gave a warning