Class::MakeMethods is an extremely useful module that is probably too often overlooked by traditional Perl hackers who typically prefer to roll-their-own. It has saved me hours of coding the same old cut-and-paste pieces in each class I write.
However, when reading the documentation it is very difficult to see the power of the module, since is spread out over a number of pages, difficult to understand, and poorly written in some places. I am certain that this will make many potential users just pass it over for something easier to understand. It definitely gives the perception that the module is much more difficult to use than it really is. I hope that the author will invest some serious time in improving the organization and readability of the documentation. I am willing to help if necessary, and I am sure many others are too.