Re: [Ietf-and-github] Opsdir last call review of draft-ietf-git-using-github-04

"Martin Thomson" <mt@lowentropy.net> Mon, 24 February 2020 16:15 UTC

Return-Path: <mt@lowentropy.net>
X-Original-To: ietf-and-github@ietfa.amsl.com
Delivered-To: ietf-and-github@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 76CFB3A0ECC; Mon, 24 Feb 2020 08:15:40 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.098
X-Spam-Level:
X-Spam-Status: No, score=-2.098 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=lowentropy.net header.b=s0Xl3J83; dkim=pass (2048-bit key) header.d=messagingengine.com header.b=Jg0S80oc
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id POgPAOVUHTbP; Mon, 24 Feb 2020 08:15:36 -0800 (PST)
Received: from out1-smtp.messagingengine.com (out1-smtp.messagingengine.com [66.111.4.25]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 889C03A0ED3; Mon, 24 Feb 2020 08:15:36 -0800 (PST)
Received: from compute1.internal (compute1.nyi.internal [10.202.2.41]) by mailout.nyi.internal (Postfix) with ESMTP id A3A1F21FD7; Mon, 24 Feb 2020 11:15:35 -0500 (EST)
Received: from imap2 ([10.202.2.52]) by compute1.internal (MEProxy); Mon, 24 Feb 2020 11:15:35 -0500
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lowentropy.net; h=mime-version:message-id:in-reply-to:references:date:from:to :cc:subject:content-type:content-transfer-encoding; s=fm1; bh=4s MbUJOmqnZS6+blaEDQVLAbR8jb9K0r0LT8HlOuAuI=; b=s0Xl3J83yBfxu7kKAk JieG/rGDw1h4CPZdhEC9V4Ku24G4jw7xkluOaiEs3c8+Z/XPNE7hmHPEk2GsliFS ZMd/F2w6jwkgF+3/58YpgLlKZEU0Mt0xtzcWVWEUD4RqX6YM85h1Tl0D80HRvcXU cvmq6bwH5bwP6IktkuJnwzzfxqr4QL5W7gVW8DfWMhfH7o/Qjp3YPHEfqgNWwugN Nr9uRbWsRYN7LVfohE8usa8QiTzz+OvM3O6Kyu0NbQfrjPo/v52Y1aD6E0q9UHuZ lohlO248mpzU21yq57lvDuBGsAMwnl5f8jB2YVvURcChtpwPAbWgvsmzQ7hWctrt +5Qw==
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:content-type :date:from:in-reply-to:message-id:mime-version:references :subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm2; bh=4sMbUJOmqnZS6+blaEDQVLAbR8jb9K0r0LT8HlOuA uI=; b=Jg0S80ocp23MuiIwnvE8+1dGkAQolc2hcvRf3dtva74M0vqyDWRJPz7fr 1WhsqVLRC5dusx4mymQPVjZYd9+FldUEMvrMcHeBCUGw0puVfG4jjkVo+PfTaU2W pDKQZqIS5oizJLyVxmPVyYA7S0Dl5tOW46dYjUF+vjIpOeMqBnnhmEUUf1kl78RN G3fa9xTWRsAyTEigBIcKhFmGKg2eb3i23VDBUwh3BDDR9TaLnE/NPMQRDDOrgT2h DyTwcWed+5UR1j3NS/1zjdE4YklyVWclw5brX18D+j7rXzNFpasYtK/DR7KmUMpi KrkN5AItQu8B1oGn4tH/fH6SPvknQ==
X-ME-Sender: <xms:pvZTXsqaOWr9x2zemnrcniQ3Q3H7yV5o9ivrOi9hOuqhMgRHe0rU3w>
X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedugedrledtgdekiecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecunecujfgurhepofgfggfkjghffffhvffutgfgsehtqh ertderreejnecuhfhrohhmpedfofgrrhhtihhnucfvhhhomhhsohhnfdcuoehmtheslhho figvnhhtrhhophihrdhnvghtqeenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmh epmhgrihhlfhhrohhmpehmtheslhhofigvnhhtrhhophihrdhnvght
X-ME-Proxy: <xmx:pvZTXoxAo3eEzcxjp5sDrO-O87pkEOKfMqZnWq6The65f4uJ2BSgbQ> <xmx:pvZTXt_y3WoWaSw0kEjyLoOPqD65-DSTJTCRPXhLlShmOqtx8kD0Aw> <xmx:pvZTXpxo05-i2RUEF12F-mtNlZjdYbDmOT5McgyS_19IS7hvdzafBw> <xmx:p_ZTXkiLB7LwADr3PlwxwZHwkkGNyeb4LtIwyx-lznRqn4ijfNCKEg>
Received: by mailuser.nyi.internal (Postfix, from userid 501) id 4CEFAE00A6; Mon, 24 Feb 2020 11:15:34 -0500 (EST)
X-Mailer: MessagingEngine.com Webmail Interface
User-Agent: Cyrus-JMAP/3.1.7-947-gbed3ff6-fmstable-20200220v2
Mime-Version: 1.0
Message-Id: <32106727-5d45-4473-8775-2c5b1d4682e9@www.fastmail.com>
In-Reply-To: <158251090278.1088.6094983334229327241@ietfa.amsl.com>
References: <158251090278.1088.6094983334229327241@ietfa.amsl.com>
Date: Mon, 24 Feb 2020 08:15:13 -0800
From: "Martin Thomson" <mt@lowentropy.net>
To: "Qin Wu" <bill.wu@huawei.com>, ops-dir@ietf.org
Cc: last-call@ietf.org, draft-ietf-git-using-github.all@ietf.org, ietf-and-github@ietf.org
Content-Type: text/plain;charset=utf-8
Content-Transfer-Encoding: quoted-printable
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf-and-github/rPBCKz9COXY9kUfsDzWMd8xHaHE>
Subject: Re: [Ietf-and-github] Opsdir last call review of draft-ietf-git-using-github-04
X-BeenThere: ietf-and-github@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "Discussion of using GitHub in IETF activities, particularly for Working Groups" <ietf-and-github.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/ietf-and-github>, <mailto:ietf-and-github-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/ietf-and-github/>
List-Post: <mailto:ietf-and-github@ietf.org>
List-Help: <mailto:ietf-and-github-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/ietf-and-github>, <mailto:ietf-and-github-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 24 Feb 2020 16:15:41 -0000

Thanks for the review Qin,

I struggled a little with your second suggestion.  I ultimately settled on

+Retaining mailing lists as the primary venue for discussion of substantive
+matters ensures that this mode - along with the document management mode - is
+most compatible with existing work practices for Working Groups.

I chose 'future' rather than 'v2'.

On Sun, Feb 23, 2020, at 18:21, Qin Wu via Datatracker wrote:
> Reviewer: Qin Wu
> Review result: Has Nits
> 
> I have reviewed this document as part of the Ops area directorate's ongoing
> effort to review all IETF documents being processed by the IESG.  These
> comments were written primarily for the benefit of the Ops area directors.
> Document editors and WG chairs should treat these comments just like any other
> last call comments.
> 
> Good work, this draft provides working group github usage guidance and document
> best practice that can be referenced by all IETF working groups. A few nits
> that need to be fixed before moving forward: 1. Section 5.2,3rd paragraph: The
> word "err" is a little bit weird to me. s/err more toward/lean more toward 2.
> Section 5.2 5th paragraph: "As mailing lists remain the primary venue for
> discussion of
>    substantive matters, this mode and the document management only modes
>    remain those most compatible with existing work practices for Working
>    Groups."
> I feel the second half sentence is disconnected and not clear. should this be
> changed into "...only modes which remain those most" …? 3.Section 5.4.2,last
> paragraph The label “v2” has some ambiguity, since each draft may have already
> made multiple revisions. The latest version may not start with v1. In addition,
> should the decision label or component label be registered in IANA?
> 
> 
> 
>