[Django] #36736: Please restore h-rules on the docs home page, which were removed in the 4.2 docs.

5 views
Skip to first unread message

Django

unread,
Nov 15, 2025, 3:45:17 PM11/15/25
to django-...@googlegroups.com
#36736: Please restore h-rules on the docs home page, which were removed in the 4.2
docs.
-------------------------------------+-------------------------------------
Reporter: George Chang | Type:
| Cleanup/optimization
Status: new | Component:
| Documentation
Version: 4.2 | Severity: Normal
Keywords: h-rule pedantic | Triage Stage:
| Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 1 | UI/UX: 0
-------------------------------------+-------------------------------------
This:
[[Image(https://i.imgur.com/659rSpL.png)]]
looks so much better than this:
[[Image(https://i.imgur.com/IGk3iQS.png)]]

in my opinion. The h-rules are absent from 4.2 onwards also. Is there any
particular reason why they were removed?
--
Ticket URL: <https://code.djangoproject.com/ticket/36736>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

Django

unread,
Nov 19, 2025, 6:55:17 AM11/19/25
to django-...@googlegroups.com
#36736: Please restore h-rules on the docs home page, which were removed in the 4.2
docs.
-------------------------------------+-------------------------------------
Reporter: George Chang | Owner: (none)
Type: | Status: closed
Cleanup/optimization |
Component: Documentation | Version: 4.2
Severity: Normal | Resolution: invalid
Keywords: h-rule pedantic | Triage Stage:
| Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by Natalia Bidart):

* easy: 1 => 0
* resolution: => invalid
* status: new => closed

Comment:

Hello George Chang, and thank you for your interest in improving Django.

It took me a bit of investigation to understand the underlying cause. In
the future, providing any initial analysis or context you have already
uncovered would be very helpful, as it can speed up the process for
everyone.

In this case the change is not in Django itself. Starting with Docutils
0.17, the HTML5 writer began emitting semantic tags like `<section>`
instead of the older `<div class="section">` structure. Sphinx adopted
that change and the Django documentation picked it up when the docs
toolchain was updated. Because of that, some of the CSS in the
djangoproject.com theme that targeted the old structure no longer applies
(see
https://github.com/django/djangoproject.com/blame/ecfa16f2fd51c412b2dc8de34036bdad3b2c9a9b/djangoproject/scss/_style.scss#L322
for reference).

The styles for the Django docs live in the djangoproject.com repository,
not in Django core (and this tracker is for Django core issues only). If
you would like to propose adjustments to restore the horizontal
separators, please open an issue or pull request on:
https://github.com/django/djangoproject.com/issues

https://github.com/django/djangoproject.com

Thanks again for the report and for helping improve the documentation
experience.
--
Ticket URL: <https://code.djangoproject.com/ticket/36736#comment:1>
Reply all
Reply to author
Forward
0 new messages