You should enclose your code in "code" tags. This allows us to easily use the "download" link to copy-n-paste your code. It also prevents your code from being mangled: [$i] was linkified. Please edit your post.
You should enclose long code segments in "readmore" tags.
I find it difficult to follow because you seem to have interspersed rendered POD with code snippets. Or is the code part of the rendered POD? It would be easier to follow if you posted actual POD (=head1, etc.). What are the "...." for? If you post actual POD, we can run podchecker and see how it renders for us.
I ran spell checker: exeriments, persistance, sharded, thier
Snippets of code should be wrapped in
<code> tags not<pre> tags. In fact, <pre>
tags should generally be avoided. If they must
be used, extreme care should be
taken to ensure that their contents do not
have long lines (<70 chars), in order to prevent
horizontal scrolling (and possible janitor
intervention).