Page MenuHomePhabricator
Create Task
Maniphest T413563

Documentation is incomplete since Sphinx update to release 9 or 9.1
Closed, ResolvedPublicBUG REPORT
Actions

Description

master documentation is broken probably after sphinx was updated in rPWBC54f9635 but no warnings were given within CI.

Details

Related Changes in Gerrit:
Show related patches Customize query in gerrit

Related Objects

Event Timeline

Xqt created this task.Dec 29 2025, 8:02 AM
Restricted Application added subscribers: pywikibot-bugs-list, Aklapper. · View Herald TranscriptDec 29 2025, 8:02 AM
Xqt triaged this task as High priority.Dec 29 2025, 8:03 AM
Xqt changed the subtype of this task from "Task" to "Bug Report".
gerritbot added a comment.Dec 29 2025, 11:37 AM

Change #1221591 had a related patch set uploaded (by Xqt; author: Xqt):

[pywikibot/core@master] Use Sphinx 8.2.3

https://gerrit.wikimedia.org/r/1221591

gerritbot added a project: Patch-For-Review.Dec 29 2025, 11:37 AM

Change #1221591 merged by Xqt:

[pywikibot/core@master] Use Sphinx 8.2.3

https://gerrit.wikimedia.org/r/1221591

gerritbot added a comment.Dec 29 2025, 12:07 PM

Change #1221594 had a related patch set uploaded (by Xqt; author: Xqt):

[pywikibot/core@master] Revert^2 "doc: replace directives describing changes between versions"

https://gerrit.wikimedia.org/r/1221594

gerritbot added a comment.Dec 29 2025, 12:09 PM

Change #1221596 had a related patch set uploaded (by Xqt; author: Xqt):

[pywikibot/core@master] Revert^2 "doc: Update Sphinx"

https://gerrit.wikimedia.org/r/1221596

gerritbot added a comment.Dec 29 2025, 12:10 PM

Change #1221596 merged by Xqt:

[pywikibot/core@master] Revert^2 "doc: Update Sphinx"

https://gerrit.wikimedia.org/r/1221596

gerritbot added a comment.Dec 29 2025, 12:12 PM

Change #1221594 merged by Xqt:

[pywikibot/core@master] Revert^2 "doc: replace directives describing changes between versions"

https://gerrit.wikimedia.org/r/1221594

Maintenance_bot removed a project: Patch-For-Review.Dec 29 2025, 12:30 PM
Xqt added a project: Upstream.Dec 29 2025, 12:50 PM
Xqt moved this task from Backlog to Reported Upstream on the Upstream board.

https://github.com/executablebooks/sphinx-tabs/issues/209

gerritbot added a comment.Dec 29 2025, 12:52 PM

Change #1221614 had a related patch set uploaded (by Xqt; author: Xqt):

[pywikibot/core@master] Revert^3 "doc: replace directives describing changes between versions"

https://gerrit.wikimedia.org/r/1221614

gerritbot added a project: Patch-For-Review.Dec 29 2025, 12:52 PM
gerritbot added a comment.Dec 29 2025, 12:58 PM

Change #1221614 merged by Xqt:

[pywikibot/core@master] Revert^3 "doc: replace directives describing changes between versions"

https://gerrit.wikimedia.org/r/1221614

gerritbot added a comment.Dec 29 2025, 1:25 PM

Change #1221615 had a related patch set uploaded (by Xqt; author: Xqt):

[pywikibot/core@master] doc: redurce Furo version

https://gerrit.wikimedia.org/r/1221615

gerritbot added a comment.Dec 29 2025, 1:28 PM

Change #1221615 merged by Xqt:

[pywikibot/core@master] doc: redurce Furo version

https://gerrit.wikimedia.org/r/1221615

Maintenance_bot removed a project: Patch-For-Review.Dec 29 2025, 1:30 PM
Xqt changed the task status from Open to Stalled.Dec 31 2025, 11:04 AM

Waiting for any upstream Sphinx tabs supporting Sphins 9.

gerritbot added a comment.Jan 8 2026, 12:17 PM

Change #1224646 had a related patch set uploaded (by Xqt; author: Xqt):

[pywikibot/core@master] [doc] Retry using Sphinx 9

https://gerrit.wikimedia.org/r/1224646

gerritbot added a project: Patch-For-Review.Jan 8 2026, 12:17 PM
Xqt changed the task status from Stalled to Open.Jan 8 2026, 12:33 PM
gerritbot added a comment.Jan 8 2026, 12:43 PM

Change #1224646 merged by jenkins-bot:

[pywikibot/core@master] [doc] Retry using Sphinx 9

https://gerrit.wikimedia.org/r/1224646

Maintenance_bot removed a project: Patch-For-Review.Jan 8 2026, 1:32 PM
Xqt renamed this task from Documentation is incomplete since Sphinx update to release 9 to Documentation is incomplete since Sphinx update to release 9 or 9.1.Jan 8 2026, 1:59 PM
gerritbot added a comment.Jan 8 2026, 3:12 PM

Change #1224699 had a related patch set uploaded (by Xqt; author: Xqt):

[pywikibot/core@master] doc: use autodoc legacy to prevent missing files

https://gerrit.wikimedia.org/r/1224699

