Debian / debiman

debiman generates a static manpage HTML repository out of a Debian archive
Apache License 2.0
191 stars 46 forks source link

Improve search/prioritization of manpages (show man 5 interfaces from ifupdown) #162

Open dgilman opened 1 year ago

dgilman commented 1 year ago

Right now, if you do a search on the front page of manpages.debian.org for interfaces you'll get sent to the copy of man 5 interfaces from ifupdown2. I would imagine that most of the time the user really wants to see the manpage for ifupdown given that a) it is a package installed by default b) Debian's /etc/network/interfaces is unique to Debian and the manpage is the authoritative documentation for it.

I don't know the total web of URLs and redirects available on manpages.debian.org but I would not be surprised if there were some pages to searches linked around on the greater internet that are now getting redirected to the ifupdown2 version of the manpage.

Perhaps it is possible to prioritize the manpages selected for the "I'm Feeling Lucky" search on the front page to prioritize packages that are Priority: important or otherwise included in the default installation of Debian?

stapelberg commented 1 year ago

Preferring Priority: important packages when resolving conflicts like that sounds like a good idea.

Another idea that requires more work (additional data sources) but may produce better results in more cases is to look at popularity figures from popcon.

I don’t have time to implement such improvements myself currently, so I’ve tagged this issue with “enhancement” and “help wanted”.