hotshoe has asked for the wisdom of the Perl Monks concerning the following question:
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.