qmk/qmk_firmware

[Bug] Docs search ranks results incorrectly

Open

#17 451 ouverte le 22 juin 2022

Voir sur GitHub
 (2 commentaires) (1 réaction) (0 assignés)C (43 867 forks)batch import
bugdocumentationhelp wanted

Métriques du dépôt

Stars
 (20 368 stars)
Métriques de merge PR
 (Merge moyen 20j 9h) (27 PRs mergées en 30 j)

Description

Describe the Bug

When I use the search on docs.qmk.fm, the search results do not obey any sort of logical (to me) ordering. As a simple example: If I enter "layers" as the search query, the doc page for the layers feature (feature_layers) is only the ninth search result.

I think part of the problem is that the search results point to sections, not pages. I can sort of see the benefit of this, but it runs contrary to how I expect most search engines to work. It means for example that a single page with many sections referring to the query string can crowd out the search results.

I find this a strong pain point when working with QMK, helping others out with understanding QMK features, etc. I can never rely on the search to give me what I want. I have mentally gotten used to typing a search term, clicking through to the first result, and then following a trail of breadcrumbs until I get where I actually wanted to be.

Guide contributeur