in reply to writing docs and publishing on cpan

The easiest way to create a module for distribution on CPAN is probably to use Module::Starter. It will create the necessary standard components a module distribution needs: Install Module::Starter, then type 
module-starter --module Ping::Pong::Pang

[download]
on the command line, and it will create a new subdirectory named Ping-Pong-Pang with all the necessary files in it.

Do also take the time to read what other module writers have done. Create a test suite, and get your PAUSE account. Good luck.

--
Andreas

In Section Seekers of Perl Wisdom