Perl-Toolchain-Gang / ExtUtils-MakeMaker

Perl module to make Makefiles and build modules (what backs Makefile.PL)
https://metacpan.org/release/ExtUtils-MakeMaker
64 stars 76 forks source link

Link to `perlnewmod` and friends #453

Open nataraj-hates-MS-for-stealing-github opened 4 weeks ago

nataraj-hates-MS-for-stealing-github commented 4 weeks ago

I sometimes create new perl modules for CPAN, but not often enough to remember how did I do it last time.

Usually it takes no time to find ExtUtils::MakeMaker but it is not about creating skeleton module distribution that I really need

Finding perlnewmod and module-starter takes much more time, there are not many mentions in the internet (ExtUtils::MakeMaker has many mentions)

I guess it is common mistake, that is made by many potential module authors.

We need for sure link to perlnewmod and to module-starter and h2xs. At least in "SEE ALSO" section.

I would also strongly recommend to add it to "SEE INSTEAD?" section at the beginning of the documentation like it is done in https://metacpan.org/pod/Data::UUID module. To redirect those who is looking for module skeleton creator.

I can do the PR, but I am not able to decide what way it should be. Can we have "SEE INSTEAD?" section?

nataraj-hates-MS-for-stealing-github commented 4 weeks ago

I added #454 as a suggestion how this can be solved