Opened 11 years ago

Closed 10 years ago

#22796 closed Cleanup/optimization (fixed)

"Working with forms" docs need improving

Reported by: Daniele Procida Owned by: Daniele Procida
Component: Documentation Version: dev
Severity: Normal Keywords:
Cc: Triage Stage: Accepted
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: yes
Easy pickings: no UI/UX: no

Description

Our main "introduction to forms" documentation is ​https://docs.djangoproject.com/en/dev/topics/forms/

It lacks sufficient basic explanation of web form handling in general to be useful to someone who is tackling this for the first time.

It also contains some sections that mention, but offer no explanation of, matters that don't need to be in an introductory document.

It also interrupts its own basic explanations with unnecessary reference to much more advanced concepts.

Change History (5)

comment:2 by Tim Graham, 11 years ago

Has patch: set
Triage Stage: Unreviewed → Ready for checkin

comment:3 by Daniele Procida, 11 years ago

Owner: changed from nobody to Daniele Procida
Status: new → assigned

comment:4 by Tim Graham, 11 years ago

Patch needs improvement: set
Triage Stage: Ready for checkin → Accepted

Some more comments have been left on the PR.

comment:5 by Tim Graham <timograham@…>, 10 years ago

Resolution: → fixed
Status: assigned → closed

In 60375eda324d708870dc2ba18b4ac4d6114a68f6:

[1.7.x] Fixed #22796 -- Added a more basic explanations of forms.

Thanks bmispelon, kezabelle, jorgecarleitao, and timgraham for reviews.

Backport of cd20b5d186 from master

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