[BlueBream] documenting zope3 / bluebream sources?!

[Christophe Combelles]

Le 07/07/2010 20:54, Stephan Richter a écrit :
> On Tuesday, July 06, 2010, Justin Ryan wrote:
>> My mistake, meant apidoc.zope.org, but you may be right that it is
>> worthwhile to consider another generator and build an alt for bb
>> community.

I don't think we need another tool, the original zope3 apidoc is a fantastic 
tool. We could just make it live again in bluebream, and improve it.
Improving means (at least) enabling offline doc generation for a project, to 
allow reading the doc even if the server does not start.

Christophe

>
> Why? None of the existing generators will result in good results. And I would
> hate our docstrings be infested with doxygen hints, especially since most of
> the info is in the interfaces.
>
> Regards,
> Stephan