Semantic-Org / Semantic-UI-Docs

Official Documentation for Semantic UI
http://www.semantic-ui.com
303 stars 1.43k forks source link

[doc website] Add a nice search experience #424

Open s-pace opened 5 years ago

s-pace commented 5 years ago

👋 team,

TL;DR: Add a learn-as-you-type search experience to the documentation

I'm working at Algolia on the a project called DocSearch which goal is to enhance documentation websites with exhaustive, fast and relevant search. You might have seen DocSearch live already on websites like react, Bootstrap, Brew or jQuery.

I have created a preview of this solution and what DocSearch on the semantic-ui website could will look like here. Feel free to try it and let us know what you think. Please note the learn-as-you-type experience and the typo tolerance:

demo of DocSearch + semantic-ui

The way DocSearch works is by crawling your content, pushing the results into an Algolia index, and then requesting this index directly from the website front-end through JavaScript.

We'll take care of crawling your website and populating the Algolia index with the latest changes every 24h for you. You don't need to change anything to your deployment process. The only thing you need to add are the following CSS and JS snippets that will bind the dropdown to your searchbox.

We built DocSearch with the idea of giving back to the Open-Source community. This is why your crawling configuration is available on GitHub if you want to change it. We also have our own documentation to help you tweak the dropdown to your needs. You'll also have access to analytics on the most searched terms or those with no results. All of this is of course entirely free.

solves #318