Thomas Klausner wrote:
The one advantage of dedicated examples for me is that I can take that example file (mostly downloaded from search.cpan.org), run it, modifiy it, run it etc.
Cutting and pasting from the docs works as well, no network required. And its going to be the example for the right version (ie. the one you have installed, not the latest on CPAN).
This hardly works with code embedded in the docs, as this code tends to be overly verbose (eg no 'use strict' etc).
That's spurious. The quality of the code has nothing to do with whether its in a file or a POD document. In fact, with Test::Inline I can test my example code in the POD.