On 2/6/07, Ian Wilson <[EMAIL PROTECTED]> wrote:
>
> Hello Hello,
>
very nice layout indeed, I agree with Kevin comments and here are some more.

> First off I think we need two major documents.  One that is just a
> boring reference of what core widgets are available and what they
> actually do.
this should be solve with the api docs, although for some reason
epydoc is failing to get the widgets package, maybe it's all that
magic :)

> 3. Form Widget + Validation
>   -this is a little sloppy and inconsistent so it will be hard to
> explain, since validators and widgets are really not that related but
> _seem_ to be
> a.how validators are assigned to widgets(forms/schemas/inside forms)
> b.how a select field guesses validators(I don't really know how this
> works but there is something fishy here and it needs to be documented
> somewhere even if its just to say _always_ give them a validator or it
> doesn't work right)
>
I think there should be an explanation of plain validators first maybe
just a link to the validators page, this will to be make people see
that they are just two different things that work fine with eachother.

> 5. Examples(We can pull a lot of this from a the old trac docs and
> then start getting rid of them)
> a.we need to display how you use all the core widgets(_actually_ use),
> my biggest pet peeve was it took me forever to figure out how to get
> options/repetitions to the right widget at display time, so maybe one
> uber form that does everything with validators would do it.
>
I think we should work on the widgetbrowser a little more, the samples
there are very confusing to someone just starting. and then have a set
of examples that combine widgets.

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"TurboGears Docs" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at 
http://groups.google.com/group/turbogears-docs?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to