Re: [Ietf-and-github] Mail regarding draft-ietf-git-github-wg-configuration, section 3.1 (Contributions)

"Martin Thomson" <mt@lowentropy.net> Tue, 05 March 2019 02:42 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 25BB7130E9C for <ietf-and-github@ietfa.amsl.com>; Mon, 4 Mar 2019 18:42:35 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.7
X-Spam-Level:
X-Spam-Status: No, score=-2.7 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, 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=plFLNntO; dkim=pass (2048-bit key) header.d=messagingengine.com header.b=fa9d18uh
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 2pUXL7lwdo_o for <ietf-and-github@ietfa.amsl.com>; Mon, 4 Mar 2019 18:42:33 -0800 (PST)
Received: from out2-smtp.messagingengine.com (out2-smtp.messagingengine.com [66.111.4.26]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 312E5130E8E for <ietf-and-github@ietf.org>; Mon, 4 Mar 2019 18:42:33 -0800 (PST)
Received: from compute1.internal (compute1.nyi.internal [10.202.2.41]) by mailout.nyi.internal (Postfix) with ESMTP id 730D621FAE for <ietf-and-github@ietf.org>; Mon, 4 Mar 2019 21:42:32 -0500 (EST)
Received: from imap2 ([10.202.2.52]) by compute1.internal (MEProxy); Mon, 04 Mar 2019 21:42:32 -0500
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lowentropy.net; h=message-id:in-reply-to:references:date:from:to:subject :content-type:content-transfer-encoding; s=fm1; bh=20Mh7sWogwRFi DZorsSSkSasWLTuaQsSkSL96ujno5M=; b=plFLNntOg1nb/O55bjjzmaPfDkAom aOlBKvWTsVwR7wlTkgr8JwdHa0x4aoNrXXkYsukIuRJb3Y9GHuHPw5xrMOcUDG/v Il8sPhNtLRi7kIGpuo3Jllx4/RLks8cTx3bg02oekBiZguD53EEPHBDRqzNqa+v4 EcqdGruxosZENfVCT0vyJTLfdBuPj8b6Dwi/nBjU6GBVvB4PuH8LAJuN6c97eSKB qnhpAHShE3jnR/lFHifCZQgqh57lEr+++l/05zzXHXykQQrqaCwFltnDtdwjaGP7 YndDNGk4Cy9jZoGCajtjqky5ZnX9zV39bqXAzeTaupAk51dg7WHK7tcEQ==
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=content-transfer-encoding:content-type :date:from:in-reply-to:message-id:references:subject:to :x-me-proxy:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s= fm2; bh=20Mh7sWogwRFiDZorsSSkSasWLTuaQsSkSL96ujno5M=; b=fa9d18uh TvKJDbJGU/jcbnxv8WpUZ0Q057FsRFK4fyGejrHuizFlEjnUObe5q3AxuVNjgxzn 89rORN+pqo5ESS3SQHFIVoNoGkd62OEW9qiwKiwD1FAx0ghA/nYyrKsO6Qw/pNMk GW4u23KdbHDRAMU8ZUv3SmTMqQaU9/Q2Xkn1F83ldhY1LBqK+O5wvHlx0xbW5vba njLsbAU7PhDd4LKCMw8tXNHIljDMRqXB7EnSkqNWfhQRXp/9eW1IrHM1TjTrUOXb B7k3rwbbe1e5ih6SjdHIk/tG1/9Kc9eLeeTJnE2iHx6UcBEWgBUv6VOXpYNVL7t+ wApQ2Vvh8NvyJQ==
X-ME-Sender: <xms:GOJ9XNqqwwR4JQEur1RswSvgtfFwiudlUS8UDrqSDhpmsU1PhisjRw>
X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedutddrfedvgdehtdcutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecunecujfgurhepofgfkfgjfhffhffvufgtgfesthhqre dtreerjeenucfhrhhomhepfdforghrthhinhcuvfhhohhmshhonhdfuceomhhtsehlohif vghnthhrohhphidrnhgvtheqnecuffhomhgrihhnpehgihhthhhusgdrtghomhdpihgvth hfrdhorhhgnecurfgrrhgrmhepmhgrihhlfhhrohhmpehmtheslhhofigvnhhtrhhophih rdhnvghtnecuvehluhhsthgvrhfuihiivgeptd
X-ME-Proxy: <xmx:GOJ9XHT2odMOLaqI9eSB_UaPNbb1t3eNb0huP7zVIyIuub3KNYjItA> <xmx:GOJ9XH0iu_iBoOmyi_Mk-0aPD4Jxgumd_y-oBTpu_DF9JVvcdomdaA> <xmx:GOJ9XDC7cs2SCoSI0pih2Sea9Zm54pzeeNoShL-sI157jPPpnYTUAQ> <xmx:GOJ9XGeHNkhKaybxZ_Tm6YtB4Seem18z1Ta7Q-29foki931YzTrwVQ>
Received: by mailuser.nyi.internal (Postfix, from userid 501) id 0F0E07C1EB; Mon, 4 Mar 2019 21:42:32 -0500 (EST)
X-Mailer: MessagingEngine.com Webmail Interface
User-Agent: Cyrus-JMAP/3.1.5-925-g644bf8c-fmstable-20190228v5
X-Me-Personality: 92534000
Message-Id: <c99214a2-40ee-41dd-a4dc-e361d56771cd@www.fastmail.com>
In-Reply-To: <C29868B2-6489-4D3C-A57F-4A6A52CA72B3@contoso.com>
References: <C29868B2-6489-4D3C-A57F-4A6A52CA72B3@contoso.com>
Date: Mon, 04 Mar 2019 21:42:33 -0500
From: Martin Thomson <mt@lowentropy.net>
To: 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/5XxXxP3ioApL_Em-upYyuiz62oM>
Subject: Re: [Ietf-and-github] Mail regarding draft-ietf-git-github-wg-configuration, section 3.1 (Contributions)
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, 05 Mar 2019 02:42:35 -0000

Hi Stephan,

I encourage you to attempt to contribute to a draft repository on GitHub.  The BCP79 notice is perhaps not as prominent as you might like, but there is a fairly clear path to it.

In case you can't find an example, here's a link where you can create an issue for the draft I just posted: https://github.com/martinthomson/hx-uri/issues/new

I tend to think that is adequate.  If you disagree, we can discuss the pros and cons of searching for something more robust.

Section 3.1 of the draft we're discussing here (of the long name) includes provisions designed to accomplish the goal you describe.  And yes, the template code I maintain emplaces a default notice.  I understand that reading the code is difficult (I'll be the first to acknowledge how arcane this stuff is), but it is described in language I hope you can understand here: https://github.com/martinthomson/i-d-template/blob/master/doc/FEATURES.md#setup-a-repository

