If my code is lib/Book/Page.pm, should it be lib/Book/Page.pod

I guess so. Have you tried it? For what it's worth, MakeMaker can be a bit hard to comprehend. For some reason I couldn't get the additional XS modules in my Audio::LADSPA module to compile unless I put them in their own subdirectory with their own Makefile.PL. For instance, Audio::LADPSA::Plugin goes into /Plugin/Plugin.pm and then the docs go into /Plugin/Plugin.pod. By the way, if you want to see how other people do it, did you know you can browse inside module distributions on search.cpan.org by clicking one the "browse" link on the module page? like this