kestra-io / kestra-io/docs

Improve homepage search relevance

Open
#3,893 1 comment 2 reactions 0 assignees View on GitHub
area/docs kind/cooldown
Dominant language
Astro
Stars
155
Forks
177
Avg merge
1d 20m
Merged PRs (30d)
192

Description

### Describe what's missing in our docs

The current homepage search does not consistently surface the most relevant or authoritative content for core concepts. For example, searching for “Inputs” (a fundamental Kestra concept) does not return the basic Inputs reference in the top results, but instead surfaces an older migration guide.

Image

https://kestra.io/docs/workflow-components/inputs

We should improve the relevance and prioritization of search results for core concepts and reference documentation. This may involve improving our own indexing, ranking, or content weighting—or evaluating whether a third-party search solution (e.g. Algolia) would deliver better, more predictable results.

Goal: make it easy for users to quickly find the correct, up-to-date documentation for core Kestra concepts.

Contributor guide

Open the contributing guide

Research direction

Start by reproducing the homepage search for “Inputs” and compare its results with the Inputs reference at https://kestra.io/docs/workflow-components/inputs. Investigate the existing indexing and ranking approach before evaluating whether a third-party search solution is needed; done means core concepts surface the correct, current reference documentation predictably.

Written by the indexing model from the issue text.

Assessment

Domain
documentation, search
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.