IETF Logo Mail Archive

Re: [Ietf-and-github] Seeking feedback on draft-ietf-git-using-github and Git tutorial

Brian E Carpenter <brian.e.carpenter@gmail.com> Sat, 05 October 2019 01:41 UTC

Return-Path: <brian.e.carpenter@gmail.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 3754C12006E for <ietf-and-github@ietfa.amsl.com>; Fri, 4 Oct 2019 18:41:27 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.999
X-Spam-Level:
X-Spam-Status: No, score=-1.999 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.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 bE1PmDuqMEN0 for <ietf-and-github@ietfa.amsl.com>; Fri, 4 Oct 2019 18:41:25 -0700 (PDT)
Received: from mail-pf1-x442.google.com (mail-pf1-x442.google.com [IPv6:2607:f8b0:4864:20::442]) (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 44F3F12006B for <ietf-and-github@ietf.org>; Fri, 4 Oct 2019 18:41:25 -0700 (PDT)
Received: by mail-pf1-x442.google.com with SMTP id v4so4934286pff.6 for <ietf-and-github@ietf.org>; Fri, 04 Oct 2019 18:41:25 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=subject:to:references:from:message-id:date:user-agent:mime-version :in-reply-to:content-language:content-transfer-encoding; bh=KwxaMnhBK8RnLusAn0A0zR9ODqw3QU2hZngYevYyWbQ=; b=BRWduFEqOmYvbuWvmC5rieVf8Wtlyf552OOb0e4C0vlJi3iRQg8AM02OS9Lg6aYhsW BEKqdH7EzXGD6ERE/8ftFy48M33WL4BxiSfc2PgPt+vX8Xfqk1+qM8N7ywCJ8vCu8Dee 9hMNxojEgbbdi3MNK/xv2uo+OQdDhQrX1xFWVdV7d6zDxBBw8DIc/3LvLbrzTtr4KwYM bPjU3VPADtzhVpZOwmLYBuEoTQiyYUupZFSA382PqpAC5L+/AlNbdfxQUVvIStxEfrhJ IjCGfDwJtpF1M1ntt78CT1AYQKv6uuAwcYTmcewSH+LjfhgZppMSe6CPlNAm94/SiavG WRow==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=KwxaMnhBK8RnLusAn0A0zR9ODqw3QU2hZngYevYyWbQ=; b=VjboWXuKoIpn9dC2ynrkccxFlokdYy2vBrrjBMDy0lOR3XOCzxPH2pRcbfDD3J04HA 7BqJyoXCr/f+A725BxDpn7UNGXZz1cwbdsSvUwBQZlvhBYIMXcEe4ea/Qz8EE0mo7cj7 uY2L64viq3juLpFCFjtKl9mYAk/E4hNyo9Tcn3QP/DVQ3Q7QLs+rVTSQt3Zh1uqPn0xk DGsIAmddtcjkSBUO7DWoerTdfJnoPxFajLuM1nzNDkmXTNv7OYhATZVevBLp9dkjrCSt Vx2qvul/LiklBgQ89mB07DNoIP7oZLXE3+7hfnWyEqsij0IYXK/7XNztgmcyjavCawpt BiyQ==
X-Gm-Message-State: APjAAAWEPXuwzYJcGDPlNxWmlzS7k6W0uRlw+HVglQqpEOlMKI8A2jBT D1+P6EYB6uIHMUBswyxffIw9Op6Z
X-Google-Smtp-Source: APXvYqyN8wOPW5Q1Pb2Fkx3eyrfmBpqcl7sENDKarmESXjDq6dOmfroKf1/NXq81cPOZzAliIW9Bmg==
X-Received: by 2002:a65:4002:: with SMTP id f2mr5391619pgp.447.1570239684171; Fri, 04 Oct 2019 18:41:24 -0700 (PDT)
Received: from [192.168.178.30] (233.148.69.111.dynamic.snap.net.nz. [111.69.148.233]) by smtp.gmail.com with ESMTPSA id q3sm6742375pgj.54.2019.10.04.18.41.21 for <ietf-and-github@ietf.org> (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 04 Oct 2019 18:41:22 -0700 (PDT)
To: ietf-and-github@ietf.org
References: <81307dc9-b275-4305-84d8-3a602ab271f5@www.fastmail.com> <BBCDB401-F370-419B-824D-74067EAD7F0F@apple.com>
From: Brian E Carpenter <brian.e.carpenter@gmail.com>
Message-ID: <53279a4d-4b29-4ed0-9db7-ae74e61133f7@gmail.com>
Date: Sat, 05 Oct 2019 14:41:21 +1300
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:60.0) Gecko/20100101 Thunderbird/60.9.0
MIME-Version: 1.0
In-Reply-To: <BBCDB401-F370-419B-824D-74067EAD7F0F@apple.com>
Content-Type: text/plain; charset="utf-8"
Content-Language: en-US
Content-Transfer-Encoding: 7bit
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf-and-github/Mve9RWuRnFiTRoks794S9WmJTuc>
Subject: Re: [Ietf-and-github] Seeking feedback on draft-ietf-git-using-github and Git tutorial
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: Sat, 05 Oct 2019 01:41:27 -0000

>> On Oct 4, 2019, at 1:32 PM, Christopher Wood <caw@heapingbits.net> wrote:
>>
>> Hi folks,
>>
>> As we approach Singapore, it would be quite useful to get more feedback on draft-ietf-git-using-github, especially with the changes merged in September. You can view the editor's copy here:
>>
>>   https://ietf-gitwg.github.io/using-github/draft-ietf-git-using-github.html
>>
>> (I'm sure an updated version in the datatracker will come shortly.)

When, please? The -00 draft is close to expiry. Apparently no update was posted prior to IETF 105 (against the advice in "6. Internet-Draft Publication"). Reading that section, I think it says too little about the danger of infrequent updates disadvantaging some WG members. I think that WG chairs SHOULD adopt a policy about the frequency of drafts (and IMHO it SHOULD be more frequent than one per IETF cycle, if a document is under active development).

Also I had to work a little bit to get hold of diffs in the usual (rfcdiff) form. This may change somwhat as we move to xmlrfcv3, but could we recommend that .txt and Diff...txt.html files are also always made available? (Yes, the .txt file is there, but I had to guess where.)

>> To accompany this document, we also put together a tutorial for people new to Git(Hub) and its use for IETF draft development:
>>
>>   https://ietf-gitwg.github.io
>>
>> It aims to help IETF contributors get started with the system, Martin's excellent i-d-template toolchain, and GitHub for the purposes of supporting the different Modes of Interaction described in draft-ietf-git-using-github.

It's a good start. But it doesn't provide pointers on how to install GitHub on the popular operating systems, and it doesn't do much for people who prefer to use the GitHub desktop app on Windows, or those who mainly want to use the web interface.

Regards
    Brian

v2.23.0 | Report a Bug | By Email