Re: [Ietf-and-github] Simple WG policy for document management

"Martin Thomson" <mt@lowentropy.net> Tue, 22 October 2019 04:31 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 1B9E512004F for <ietf-and-github@ietfa.amsl.com>; Mon, 21 Oct 2019 21:31:17 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.701
X-Spam-Level:
X-Spam-Status: No, score=-2.701 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, RCVD_IN_DNSWL_LOW=-0.7, SPF_PASS=-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=j/J32SIX; dkim=pass (2048-bit key) header.d=messagingengine.com header.b=Jz1lTXwN
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 XMJ3XD9Sj9aj for <ietf-and-github@ietfa.amsl.com>; Mon, 21 Oct 2019 21:31:15 -0700 (PDT)
Received: from wout5-smtp.messagingengine.com (wout5-smtp.messagingengine.com [64.147.123.21]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 8472B120058 for <ietf-and-github@ietf.org>; Mon, 21 Oct 2019 21:31:15 -0700 (PDT)
Received: from compute1.internal (compute1.nyi.internal [10.202.2.41]) by mailout.west.internal (Postfix) with ESMTP id C5DBC2E0 for <ietf-and-github@ietf.org>; Mon, 21 Oct 2019 23:33:52 -0400 (EDT)
Received: from imap2 ([10.202.2.52]) by compute1.internal (MEProxy); Mon, 21 Oct 2019 23:33:52 -0400
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 :subject:content-type; s=fm3; bh=mKYS/RuNBIKJ5p06VgatARmd3Y0/b91 iVOLwcJF7Na8=; b=j/J32SIXaJBEeU6dPOGYLJCwKcGE0YQDSzCeqR/WIcxkrRC /iz4Bu3mzbvIK0NbtRDJHU9QTMTOzbjIIN2EPGjG3H3rQoFVf9o6l3KeIqEyRBhH 0JXhSXv6aK0uIpfr7t8fpvpG0V0+b8Kieq5vGZL27a95j4ZFkyDJsz86D2lAgP5l BnuBwbM5wb90IpNwOEH707alkARFaI9/iYIImiKIZVyb0Czm7tOva8PClSOrt2iS n0jbGwPNB+iA1aa2gesTET9ZVo3vzWgPwztir1iBC1AViIGSTbV2ucM7k2fDD6UU vWiHG4g4b55bShEWjoI1+0MdymFQIfbLAkxJ6SA==
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=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=fm1; bh=mKYS/R uNBIKJ5p06VgatARmd3Y0/b91iVOLwcJF7Na8=; b=Jz1lTXwNz5WuMX1Vex1AD+ IrGNSZ4dVbtGuzAGGl2b94bO4pQ4k5LpUQDHckPJpqNP2Fx+Q1jz5fUwrizpsKWe nNLRD2tbWJ89UDvI8jzlO9wleJqivIIrHtAeEbb/nBZpsTuLGoJ09I3ZJG9hvWWW kbSxKDtIEImzpIEuab1PpTncN2VhScO6lLztSerHwMO3dkB/R5XmaIpFvRwM/meM RA2BARLBdioo+xD7QU7cJmhapc2hL38DUI9UZ9WusfR1UkUMEfhYISkJYWHGf1hV uo0lQ2O8j5mx/J3h/sMrF3BYoA66gL7DBUO/D/eePZyPxwJafit2a3Y2ewb9xwAw ==
X-ME-Sender: <xms:oHiuXdSX2gkstCPovhUFTPHsyNyJlDC852FgfD3LVOFf9m1ef0Jzeg>
X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedufedrkeeigdejvdcutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecunecujfgurhepofgfggfkjghffffhvffutgesthdtre dtreertdenucfhrhhomhepfdforghrthhinhcuvfhhohhmshhonhdfuceomhhtsehlohif vghnthhrohhphidrnhgvtheqnecuffhomhgrihhnpehgihhthhhusgdrtghomhenucfrrg hrrghmpehmrghilhhfrhhomhepmhhtsehlohifvghnthhrohhphidrnhgvthenucevlhhu shhtvghrufhiiigvpedt
X-ME-Proxy: <xmx:oHiuXXFLyKB0hQrFrsDbfN5He_gb84-H2F-VreMDpf3iP6JnUQkfTQ> <xmx:oHiuXaeIxvBQ-zrE61C6xMu9wYFzti_PqRiTBohCZIDTKXJJEBKWgw> <xmx:oHiuXfrqc3nwC8N-jobvTtzFR1KAqLspnPw42NkmGdiXcNIqvVbkdQ> <xmx:oHiuXcbQDXs2vyOpZaDQW3h23ysTy-Uh-GwQke2ICspPcq9HPFOWDA>
Received: by mailuser.nyi.internal (Postfix, from userid 501) id 2EFC8E00A5; Mon, 21 Oct 2019 23:33:52 -0400 (EDT)
X-Mailer: MessagingEngine.com Webmail Interface
User-Agent: Cyrus-JMAP/3.1.7-470-gedfae93-fmstable-20191021v4
Mime-Version: 1.0
Message-Id: <2a1c0461-f203-4044-90e7-43276c056809@www.fastmail.com>
In-Reply-To: <cb3ba8ae-3518-048f-e7dd-fbe7adfc899a@icann.org>
References: <cb3ba8ae-3518-048f-e7dd-fbe7adfc899a@icann.org>
Date: Tue, 22 Oct 2019 14:33:33 +1100
From: Martin Thomson <mt@lowentropy.net>
To: ietf-and-github@ietf.org
Content-Type: text/plain
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf-and-github/npVNUQjrNwaneDYzOBntNzupS7w>
Subject: Re: [Ietf-and-github] Simple WG policy for document management
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: Tue, 22 Oct 2019 04:31:17 -0000

On Tue, Oct 22, 2019, at 04:50, Paul Hoffman wrote:
> [...] I'd like to either see 5.1 be expanded to allow PRs 
> from the WG, or a new section 5.2 inserted that is 5.1 plus WG PRs.

https://github.com/ietf-gitwg/using-github/pull/new/light-pr does the former, which I think makes the most sense here.  That is, it allows editors to manage the document as they see fit, using the tools available, but doesn't confer any special status to those tools.

As Paul observes, the text could have been read to imply that editors can't use pull requests at all.  That was never the intention.

> Does this match with what others have found in WGs that are just using 
> GitHub for document management and pre-draft-revision change tracking?

Yeah, this matches what I've seen in practice.