Improve the documentation of the various packaging layouts

[wilkinsona]

In particular, documentation for the module layout appears to be completely missing (other than Javadoc).

[snicoll]

If we're going to do that in the reference guide, we should have a link of some kind in the maven plugin site as well.