[Zope3-dev] RFC: ViewDirectoryHierarchyReorganization

holger krekel pyth@devel.trillke.net
Thu, 28 Nov 2002 22:00:25 +0100


Stephan Richter wrote:
> On Wednesday 27 November 2002 17:07, holger krekel wrote:
> > You are right :-)  If we are not caught writing fiction only then
> > i'd still like to do some coding.  I still believe that a Zope3
> > Documentation Component or Service (?) could ease Zope3 adoption, at least
> > on my part :-)
> 
> Holger,
> 
> see my Online Help Proposal. I also spiffed up the Documentation SubProject 
> Page quiet a bit recently.

thanks for the pointer.  But this proposal is only about 'static'
documentation rather than generated (e.g. out of docstrings) documentation, right?

IMO Martijn's proposal is about aiding Web Designers with interface
information (and trying to not bother them with implementation locations). 

Of course, 'static' documentation has its place, too.  And e.g.
in static documentation, references to Interfaces should be
cross-referenced when viewed with a browser.  

    holger