Re: Request: Have git commit messages for design changes include links to relevant discussion email threads

Mark Nottingham <mnot@mnot.net> Tue, 30 April 2013 00:13 UTC

Return-Path: <ietf-http-wg-request@listhub.w3.org>
X-Original-To: ietfarch-httpbisa-archive-bis2Juki@ietfa.amsl.com
Delivered-To: ietfarch-httpbisa-archive-bis2Juki@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 722F821F9B8E for <ietfarch-httpbisa-archive-bis2Juki@ietfa.amsl.com>; Mon, 29 Apr 2013 17:13:03 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -9.892
X-Spam-Level:
X-Spam-Status: No, score=-9.892 tagged_above=-999 required=5 tests=[AWL=0.407, BAYES_00=-2.599, MIME_8BIT_HEADER=0.3, RCVD_IN_DNSWL_HI=-8]
Received: from mail.ietf.org ([12.22.58.30]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id UqpGDcp6m5GB for <ietfarch-httpbisa-archive-bis2Juki@ietfa.amsl.com>; Mon, 29 Apr 2013 17:12:58 -0700 (PDT)
Received: from frink.w3.org (frink.w3.org [128.30.52.56]) by ietfa.amsl.com (Postfix) with ESMTP id 3B64621F9A4C for <httpbisa-archive-bis2Juki@lists.ietf.org>; Mon, 29 Apr 2013 17:12:58 -0700 (PDT)
Received: from lists by frink.w3.org with local (Exim 4.72) (envelope-from <ietf-http-wg-request@listhub.w3.org>) id 1UWyAT-0002s8-34 for ietf-http-wg-dist@listhub.w3.org; Tue, 30 Apr 2013 00:11:37 +0000
Resent-Date: Tue, 30 Apr 2013 00:11:37 +0000
Resent-Message-Id: <E1UWyAT-0002s8-34@frink.w3.org>
Received: from lisa.w3.org ([128.30.52.41]) by frink.w3.org with esmtp (Exim 4.72) (envelope-from <mnot@mnot.net>) id 1UWyAK-0002ok-KR for ietf-http-wg@listhub.w3.org; Tue, 30 Apr 2013 00:11:28 +0000
Received: from mxout-08.mxes.net ([216.86.168.183]) by lisa.w3.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.72) (envelope-from <mnot@mnot.net>) id 1UWyAJ-0005AG-P6 for ietf-http-wg@w3.org; Tue, 30 Apr 2013 00:11:28 +0000
Received: from mnot-mini.mnot.net (unknown [118.209.190.66]) (using TLSv1 with cipher AES128-SHA (128/128 bits)) (No client certificate requested) by smtp.mxes.net (Postfix) with ESMTPSA id DA3FB50A73; Mon, 29 Apr 2013 20:11:04 -0400 (EDT)
Content-Type: text/plain; charset="utf-8"
Mime-Version: 1.0 (Mac OS X Mail 6.3 \(1503\))
From: Mark Nottingham <mnot@mnot.net>
In-Reply-To: <CAA4WUYiaweXEt_AyEgkxf=R1EzNzkcdJFnGwvJv0QnP0Mtywfw@mail.gmail.com>
Date: Tue, 30 Apr 2013 10:11:01 +1000
Cc: HTTP Working Group <ietf-http-wg@w3.org>, Alexey Melnikov <alexey.melnikov@isode.com>, Martin Thomson <martin.thomson@gmail.com>
Content-Transfer-Encoding: quoted-printable
Message-Id: <F42EED40-DC5A-4AD4-873B-69739737470A@mnot.net>
References: <CAA4WUYiaweXEt_AyEgkxf=R1EzNzkcdJFnGwvJv0QnP0Mtywfw@mail.gmail.com>
To: "William Chan (陈智昌)" <willchan@chromium.org>
X-Mailer: Apple Mail (2.1503)
Received-SPF: pass client-ip=216.86.168.183; envelope-from=mnot@mnot.net; helo=mxout-08.mxes.net
X-W3C-Hub-Spam-Status: No, score=-4.3
X-W3C-Hub-Spam-Report: AWL=-2.426, BAYES_00=-1.9, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001
X-W3C-Scan-Sig: lisa.w3.org 1UWyAJ-0005AG-P6 c45dcb140886653e5c384e109795b0d5
X-Original-To: ietf-http-wg@w3.org
Subject: Re: Request: Have git commit messages for design changes include links to relevant discussion email threads
Archived-At: <http://www.w3.org/mid/F42EED40-DC5A-4AD4-873B-69739737470A@mnot.net>
Resent-From: ietf-http-wg@w3.org
X-Mailing-List: <ietf-http-wg@w3.org> archive/latest/17693
X-Loop: ietf-http-wg@w3.org
Resent-Sender: ietf-http-wg-request@w3.org
Precedence: list
List-Id: <ietf-http-wg.w3.org>
List-Help: <http://www.w3.org/Mail/>
List-Post: <mailto:ietf-http-wg@w3.org>
List-Unsubscribe: <mailto:ietf-http-wg-request@w3.org?subject=unsubscribe>

Yep, this is good practice. Editors, Github will automatically do this if you reference the issue with "#"; e.g.,

"Change Foo to Bar; see #555."

Also, you can use "fixes" or "closes" to close the related issue. Please be careful when doing so with design issues, as we need to make sure they're properly accounted for. See: <https://help.github.com/articles/closing-issues-via-commit-messages>

Cheers,



On 30/04/2013, at 4:06 AM, William Chan (陈智昌) <willchan@chromium.org> wrote:

> It'd make it easier for me to go to github blame/history and identify where stuff comes from. Cheers.

--
Mark Nottingham   http://www.mnot.net/