in reply to Perl source code documentation?

Search for perlguts.pod, perlhack.pod, perloptreeguts.pod.

The source code has lots of good comments, and is not chaotic at all at a second glance. You just time to understand it.

Use gdb to step through the sections you are interested in.