facebook / relay

Relay is a JavaScript framework for building data-driven React applications.
https://relay.dev
MIT License
18.29k stars 1.81k forks source link

Docs: search behaves weirdly depending on the URL state #4504

Open MarceloPrado opened 8 months ago

MarceloPrado commented 8 months ago

It's quite annoying that Docusaurus search seems scoped to the current URL. As you can see from the repro, searching for Imperatively in the Relay home and in the "Next" version yields different results. This makes it harder to learn the framework, as finding the API/guide I need is often cumbersome.

I understand the team wants to "gate" access to certain docs depending on whether they are available or not. But to use my repro as an example, as a Relay user I already have access to the imperative APIs described in the guide, and hence, I expect them to be available in the major I'm at (v15).

Repro:

https://github.com/facebook/relay/assets/8047841/00d66e55-63b7-4b9c-99bf-4e9bd35dda5a

captbaritone commented 8 months ago

Thanks for flagging. I was just looking into why search seems broken. Let me see what I can figure out here.

JUSTIVE commented 1 month ago

other than the issue above, the whole search feature is broken. I've never had a successful search experience on the docs page.