[Django] #36320: ReadTheDocs builds for 5.2 is broken

16 views
Skip to first unread message

Django

unread,
Apr 11, 2025, 4:14:05 PM4/11/25
to django-...@googlegroups.com
#36320: ReadTheDocs builds for 5.2 is broken
-------------------------------------+-------------------------------------
Reporter: Baptiste Mispelon | Type: Bug
Status: new | Component:
| Documentation
Version: 5.2 | Severity: Normal
Keywords: readthedocs rtd | Triage Stage:
sphinx | Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
As far as I can tell, the Rtd builds for 5.2 have never worked:
https://app.readthedocs.org/projects/django/builds/?version__slug=5.2.x.

This is causing (small) issues for the website because we rely on them for
serving the PDF and ePub builds of the docs:
https://github.com/django/djangoproject.com/issues/2026
--
Ticket URL: <https://code.djangoproject.com/ticket/36320>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

Django

unread,
Apr 11, 2025, 4:49:58 PM4/11/25
to django-...@googlegroups.com
#36320: ReadTheDocs builds for 5.2 is broken
-------------------------------------+-------------------------------------
Reporter: Baptiste Mispelon | Owner: (none)
Type: Bug | Status: new
Component: Documentation | Version: 5.2
Severity: Normal | Resolution:
Keywords: readthedocs rtd | Triage Stage:
sphinx | Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Comment (by Baptiste Mispelon):

Looking at the 5.1 logs from a few months ago [1] it looks like the epub
build is breaking since bed70e2c00ee05ab28e3f01c390cb13501216450 and that
causes the whole build to fail.

[1]
https://app.readthedocs.org/projects/django/builds/?page=5&version__slug=5.1.x
--
Ticket URL: <https://code.djangoproject.com/ticket/36320#comment:1>

Django

unread,
Apr 11, 2025, 5:05:49 PM4/11/25
to django-...@googlegroups.com
#36320: ReadTheDocs builds for 5.2 is broken
-------------------------------------+-------------------------------------
Reporter: Baptiste Mispelon | Owner: (none)
Type: Bug | Status: new
Component: Documentation | Version: 5.2
Severity: Normal | Resolution:
Keywords: readthedocs rtd | Triage Stage:
sphinx | Unreviewed
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by Baptiste Mispelon):

* has_patch: 0 => 1

Comment:

I believe https://github.com/django/django/pull/19377 should fix it (it
fixes the building of the ePub docs locally for me)
--
Ticket URL: <https://code.djangoproject.com/ticket/36320#comment:2>

Django

unread,
Apr 11, 2025, 6:24:37 PM4/11/25
to django-...@googlegroups.com
#36320: ReadTheDocs builds for 5.2 is broken
-------------------------------------+-------------------------------------
Reporter: Baptiste Mispelon | Owner: (none)
Type: Bug | Status: new
Component: Documentation | Version: 5.2
Severity: Normal | Resolution:
Keywords: readthedocs rtd | Triage Stage: Accepted
sphinx |
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by David Smith):

* stage: Unreviewed => Accepted

--
Ticket URL: <https://code.djangoproject.com/ticket/36320#comment:3>

Django

unread,
Apr 11, 2025, 6:57:58 PM4/11/25
to django-...@googlegroups.com
#36320: ReadTheDocs builds for 5.2 is broken
-------------------------------------+-------------------------------------
Reporter: Baptiste Mispelon | Owner: Baptiste
| Mispelon
Type: Bug | Status: assigned
Component: Documentation | Version: 5.2
Severity: Normal | Resolution:
Keywords: readthedocs rtd | Triage Stage: Accepted
sphinx |
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by Antoliny):

* owner: (none) => Baptiste Mispelon
* status: new => assigned

--
Ticket URL: <https://code.djangoproject.com/ticket/36320#comment:4>

Django

unread,
Apr 12, 2025, 1:38:06 PM4/12/25
to django-...@googlegroups.com
#36320: ReadTheDocs builds for 5.2 is broken
-------------------------------------+-------------------------------------
Reporter: Baptiste Mispelon | Owner: Baptiste
| Mispelon
Type: Bug | Status: assigned
Component: Documentation | Version: 5.2
Severity: Normal | Resolution:
Keywords: readthedocs rtd | Triage Stage: Ready for
sphinx | checkin
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by Mariusz Felisiak):

* stage: Accepted => Ready for checkin

--
Ticket URL: <https://code.djangoproject.com/ticket/36320#comment:5>

Django

unread,
Apr 12, 2025, 1:39:18 PM4/12/25
to django-...@googlegroups.com
#36320: ReadTheDocs builds for 5.2 is broken
-------------------------------------+-------------------------------------
Reporter: Baptiste Mispelon | Owner: Baptiste
| Mispelon
Type: Bug | Status: closed
Component: Documentation | Version: 5.2
Severity: Normal | Resolution: fixed
Keywords: readthedocs rtd | Triage Stage: Ready for
sphinx | checkin
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by GitHub <noreply@…>):

* resolution: => fixed
* status: assigned => closed

Comment:

In [changeset:"ac16d2876da296d8e50450bf7d776f92d1e16b0d" ac16d287]:
{{{#!CommitTicketReference repository=""
revision="ac16d2876da296d8e50450bf7d776f92d1e16b0d"
Fixed #36320 -- Ignored "duplicated_toc_entry" for ePub docs build.
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/36320#comment:6>

Django

unread,
Apr 12, 2025, 1:40:16 PM4/12/25
to django-...@googlegroups.com
#36320: ReadTheDocs builds for 5.2 is broken
-------------------------------------+-------------------------------------
Reporter: Baptiste Mispelon | Owner: Baptiste
| Mispelon
Type: Bug | Status: closed
Component: Documentation | Version: 5.2
Severity: Normal | Resolution: fixed
Keywords: readthedocs rtd | Triage Stage: Ready for
sphinx | checkin
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Comment (by Mariusz Felisiak <felisiak.mariusz@…>):

In [changeset:"64ec347fc5ede2efddb9cf4b25e036708fd3458b" 64ec347f]:
{{{#!CommitTicketReference repository=""
revision="64ec347fc5ede2efddb9cf4b25e036708fd3458b"
[5.2.x] Fixed #36320 -- Ignored "duplicated_toc_entry" for ePub docs
build.

Backport of ac16d2876da296d8e50450bf7d776f92d1e16b0d from main
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/36320#comment:7>

Django

unread,
Apr 12, 2025, 1:40:37 PM4/12/25
to django-...@googlegroups.com
#36320: ReadTheDocs builds for 5.2 is broken
-------------------------------------+-------------------------------------
Reporter: Baptiste Mispelon | Owner: Baptiste
| Mispelon
Type: Bug | Status: closed
Component: Documentation | Version: 5.2
Severity: Normal | Resolution: fixed
Keywords: readthedocs rtd | Triage Stage: Ready for
sphinx | checkin
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Comment (by Mariusz Felisiak <felisiak.mariusz@…>):

In [changeset:"af6d305fc7ac375c9a273b49c8038e5e9030830b" af6d305]:
{{{#!CommitTicketReference repository=""
revision="af6d305fc7ac375c9a273b49c8038e5e9030830b"
[5.1.x] Fixed #36320 -- Ignored "duplicated_toc_entry" for ePub docs
build.

Backport of ac16d2876da296d8e50450bf7d776f92d1e16b0d from main
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/36320#comment:8>
Reply all
Reply to author
Forward
0 new messages