in reply to Re^2: Some clarification where pod files should reside in a distro
in thread Some clarification where pod files should reside in a distro

I didnt really clarify because I guess its something one could go on talking about forever if sufficiently interested.

I don't exclusively put POD in modules. I also do like you say. I use POD in the docs/ directory... put it in html comments... all over the place.

But for the developer documentation, my rule is that the POD for a given method goes directly above that method. I've developed this convention because I use Catalyst a lot and it generates POD when you make a stub controller.

regards,

  • Comment on Re^3: Some clarification where pod files should reside in a distro

In Section Seekers of Perl Wisdom