1. I don't know where SDL::Tutorial is or how it looks and if certain parts of it are marked as =for code or something. And the links to the SDL site dont help. There is a tutorial there written in PHP.
2. I personally just create a directory of working code and inline it into POD via Text::Template. The DBIx::Recordset::Playground distribution contains about 20 examples and I inline them using a couple of Text::Template macros I wrote. If people want working code, they just cd to the directory where the code is and run it!

PApp::SQL and CGI::Application rock the house