🔧 [CHANGE] - upgrade to Docusaurus 3 - search plugin

[MatissJanis]

Description

The current search plugin for docusaurus has two issues:

1. it is not compatible with docusaurus v3 (which prohibits us from upgrading)
2. it indexes all pages (ideally we should not index the release notes since they just spam the search results)

Expected behavior

Find a solution to solve the above two issues. This might require switching to a different search plugin.

[RubenOlsen]

@MatissJanis I'll take a look at this.

[psybers]

@MatissJanis Perhaps this? https://v1.docusaurus.io/docs/en/search

[psybers]

Sorry, linked to the old page. Here is the current: https://docusaurus.io/docs/search

[psybers]

But also maybe the existing search plugin works on v3? cmfcmf/docusaurus-search-local#205

And there was a PR to support ignoring paths: https://github.com/cmfcmf/docusaurus-search-local/pull/87/files

We could fork that plugin and add that support.

[RubenOlsen]

@psybers, thanks for the pointer. I am planning to start working on this issue next week.

[RubenOlsen]

Status per Jan 5th: Lots and lots of breaking changes. This did not become a walk in the park - and a side effect is that some characters from now on {}[]<>, etc need to be escaped.

[MatissJanis]

I wonder if it would be easier to just start fresh with the latest version of Docusaurus. And then copy over all the existing articles to the new version.

Maybe that's easier than trying to upgrade in-place.

[RubenOlsen]

@MatissJanis

I have been able to set aside some time for this now - and I'll take another go at this.

My biggest problem last time I looked into this was that so many pages had to be amended due to change in the Docusarus 3 markup.