Vedr. [Zope3-Users] Zope 3 API documentation needs a new strategy

Luciano Ramalho ramalho at
Wed Jul 18 17:07:14 EDT 2007

On 7/18/07, Benji York <benji at> wrote:
> Does help?

Not really. Before yesterday, there was no explanation about how to
access apidoc (I put that in the linked page APIDocTool yesterday).

The apidoc tool itself is limited. For debugging purposes, it might be
useful that the search is limited to registered interfaces. But while
reading about Zope 3 I wanted to check on IComponentArchitecture but
the search could not find it. I had to use grep to find it and learn
the path that I could use to browse to it in the apidoc:


And finally, the wiki Documentation page does not mention the abundant
README.txt files scattered all over the source tree where the real
documentation exists.



PS. BTW, I'd like to mention that besides the people who replied in
the list, I got pvt replies of people saying that they feel the same
way as I do about the current docs.

More information about the Zope3-users mailing list