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
32654	docstring in modules created by startapp	Sandro Covo	nobody	"I propose to add a docstring to the files created by startapp, similar to the docstrings that are included in the modules created by `startproject`.

They could include some information about when and for what version they were generated and some directions for users on what to do in the modules.

The `models.py` for example includes a comment `# create your models here` or `# Create your views here.`, which I think is not extremely helpful, either you know about models already, in which case you would know what to do without this comment. Or you don't know anything about models, in which case you need more information on how to proceed. I suggest having a short paragraph about the modules with a link to the django documentation. I think that serves new users as well as more experienced users, if the want to look something up.

For some modules it might make sense to include a bit of a template for an actual docstring, maybe like: ""This module contains the models for the {{appname}}-app"".
"	Uncategorized	closed	Core (Management commands)	3.2	Normal	wontfix	startapp documentation		Unreviewed	0	0	0	0	1	0