Skip to content

Update the search results layout #76

@settermjd

Description

@settermjd

After talking with @voroyam, I propose making two changes to the search results structure to make them easier for users to read; specifically, these are:

  1. Group search results by documentation version
  2. Remove the "Score" information

Group Search Results by Documentation Version

In the screenshot below, you can see the current ownCloud docs search results on the left, and the Antora documentation search results on the right.

search results comparison

I believe that the layout of Antora's search results, or something akin to it, will make it easier for users to find the information that they're looking for, specific to their installed version of ownCloud.
Secondarily, it would be excellent if the search could also top-load the results for the version of the documentation that the user is currently viewing if there are any.

Remove the Score Information

I appreciate that this is information that ElasticSearch stores internally, but from a user perspective, I don't see how it helps the user pick the information most relative to their search query, as the wording isn't necessarily the most intuitive in that regard.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions