1854149 - Upgrade to sphinx 7.X

Status: RESOLVED FIXED

(Developer Infrastructure :: Source Documentation, task)

Description

[Sylvestre Ledru [:Sylvestre]]

current version https://pypi.org/project/Sphinx/ is 7.2.6

blocked by https://github.com/mozilla/sphinx-js/issues/227 for now

Comment 1

[Will Kahn-Greene [:willkg] ET needinfo? me]

I did a 3.2.2 release for sphinx-js which drops the upper-bound requirement for Sphinx. I think that should unblock you. Let me know if it doesn't.

Comment 2

[Logan Rosen [:Logan]]

Attachment: Bug 1854149 - upgrade to Sphinx 7.1.2 r?sylvestre

Comment 3

[Mark Banner (:standard8)]

Should bug 1854327 be landing first?

Comment 4

[Andrew Halberstadt [:ahal]]

Yes I think so, also Sphinx 7.x drops support for Python 3.8 (as of now, we still support 3.7 in mach though 3.8 is about to become the new minimum).

So that means we'd need to explicitly decide to require a higher version of Python to build the docs than the rest of the mach ecosystem.

Comment 5

[Logan Rosen [:Logan]]

Sphinx 7.2.0 is the version that dropped support for Python 3.8, so I've put up a PR that upgrades us to 7.1.2 (the last version supporting 3.8).

Comment 6

[Logan Rosen [:Logan]]

Olivier, please take a look when you get the chance per Sylvestre's comment on Phabricator.

Comment 7

[BugBot [:suhaib / :marco/ :calixte]]

Redirect a needinfo that is pending on an inactive user to the triage owner.
:Sylvestre, since the bug has recent activity, could you have a look please?

For more information, please visit BugBot documentation.

Comment 8

[Pulsebot]

Pushed by [e-mail]:
https://hg.mozilla.org/integration/autoland/rev/771b1c088c61
upgrade to Sphinx 7.1.2 r=sylvestre,firefox-source-docs-reviewers DONTBUILD

Comment 9

[Sandor Molnar[:smolnar]]

https://hg.mozilla.org/mozilla-central/rev/771b1c088c61

Comment 10

[[:sergesanspaille]]

Attachment: live_backing.log

Comment 11

[[:sergesanspaille]]

Hey,
the associated patch upgraded docutils to a revision not available in python 3.8, which breaks the mozlint task, as shown in the associated backlog. I'll have a look.

Comment 12

[[:sergesanspaille]]

ok, that's just a missing dep in https://pypi.pub.build.mozilla.org/pub/, I'll open a bug