I tend to write documentation where Module::Starter puts its boilerplate - within the code. I don't find this inconvenient, since I use Vim to fold POD. I'd put it in the end if I wasn't able to do this.
Comment on Re: POD using __END__ with function comments
OK, I think I see the issue. I'm expecting everything to be rosy when I'm reading this via less, or without editor help.
So then the question becomes "suppose you didn't have 'POD folding' in an editor and wanted to put the method descriptions at the end. Are there any perl tools that automatically help to keep the end METHOD section synchronized?"