#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 , 11 years ago
Resolution: | → worksforme |
---|---|
Status: | new → closed |
comment:2 by , 6 years ago
Version: | 1.6 → 2.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 , 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 , 6 years ago
Resolution: | worksforme |
---|---|
Status: | closed → new |
Triage Stage: | Unreviewed → Accepted |
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.
It works for me without a server restart.