Skip to content

docs(css): add troubleshooting note for static files and server restart (#1596) - #1906

Closed
xcalibur73 wants to merge 1 commit into
DjangoGirls:masterfrom
xcalibur73:fix-css-static-troubleshooting
Closed

xcalibur73 wants to merge 1 commit into
DjangoGirls:masterfrom
xcalibur73:fix-css-static-troubleshooting

Conversation

@xcalibur73

Copy link
Copy Markdown

Summary of Changes

Resolves #1596.

In en/css/README.md, right after students add the link to �log.css and refresh the page (Figure 14.2), we added an explicit note covering the three common reasons why new custom styles might not reflect:

  1. Restarting the development server: When new static directories (static/css/) are introduced while python manage.py runserver is already running, Django often needs a server restart (Ctrl + C then
    unserver) to detect the newly created path.
  2. Hard refreshing the browser: Browsers frequently serve cached stylesheets; a hard refresh (Ctrl + F5 or Ctrl + Shift + R on Windows/Linux, Cmd + Shift + R on macOS) forces a fresh fetch.
  3. Checking DEBUG = True: Verifying that DEBUG = True in mysite/settings.py so Django continues serving static files during local development.

Verification

  • Markdown formatting verified.
  • Follows the welcoming, beginner-friendly Django Girls tone and style guidelines.

…rt (#1596)

Add troubleshooting guidance covering server restart, browser cache bypass, and DEBUG=True check when newly created static CSS files do not appear after page refresh.
@xcalibur73 xcalibur73 closed this by deleting the head repository Sep 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Missing step in the CSS section

1 participant