Regarding the trust notice or the content of the contributing notice, that's not something I'd care to comment on.  You can see what I have, which is - in part - something recommended by the IETF Trust and IESG, and in part just text that I believe to be helpful: https://github.com/martinthomson/i-d-template/blob/master/template/CONTRIBUTING.md

Cheers,
Martin

On Tue, Mar 5, 2019, at 04:16, Stephan Wenger wrote:
>  
> Hi,
> 
> 
> One concern I have when I see people, in an IETF context, work on docs 
> in toolchains other than IETF mailing lists and posting of I-Ds on the 
> IETF infrastructure is that I think we should ensure that BCP79 sticks. 
> BCP79 is the IETF’s patent policy. A scenario to avoid is that people 
> insert patented technologies without being bound by the patent policy. 
> To avoid that, there ought to be a mechanism that a) unambiguously 
> makes it clear that any written contribution using GitHib tools 
> constitute Contributions in the BCP79 sense, and b) ensures that a user 
> that makes a written contribution using GitHub tools would have seen 
> the Note Well at least once. 
> 
> 
> I believe that most GitHub-using working groups in the IETF have 
> assured that by including something like a click-through of the Note 
> Well when accessing the GitHub repository (writing to it in whatever 
> form). That, I think is sufficient, but perhaps should be documented in 
> this draft. I don’t know enough about the mechanics to propose text 
> myself. Lots of that may already be present in Martin’s template, but 
> that template is hard to read/understand for someone like me, who’s not 
> writing software or webpages.
> 
> 
> One thing I don’t understand is why the Trust outbound license needs to 
> be present in the repository, as suggested in section 3.1. Especially 
> for a WG that uses GitHub only for maintaining documents and not 
> software. Can someone explain or point me to an explanation?
> 
> 
> Thanks,
> 
> Stephan
> 
> 
> 
> 
> 
> 
> _______________________________________________
> Ietf-and-github mailing list
> Ietf-and-github@ietf.org
> https://www.ietf.org/mailman/listinfo/ietf-and-github
>