Jorge Godoy schrieb:
If you restrict yourself to the wiki then there isn't a lot. :-) Search the archives here and you'll see a lot more of resources and examples. There are blogs with recipes, notes, etc.

I think that scattered notes, hints, mailing list messages etc. don't count as
documentation. If you're determined, you'll get along, but I still maintain
that TurboGears (i.e. the distribution, wiki, trac and amin page) itself has no
proper documentation on widgets.

Have you looked at the toolbox?

'course I did. Here a few examples from the Parameter tag from a few random
widgets:

AJAXRemoteFunction:

loading: No doc available
confirm: No doc available
after: No doc available
update: No doc available
action: No doc available
attrs: No doc available
on_complete: No doc available
loaded: No doc available
on_failure: No doc available
data: No doc available
on_success: No doc available
before: No doc available

TableForm:

submit_text: Text for the submit button
convert: Should the value be coerced by the validator at display?
table_attrs: Extra (X)HTML attributes for the Table tag
method: HTTP request method
action: Url to POST/GET the form data
disabled_fields: List of names of the fields we want to disable
form_attrs: Extra (X)HTML attributes for the form tag

Where is the documentation of 'value'? It's not in here, because it's a
parameter of Widget or CompoundWidget, so it won't show up in the toolbox.
Automatically generated API docs are nice, but they can't cover everything.

Go for it!  But remember that ToscaWidgets will become the standard.

I know. That's what's so fascinating about TurboGears. We don't really need
documentation, because before you'll get to know a component properly, it'll be
replaced by another anyway ;-)


Chris

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"TurboGears" 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?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to