git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Git, merging, and News/Relnotes files

From
Edward Z. Yang <edwardzyang@thewritingpot.com>
Date
Jul 5, 2008, 07:24 UTC
Message-ID
<g4n7j6$359$1@ger.gmane.org>

As a policy on a project that I manage, almost every commit warrants a change to our NEWS (changelog) file, which end-users can browse to get an in-depth idea of the changes that have happened from the last release. If it's an added feature, the changelog includes a description of how to use it; if it's a fixed bug, it briefly describes what happened. Internal changes may or may not get added, depending on the visibility of the APIs affected.

Something that I've noticed recently, as we've started migrating away from the ghetto SVN development model to the Git branchy model, is that this NEWS file ends up being the source of a lot of conflicts. Granted, they're easy conflicts to resolve, but still, they make a pull a little more complicated than it should be.

What would you guys, as experienced Git users, recommend in this case? Scrapping a NEWS file and simply drawing up the release-notes shortly before release (as the Git project does)? Aggregating the Git commit messages into one monster release log? Having the release manager add the NEWS entries himself, and mandate that no patch have it in them?

Thanks!
Next: Linus Torvalds
Message 1 of 6 in “Git, merging, and News/Relnotes files”
  1. Edward Z. YangJul 5, 2008
  2. Linus TorvaldsJul 5, 2008
  3. Edward Z. YangJul 5, 2008
  4. Linus TorvaldsJul 5, 2008
  5. Dmitry PotapovJul 6, 2008
  6. Edward Z. YangJul 9, 2008

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.