[docs-infra] Algolia search results targeting FAQ page results in 404 with v6 (and below)

[vitality82]

Steps to reproduce

Guys sorry for dropping in like this, I have no time for all the details of confirming to issue protocol. The fact is this:

Search results only provide correct results with links if using the latest version. We are still on MUI X v6 so naturally choose v6 and all the search results are NOOP.

Current behavior

No response

Expected behavior

No response

Context

No response

Your environment

npx @mui/envinfo

  Don't forget to mention which browser you used.
  Output from `npx @mui/envinfo` goes here.

Search keywords: docs 404

Search keywords:

[michelengelen]

The only broken links I could find are those targeting the FAQ page which is not backported to v6 apparently. Related PR: mui/mui-x#11686

[michelengelen]

cc @MBilalShafi

[MBilalShafi]

Although porting it back to v6 would solve the issue for this particular page and v6, it won't be solved completely.
For example, the same is reproducible in v5.

Even worse, it's true for all new sections being added in the current major, for example, a fairly recently merged feature (v7) is being displayed in v6 documentation and beyond too but takes nowhere relevant.

For a proper fix, and avoiding similar issue to occur in future, we need to investigate more on how to optimize algolia to only index the pages available on currently accessed major version.

This should be a problem for all products under MUI X (at least, not sure if the same holds true for MUI Core too).

[alexfauquette]

@MBilalShafi That's a global issue. We have a unique algolia crawler that runs on https://mui.com and v5.mui.com, v6.mui.com and other versions call the same index.

We can handle version as different instance of the docs and so have on index per version as mention in algolia docs

I'm running the creation of a v5 docs for test purpose

[vitality82]

I hope my issue has not induced noise, for the record we would stay a happy customer even if this was not solved. The ultimate goal is to find time and space to upgrade to latest version (business goals always come first). This is just one of those issues in the moment when you search for docs for a required version.

You guys rock!