id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
14528	django.contrib.staticfiles documentation issues	Brian Neal	Jannis Leidel	"While reading the docs for this new app and trying to understand it, I've found some minor documentation type issues.

 1. [http://docs.djangoproject.com/en/dev/ref/contrib/staticfiles/#staticfiles-finders Here] it says AppDirectoriesFinder looks in a {{{ static }}} directory. But [http://docs.djangoproject.com/en/dev/ref/contrib/staticfiles/#django-admin-collectstatic here] it says the command looks in a {{{ media }}} directory.
 1. [http://docs.djangoproject.com/en/dev/ref/contrib/staticfiles/#django-admin-collectstatic Here] the 2nd paragraph just abruptly ends (""the findstatic command can help show you where"").
 1. [http://docs.djangoproject.com/en/dev/ref/contrib/staticfiles/#staticfiles-url Here] the second example has misspelled ""example.com"".
 1. The note under [http://docs.djangoproject.com/en/dev/ref/contrib/staticfiles/#staticfiles-finders here] has some sphinx markup mistakes (""When using the :class:AppDirectoriesFinder`"")
 1. Do you want to mention the staticfiles application in [http://docs.djangoproject.com/en/1.2/howto/static-files/#module-django.views.static this section] of the docs?

And maybe this is out of scope for a typo only ticket, but I for one would appreciate some guidance or background on this application and how it relates to MEDIA_ROOT and MEDIA_URL. Maybe stress that MEDIA_URL and MEDIA_ROOT are for files users upload, while staticfiles handles static media for apps (assuming I've correctly interpreted the purpose correctly). I assume this app is trying to solve the problem of getting app media mixed up with user uploaded media?

Thanks!"		closed	Documentation	dev		fixed	staticfiles docs		Accepted	0	0	0	0	0	0