#15134: modelforms documentation appears twice in doctree
-----------------------------------------------------------------+----------
Reporter: Aryeh Leib Taurog <vim@…> |
Owner: nobody
Status: closed |
Milestone:
Component: Documentation |
Version: SVN
Resolution: fixed |
Keywords:
Triage Stage: Ready for checkin | Has
patch: 0
Needs documentation: 0 | Needs
tests: 0
Patch needs improvement: 0 |
-----------------------------------------------------------------+----------
Changes (by anonymous):
* status: reopened => closed
* resolution: => fixed
Comment:
In this instance, I think Russ' fix was appropriate. The entry in the
Topics index didn't belong there, its proper home is in the Forms index.
While I agree that `ModelForms` and `ModelFormsets` are important, they
are accessible from both the Forms index *and* from the front page of the
docs ("forms for models"). I think this is sufficient for arriving at the
correct location.
To the point of "I suggest that [...] the toctree entry in
topics/forms/index be [...] converted to a regular cross-reference link":
That link is using Sphinx's auto-generated TOC mechanism, which creates a
normal cross-reference. It just so happens that the second-level heading
in that document is also marked as an inline code block (which is
perfectly fine). That markup carries across to the TOC, hence the
different appearance.
I'm gonna re-close this as fixed, but thank you for your input Aryeh.
--
Ticket URL: <http://code.djangoproject.com/ticket/15134#comment:5>
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.
