id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
37138	Outdated docs CSS in local and preview builds	Mike Edmunds	Mike Edmunds	"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.)"	Cleanup/optimization	assigned	Documentation	6.0	Normal				Unreviewed	0	0	0	0	0	0