[Django] #36789: PDF Docs builds are broken

7 views
Skip to first unread message

Django

unread,
Dec 10, 2025, 2:07:27 PM12/10/25
to django-...@googlegroups.com
#36789: PDF Docs builds are broken
-----------------------------+-------------------------------------------
Reporter: David Smith | Type: Bug
Status: new | Component: Documentation
Version: 6.0 | Severity: Release blocker
Keywords: | Triage Stage: Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-----------------------------+-------------------------------------------
Since eaf7b563a5d3861026242fdb503a58f71acf17f6 the pdf build of the docs
have been broken. See report on the
[https://forum.djangoproject.com/t/django-6-0-pdf-documentation-not-
downloading/43688/2 forum].

I traced the commit which introduced this error by looking through the
build logs on read the docs.

Pass - https://app.readthedocs.org/projects/django/builds/30151643/
Fail - https://app.readthedocs.org/projects/django/builds/30194393/

The error messages are along the lines of the following so seems to make
sense that it's the identified commit that introduced the regression.

{{{ Missing input file '{internals/_images/contribution_process}}}}

I suspect it is because a `.pdf` version of the image was not included as
part that change.
--
Ticket URL: <https://code.djangoproject.com/ticket/36789>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

Django

unread,
Dec 10, 2025, 4:21:01 PM12/10/25
to django-...@googlegroups.com
#36789: PDF Docs builds are broken
---------------------------------+------------------------------------
Reporter: David Smith | Owner: (none)
Type: Bug | Status: new
Component: Documentation | Version: 6.0
Severity: Release blocker | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
---------------------------------+------------------------------------
Changes (by Natalia Bidart):

* cc: ontowhee (added)
* stage: Unreviewed => Accepted

Comment:

Thank you David! I think your conclusion makes sense. At the time neither
LIlian nor I knew why there was a PDF for the image.
--
Ticket URL: <https://code.djangoproject.com/ticket/36789#comment:1>

Django

unread,
Dec 10, 2025, 11:53:31 PM12/10/25
to django-...@googlegroups.com
#36789: PDF Docs builds are broken
---------------------------------+------------------------------------
Reporter: David Smith | Owner: Pravin
Type: Bug | Status: assigned
Component: Documentation | Version: 6.0
Severity: Release blocker | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
---------------------------------+------------------------------------
Changes (by Pravin):

* has_patch: 0 => 1
* owner: (none) => Pravin
* status: new => assigned

--
Ticket URL: <https://code.djangoproject.com/ticket/36789#comment:2>

Django

unread,
Dec 11, 2025, 11:37:53 AM12/11/25
to django-...@googlegroups.com
#36789: PDF Docs builds are broken
-------------------------------------+-------------------------------------
Reporter: David Smith | Owner: Pravin
Type: Bug | Status: assigned
Component: Documentation | Version: 6.0
Severity: Release blocker | Resolution:
Keywords: | Triage Stage: Ready for
| checkin
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by Natalia Bidart):

* stage: Accepted => Ready for checkin

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

Django

unread,
Dec 11, 2025, 11:39:01 AM12/11/25
to django-...@googlegroups.com
#36789: PDF Docs builds are broken
-------------------------------------+-------------------------------------
Reporter: David Smith | Owner: Pravin
Type: Bug | Status: closed
Component: Documentation | Version: 6.0
Severity: Release blocker | Resolution: fixed
Keywords: | Triage Stage: Ready for
| checkin
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by nessita <124304+nessita@…>):

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

Comment:

In [changeset:"2d5a780eb5c83775f428e152517abc05b759cb8a" 2d5a780]:
{{{#!CommitTicketReference repository=""
revision="2d5a780eb5c83775f428e152517abc05b759cb8a"
Fixed #36789 -- Added missing PDF file for
docs/internals/_images/contribution_process.svg.

The PDF is needed to build the PDF version of the whole docs.
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/36789#comment:4>

Django

unread,
Dec 11, 2025, 11:40:05 AM12/11/25
to django-...@googlegroups.com
#36789: PDF Docs builds are broken
-------------------------------------+-------------------------------------
Reporter: David Smith | Owner: Pravin
Type: Bug | Status: closed
Component: Documentation | Version: 6.0
Severity: Release blocker | Resolution: fixed
Keywords: | Triage Stage: Ready for
| checkin
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Comment (by Natalia <124304+nessita@…>):

In [changeset:"728e3067a647eff81615fcc3bcff4e01cb028272" 728e3067]:
{{{#!CommitTicketReference repository=""
revision="728e3067a647eff81615fcc3bcff4e01cb028272"
[6.0.x] Fixed #36789 -- Added missing PDF file for
docs/internals/_images/contribution_process.svg.

The PDF is needed to build the PDF version of the whole docs.

Backport of 2d5a780eb5c83775f428e152517abc05b759cb8a from main.
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/36789#comment:5>

Django

unread,
Dec 11, 2025, 12:08:18 PM12/11/25
to django-...@googlegroups.com
#36789: PDF Docs builds are broken
-------------------------------------+-------------------------------------
Reporter: David Smith | Owner: Pravin
Type: Bug | Status: closed
Component: Documentation | Version: 6.0
Severity: Release blocker | Resolution: fixed
Keywords: | Triage Stage: Ready for
| checkin
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Comment (by Natalia Bidart):

Confirmed this was fixed. Build
https://app.readthedocs.org/projects/django/builds/30659945/ shows a
success PDF build.
--
Ticket URL: <https://code.djangoproject.com/ticket/36789#comment:6>
Reply all
Reply to author
Forward
0 new messages