Re: [Ietf-and-github] Warren Kumari's Discuss on draft-ietf-git-using-github-05: (with DISCUSS and COMMENT)
Eric Rescorla <ekr@rtfm.com> Tue, 10 March 2020 18:47 UTC
Return-Path: <ekr@rtfm.com>
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 ACD353A0850
for <ietf-and-github@ietfa.amsl.com>; Tue, 10 Mar 2020 11:47:59 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.896
X-Spam-Level:
X-Spam-Status: No, score=-1.896 tagged_above=-999 required=5
tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1,
HTML_MESSAGE=0.001, SPF_HELO_NONE=0.001, SPF_NONE=0.001,
URIBL_BLOCKED=0.001] autolearn=unavailable autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key)
header.d=rtfm-com.20150623.gappssmtp.com
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 mO156mhH9WCW for <ietf-and-github@ietfa.amsl.com>;
Tue, 10 Mar 2020 11:47:55 -0700 (PDT)
Received: from mail-lf1-x133.google.com (mail-lf1-x133.google.com
[IPv6:2a00:1450:4864:20::133])
(using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits))
(No client certificate requested)
by ietfa.amsl.com (Postfix) with ESMTPS id 602A53A0851
for <ietf-and-github@ietf.org>; Tue, 10 Mar 2020 11:47:55 -0700 (PDT)
Received: by mail-lf1-x133.google.com with SMTP id q9so5149786lfc.10
for <ietf-and-github@ietf.org>; Tue, 10 Mar 2020 11:47:55 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=rtfm-com.20150623.gappssmtp.com; s=20150623;
h=mime-version:references:in-reply-to:from:date:message-id:subject:to
:cc; bh=nfh/uQ26rJLtQD5RYfk4L62sNp9QTinnrFH7ap3SMVo=;
b=G3dAboR8YP69N42TXaQxfcZG2tAFSkUkBiv8R00z0UGRyqtLWxWnvwXmypowr0EVI4
1xW8M8PQN/yfRUn332577zBTDD4Rdi13ofiWTJdKiMCRS1E9IYU2eIBgT4gnDHQyCgCx
5mIc43RDnHWjzDoSqQg8nfUMoyE8z+6kXafW6sowLYqDmOeUcxkRlSQFd567N9z2VQwl
htyFs0o8WXi3coDUaSVv0GV1mAPFPGQ15Qb8loiRB1M48ffMO6pvFkErgcAqe0PTNm2A
eYARA/+Z6F98xVlSyhb76OJRYIBArGjOSsSrfAz5hjdv67PC12ywHM/Jz6RyhjmC3rxB
fiRw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=1e100.net; s=20161025;
h=x-gm-message-state:mime-version:references:in-reply-to:from:date
:message-id:subject:to:cc;
bh=nfh/uQ26rJLtQD5RYfk4L62sNp9QTinnrFH7ap3SMVo=;
b=saaETgZZ8I+0AfvYYLEZBMlJtdN1PBHkLabSNGTKkksXYt5Rdd25d0EgP6SWZH6A5a
pqFvlGJXynQ/+kOaWoaFMgjHzIpojAY2RQGWdYfii6DVMi56g23nJaHDUQa94W6ci6l4
aNBNlWyaIT3/OS3Q5zWry8cL3gM+TLsVcuVlOZ9p4hDHHUJLIwNAanRioR2qUuwN20O0
TvWOsNoTDO3fpftNLvKa+gmYPfHj2wwQOTr+J4hDuVP1SPc0FjZ0+M1CL8fB2O9l/DlG
xLFGe7JatzlM4j3mGafpL7UXV7lBPoItIu5le9DMhi1wlYr/F7kGYp1gESaPwrgkd5eR
XZtA==
X-Gm-Message-State: ANhLgQ2EcmTZgGsbv8amnOp7JE8MqNbO6xsgXWn1sKPAS4I+mErV3e3t
ONox639DZEDuAR/B1k7+uaVAZJpQetUtVJI3CEYUxw==
X-Google-Smtp-Source: ADFU+vsvIe0fpGfAcglJpmjvMiYsd0+FCDKrVB24Yv0iHdLai84uPGZESwgYE8DMJVB5i4KA7f9JOETgJ+R8ovN7IVQ=
X-Received: by 2002:a05:6512:1041:: with SMTP id
c1mr13602159lfb.14.1583866073430;
Tue, 10 Mar 2020 11:47:53 -0700 (PDT)
MIME-Version: 1.0
References: <158386231480.15427.9414945774814479191@ietfa.amsl.com>
<CABcZeBP76vZW9ob9pX5SQYvoemVPmNz-xj-MShht5TWO0RGLdA@mail.gmail.com>
<CAHw9_iJFRgFAv8V-Ubfniwm8z=EhE5hZ8TZSvZmOX_DYixA8pQ@mail.gmail.com>
In-Reply-To: <CAHw9_iJFRgFAv8V-Ubfniwm8z=EhE5hZ8TZSvZmOX_DYixA8pQ@mail.gmail.com>
From: Eric Rescorla <ekr@rtfm.com>
Date: Tue, 10 Mar 2020 11:47:16 -0700
Message-ID: <CABcZeBPYToK0B=HKf44dPgYBsX+nueCzwpT_h6qoQi74DkCBwQ@mail.gmail.com>
To: Warren Kumari <warren@kumari.net>
Cc: The IESG <iesg@ietf.org>, draft-ietf-git-using-github@ietf.org,
ietf-and-github@ietf.org, git-chairs@ietf.org,
Christopher Wood <caw@heapingbits.net>
Content-Type: multipart/alternative; boundary="000000000000addcad05a0848ef7"
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf-and-github/oGcBTRzwXRtbkL5e9iAmnJCfGAg>
Subject: Re: [Ietf-and-github] Warren Kumari's Discuss on
draft-ietf-git-using-github-05: (with DISCUSS and COMMENT)
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, 10 Mar 2020 18:48:00 -0000
Warren, Thanks for your response. While it's true that the list cannot be exhaustive, it seems to me that your DISCUSS comments pretty clearly fall within the "non-criteria" bucket, specifically "Disagreement with informed WG decisions that do not exhibit problems outlined in Section 3.1 (DISCUSS Criteria) <https://ietf.org/about/groups/iesg/statements/iesg-discuss-criteria/#stand-disc>. In other words, disagreement in preferences among technically sound approaches." and potentially "Reiteration of the issues that have been raised and discussed as part of WG or IETF Last Call, unless the AD believes they have not been properly addressed." I note that the non-criteria do not contain the escape hatch you cite here, but rather say clearly: "None of the following are criteria for which the IESG should DISCUSS a document; though they might reasonably form the basis of a non-blocking comment on a document." -Ekr On Tue, Mar 10, 2020 at 11:37 AM Warren Kumari <warren@kumari.net> wrote: > I'm going to take option C: "This cannot be an exhaustive list, but > this set should be taken as exemplary of the common causes for > DISCUSSes seen by the IESG in the past.". > > W > > On Tue, Mar 10, 2020 at 2:01 PM Eric Rescorla <ekr@rtfm.com> wrote: > > > > Hi Warren, > > > > I've got some thoughts about the merits of this DISCUSS comment, but > before I do that, which of the DISCUSS criteria [0] do you think applies to > this DISCUSS? > > > > -Ekr > > > > > > [0] https://ietf.org/about/groups/iesg/statements/iesg-discuss-criteria/ > > > > > > > > > > On Tue, Mar 10, 2020 at 10:45 AM Warren Kumari via Datatracker < > noreply@ietf.org> wrote: > >> > >> Warren Kumari has entered the following ballot position for > >> draft-ietf-git-using-github-05: Discuss > >> > >> When responding, please keep the subject line intact and reply to all > >> email addresses included in the To and CC lines. (Feel free to cut this > >> introductory paragraph, however.) > >> > >> > >> Please refer to > https://www.ietf.org/iesg/statement/discuss-criteria.html > >> for more information about IESG DISCUSS and COMMENT positions. > >> > >> > >> The document, along with other ballot positions, can be found here: > >> https://datatracker.ietf.org/doc/draft-ietf-git-using-github/ > >> > >> > >> > >> ---------------------------------------------------------------------- > >> DISCUSS: > >> ---------------------------------------------------------------------- > >> > >> I originally balloted Abstain, but this is (and has been) bothering me > enough > >> that I'm changing it to a discuss. > >> > >> This feels like additional centralization / control / process, without > good > >> justification. I happen to use GitHub for my documents (along with > discussion / > >> agreement with co-authors), but in personal repos. Our documents include > >> something like: "[ This document is being collaborated on in Github at > >> https://github.com/wkumari/<draft-name>me>. The most recent version of > the > >> document, open issues, and so on should all be available there. The > authors > >> gratefully accept pull requests. ]" > >> > >> This document contains a lot of text about setting up, administering, > etc a WG > >> organization / repos -- but there is no good justification (that I > could find) > >> on what advantages this has over simply encouraging people use GitHub > (because > >> it is easy, and well known), and keeping things in their own repos. If > WG > >> documents include a pointer (like above) to the repo, everyone can find > it, and > >> we don't need all this. This smacks of scope-creep / chairs having > control and > >> process where it a: isn't needed and b: isn't helpful. > >> > >> > >> ---------------------------------------------------------------------- > >> COMMENT: > >> ---------------------------------------------------------------------- > >> > >> I spent a while trying to decide between Abstain and DISCUSS. > >> > >> I'm uncomfortable with much of this document: > >> 1: This a BCP, and strongly implies that this is the "right" way for > working > >> groups to manage themselves and documents streams. The charter says: > "Whether > >> working groups choose to use GitHub or the documented policies to > support their > >> work will remain entirely at their discretion." - while the document > does let > >> WGs choose, the BCP track strongly implies that this is the "best" way. > I > >> happen to put documents that I author in git (hosted on GitHub), and > use that > >> to collaborate with my co-authors, but this is *our* choice, imposing > our > >> working process on others is a mistake - we have used the "as long at > it can be > >> turned into the canonical format we don't care how you make it" > paradigm for a > >> reason. If people create the XML in vim or emacs is, and should be > entirely > >> their decision - telling people that the "right" editor is vi is wrong > - and a > >> BCP does that... > >> > >> The charter also says: "The documents produced by this group will not > alter the > >> Internet Standards Process (BCP 9). They will describe how to work > within it." > >> but the document sails very close to the wind in many places - e.g: > "Working > >> Group chairs MAY request a revision of an Internet-Draft being managed > on > >> Github at any time, in consultation with document editors." It has > always been > >> clear that chairs can request revisions to WG documents; this doesn't > change > >> it, but mentioning things like this simply muddies the water / makes > more > >> places for people to have to check. Section 7 is an example place where > is is > >> really dangerous - and I think comes close to trying to change BCP9. > >> > >> 2: The focus on GitHub makes my deeply uncomfortable -- I get the > argument that > >> it is the standard / best known hosted git provider (and, in my > *opinion* the > >> right one for us to use), but there are many places where term "GitHub" > applies > >> to "self hosted" solutions like GitLab / Gitea / etc. This feels very > close to > >> the IETF recommending that WG participants sign the blue-sheets with a > Bic pen > >> when all we need is some sort of writing implement. Just as one example: > >> "GitHub facilitates more involved interactions,..." this is true of > gitea, > >> gitlab, bitbucket and many other tools -- calling out GitHub gives one > tool > >> prominence and is not appropriate for the IETF to do. > >> > >> 3: We require that all decisions be made on mailing lists - when people > happen > >> to use GitHub to collaborate on documents and happen to use the issue > tracker > >> to track issues, it is clear that this is just for their personal > convenience > >> -- having WG "owned" repos *will* lead to instances where decisions get > made in > >> the issue tracker, and not communicated tp the mailing list - this will > end up > >> with two classes of users: those that keep checking the issue tracker, > and > >> those that follow the mailing list and are surprised by the decisions > made. > >> > >> 4: git (and GitHub) has a really steep learning curve - if a WG decides > to > >> fully jump in and start using GitHub, this (either explicitly or > implicitly) > >> disenfranchises people who don't use or want to use git. > >> > >> 5: Moving state (primarily issues) from a personal repo to a WG one > when a > >> document is adopted is non-trivial -- "You can only transfer issues > between > >> repositories owned by the same user or organization account. You can't > transfer > >> an issue from a private repository to a public repository." and they > have to be > >> (AFAIK), moved individually - this will likely lead to loss of state (I > may > >> also have missed it, but I don't see anywhere in the document that > talks about > >> migrating a document / repo from an individual to a WG hosted version, > and what > >> should happen). I have a document which moved from hosted at > >> www.github.com/wkumari/<document name> to > >> www.github.com/capport-wg/<document-name> - this involved > administrative > >> annoyance, loss of state, and annoyance - for no benefit that I could > see. I > >> think a much much better approach would be have people simple keep the > >> documents in their personal repos and not have the disruption that > moving the > >> repo entails. > >> > >> Don't get me wrong - I like git, and a: host my own gitea instance, b: > maintain > >> a few gitlabs and gogs instances, and c: put all of my drafts in GitHub > - but I > >> really don't think that the IETF should be implying that this is the > "one true > >> way" (BCP) (nor do I like the WG hosted model). > >> > >> > >> > >> _______________________________________________ > >> Ietf-and-github mailing list > >> Ietf-and-github@ietf.org > >> https://www.ietf.org/mailman/listinfo/ietf-and-github > > > > -- > I don't think the execution is relevant when it was obviously a bad > idea in the first place. > This is like putting rabid weasels in your pants, and later expressing > regret at having chosen those particular rabid weasels and that pair > of pants. > ---maf >
- [Ietf-and-github] Warren Kumari's Discuss on draf… Warren Kumari via Datatracker
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Eric Rescorla
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Joel M. Halpern
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Eric Rescorla
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Warren Kumari
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Alissa Cooper
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Eric Rescorla
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Warren Kumari
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Brian E Carpenter
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Barry Leiba
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Martin Thomson
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Salz, Rich
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Richard Barnes
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Alissa Cooper
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Warren Kumari
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Salz, Rich
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Christopher Wood
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Warren Kumari
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Joseph Lorenzo Hall
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Eric Rescorla
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Martin Thomson
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Martin Thomson
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Mark Nottingham
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Eric Rescorla
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Mark Nottingham
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Martin Thomson
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Eric Rescorla
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Mark Nottingham
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Mark Nottingham
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Eric Rescorla
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Martin Thomson
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Mark Nottingham
- Re: [Ietf-and-github] Warren Kumari's Discuss on … Salz, Rich
- Re: [Ietf-and-github] Warren Kumari's Discuss on … STARK, BARBARA H