well, i've had a few ideas ... but nothing particularly immediately applicable.

the strength i've seen with some of the PHP documentation is the ability to make associations between files/ modules. granted, it's just a special comment that's parsed, but it would be *very* helpful to be able to generate some of those programmatically.

the other 'weakness' i can see ... is somewhat related. for better or worse, perl uses the *nix mentality of building individual tools for individual jobs. the programmer is the one left to document the work (and rightfully so), *but* many of the dependencies, called and calling functions, etc get embedded in the developer's head, and don't always make it out into the doc.

while perldoc can be invaluable, for some it may be seen as and 'advanced topic'. i went looking for a 'cheat sheet' for POD commands a while back (when i asked a vaguely similar question) and was at a loss to find one. then i got sucked back into bug fixing, and never made the time to go back and find one.