Re: [edu-team] GitHub Tutorial

Niels ten Oever <niels@article19.org> Wed, 12 April 2017 14:30 UTC

Return-Path: <niels@article19.org>
X-Original-To: edu-team@ietfa.amsl.com
Delivered-To: edu-team@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id C3EB1129BAB for <edu-team@ietfa.amsl.com>; Wed, 12 Apr 2017 07:30:10 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.902
X-Spam-Level:
X-Spam-Status: No, score=-1.902 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
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 J3JENqiWMdxK for <edu-team@ietfa.amsl.com>; Wed, 12 Apr 2017 07:30:08 -0700 (PDT)
Received: from smarthost1.greenhost.nl (smarthost1.greenhost.nl [195.190.28.81]) (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 D454C129BA8 for <edu-team@ietf.org>; Wed, 12 Apr 2017 07:30:07 -0700 (PDT)
Received: from smtp.greenhost.nl ([213.108.104.138]) by smarthost1.greenhost.nl with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.84_2) (envelope-from <niels@article19.org>) id 1cyJHX-00029C-9z for edu-team@ietf.org; Wed, 12 Apr 2017 16:30:04 +0200
To: edu-team@ietf.org
References: <03F50F33-938B-4214-8E08-2B314BC14D73@vigilsec.com> <17e534b5-6ed6-bab7-4f51-167fc35d6df9@ripe.net> <630E1BF9-A683-4BDB-BAE6-09AA79679120@vigilsec.com>
From: Niels ten Oever <niels@article19.org>
Message-ID: <e1ea61fe-e4ca-111d-9cff-541cbf8b3326@article19.org>
Date: Wed, 12 Apr 2017 16:30:01 +0200
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Thunderbird/45.8.0
MIME-Version: 1.0
In-Reply-To: <630E1BF9-A683-4BDB-BAE6-09AA79679120@vigilsec.com>
Content-Type: multipart/signed; micalg="pgp-sha256"; protocol="application/pgp-signature"; boundary="DHAcMQ2ONUtHAidGWrD30t8eS2w7bonPQ"
X-Virus-Scanned: by clamav at smarthost1.samage.net
X-Scan-Signature: 1621a07189ffd89c587b37d28d532eca
Archived-At: <https://mailarchive.ietf.org/arch/msg/edu-team/XsKB7GrBIRxB3zXFN1j91b0c-g8>
Subject: Re: [edu-team] GitHub Tutorial
X-BeenThere: edu-team@ietf.org
X-Mailman-Version: 2.1.22
Precedence: list
List-Id: IETF Education Team <edu-team.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/edu-team>, <mailto:edu-team-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/edu-team/>
List-Post: <mailto:edu-team@ietf.org>
List-Help: <mailto:edu-team-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/edu-team>, <mailto:edu-team-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 12 Apr 2017 14:30:11 -0000

Hi all,

I think this could be different kind of workshops:

1. Github 101 (how does Github work)
2. How to collaborate on a draft using Github
	- kramdown
	- xml2rfc
	- automated building on Github with Travis / Circle
	- Receiving pull requests & mapping issues
3. How to setup a repository for a WG

I think 3. would be controversial (and maybe hard to do without Mark
because the HTTPbis WG website is currently pretty much the furthest you
can go where it comes to Github integration and use of it functionality)

1. and 2. should probably be doable in two hours?

Best,

Niels


Niels ten Oever
Head of Digital

Article 19
www.article19.org

PGP fingerprint    2458 0B70 5C4A FD8A 9488
                   643A 0ED8 3F3A 468A C8B3

On 04/12/2017 04:22 PM, Russ Housley wrote:
> I think it would be a good time for an advocate to share the reasons
> that they like to use GitHub.  There are of course other options, but
> GitHub seems to be gaining momentum.
> 
> I do not think we should wait until everything is polished.  Letting
> people use GitHub and sharing their experiences will help the
> community make the right decisions.  As you know, I believe in
> incremental improvement.
> 
> Russ
> 
> 
>> On Apr 12, 2017, at 4:48 AM, Mirjam Kuehne <mir@ripe.net> wrote:
>> 
>> Hi Russ,
>> 
>> Thanks for the suggestion. We had a GitHub training for WG chairs
>> some time ago which was well receive. I also thought it would be a
>> good time to provide that for the larger IETF community.
>> 
>> On the other hand, at IETF 98 there was a GitHub BoF (organised by
>> Paul Hoffman) which was also discussed during the WG chairs
>> session. I had a chat with Paul Hoffman afterwards. He thought it
>> would be too early for a tutorial at this point until we have all
>> the processes in order (how to integrate email discussions with
>> discussions on GitHub etc.). I am not sure I am convinced however.
>> People won't stop using GitHub in the meantime and it wouldn't hurt
>> to provide some tips and tricks.
>> 
>> At the WG chairs session it was also suggested to possibly combine
>> this with other tools and provide a training on travis(?), circl
>> and GitHub for instance.
>> 
>> What do others think?
>> 
>> Mirjam
>> 
>> 
>> On 11/04/17 19:02, Russ Housley wrote:
>>> In the hallway, I heard some people asking for a Sunday tutorial
>>> about GitHub.  Maybe we can find someone to talk about that.
>>> Martin and Mark are on the IAB, so they are probably not
>>> available on Sunday afternoon.  Who else could do it? 
>>> _______________________________________________ edu-team mailing
>>> list edu-team@ietf.org 
>>> https://www.ietf.org/mailman/listinfo/edu-team
>>> 
>> 
> 
> _______________________________________________ edu-team mailing
> list edu-team@ietf.org 
> https://www.ietf.org/mailman/listinfo/edu-team
>