Improve in-site search: better Chinese language support and configurable result list length #5592
YIMINGLI2022
started this conversation in
Feature Requests
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
-
Description:
We'd like to request two enhancements to Mintlify's built-in documentation search:
The current search experience for Chinese-language documentation is suboptimal. Queries in Chinese often fail to surface the most relevant pages, and results are frequently dominated by API reference content even when users are searching for conceptual or guide pages. Please consider:
Improved tokenization/segmentation for Chinese (and ideally Japanese/Korean) text, since these languages don't use whitespace to separate words.
Better relevance ranking for non-English content.
Indexing improvements that account for multilingual /zh/, /ja/, etc. content paths.
2. Configurable search result list length
The search dropdown currently caps results at around 10 items, with no way to extend or paginate. We'd like:
A configuration option in docs.json (e.g., search.maxResults) to control how many results are displayed.
Optionally, a "show more" / pagination affordance or a full search results page for longer result sets.
Why this matters:
For larger documentation sites — especially multilingual ones — a 10-result cap combined with weak CJK ranking means users frequently can't find the page they need through search, even when it exists. These improvements would significantly improve documentation discoverability for non-English audiences.
Beta Was this translation helpful? Give feedback.
All reactions