You already got good comments, just want to mention it's a semi-common practice to have a .pod file companion where the documentation goes. Usually this is for modules, though, .pm files. So MyStufs.pm would have the code and MyStufs.pod, or even something like MyStufs/Manual.pod, the documentation.