in reply to POD conventions
For what it's worth, I personally find POD interspersed within the code to be too distracting (e.g. to see the previous subroutine I have to scroll past all of the POD). Instead I prefer it when the POD is placed at the end of the file.