Christian Theune a écrit :
Hi,
KLEIN Stéphane wrote:
I wonder whether we can add README file at subversion root directory
to explain how differentiate zope 2 from Zope 3 project ?
I suggest this content :
"""
Frequently Asked Question :
Q : What directory are Zope 2 and Zope 3 projects ?
A : There aren't simple rules. First, every directory that begins with
"Products." is a Zope 2 project. Every directory that begins with
"z3c" or "zc" is a Zope 3 project. For every other directory, you have
to look at its files. If there are files with zcml extension then it's
a Zope 3 project. Otherwise read the README file to see if it's a Zope
2 or a Zope 3 project
"""
I this should go into the developer guidelines/SVN area in the wiki.
some thoughts
The problem is there is (unless unkown to me) no central description web site
for all these components. Everything is in a deep svn hierarchy, and there is no
way to know which one is in a finished or usable state, which one is deprecated,
which one is for zope2 or zope3, etc.
So when we want to find a component, we end up in http://svn.zope.org
and there is no information. Such a Readme file would be at least the very
beginning of a documentation for these components, or at least a way to
diffentiate them.
Today I found a message from early 2005 speaking about the problem with zope3
communication, presentation and documentation.
http://faassen.n--tree.net/blog/view/weblog/2005/04/06/0
Nothing has changed and today there is absolutely nothing to nicely present
Zope3 apart from the complicated and multiples wikis.
However it seems that the eggification has brought some standard files such as
CHANGES.txt INSTALL.txt MANIFEST.in README.txt
Maybe it would be possible to use these files, and maybe to add a few others, to
automatically generate a nice web site with the component list, their
description, their state, their documentation, etc.?
That way, the site would be automatically updated along with the svn when the
developpers commit changes to it.
Christophe
___
Zope3-dev mailing list
Zope3-dev@zope.org
Unsub: http://mail.zope.org/mailman/options/zope3-dev/archive%40mail-archive.com
