Alberto Valverde schrieb:
> so I'll *try* writting a more general widget oerview.
Hi Alberto,
I just had a private email conversation with Florent Aide about the widget docs
and I was planning to start a comprehensive overview about widgets myself.
Since I don't think that I would be able to finish such an undertaking in a
single day, it would be perfect, if we could share the work on this.
Below follows a preliminary draft of the doc structure resp. the points I would
like to see covered. Some of these topics are already (partly) covered by
existing wiki pages and for some there are good emails from you or others that
could be used as a basis.
What do you think about it?
Chris
Widget documentation
--------------------
- What are widgets?
- What can/should you use widgets for?
- What are the parts of a widget?
- template
- JavaScript
- CSS
- glue code (i.e. __init__(), update_params())
- sub/compound widgets
- validators
- How to use TG standard widgets
- instantiation (__init__ parameters)
- passing the widget to your template
- widget display (parameters)
- How to structure your code, i.e. where to put what
- How to create your own custom widgets
- Simple widgets
- Compound widgets / Forms
- Widget lists
- Validation schema
- Custom validators
- Controller methods:
- validation
- error handling
- form submission handling
- Custom JavaScript / CSS code
- Dataflow
- between a widget and the controller.
- JavaScript / CSS inclusion
- ???
--~--~---------~--~----~------------~-------~--~----~
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
-~----------~----~----~----~------~----~------~--~---
