Documentation Build Errors.

[scott-huberty]

As seen in #1357 and #1355

the docs-build job is giving this error:

/home/circleci/project/mne_bids/path.py:docstring of mne_bids.BIDSPath.root:1: WARNING: py:class reference target not found: pathlib._local.Path [ref.class]

From local tests, my current hypothesis is that this has something to do with Python 3.13, which the CircleCI runner uses:

Because Locally, on python 3.10, I don't get the error above, and the docstring of BIDSPath.root correctly hyperlinks to the python docs:

on Python 3.13 it looks like this ("Path" does not hyperlink):

I don't think I have the skill to track down the source of that issue. But we can force the CircleCI runner that deploys docs-build to user a lower version of Python as a work around?

[drammock]

see here for explanation: sphinx-doc/sphinx#13178 (comment)

I put a fix workaround into #1353 (this commit: 653dcc4) but it hasn't been merged yet

[scott-huberty]

Ah I didn't realize this was already on the radar over at #1353, thx @drammock !