#5647: Your First App - URL section - too complex - suggestions
-------------------------------------+--------------------------------------
Reporter:  [EMAIL PROTECTED]  |       Owner:  nobody       
  Status:  new                       |   Component:  Documentation
 Version:  SVN                       |    Keywords:               
   Stage:  Unreviewed                |   Has_patch:  0            
-------------------------------------+--------------------------------------
 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

-- 
Ticket URL: <http://code.djangoproject.com/ticket/5647>
Django Code <http://code.djangoproject.com/>
The web framework for perfectionists with deadlines
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"Django updates" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at 
http://groups.google.com/group/django-updates?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to