Here's an interesting case. I'll use the metacpan-web link to illustrate the point:
The API returns:
This raises the questions of how much we really care about Pod in Makefile.PL and also a related issue of indexing Makefile.PL:
I think this issue was raised elsewhere, but it makes sense to refer to it in this context.
So what's the problem here? That the Pod producer doesn't ignore =for cmt?
Or that the Makefile is indexed in the first place? I find it quite useful that documentation in the Makefile.PL is listed on the /release page. However, https://metacpan.org/search?q=makefile.pl linking to the same file for the first few results in definitely a problem. But not easy to fix, since there is no index file for pod only files (i.e. without a package declaration).
We are going to stop indexing Makefile.PL's so this ticket isn't relevant