[Twisted-web] nevow documentation

[Beau Hartshorne]

On 26-May-06, at 7:16 AM, Manlio Perillo wrote:

> Hi.
>
> The base documentation for Nevow is very well written (it is very
> unfortunate that Donovan Preston no longer maintain Nevow).
>
> Is this documentation up to date with the current versione of twisted?
>
> What are the most important missing features?
>
> As I can see:
> - more detailed documentation of IRequest.
>   As an example 200, 404 and 500 return code are automatically  
> generated
> by Nevow (when rendering a resource, when returning None by
> locateChildren and bu raising an exception in a renderer, ***what  
> else?***
>
> - documentation of interfaces like IContainer, ISession and IRenderer,
> ICanHandleException, IHand?, ...
>
> - more detailed documentation about context (remember, ...)
>
> - documentation for macro
> - documentation for fragments
> - documentation for guard
>
> - some interfaces are not documented at all
> (as ISettable, IStatusMessage, ...)
>
>
> All this stuff is explained in the examples but it can help a lot to
> have them organized in a better way.

There are a few extra gems you can find from here:
http://divmod.org/trac/wiki/TitleIndex

I am not a project contributor, but if you notice anything that could  
be better (like a page that serves as a comprehensive documentation  
index) please add it to the wiki.

Beau