Nice work!
I think I have tried to write a tutorial for the PDF::API2 about 3-4 times now,
but haven't managed to finish the work, and when compared to the work you have done
I think we should all be greatful for that. ;-)
Nice with the professional explanation of media/crop/bleed/art-boxes.

/K2