After falling in love with Pod::Weaver, I've released two new Pod::Weaver plugins which you may find useful for assembling boilerplate POD sections in your distributions.
The first is Pod::Weaver::Section::Extends which will add a
=head1 EXTENDS section with a list of everything in your
@ISA at compile-time. It should work with any kind of object that modifies
@ISA in a normal way.
The second is Pod::Weaver::Section::Consumes, which does the same thing for Moose roles. It will interrogate any Moose-compatible
meta object for your class to find a list of roles.