[SVN] Bundle release notes

Allan Odgaard throw-away-1 at macromates.com
Fri Aug 4 16:25:41 UTC 2006


Since bundles are such an integral part of TextMate, Brad Choate  
requested that changes to these make it into the programs release  
notes, with which I agree.

But of course not if this can’t be automated ;)

So my suggestion is that all lines prefixed with [keyword] from the  
commit messages are automatically captured for the release notes  
(keyword should preferably be: NEW, FIXED, CHANGED, REMOVED, or INFO.)

In addition mentioning a ticket (in such line) matched using /ticket  
\h{8}/ will automatically close that ticket with the commit message  
when the build with this change goes public [1].

Two concerns here:

  1. For presenting the release notes I will prefix or group notes  
with their corresponding bundle. This means that one should not  
commit changes to two bundles at the same time and make a note which  
applies only to one (actually, one should not do this anyway.)

  2. Currently the release note system is made so that entries can  
only be a single line. Maybe this is too limiting? If so probably an  
entry should just continue to next [keyword] or end-of-message.

I was also planning to add the full name of the committer, unless  
there are objections. This should also make it more transparent for  
users who works on what.


[1] I will also look into expanding the ticket system so bundle  
authors can own tickets etc. though this is a little long-term.




More information about the textmate-dev mailing list