Manlio Perillo
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 those? -- Dave Abrahams Boost Consulting www.boost-consulting.com