[sipcore] Tracker Etiquette

Adam Roach <adam@nostrum.com> Tue, 31 August 2010 19:56 UTC

Return-Path: <adam@nostrum.com>
X-Original-To: sipcore@core3.amsl.com
Delivered-To: sipcore@core3.amsl.com
Received: from localhost (localhost [127.0.0.1]) by core3.amsl.com (Postfix) with ESMTP id 6ECC53A6A08 for <sipcore@core3.amsl.com>; Tue, 31 Aug 2010 12:56:48 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -102.6
X-Spam-Level:
X-Spam-Status: No, score=-102.6 tagged_above=-999 required=5 tests=[AWL=0.000, BAYES_00=-2.599, SPF_PASS=-0.001, USER_IN_WHITELIST=-100]
Received: from mail.ietf.org ([64.170.98.32]) by localhost (core3.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id MHzXDRZ40iSD for <sipcore@core3.amsl.com>; Tue, 31 Aug 2010 12:56:47 -0700 (PDT)
Received: from nostrum.com (nostrum-pt.tunnel.tserv2.fmt.ipv6.he.net [IPv6:2001:470:1f03:267::2]) by core3.amsl.com (Postfix) with ESMTP id 3991E3A6873 for <sipcore@ietf.org>; Tue, 31 Aug 2010 12:56:47 -0700 (PDT)
Received: from hydra-3.local (ppp-70-249-149-233.dsl.rcsntx.swbell.net [70.249.149.233]) (authenticated bits=0) by nostrum.com (8.14.3/8.14.3) with ESMTP id o7VJvGMM079006 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for <sipcore@ietf.org>; Tue, 31 Aug 2010 14:57:17 -0500 (CDT) (envelope-from adam@nostrum.com)
Message-ID: <4C7D5E9C.9090908@nostrum.com>
Date: Tue, 31 Aug 2010 14:57:16 -0500
From: Adam Roach <adam@nostrum.com>
User-Agent: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.6; en-US; rv:1.9.2.8) Gecko/20100802 Thunderbird/3.1.2
MIME-Version: 1.0
To: SIPCORE <sipcore@ietf.org>
Content-Type: text/plain; charset="ISO-8859-1"; format="flowed"
Content-Transfer-Encoding: 7bit
Received-SPF: pass (nostrum.com: 70.249.149.233 is authenticated by a trusted mechanism)
Subject: [sipcore] Tracker Etiquette
X-BeenThere: sipcore@ietf.org
X-Mailman-Version: 2.1.9
Precedence: list
List-Id: SIP Core Working Group <sipcore.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/listinfo/sipcore>, <mailto:sipcore-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/sipcore>
List-Post: <mailto:sipcore@ietf.org>
List-Help: <mailto:sipcore-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/sipcore>, <mailto:sipcore-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 31 Aug 2010 19:56:48 -0000

[as chair]

The issue tracker has been introduced without much in the way of 
guidelines. I think that, used correctly, it can be very useful for 
making sure specific issues don't get lost in the noise. It saves 
authors the work of exhaustively trawling the mailing list to make 
certain everything has been addressed.

However.

If we generate so many tickets that document authors spend more time 
closing tickets than actually fixing the document, then the tracker 
becomes a liability instead of an asset.

For right now, I'd like us to adjust how we deal with nits and editorial 
comments. For the most part, these should be sent to the list or 
directly to the author to be addressed (i.e., no need to open a ticket). 
Tracking these isn't important or even all that useful; if we miss one, 
then the paid RFC editor staff whose job it is to address these kinds of 
errors will probably catch it.

Larger or more structural issues can be entered into the tracker -- but 
please don't enter each such editorial comment into a new ticket. Gather 
all of your non-technical comments together, and put them in a single 
ticket.

Finally, it would be helpful to document authors if you included 
something in the ticket name that indicated which document the tracker 
issue is on. It doesn't have to be a whole document name; something like 
"4244bis" for the history-info draft would be sufficient.

Thank you.

/a