in reply to On providing documentation with your modules
Perhaps you could write a tutorial that explains and writes out example code, as does SDL::Tutorial.