[Zope3-dev] the maintenance of change logs

[Jim Fulton]

On Sep 22, 2006, at 12:52 PM, Martijn Faassen wrote:

> Jim Fulton wrote:
...
>> Some things to note:
>> I knit all of the .txt files, including documentation-oriented  
>> doctest files together in the distutils long description.  This  
>> causes the pypi page to be pretty informative:
>>   http://www.python.org/pypi/zc.buildout
>
> I looked into doing this for zc.catalog as well, but in the end  
> decided not to. zc.catalog contains quite a few doctests and the  
> knitting would be quite involved, so I deferred the work.

I bet it has fewer doc files that zope.testing. http://www.python.org/ 
pypi/zope.testing, and the knitting wasn't that hard,
http://svn.zope.org/zope.testing/trunk/setup.py?view=markup.


> While I'm happy with the way this works now as it's agile, I am  
> also hoping that eventually we can move away from the cheeseshop as  
> the prime documentation site of a project; it's not ideally suited  
> for that.

It's not bad either, IMO.  Anyway, in the mean time, I suggest that  
if we try to standardize on anything, I suggest we follow a mechanism  
that works *now*.

...

> Anyway, we need to start writing this stuff down in an easily found  
> place. Like zope.org...

While I feel what I'm doing is still somewhat experimental, I'm happy  
to write it down somewhere, if someone will tell me where. :)

Jim

--
Jim Fulton			mailto:jim at zope.com		Python Powered!
CTO 				(540) 361-1714			http://www.python.org
Zope Corporation	http://www.zope.com		http://www.zope.org