[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