Opened 16 years ago

Closed 16 years ago

Last modified 13 years ago

#8006 closed (invalid)

ModelForm documentation too well hidden?

Reported by: gwynevans Owned by: nobody
Component: Documentation Version: dev
Severity: Keywords: forms modelforms
Cc: Triage Stage: Accepted
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

It seems to me that the link to the ModelForm documatation (http://www.djangoproject.com/documentation/modelforms/) is somewhat hidden, in that as far as I could see, it only appears at around the 3/4 mark of the form documentation, far enough down that even to see the entry in the TOC, most people will have had to page down once or twice! I'd suggest that it either needs to be linked from the top Documentation page or failing that, move its line/link on the Forms documentation up to the top of that document.

Change History (4)

comment:1 by Malcolm Tredinnick, 16 years ago

milestone: 1.0 beta

comment:2 by adamfast, 16 years ago

milestone: 1.0
Triage Stage: UnreviewedAccepted

comment:3 by Julien Phalip, 16 years ago

Resolution: invalid
Status: newclosed

I agree your request was valid considering the old documentation. However, as I see it now after doc-refactor, ModelForm is referenced at least twice -- in the "Form objects" and the "Further topics" sections -- which is not bad for just an introduction to forms.
http://docs.djangoproject.com/en/dev/topics/forms/

If you think ModelForm is still too hidden and want to reopen this ticket, please also provide a patch. That would make it much easier to review the pertinence of the proposal.

comment:4 by Jacob, 13 years ago

milestone: 1.0

Milestone 1.0 deleted

Note: See TracTickets for help on using tickets.
Back to Top