On Aug 20, 2007, at 8:22 PM, Stephan Richter wrote:
On Saturday 18 August 2007 17:03, Philipp von Weitershausen wrote:
* Please also don't forget to add a changelog entry in README.txt,
especially if you're adding features. If there's no README.txt
is a good time to give it one. It should start out with a simple
paragraph and have at least one section called "Changes". You
use its contents as the long_description in setup.py. Other packages
(e.g. zope.proxy or zope.publisher) can serve as examples.
Why do the changes have to be part of the README file? That seems
no good. I
think a separate file is much better.
If you use a separate file, and you are going to create a source
distribution, then you need to have extra magic in your setup.py to
include CHANGES.txt in the distribution. IMO, setup magic is bad.
I'd prefer to see simpler setup.py files and thus I prefer to include
the change log in README.txt.
Jim Fulton mailto:[EMAIL PROTECTED] Python
CTO (540) 361-1714
Zope Corporation http://www.zope.com http://www.zope.org
Zope3-dev mailing list