#22796 closed Cleanup/optimization (fixed)

"Working with forms" docs need improving

Reported by: EvilDMP Owned by: EvilDMP
Component: Documentation Version: master
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


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 Changed 18 months ago by timo

  • Has patch set
  • Triage Stage changed from Unreviewed to Ready for checkin

comment:3 Changed 18 months ago by EvilDMP

  • Owner changed from nobody to EvilDMP
  • Status changed from new to assigned

comment:4 Changed 18 months ago by timo

  • Patch needs improvement set
  • Triage Stage changed from Ready for checkin to Accepted

Some more comments have been left on the PR.

comment:5 Changed 17 months ago by Tim Graham <timograham@…>

  • Resolution set to fixed
  • Status changed from assigned to 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