The solution to this problem (if it is really a problem) is to keep
around a side file with some errata.  I have such a side file that I
use with my script which compares two branches via git log.  There's
always commits where the wrong message got applied, or the jira number
was missing, or etc.  You can just have your script ignore those
commits.  Real-world data is always a little dirty.

Anyway, as Allen mentioned earlier, the git log is more likely to be
correct than CHANGES.txt, since git never forgets to handle merges and
cherry-picks, and humans often do.  I think it's pretty rare to
remember to do one but forget the other.  It is true that CHANGES.txt
can be mutated, whereas commit hashes cannot.  But if the CHANGES.txt
change update was a separate commit, most people doing backports and
cherry-picks will miss it, so... I wouldn't count on that really
helping things much.

I certainly have no objection to generating CHANGES.txt and release
notes off JIRA, which avoids some of these problems (jiras can be
edited, after all).  But JIRA has its own set of problems... it's not
always available and it's centralized.  If the JIRA REST APIs change,
or the data center loses its backups, or you don't have a network
connection, you can't examine JIRA.  But you can always examine git
log.

Colin

On Tue, Apr 7, 2015 at 3:51 PM, Allen Wittenauer <a...@altiscale.com> wrote:
>
> For those wondering, YARN-2429 is the wrong JIRA for that commit.  Simple 
> typo, but deadly if one is using to use the git log to determine what’s 
> actually committed...
>

Reply via email to