Skip to content

Improve search usability #4228

@DamianMaslanka5

Description

@DamianMaslanka5

Currently it is difficult to find some information when I know exactly what I am looking for, but I don't know exact page that I am looking for.

For example, when I search for data type and I am looking for general information about types available in ClickHouse, I know this information is in the SQL Reference section somewhere, because I looked at it previously.

I see few pages related to integrations, that I am not interesed in (this is even worse in the search modal)

https://clickhouse.com/docs/search?q=data%20type

Image

Proposed solutions

1. Filter by section

Add ability to filter results by section, for example:

  • Server Admin
  • Reference
  • Integrations
  • ClickStack

See GitLab's filtering functionality

https://docs.gitlab.com/search/?q=clickhouse&page=1&filters=contribute

Image

2. Add breadcrumb path to search results to quickly identify source of the page

GitLab

Image

ClickHouse

Image

3. Show more results in the search modal

Current height

Image

What I expect (75vh on div with DocSearch-Dropdown class)

Image

Metadata

Metadata

Assignees

Labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions