On 8 Jun 2007, at 13:04, Andy Armstrong wrote: [snip]
I can see the benefits of keeping a method and its documentation adjacent. Intuition would would pull me in that direction - but practice pulls me in the other direction. When I have my documentation head on I just want to see documentation.
[snip]
Something I find trez useful when writing pod is this little script http://www.perlmonks.org/index.pl?node_id=227856(my local version has been hacked a bit since, but I imagine this still works)