CMSP 31. Version changes

2009-10-09 Thread David Golden
31. Version changes

Proposal:

Description of changes in that versions and tags for changes. Useful for
submission to Freshmeat and for quick review of changes. --Chorny 18:51, 30
September 2009 (BST)


Re: CMSP 31. Version changes

2009-10-09 Thread Steffen Mueller

Hans Dieter Pearcey wrote:

Excerpts from David Golden's message of Fri Oct 09 07:55:36 -0400 2009:

31. Version changes

Proposal:

Description of changes in that versions and tags for changes. Useful for
submission to Freshmeat and for quick review of changes. --Chorny 18:51, 30
September 2009 (BST)


This seems like getting people to agree on a machine-readable changelog format,
which appears only slightly more likely than world peace.  Am I misreading it?


Apart from my usual complaint about where does the information come 
from?, this seems possible enough if you leave most of it up to the 
author: Add a sequence that has a version, an *optional* release date, 
and (a possibly optional) free-form field of changes. Personally, I'd 
like to go one step further and make the free form field really an array 
of free-form fields for individual changes. That offers the opportunity 
for opposed authors to use a single one of them as a free-form field for 
all changes.


Steffen


Re: CMSP 31. Version changes

2009-10-09 Thread Ricardo Signes
* Dieter
 This seems like getting people to agree on a machine-readable  
 changelog format,
 which appears only slightly more likely than world peace.  Am I  
 misreading it?


* Graham Barr gb...@pobox.com [2009-10-09T10:36:48]
 yeah. I can see the benefit of machine readable changelogs. I am just  
 not sure that META is the right place for it.

I opposed the proposal for both the reasons above.

-- 
rjbs


Re: CMSP 31. Version changes

2009-10-09 Thread David E. Wheeler

On Oct 9, 2009, at 8:03 AM, Ricardo Signes wrote:


* Dieter

This seems like getting people to agree on a machine-readable
changelog format,
which appears only slightly more likely than world peace.  Am I
misreading it?



* Graham Barr gb...@pobox.com [2009-10-09T10:36:48]

yeah. I can see the benefit of machine readable changelogs. I am just
not sure that META is the right place for it.


I opposed the proposal for both the reasons above.


-1 Agreed.

David



Re: CMSP 31. Version changes

2009-10-09 Thread David Golden
On Fri, Oct 9, 2009 at 7:55 AM, David Golden xda...@gmail.com wrote:
 31. Version changes

 Proposal:

 Description of changes in that versions and tags for changes. Useful for
 submission to Freshmeat and for quick review of changes. --Chorny 18:51, 30
 September 2009 (BST)

-1 for moving all of the changelog into META

+0.5 for a keyword that contains text describing the *latest* change.
No dates/tags/structure, etc.  Just text.

This would allow authors to specify change notes in a way that
search.cpan.org or other sites could read without having to parse
Changes themselves.  It puts the burden on authors, not indexers.

-- David