The Perl Phalanx Project - What is Kwalitee?
Measuring quality is hard, and so we coined the term Kwalitee which is measurable (but inexact quality), so we can know it when we see it.
If there is any difference between the docs, the code and the tests, it is a bug. Period. The bug might be in the docs or the tests, and the code is fine, but it's still a bug.
If there is ambiguity about how the code is supposed to work, it is a bug. The documentation must be clarified, and the code may be out of sync as well.
If a hoplite discovers something behaving "incorrectly", according to the hoplite, it may or may not be a bug, according to the author's intent.
is( unlink( $filename ), 1, "Remove $filename" ); ok( !-e $filename, "Actually gone" );