Hacker News Reader

Comment by _fat_santa | Hacker News Reader

What I found out is that because Docusaurus is so popular, you get a form of standardization across docs. I can go from React Native docs to Redux docs to TailwindCSS docs and I've already got a solid idea of where everything will be because its a docusarus site.

One thing in particular is that Docusarus has the CMD + K command to do a search, it's so nice being able to go to all the different sites for docs and have the UI work in exactly the same way.

View on HN

Thanks for the feedback

To be fair what you describe is more a side-result of our community rather than our own features.

CMD+K is a popular shortcut. It's not built-in Algolia DocSearch modal.

Also other frameworks like VitePress have a similar experience: https://vitepress.vuejs.org/

if i have 1 piece of feedback about docusaurus docsearch, it is that doing faceted search (eg to filter for languages, or library versions) is not at all documented. i've tried multiple times and failed. if someone from Algolia is reading this, we could really use your help there, it would greatly increase the experience of all docs via docusaurus and improve Algolia integration.

Thanks for the feedback

We call this "contextual search": https://docusaurus.io/docs/search#contextual-search

It's now enabled by default and facet on version + language so normally you don't have to do anything (like it was the case on v1).

Now we don't provide very good APIs to customize this default facetted search, so it's more all or nothing.

Is this solving your use-case or you need something else?

Reply on news.ycombinator.com