NO! In the last few years, the reference perldocs have been littered with more and more examples and tutorials. Don't. I like references. Perl comes with tutorial perldocs too, if there has to be an example, put it there. I hate the form the core perldocs have taken these days.