sveltejs/svelte.dev

Docs search overly prioritizes tutorials

Open

#1,420 opened on Jul 16, 2025

View on GitHub
 (2 comments) (1 reaction) (0 assignees)Svelte (255 forks)github user discovery
docs (functionality)help wanted

Repository metrics

Stars
 (301 stars)
PR merge metrics
 (PR metrics pending)

Description

When I search the Svelte docs (like typing "req" to get to RequestEvent), the top results are mostly tutorials. In the attached example, five tutorial pages show up before the actual RequestEvent type, which is what I was trying to find.

Would it be possible to tweak the search ranking so that reference documentation is shown before tutorial content? I understand tutorials are important, but in many cases, someone searching a specific term is likely trying to jump directly to the corresponding doc page.

Contributor guide

Research direction
Inspect the search configuration files (e.g., Algolia index settings) to find where ranking is defined. Adjust the ranking to prioritize reference documentation pages over tutorial pages for relevant search terms, possibly by assigning higher weight to the 'type' attribute or by customizing the 'customRanking' field.
Tech stack
None
Domain
documentationbackend
Issue type
Feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
Half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
understanding of search configuration (e.g., Algolia)
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
70