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
5647	Your First App - URL section - too complex - suggestions	john.staff2222@…	nobody	"Yikes, the section on URL's is really too complex for ""First App"" - it's great that Django has all that power but especially for the ""First App"" the poor new user does not need to be exposed to that much - it's pretty overwhelming.  So let's just use a simple example:

""(r'^mymodel/list/$', 'myproject.myapp.views.mymodel_listing'),""

forget the part of using ""/include"" - a first app doesn't need that level of detail.

Just keep the focus on how the user needs to provide a translation table of what the URL is and what it calls - and why the user needs to do this manually in Django as opposed to how it's automatically done in Rails.  But I would add a ""Tip"" window that explains how the ""myproject.myapp.views"" can be moved to the patterns parameter for easier listings (I just discovered this rereading the section).  Anything easier, simpler should always be highlighted in a ""Tips"" box 
"		closed	Documentation	dev		wontfix			Design decision needed	0	0	0	0	0	0