http://www.perlmonks.org?node_id=1206883

hotshoe has asked for the wisdom of the Perl Monks concerning the following question:

Hello monks, This is my first forum post and seeking advice as limited experience w/ Perl. I have a perl package Foo, and several submodules for purpose of structuring my code (Foo::Util, Foo::Bar, etc.). The client shouldn't be interfacing directly with these submodules. Are there any best practices around packaging, documenting. etc., that I should know about? It is pointless to document the submodules, but at same time, they would get installed into the user's library path so I feel like something should be documented (even if just to indicate do not call directly). Any help / advice is much appreciated. Thanks!