[Twisted-web] Re: Thoughts on documentation, wading into Twisted, Nevow, etc.

[Beau Hartshorne]

On 7-Jul-06, at 5:12 PM, Valentino Volonghi aka Dialtone wrote:

> The main question is for sure the following:
> - How can I authenticate with guard using a database? (talk about  
> writing checkers)
> - How can I use an ORM inside Nevow? (talk about Axiom,  
> twisted.enterprise.adbapi, sqlalchemy+sAsync or simpler  
> transactionToThread)
> - How do I handle forms in Nevow? (talk about formal)
> - What's the preferred way to share global state in a Nevow  
> application? (talk about passing something in the root page and  
> having the root page to pass that over and over to all children)
> - How do I do nested sequences? (there's already an example, should  
> be better documented)
> - Man I hate how nested data_* directives behave, what are they  
> doing? (talk about IContainer)
> - What is a macro? (talk about one-time renderers)
>
> And other questions that currently I can't remember.

Those sound more like a FAQ. How about titles more like:
- Authenticating Web Users
- Using ORMs (Databases)
- Parse and Validate a Form
- Share Global State
- Rendering Nested Sequences
- Nested Data Directives
- One-time Renderers

And maybe:
- User Sessions
- Virtual Host Setup