[Twisted-web] Re: nevow documentation

David Abrahams dave at boost-consulting.com
Wed May 31 13:48:06 CDT 2006

Manlio Perillo <manlio_perillo at libero.it> writes:

> 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.

I also have a few suggestions for fairly minor edits that would
improve the comprehensibility of these docs.  Where should I report

Dave Abrahams
Boost Consulting

More information about the Twisted-web mailing list