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
28403	Improve the example for FORMAT_MODULE_PATH and add missing formats	karyon	Ashaba John	"two issues with the [https://docs.djangoproject.com/en/dev/ref/settings/#std:setting-FORMAT_MODULE_PATH documentation for FORMAT_MODULE_PATH]:

first, it suggests to create this directory structure: 

{{{
mysite/
    formats/
        __init__.py
        en/
            __init__.py
            formats.py
}}}

since i didn't like adding a new {{{formats}}} folder for that, i first did not use {{{FORMAT_MODULE_PATH}}}. then i realized i could use the locale path for that, and then i saw that even django itself does that. so, my first suggestion is to replace {{{formats/}}} by {{{locale/}}} in that directory structure, and maybe even explicitly add a sentence how the locale directory can be used for the formats.

second, the docs say something about ""available formats are:"" and then a long list of settings. to me it seems like {{{DATE_INPUT_FORMATS}}} and {{{DATETIME_INPUT_FORMATS}}} are missing from this list. if they were excluded for a specific reason, that should be stated there as well."	Cleanup/optimization	closed	Documentation	1.11	Normal	fixed			Ready for checkin	1	0	0	0	0	0