Example programs and the Cookbook approach
Gabor Szabo wrote an post about Supplying examples with CPAN modules which struck me as a really good idea.
Spreadsheet::WriteExcel includes over 70 example programs so I put together a program that could be called from the makefile to build a Pod document of the examples.
Example programs are invaluable. They act as a first line of defense against frequently asked questions and they also help people who prefer a "Cookbook" approach to learning a new API or language.