Manlio Perillo <[EMAIL PROTECTED]> 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 those? -- Dave Abrahams Boost Consulting www.boost-consulting.com _______________________________________________ Twisted-web mailing list [email protected] http://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-web
