metacpan-web
metacpan-web copied to clipboard
Opening source prefers pod over pm files
When clicking on the source button for a module that has split .pod and .pm files, it will open the (fairly useless) .pod file instead of the much more useful .pm file. For example Net::LDAP.
There is a .pod AND a .pm file for Net::LDAP - https://metacpan.org/pod/Net::LDAP has the correct link
Maybe need a 'source .pod' and 'source .pm' link or something?
+1 to this.
I keep running into it and every time I do it's far from obvious initially why the file I'm looking at doesn't contain any perl code. It surprises me every single time.
https://metacpan.org/pod/Net::LDAP has the correct link
That isn't very helpful when both the search engine and the distribution overview link to the pod.
This is mostly fixed now. The distribution page now links to the .pm file, which has separate links for the source and pod source. The search page is still linking the pod file though.
The distribution page is now correctly linking to the pm file.
On my reading, this could be closed? It offers a "Pod source" link now?
I think the remaining issue is that the actual search links to https://metacpan.org/pod/distribution/perl-ldap/lib/Net/LDAP.pod
Bump. Recently started splitting my code and documentation and this problem annoys me. There's no clear indication that "Source" will show me pod, not perl. Also no easy way to go to corresponding .pm file, the easiest seems to be changing the extension in the browser address bar...