Themes that implement their own comment-wrapper.tpl.php need special instructions

Themes such as Adaptivetheme, Zen, Genesis, Fusion and others that come with their own comment-wrapper.tpl.php file won't work out of the box and need to use either the template from the module or remove their own comment-wrapper.tpl.php file or fold in the differences (replace print $content with the relevant changes).

I think you have based your template on Zens implementation which should be documented also, since not all themes will print $classes, for example of the above themes only Adaptivetheme and Zen do, while Fusion prints its $skinr class directly in the template, so that needs to be accounted for.

This should all be documented as it is generating confusion and issues such as #619012: Comments bonus API comment-wrapper.tpl.php file overridden by Adaptivetheme comment-wrapper.tpl.php