#15134: modelforms documentation appears twice in doctree
---------------------------------------------------+------------------------
 Reporter:  Aryeh Leib Taurog <v...@aryehleib.com>  |       Owner:  nobody    
   Status:  new                                    |   Milestone:            
Component:  Documentation                          |     Version:  1.2       
 Keywords:                                         |       Stage:  Unreviewed
Has_patch:  0                                      |  
---------------------------------------------------+------------------------
 docs/topics/forms/modelforms.txt is included in the toctree from two
 locations:
  * docs/topics/index.txt
  * docs/topics/forms/index.txt

 This is confusing for the reader.

 I suggest that the toctree entry in topics/index be retained and the
 toctree entry in topics/forms/index be removed or converted to a regular
 cross-reference link.  The reasons I would prefer that are:
  1. ModelForms is sufficiently large, complex, and important a topic to
 warrant it's own section
  2. It will be easier to find in the docs if it has a 2nd-level heading
  3. It doesn't make sense to introduce ModelFormsets before introducing
 Formsets

-- 
Ticket URL: <http://code.djangoproject.com/ticket/15134>
Django <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 django-updates@googlegroups.com.
To unsubscribe from this group, send email to 
django-updates+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/django-updates?hl=en.

Reply via email to