in reply to Re^2: Python OO v Moose
in thread Python OO v Moose
I used to intersperse my pod and code, but eventually grew to dislike that, so now place all my pod at the end of the file.
Yes, there's something to be said for keeping documentation and code close together, but having them in the same file is close enough for me. Putting all the pod at the end I think encourages me to write documentation that flows better as a document - making the pod less a list of methods, and more a how-to.