Opened 11 years ago

Closed 6 years ago

Last modified 6 years ago

#22390 closed Cleanup/optimization (fixed)

Document restart required after adding statics directory: tutorial part 06

Reported by: anonymous Owned by: nobody
Component: Documentation Version: 2.1
Severity: Normal Keywords: docs tutorial static
Cc: Triage Stage: Accepted
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: yes UI/UX: no

Description

The intro tutorial on the Polls app:

https://docs.djangoproject.com/en/1.6/intro/tutorial06/#customize-your-app-s-look-and-feel

describes setting up a static folder. It is completely correct, but doesn't mention that a restart of the server is required to pick up the newly created statics folder.

Where it says:

That’s all you need to do for development. Reload http://localhost:8000/polls/ and you should see that the poll links are green (Django style!) which means that your stylesheet was properly loaded.

It would be clearer to say:

That’s all you need to do for development. Restart the server with python manage.py runserver, then reload http://localhost:8000/polls/ and you should see that the poll links are green (Django style!) which means that your stylesheet was properly loaded.

Change History (7)

comment:1 by Tim Graham, 11 years ago

Resolution: worksforme
Status: newclosed

It works for me without a server restart.

comment:2 by Bob Kline, 6 years ago

Version: 1.62.1

This might be working without the restart for some developers, but I spent quite a while trying to figure out what was going on, until I stumbled across this ticket. How hard would it be for the tutorial to mention that you might need to restart the server in order for the style changes to be picked up?

comment:3 by Tim Graham, 6 years ago

I think we would first like to understand the root cause of why it works sometimes but not others, if that's the case.

comment:4 by Tim Graham, 6 years ago

Resolution: worksforme
Status: closednew
Triage Stage: UnreviewedAccepted

This was reported again in #29909. After retesting, I can't see why it would work without restarting the server, however, there's nothing saying to start the server earlier. Nonetheless, I'll submit a clarification.

comment:5 by Tim Graham, 6 years ago

Has patch: set

comment:6 by GitHub <noreply@…>, 6 years ago

Resolution: fixed
Status: newclosed

In d8f8353:

Fixed #22390 -- Doc'd possible server restart required in tutorial 6.

comment:7 by Tim Graham <timograham@…>, 6 years ago

In 1df26757:

[2.1.x] Fixed #22390 -- Doc'd possible server restart required in tutorial 6.

Backport of d8f83531c2dc40a7add4afc5b917c1e5a7452be8 from master.

Note: See TracTickets for help on using tickets.
Back to Top