Re: adapting IETF in light of github and similar tools

Jay Daley <> Tue, 20 April 2021 21:19 UTC

Return-Path: <>
Received: from localhost (localhost []) by (Postfix) with ESMTP id 515D93A1BDA; Tue, 20 Apr 2021 14:19:00 -0700 (PDT)
X-Virus-Scanned: amavisd-new at
X-Spam-Flag: NO
X-Spam-Score: -1.898
X-Spam-Status: No, score=-1.898 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, HTML_MESSAGE=0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Received: from ([]) by localhost ( []) (amavisd-new, port 10024) with ESMTP id TEDn1BnHpEtO; Tue, 20 Apr 2021 14:18:55 -0700 (PDT)
Received: from jays-mbp.localdomain (unknown []) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by (Postfix) with ESMTPSA id 611163A1BD2; Tue, 20 Apr 2021 14:18:54 -0700 (PDT)
From: Jay Daley <>
Message-Id: <>
Content-Type: multipart/alternative; boundary="Apple-Mail=_786062C5-F02D-4781-AC0E-5FC89A03DE0B"
Mime-Version: 1.0 (Mac OS X Mail 13.4 \(3608.\))
Subject: Re: adapting IETF in light of github and similar tools
Date: Wed, 21 Apr 2021 09:18:50 +1200
In-Reply-To: <001001d7360b$2384e0d0$6a8ea270$>
Cc: "Salz, Rich" <>, Keith Moore <>,
To: Larry Masinter <>
References: <20210420160859.BF41573B7076@ary.qy> <> <> <> <001001d7360b$2384e0d0$6a8ea270$>
X-Mailer: Apple Mail (2.3608.
Archived-At: <>
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: IETF-Discussion <>
List-Unsubscribe: <>, <>
List-Archive: <>
List-Post: <>
List-Help: <>
List-Subscribe: <>, <>
X-List-Received-Date: Tue, 20 Apr 2021 21:19:00 -0000

> On 21/04/2021, at 5:32 AM, Larry Masinter <> wrote:
> Git/github could use some adaption to make it work better for IETF.
> I sent in some suggestions back in January. Does anyone think GitHub is
> perfect for IETF use already?
> -----Original Message-----
> From: Larry Masinter <> On Behalf Of Larry Masinter
> Sent: Wednesday, January 6, 2021 10:51 AM
> To:
> Subject: RE: Old directions in social media.
> I'd like to see the IETF LLC fund some development of enterprise to make it work better.
> Just off the top ...

RFC 8875 sets out a plan for how GitHub repositories should be managed and gives the Secretariat and Tools Team various tasks and responsibilities.  As it stands there are two issues with this.  One is the high administrative burden of multiple organisations and repositories.  The second is the limited access to features provided by the free tier, such as the Audit API, which are useful for tools integrations.

As of last week we have an enterprise license for GitHub, which gives the following features:

- access to the Audit API that let’s us pull records of everything for archiving
- allows the creation of unlimited organisations and public repositories under this account.  We can assign whoever we want to manage those without them requiring a license while the Secretariat remains an owner for when an admin change is needed.
- existing organisations can be included under this account if they choose to move to the account
- we are also investigating how it can be used to provide central licensing terms, which will be <> to comply with RFC 8875

This basically provides the features the Secretariat and Tools Team need to deliver RFC 8875.  It is also quite cheap as we can use the minimum 10 user license pack, with a not-for-profit discount, provided that we don’t do anything with private repositories, which would change the licensing dramatically.  

> An enterprise license so it could be customized.

Your specific suggestions below should be raised for discussion on tools-discuss.

> Fix the default GFM so it could easily be used to produce xml2rfcv3 With custom diff appropriate.
> Default actions for building PDF, HTML, text views Tie in with DataTracker and appropriate authentication....
> Integrate with email and wg "decisions"
> Fix the bugs in GitHub "discussions" <-> Issues Integration with meeting tools (agendas, minutes) Default "Teams" & roles appropriate for WG work rather than software development Tutorials & written guides for using Git for IETF work  Regular summaries and insights appropriate for document production Some way to subscribe to summaries of actions and topics without watching every action on the repo (maybe a 'significant change' flag that the PR has and must be approved)


Jay Daley
IETF Executive Director