Opened 3 weeks ago

Last modified 2 weeks ago

#37138 assigned Cleanup/optimization

Outdated docs CSS in local and preview builds

Reported by: Mike Edmunds Owned by: Mike Edmunds
Component: Documentation Version: 6.0
Severity: Normal Keywords:
Cc: Triage Stage: Accepted
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: yes
Easy pickings: no UI/UX: no

Description

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:

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.)

Change History (2)

comment:1 by Natalia Bidart, 3 weeks ago

Triage Stage: Unreviewed → Accepted

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!

comment:2 by Mike Edmunds, 3 weeks ago

Has patch: set
Patch needs improvement: set

PR (draft): ​https://github.com/django/django/pull/21416

Version 0, edited 3 weeks ago by Mike Edmunds (next)
Note: See TracTickets for help on using tickets.
Back to Top