[Zope] Wish for the next Zope Release: Doc tab for every Zope entity

Chris McDonough chrism@digicool.com
Fri, 1 Sep 2000 08:48:16 -0400


> Is DC planning to do something in that matter?

It's not a priority right now.  You may want to propose something on
dev.zope.org if you think you have an idea of how it should work.

> 
> also the docstring should perhaps not be just one property, but
> structured (author,parameters,prerequisites...) as it is in
> javadoc (ok, we don't like java, but thats a point where we 
> can learn from java)

Good point.

> 
> The next point:
> if there is a 'Documentation' tab then
> every Zope developer is leaded to document his code.
> ( DTML is not always simple to read for other people except 
> the author ;-)

Perhaps.  It depends on the developer.

> 
> just my 2 cents...

Thanks...

> phil
> *********** REPLY SEPARATOR  ***********
> 
> On 01.09.2000 at 08:16 Chris McDonough wrote:
> 
> >I agree that instances of DTML methods, DTML documents, SQL methods,
> >Python methods, objects based on ZClasses, etc. should have 
> "docstring"
> >capabilities in some sort of common-denominator fashion.
> >
> ><dtml-comment> is the only way this can be done for DTML methods.
> >
> >The other objects can have properties, which could be documentation.
> >
> >-----Original Message-----
> >From: Philipp Auersperg [mailto:zope@philosoft.at]
> >Sent: Friday, September 01, 2000 6:23 AM
> >To: zope@zope.org
> >Subject: [Zope] Wish for the next Zope Release: Doc tab for 
> every Zope
> >entity
> >
> >
> >Mostly when developing a project it should be documented as well :)
> >The best would be a strucutral documentation that can be generated 
> >out of the project so that it always keeps track of the 
> software and is
> >up to date
> >
> >- Python has that because there are the doc strings for classes and
> >methods
> >- Java has it (javadoc)
> >- Zope - ?
> >
> >For Zope it would be fine if every entity in the ODB has a
> >'Documentation' tab
> >So I could when developing a Zope site always on the fly document its
> >structure 
> >without having to leave y developing environment.
> >
> >Then its an easy thing to write a doc generator that queries 
> the objects
> >in the ODB
> >and their documentation.
> >
> >Did I miss something and such a beast exists or is there really
> >something to be done?
> >I don't mean documentation in <dtml-comment>, I mean documentation as
> >seperate 
> >property for each object and method.
> >
> >Philipp Auersperg (zwork)
> 
> 
> 
> 
> _______________________________________________
> Zope maillist  -  Zope@zope.org
> http://lists.zope.org/mailman/listinfo/zope
> **   No cross posts or HTML encoding!  **
> (Related lists - 
>  http://lists.zope.org/mailman/listinfo/zope-announce
>  http://lists.zope.org/mailman/listinfo/zope-dev )
>