Skip to content

Built in search can not find some strings #5640

Description

@mpkorstanje

The built in search on docs.junit.org isn't able to find exact text matches, or if it does the results are incomplete. This is mildly annoying because this information should be easily discoverable and lowers the trust in the built in search function.

The current workaround, to switch the view to "Single Page" and then using the built in browser search works well enough.

Steps to reproduce (A)

  1. Go to https://docs.junit.org/6.0.3/
  2. Search for junit.platform.stacktrace.pruning.enabled
  3. Observe the message No results found for query "junit.platform.stacktrace.pruning.enabled"
  4. Go to https://docs.junit.org/6.0.3/running-tests/stack-trace-pruning.html
  5. Observe that property is documented.

Steps to reproduce (B)

  1. Go to https://docs.junit.org/6.0.3/
  2. Search for org.junit.jupiter.api.Assumptions
  3. Observe a single result found for https://docs.junit.org/6.0.3/migrating-from-junit4.html#tips
  4. Go to https://docs.junit.org/6.0.3/writing-tests/assumptions.html
  5. Observe that the assumptions class is referenced elsewhere.

Deliverables

  • A better search?

Activity

  1. added theissue type on Apr 27, 2026
  2. changed the issue type fromtoon Apr 27, 2026
  3. changed the title [-]Build in search can not find some strings[/-] [+]Built in search can not find some strings[/+] on Apr 27, 2026
  4. Tanixq commented on May 12, 2026

    @Tanixq

    I investigated this issue and traced the behavior to the @antora/lunr-extension search implementation used by the JUnit documentation site.

    I opened an upstream merge request with a proposed fix here:
    https://gitlab.com/antora/antora-lunr-extension/-/merge_requests/113

    The change improves discoverability for dotted identifiers such as:

    • org.junit.jupiter.api.Assumptions
    • junit.platform.stacktrace.pruning.enabled

    while preserving existing exact-match search behavior as much as possible.

  5. marcphilipp commented on Sep 18, 2026

    @marcphilipp
    Member

    @Tanixq Thanks! Did you see the comment on the PR to create an issue first?

    Since Lunr.js seems abandoned, I opened a thread on Antora's Zulip asking for alternatives. https://pagefind.app/ looks promising and there's even an Antora extension for it but it's not a drop-in replacement.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions