documentation changes for serving static media
|Reported by:||Owned by:||nobody|
|Severity:||Keywords:||media static ADMIN_MEDIA_PREFIX|
|Has patch:||no||Needs documentation:||no|
|Needs tests:||no||Patch needs improvement:||no|
In the above documentation it does not mention that for your own project you should choose a url different from ADMIN_MEDIA_PREFIX for serving static files.
Also based on the settings file and website http://www.djangoproject.com/documentation/settings/, it seemed that MEDIA_URL was related to serving static media. Perhaps changing the default comments in settings.py to better explain when MEDIA_URL is actually used, and even perhaps mentioning that static files need to be dealt with another way.
Also, ADMIN_MEDIA_PREFIX would be better explained as the "URL prefix for media in the admin project". As it stands in the settings and online documentation http://www.djangoproject.com/documentation/settings/, it is the "URL prefix for admin media". To me admin media sounds like media owned by the administrator, which could mean all media.
Finally, there are a few tricks to getting CSS files to work within a template (you might tell where I tripped up). Adding a simple explanation to the tutorial I think would save many people some time.
Change History (3)
comment:1 Changed 9 years ago by
|Patch needs improvement:||unset|
|Summary:||documentation should say /media is a reserved URL → documentation changes for serving static media|