From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 21040 invoked by alias); 17 Apr 2008 14:04:42 -0000 Received: (qmail 20743 invoked by uid 48); 17 Apr 2008 14:03:53 -0000 Date: Thu, 17 Apr 2008 14:04:00 -0000 From: "cagney at redhat dot com" To: frysk-bugzilla@sourceware.org Message-ID: <20080417140353.6426.cagney@redhat.com> Reply-To: sourceware-bugzilla@sourceware.org Subject: [Bug general/6426] New: switch to "why this changed", not what changed X-Bugzilla-Reason: AssignedTo Mailing-List: contact frysk-bugzilla-help@sourceware.org; run by ezmlm Precedence: bulk List-Subscribe: List-Post: List-Help: , Sender: frysk-bugzilla-owner@sourceware.org X-SW-Source: 2008-q2/txt/msg00060.txt.bz2 List-Id: GNU coding standard dogma dictates that: - there shall be ChangeLog files - ChangeLogs contain "what changed" - source code contains "why it changed" or "why it is so" or "why it was" the idea motivating this is that developers read the source, and hence it is the source that should contain the detailed coding history; an the ChangeLog just lets you identify who changed what when. This all goes back to the days before revision control where often the only way to know who did what as through the ChangeLog file. With the introduction of distributed revision control that's less of a problem - change history can be identified by looking through your local copy of the entire repo. This of course begs the question, of should we drop ChangeLog files and rely more on GIT for recording what changed and by whom. The only stickler I know of is being able to properly record changes submitted by A but committed by B. -- Summary: switch to "why this changed", not what changed Product: frysk Version: unspecified Status: NEW Severity: normal Priority: P2 Component: general AssignedTo: frysk-bugzilla at sourceware dot org ReportedBy: cagney at redhat dot com OtherBugsDependingO 6423,6424 nThis: http://sourceware.org/bugzilla/show_bug.cgi?id=6426 ------- You are receiving this mail because: ------- You are the assignee for the bug, or are watching the assignee.