Re: [PATCH] docs: add advanced search for kernel documentation

From: Jonathan Corbet

Date: Sun Mar 22 2026 - 12:06:17 EST


Rito Rhymes <rito@xxxxxxxxxxxxxx> writes:

> Replace the stock Sphinx search page with one that reuses the
> existing searchindex.js while adding structured result grouping,
> filtering, and exact identifier matching.
>
> Results are grouped into Symbols, Sections, Index entries, and
> Pages, each in a collapsible section with a count. An Advanced
> panel exposes filters for documentation area, object type, result
> kind, and exact match mode. All state is URL-encoded so searches
> remain shareable.
>
> Page summary snippets are lazy-loaded via IntersectionObserver to
> avoid fetching every matching page up front.
>
> The sidebar keeps the existing quick-search box and adds an
> "Advanced search" link below it.
>
> Signed-off-by: Rito Rhymes <rito@xxxxxxxxxxxxxx>
> ---
> Documentation/sphinx-static/custom.css | 163 ++++
> Documentation/sphinx-static/kernel-search.js | 746 ++++++++++++++++++
> Documentation/sphinx/templates/search.html | 106 +++
> Documentation/sphinx/templates/searchbox.html | 18 +
> 4 files changed, 1033 insertions(+)
> create mode 100644 Documentation/sphinx-static/kernel-search.js
> create mode 100644 Documentation/sphinx/templates/search.html
> create mode 100644 Documentation/sphinx/templates/searchbox.html

Without looking into detail at the work (yet), can you tell me something
about how this work was created? We do have guidance for the disclosure
of the use of coding tools in
Documentation/process/coding-assistants.rst ...

I'm curious about where you are going with this in general. A look at
ritovision.com does not suggest "kernel developer" to me.

Thanks,

jon