Opened 3 years ago

Closed 3 years ago

Last modified 3 years ago

#19217 closed Uncategorized (invalid)

Make it Simple

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

Description

I know django has made things simple and I like the first tutorial also but the moment I try to explore about the static files I start wasting my time more and more..https://docs.djangoproject.com/en/dev/howto/static-files/ - This doc doesn't help at all - I may be dumb but really this is not what user needs. Its haphazard and confuses the user a lot. It should be simple step by step kind of thing. Too many questions asked on stackoverflow.com website about django static files proves that this doc is actually not helping. I went through some 10 questions on Django static files over that site and read the docs but it doesn't help. People are still asking questions on the same thing again and again.

I am still unable to use a simple css file for my first flatpage. May be it will take some 2-3 days before I figure it out - what exactly the doc is trying to say - may be not and I have to ask someone. Will see.

Change History (2)

comment:1 Changed 3 years ago by ptone

  • Needs documentation unset
  • Needs tests unset
  • Patch needs improvement unset
  • Resolution set to invalid
  • Status changed from new to closed

I'm sorry the docs didn't work out for you. We always welcome specific issues and potential improvements. However in this case there is nothing specific or actionable other than a vague "these docs are bad - please improve them". Without something specific, this isn't a valid ticket.

comment:2 Changed 3 years ago by aaugustin

The "Basic usage" section at the beginning of the static files docs is a three-step guide to a working setup:

  • 1) "Put your static files within static/ subdirectories of apps in your INSTALLED_APPS."
  • 2) "Make sure that django.contrib.staticfiles is included in your INSTALLED_APPS."
  • 3) "Refer to you static files like this: <img src="{{ STATIC_URL }}images/hi.jpg" alt="Hi!" />"

Which one of these bullet points confused you?

PS: many answers to Django-related questions on StackOverflow are wrong; I wouldn't suggest looking there for advice.

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