Fix missing jQuery error in docs

[AyodeAwe]

The latest versions 4.1 and 4.0 of sphinxcontrib-jquery have an issue with jQuery installed currently in sphinx. This is causing the search functionality to fail so I've pinned the version to 3.0.0, this resolves the issue.

[jakirkham]

Thanks Jake! 🙏

[bdice]

Is this the source of the issue? readthedocs/sphinx_rtd_theme#1452

[AyodeAwe]

Yep @bdice, seems like it

[AyodeAwe]

The suggested fix here works but not without throwing a new error Uncaught ReferenceError: _ is not defined

[bdice]

Ok. FYI @vyasr if you migrate RMM's C++ docs to use Sphinx/Breathe, we might also want to update the Sphinx theme to match the same one used for cudf/cuml/etc.

[ajschmidt8]

I'd like to confirm locally that the suggested workaround isn't sufficient before we merge this.

It'd be better if we didn't have to introduce additional dependencies.

[ajschmidt8]

The suggested fix here works but not without throwing a new error Uncaught ReferenceError: _ is not defined

I was able to confirm that this workaround resolves the issue locally without causing other problems.

Unfortunately this isn't something we'll be able to confirm in CI, as it appears that query parameters break our preview environments (a separate issue that we'll have to look into): https://downloads.rapids.ai/ci/rmm/pull-request/1321/3c3dfb6/docs/rmm/html/search/?q=allocator&check_keywords=yes&area=default#

However I think we should be fine with dropping the extra dependency and using the workaround that they've suggested.

[bdice]

I was able to confirm that this workaround resolves the issue locally without causing other problems.

@ajschmidt8 I'm a bit unsure exactly which piece of that thread helped you. That thread has a few things, like setting extensions and html_theme_path. Did you do one or both of those? Were you testing with (or without) the sphinxcontrib-jquery package (if so, which version)? Might be easiest just to push to this PR if @AyodeAwe is okay with that.

[ajschmidt8]

I was able to confirm that this workaround resolves the issue locally without causing other problems.

@ajschmidt8 I'm a bit unsure exactly which piece of that thread helped you. That thread has a few things, like setting extensions and html_theme_path. Did you do one or both of those? Were you testing with (or without) the sphinxcontrib-jquery package (if so, which version)? Might be easiest just to push to this PR if @AyodeAwe is okay with that.

I quoted the solution that worked for me. It was this one, which Jake has just added to his PR: readthedocs/sphinx_rtd_theme#1452 (comment)

[ajschmidt8]

before we merge, I will just pull the docs from S3 and check the fix locally so that we can be certain it's working as expected.

we'll look into that query parameter issue that I mentioned another time

[ajschmidt8]

confirmed. merging

[ajschmidt8]

/merge

[ajschmidt8]

ah, this incident is probably preventing the /merge command from working: https://www.githubstatus.com/incidents/rk1918knvr0w

I'll just squash merge manually for now.