[Django] #37138: Outdated docs CSS in local and preview builds

[Django]

#37138: Outdated docs CSS in local and preview builds
-------------------------------------+-------------------------------------
Reporter: Mike | Owner: Mike Edmunds
Edmunds |
Type: | Status: assigned
Cleanup/optimization |
Component: | Version: 6.0
Documentation |
Severity: Normal | Keywords:
Triage Stage: | Has patch: 0
Unreviewed |
Needs documentation: 0 | Needs tests: 0
Patch needs improvement: 0 | Easy pickings: 0
UI/UX: 0 |
-------------------------------------+-------------------------------------
The CSS used for documentation in local and ReadTheDocs PR preview builds
is ''significantly'' different from the CSS used on
docs.djangoproject.com.

The styles in docs/_theme/djangodocs/static/djangodocs.css:

* have usability problems ([https://forum.djangoproject.com/t/increasing-
size-of-html-text-in-django-docs-default-theme/45210 forum discussion])
* are missing semantically-important styles
([https://forum.djangoproject.com/t/why-does-local-django-docs-have-a
-different-styling-theme-than-the-official-one/32761/3 forum discussion])
* don't support dark mode

These and other differences complicate contributing to the documentation,
as you can't really be sure how it's going to look until the PR is merged
and published.

We should find a way to replace `docs/_theme/djangodocs/static/*.css` with
the styles from djangoproject.com. (E.g., the result of `make compile-
scss-debug` in that project.)
--
Ticket URL: <https://code.djangoproject.com/ticket/37138>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

[Django]

#37138: Outdated docs CSS in local and preview builds
-------------------------------------+-------------------------------------

Reporter: Mike Edmunds | Owner: Mike
Type: | Edmunds
Cleanup/optimization | Status: assigned
Component: Documentation | Version: 6.0
Severity: Normal | 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):

* stage: Unreviewed => Accepted

Comment:

Makes sense, I agree this is desired. How to accomplish the goal, it's
something I don't see clearly but I'm eager to see options!
--
Ticket URL: <https://code.djangoproject.com/ticket/37138#comment:1>

[Django]

#37138: Outdated docs CSS in local and preview builds
-------------------------------------+-------------------------------------
Reporter: Mike Edmunds | Owner: Mike
Type: | Edmunds
Cleanup/optimization | Status: assigned
Component: Documentation | Version: 6.0
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted

Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 1

Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Changes (by Mike Edmunds):

* has_patch: 0 => 1
* needs_better_patch: 0 => 1

Comment:

PR (draft): https://github.com/django/django/pull/21416
--
Ticket URL: <https://code.djangoproject.com/ticket/37138#comment:2>