docs: use Sphinx 8

[dimaqq]

Edit: re-locked with Sphinx 8 now that furo supports it.

[benhoyt]

Would it make sense just to wait till we can use Sphinx 8, to avoid busy-work? In the meantime, we could relax 6.2.1 to 6.x.

[dimaqq]

6.2.1 is the latest 6.x release, and Sphinx 6.x is no longer supported. In fact they rejected my bug report wrt. py 3.12.4.

[dimaqq]

I'll try to update this to Sphinx 8.

[IronCore864]

Looks nice, it seems nothing changed, which is good though!

[dimaqq]

Nothing broke visually

https://pianomister.github.io/diffsite/?url1=https%3A%2F%2Fops--1303.org.readthedocs.build%2Fen%2F1303%2F&url2=https%3A%2F%2Fops.readthedocs.io%2Fen%2Flatest%2F

The only real difference detected by tooling is that inline code spans are 1px off, but I can't see this with my own eye.

The search behaviour is different:

• ops.readthedocs.io: 7 hits for "pebble", seems to search only text
• this branch: 240 hits, listing every ops.pebble.This and that.

[dimaqq]

rebased on latest main, just in case

[tonyandrewmeyer]

• ops.readthedocs.io: 7 hits for "pebble", seems to search only text
• this branch: 240 hits, listing every ops.pebble.This and that.

This is much better. For example, a while back we had a complaint about searching for "secret" not providing useful results, which was true. Now it gives you the most obvious result first and lots of other good ones afterwards.

[benhoyt]

Ah yes, search is much better, thanks!