Re: IETF Git and GitHub tutorial

Warren Kumari <warren@kumari.net> Fri, 11 October 2019 18:50 UTC

Return-Path: <warren@kumari.net>
X-Original-To: wgchairs@ietfa.amsl.com
Delivered-To: wgchairs@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 9422E12006A for <wgchairs@ietfa.amsl.com>; Fri, 11 Oct 2019 11:50:15 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.9
X-Spam-Level:
X-Spam-Status: No, score=-1.9 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, 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=kumari-net.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 WRbWZsgaEjpQ for <wgchairs@ietfa.amsl.com>; Fri, 11 Oct 2019 11:50:12 -0700 (PDT)
Received: from mail-qt1-x82e.google.com (mail-qt1-x82e.google.com [IPv6:2607:f8b0:4864:20::82e]) (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 2E9DA120018 for <wgchairs@ietf.org>; Fri, 11 Oct 2019 11:50:12 -0700 (PDT)
Received: by mail-qt1-x82e.google.com with SMTP id c21so15255702qtj.12 for <wgchairs@ietf.org>; Fri, 11 Oct 2019 11:50:12 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=kumari-net.20150623.gappssmtp.com; s=20150623; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc:content-transfer-encoding; bh=EGQq7WnbY0Z9fipqAU0tgIhH6iaVgGAWM9W6rVdhdAQ=; b=XaxP4OSmmx0LNFINwHE32B0VeDfqv49LWcGppEkvytjmIcVus3b98l4N2LDrO2R8gE pWGyULUNFkJFv57u9X2lunQYIxbybms3EtxL39ukZ0W7vCks1WN90Hx5QIaQ4BxOanBM CMdhtgdqMPypQGze8cN2jlCv9J/QQYxjsIADbyo+lt1kcvh4O5tHTmb7G280wSs0QypM VttRT76m6txXIdQNJmCQaC2YSXEh5ahXa+a2ixeUcv5Utf/AZTmPEgaTAn0lFXMBjHn0 xWlcjrku+o2Wg7Cs5QzaXo+2CSqDf0vBssdL8BY8bEMZXDOsMqmI81gRQraYzonwUcno 5t9A==
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:content-transfer-encoding; bh=EGQq7WnbY0Z9fipqAU0tgIhH6iaVgGAWM9W6rVdhdAQ=; b=Ow7GJdnTJeMqKFkxaQBEARU3TWIuMHBn5W0j+v2k35kbd4fuFz4qB5zbMgUq6LJfqJ P6Fg94IspD7AQa7VVZ9eaCKFtVEM4jzlr75C84rSHWiz6mrMdYXT+sajecX3nE1OmAR2 Yq7D+NZ7pPN1utu1EXJLrNZtGzNDORW+gdDVIawRVkKWcV0JtOOVr/YlOml6M042BqkN Z7Y1GDjhtHkkp6QzFgo961JeXJLX8EyR14goPOH7Vv6GJEyuN/lzGFrpAczrF3sVTQJ9 FLMOHR3G8DWvnAP6cDnwe/JybDpPmyqr8AUQ01DxCBjuzagagqco6HEJdl5jIMw8jLoc vfXA==
X-Gm-Message-State: APjAAAX6hNg67MA4VcJcP3X0g6FetA99dlAOQu/jteTxTrRyfCemN2Si I2lrTTA7JRmhKucBBoGu8y0WBz0KNtEQiZ+2GA+oDA==
X-Google-Smtp-Source: APXvYqw/9MfUZRHE2xREFixq2E3WcbBFFs9mIvRiH3uvHio90UMXiJ1P7zVrhjtwNseIYTWOnuS11J1mTnMAT368DaU=
X-Received: by 2002:a0c:91bd:: with SMTP id n58mr18059470qvn.62.1570819810078; Fri, 11 Oct 2019 11:50:10 -0700 (PDT)
MIME-Version: 1.0
References: <3b3a2e43-3a37-44d8-9967-920d2f977e42@www.fastmail.com> <CADZyTk=7fN+i7H1AX+T7fW3OOQGUAd7z0mtGAeUnpr2O5vZsKA@mail.gmail.com> <CADZyTkkku5y8a1HURp6uQ447eq_dn5wzhwPxhqrpvg1U4dHctQ@mail.gmail.com> <9338.1570802815@dooku.sandelman.ca> <4FDDF67C-0E50-43C1-A067-DB4FBD5F453B@akamai.com> <85ED12CD-E3EA-4FE7-830D-6785462D0B97@encrypted.net>
In-Reply-To: <85ED12CD-E3EA-4FE7-830D-6785462D0B97@encrypted.net>
From: Warren Kumari <warren@kumari.net>
Date: Fri, 11 Oct 2019 20:49:32 +0200
Message-ID: <CAHw9_i+3ibSa465UMXr7frBMQE3kDxGx2q_UNWE11wNoqRvLwg@mail.gmail.com>
Subject: Re: IETF Git and GitHub tutorial
To: Sarah Banks <sbanks@encrypted.net>
Cc: IETF WG Chairs <wgchairs@ietf.org>, Michael Richardson <mcr@sandelman.ca>, "Salz, Rich" <rsalz@akamai.com>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
Archived-At: <https://mailarchive.ietf.org/arch/msg/wgchairs/TAD-EnjRyrnIYUaXnANbWPENXns>
X-BeenThere: wgchairs@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Working Group Chairs <wgchairs.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/wgchairs>, <mailto:wgchairs-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/wgchairs/>
List-Post: <mailto:wgchairs@ietf.org>
List-Help: <mailto:wgchairs-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/wgchairs>, <mailto:wgchairs-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 11 Oct 2019 18:50:16 -0000

On Fri, Oct 11, 2019 at 6:13 PM Sarah Banks <sbanks@encrypted.net> wrote:
>
> My WG has a lot of first timers. And a lot of non engineers - technical folks, SQA for example, but non engineers. FWIW everything Rich just said would be over their heads, in that they don't check in/check out code on a daily basis. I strongly +1 a thorough walk through guide for the typical tasks.


I don’t see the complexity -- as (possibly) Bruce Lawson said "Git
gets easier once you understand branches are homeomorphic endofunctors
mapping submanifolds of a Hilbert space."

W

P.S: I *fully* agree with you -- I do basically all of my personal
projects in git, and all of my drafts, and I contribute to other
people projects, etc -- and I *still* often just copy my changes
somewhere, delete the entire repo, checkout a clean copy and then
stuff my changes back in, all the while chanting the mantra "nom erg
con flit, nom erg con flit, please gods, nom erg con flit". (Ok, it's
been many years since I'be blown away a repo, but I *do* still have a
personal cheatsheet for how to rebase a pull request...)

I've tried explaining to some "non-computer" people how to use git,
and their eyes quicky glazed over -- for some of them the closest I've
gotten is "Use Github, click the button that looks like a pencil, type
quickly and then click 'Commit changes'. Don't touch anything else..."

W


>
> Thanks
> Sarah
>
>
> > On Oct 11, 2019, at 9:00 AM, Salz, Rich <rsalz@akamai.com> wrote:
> >
> >
> >>   And there is a serious limitation, which is that it pretty much impossible to
> >    rebase with only the web interface, so after having submitted an edit, once
> >    it is accepted, one winds up with a tree (fork) you can not use again.
> >
> > The work-around is simple and probably follows what most people do, anyway: do not re-use a branch name for different items of work. (Arguably that's an implied git best practice.) In fact, GitHub pull requests use the branch name, so I would not be surprised if doing this (which you shouldn't) can lead to problems anyway.
> >
>