id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
3255	[patch] Addition of help_text argument to newforms fields	Ben Slavin	Adrian Holovaty	"Forms often provide additional information related to fields to provide guidance to users.

Example of additional information in forms:
{{{
   Username: [__________]
             ex. bsmith
   E-mail:   [__________]
             ex. bob@example.com
}}}


Newforms provides the ability to modify the label for form fields, but not to provide further descriptive text.  This problem has been brought-up on both the developer and user mailing lists.  I propose the addition of a help_text argument for form fields -- this is similar to the argument by the same name for models.

Example of functionality:
{{{
#!python
>>> class UserRegistration(Form):
...    username = CharField(max_length=10, help_text='Ex. user@example.com')
...    password = CharField(widget=PasswordInput)

>>> p = UserRegistration(auto_id=False)
>>> print p.as_ul()
<li>Username: <input type=""text"" name=""username"" maxlength=""10"" /> Ex. user@example.com</li>
<li>Password: <input type=""password"" name=""password"" /> </li>
}}}"	enhancement	closed	Forms		normal	fixed			Design decision needed	1	0	0	1	0	0