gerritbot added a project: Patch-For-Review.Jan 8 2026, 3:12 PM
gerritbot added a comment.Jan 8 2026, 3:24 PM

Change #1224699 merged by jenkins-bot:

[pywikibot/core@master] doc: use autodoc legacy to prevent missing files

https://gerrit.wikimedia.org/r/1224699

Maintenance_bot removed a project: Patch-For-Review.Jan 8 2026, 3:30 PM
gerritbot added a comment.Jan 8 2026, 3:36 PM

Change #1224703 had a related patch set uploaded (by Xqt; author: Xqt):

[pywikibot/core@master] doc: temporary deactivate sphinx patches

https://gerrit.wikimedia.org/r/1224703

gerritbot added a project: Patch-For-Review.Jan 8 2026, 3:36 PM
gerritbot added a comment.Jan 8 2026, 3:55 PM

Change #1224703 merged by jenkins-bot:

[pywikibot/core@master] doc: temporary deactivate sphinx patches

https://gerrit.wikimedia.org/r/1224703

Maintenance_bot removed a project: Patch-For-Review.Jan 8 2026, 4:30 PM
gerritbot added a comment.Jan 8 2026, 4:31 PM

Change #1224720 had a related patch set uploaded (by Xqt; author: Xqt):

[pywikibot/core@master] doc: Prevent parallel tasks in Sphinx

https://gerrit.wikimedia.org/r/1224720

gerritbot added a project: Patch-For-Review.Jan 8 2026, 4:31 PM
Xqt added a subscriber: Mpaa.Jan 8 2026, 4:44 PM

I found the underlying problem in proofreadpage:

17:32:33   File "/src/.tox/doc/lib/python3.13/site-packages/sphinx/ext/viewcode.py", line 88, in _get_full_modname
17:32:33     value = getattr(value, attr)
17:32:33   File "/src/pywikibot/proofreadpage.py", line 182, in __get__
17:32:33     attr = self.attrs.get(obj)
17:32:33   File "/opt/pyenv/versions/3.13.5/lib/python3.13/weakref.py", line 452, in get
17:32:33     return self.data.get(ref(key),default)
17:32:33                          ~~~^^^^^
17:32:33 TypeError: cannot create weak reference to 'NoneType' object
17:32:33 viewcode can't import proofreadpage, failed with error "cannot create weak reference to 'NoneType' object"

Maybe Sphinx 8 was more tolerant.

gerritbot added a comment.Jan 8 2026, 5:45 PM

Change #1224751 had a related patch set uploaded (by Xqt; author: Xqt):

[pywikibot/core@master] doc: Fall back to Sphinx 8.2.3 to enable online documentation again

https://gerrit.wikimedia.org/r/1224751

gerritbot added a comment.Jan 8 2026, 5:49 PM

Change #1224751 merged by Xqt:

[pywikibot/core@master] doc: Fall back to Sphinx 8.2.3 to enable online documentation again

https://gerrit.wikimedia.org/r/1224751

gerritbot added a comment.Jan 27 2026, 1:27 PM

Change #1224720 merged by Xqt:

[pywikibot/core@master] ProofreadPage: Never use None as key in WeakKeyDictionary

https://gerrit.wikimedia.org/r/1224720

Maintenance_bot removed a project: Patch-For-Review.Jan 27 2026, 1:32 PM
gerritbot added a comment.Jan 29 2026, 9:32 AM

Change #1234930 had a related patch set uploaded (by Xqt; author: Xqt):

[pywikibot/core@stable] sphinx: Use Sphinx 8.2.3 for documentation

https://gerrit.wikimedia.org/r/1234930

gerritbot added a project: Patch-For-Review.Jan 29 2026, 9:32 AM
gerritbot added a comment.Jan 29 2026, 9:36 AM

Change #1234930 merged by Xqt:

[pywikibot/core@stable] sphinx: Use Sphinx 8.2.3 for documentation

https://gerrit.wikimedia.org/r/1234930

Maintenance_bot removed a project: Patch-For-Review.Jan 29 2026, 10:31 AM
gerritbot added a comment.Mar 8 2026, 3:30 PM

Change #1249046 had a related patch set uploaded (by Xqt; author: Xqt):

[pywikibot/core@master] [doc] Retry using Sphinx 9

https://gerrit.wikimedia.org/r/1249046

gerritbot added a project: Patch-For-Review.Mar 8 2026, 3:30 PM
gerritbot added a comment.Mar 8 2026, 3:34 PM

Change #1249046 merged by Xqt:

[pywikibot/core@master] [doc] Retry using Sphinx 9 after sphinx-tabs was updated

https://gerrit.wikimedia.org/r/1249046

Maintenance_bot removed a project: Patch-For-Review.Mar 8 2026, 4:30 PM
Xqt closed this task as Resolved.Mar 8 2026, 6:59 PM
Xqt claimed this task.
Content licensed under Creative Commons Attribution-ShareAlike (CC BY-SA) 4.0 unless otherwise noted; code licensed under GNU General Public License (GPL) 2.0 or later and other open source licenses. By using this site, you agree to the Terms of Use, Privacy Policy, and Code of Conduct. · Wikimedia Foundation · Privacy Policy · Code of Conduct · Terms of Use · Disclaimer · CC-BY-SA · GPL · Credits