Opened 18 years ago

Closed 18 years ago

#4232 closed (fixed)

Update to the newforms documentation

Reported by: heckj@… Owned by: Jacob
Component: Documentation Version: dev
Severity: Keywords: newforms documentation
Cc: heckj@… Triage Stage: Ready for checkin
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

In learning about how to use the newforms from within the templates, I thought I'd write it up from a template designer's point of view to make the newforms a little more accessible. I've submitted the update to the docs as a patch, attached to this bug.

Attachments (4)

newforms.diff​ (2.0 KB ) - added by heckj@… 18 years ago.
documentation updates
newforms.2.diff​ (4.1 KB ) - added by heckj@… 18 years ago.
documentation updates v2
4232.diff​ (4.2 KB ) - added by heckj@… 18 years ago.
final update - cleaned up view per request and removed nasty tabs
4232.2.diff​ (4.2 KB ) - added by heckj@… 18 years ago.
Update to the diff after checkins [5219], [5222], and [5237] (easier merge)

Download all attachments as: .zip

Change History (11)

by heckj@…, 18 years ago

Attachment: newforms.diff​ added

documentation updates

comment:1 by Simon G. <dev@…>, 18 years ago

Summary: [patch] update to the newforms documentation → Update to the newforms documentation
Triage Stage: Unreviewed → Accepted

Looks like a good start!

by heckj@…, 18 years ago

Attachment: newforms.2.diff​ added

documentation updates v2

comment:2 by heckj@…, 18 years ago

I added some more documentation - putting in an example view just above "Outputting to HTML" to bring together all of the components above. I also put in a few more "template" references on rendering of the form using shortcuts as_p, as_ul, and as_table.

comment:3 by Gary Wilson <gary.wilson@…>, 18 years ago

Patch needs improvement: set

Thanks for the documentation. Is this complete now, or are you still working on this?

A few comments:

  • It appears that you have possibly mixed some tabs in there as the indention is nonuniform.
  • In the view code, I believe it is better practice to use "if request.method == 'POST'" instead of "if request.POST".

in reply to:  3 comment:4 by anonymous, 18 years ago

Replying to Gary Wilson <gary.wilson@gmail.com>:

Thanks for the documentation. Is this complete now, or are you still working on this?

A few comments:

  • It appears that you have possibly mixed some tabs in there as the indention is nonuniform.
  • In the view code, I believe it is better practice to use "if request.method == 'POST'" instead of "if request.POST".

I'll clean up the tabs and change the view code per your suggestions, then I'll call it done for this set. I need to learn more about Widgets and the variety of ways of using them before I attack more docs.

by heckj@…, 18 years ago

Attachment: 4232.diff​ added

final update - cleaned up view per request and removed nasty tabs

comment:5 by heckj@…, 18 years ago

Added that final cleanup update. The previous diff can be deleted.

comment:6 by Gary Wilson <gary.wilson@…>, 18 years ago

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

by heckj@…, 18 years ago

Attachment: 4232.2.diff​ added

Update to the diff after checkins [5219], [5222], and [5237] (easier merge)

comment:7 by Malcolm Tredinnick, 18 years ago

Resolution: → fixed
Status: new → closed

(In [5294]) Fixed #4232 -- Added example usages to the newforms documentation. Thanks, Joe
Heck.

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