On Wed, Oct 26, 2016 at 6:14 PM, Diab Jerius <djer...@cfa.harvard.edu> wrote:
> Howdy, > > The PDLx-Mask distribution has a README.pod file at the top level, as > well as actual module documentation in lib/PDLx/Mask.pm. > > On the module's main page: > > http://search.cpan.org/~djerius/PDLx-Mask-0.01/ > > The PDLx::Mask link goes to README.pod, not to lib/PDLx/Mask.pm > > That's not quite what I expected, while this > > https://metacpan.org/pod/PDLx::Mask > > is. > > Should I not be uploading the README.pod file? I use that to > generate README and README.md. > > Thanks, > > Diab > You should not upload any .pod files in the top level of the distribution, as they will get indexed and installed for historical reasons. (Metacpan sees the name in that document as PDLx::Mask, so it does not override the indexed PDLx::Mask documentation in their index. Search.cpan.org clearly has different logic we are not privy to.) README.md and README are fine. -Dan
