Potential bug ? Docuemntation links to the wrong thing

[MartinMcGrath]

Good morning, I searched all issues and was unable to find a match.

Visit https://metacpan.org/pod/perlpod#SEE-ALSO

click 'perldoc', note that this links to POD2-ES -> perldoc rather than perldoc.

Initially there was a thought that the POD2-ES links were showing as they had more ++s, however this theory doesn't seem valid as the 'intended' perldoc now has more than the POD2-ES one. Perhaps related to the alphanumeric ordering of the results for a metacpan search.

Please note I didn't spot this, I saw this converstaion this morning.

[haarg]

perldoc is not an indexed module, so in a sense there is no "correct" place to link to. Instead, a guess is done based on various factors.

https://github.com/metacpan/metacpan-api/blob/master/lib/MetaCPAN/Document/File/Set.pm#L68-L134

Checking the various sorted fields will be needed to see why this particular pod file is being used.

[Grinnz]

Several core perldocs are not readable on metacpan because it displays the contents of the tarball not the installed documentation, which is why https://perldoc.perl.org exists.