Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Docs] Implement improved full-screen search bar #322

Open
1 of 4 tasks
Luna-Klatzer opened this issue Oct 2, 2022 · 2 comments
Open
1 of 4 tasks

[Docs] Implement improved full-screen search bar #322

Luna-Klatzer opened this issue Oct 2, 2022 · 2 comments
Assignees
Labels
docs Related to the project docs and info on the repo or website
Milestone

Comments

@Luna-Klatzer
Copy link
Member

Luna-Klatzer commented Oct 2, 2022

Is there an existing issue for this?

  • I have searched the existing issues

Current State & Issue

Currently, the website has a rather simplistic search bar, which serves as a basic way to search for content on the documentation.

This search bar does its job, but works rather poorly on smaller screens, as explained in #317 and overall doesn't look very good, as search results are listed in a very small space and you are unable to scroll for more results. To that, it seems very unstable, as the search index is hard-coded and not auto-generated yet.

Expected Changes & Improvements

  • Improve the design of the search bar and make it a full-screen search bar, where results are shown in an overlay tab that lies on top of the rest of the website. This would allow the search bar to work better across multiple screens and overall be more dynamic, without having to interact with the rest of the page.

    A good example of this done well is the Shopify Documentation for Polaris:
    image

  • Add implementation for the auto-generation of the search index inside the build script build-webpages.ts or utilise a library/service to handle the search index for the docs.

  • If possible, allow search based on description content, where the search index also contains the description at the start of every page.

Referenced sites

@Luna-Klatzer Luna-Klatzer added hacktoberfest Hacktoberfest-related issue or pull request docs Related to the project docs and info on the repo or website labels Oct 2, 2022
@Luna-Klatzer Luna-Klatzer self-assigned this Oct 2, 2022
@Luna-Klatzer Luna-Klatzer added this to the Improved Docs milestone Jan 28, 2023
@Luna-Klatzer
Copy link
Member Author

This could possibly be implemented alongside a migration to Jekyll as a building tool since it would simplify the search process and make it easier to index the pages.

Ref:

@Luna-Klatzer
Copy link
Member Author

Another alternative would be:

@Luna-Klatzer Luna-Klatzer removed the hacktoberfest Hacktoberfest-related issue or pull request label Jul 12, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Related to the project docs and info on the repo or website
Projects
Status: Under Consideration
Development

No branches or pull requests

1 participant