|Subject:||Test::Harness::Straps publicly documents private methods.|
The documentation of Test::Harness::Straps is mostly that of private methods with no indication that they are private other than the leading _. These methods should not be seen in public documentation, people will use them and then complain when they change out from under them. Each piece of private documentation should be internally wrapped in a =begin private / =end private set of POD tags so it is not displayed without special POD formatting options. At minimum there should be a note explaining the _foo convention and the perils of using private methods.