Re: [yang-doctors] automating yang doctor reviews
Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de> Mon, 23 April 2018 20:25 UTC
Return-Path: <j.schoenwaelder@jacobs-university.de>
X-Original-To: yang-doctors@ietfa.amsl.com
Delivered-To: yang-doctors@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 35B0D12D946 for <yang-doctors@ietfa.amsl.com>; Mon, 23 Apr 2018 13:25:16 -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] 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 rpv4Rj5gZjVm for <yang-doctors@ietfa.amsl.com>; Mon, 23 Apr 2018 13:25:13 -0700 (PDT)
Received: from atlas5.jacobs-university.de (atlas5.jacobs-university.de [212.201.44.20]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 86177126CBF for <yang-doctors@ietf.org>; Mon, 23 Apr 2018 13:25:13 -0700 (PDT)
Received: from localhost (demetrius5.irc-it.jacobs-university.de [10.70.0.222]) by atlas5.jacobs-university.de (Postfix) with ESMTP id 57D7DCF6; Mon, 23 Apr 2018 22:25:12 +0200 (CEST)
X-Virus-Scanned: amavisd-new at jacobs-university.de
Received: from atlas5.jacobs-university.de ([10.70.0.217]) by localhost (demetrius5.jacobs-university.de [10.70.0.222]) (amavisd-new, port 10032) with ESMTP id yEzbiQAr9_-N; Mon, 23 Apr 2018 22:25:11 +0200 (CEST)
Received: from hermes.jacobs-university.de (hermes.jacobs-university.de [212.201.44.23]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "hermes.jacobs-university.de", Issuer "Jacobs University CA - G01" (verified OK)) by atlas5.jacobs-university.de (Postfix) with ESMTPS; Mon, 23 Apr 2018 22:25:12 +0200 (CEST)
Received: from localhost (demetrius4.jacobs-university.de [212.201.44.49]) by hermes.jacobs-university.de (Postfix) with ESMTP id 2EEF420035; Mon, 23 Apr 2018 22:25:12 +0200 (CEST)
X-Virus-Scanned: amavisd-new at jacobs-university.de
Received: from hermes.jacobs-university.de ([212.201.44.23]) by localhost (demetrius4.jacobs-university.de [212.201.44.32]) (amavisd-new, port 10024) with ESMTP id h9gd3Ixs8Eqx; Mon, 23 Apr 2018 22:25:11 +0200 (CEST)
Received: from elstar.local (unknown [10.50.231.133]) by hermes.jacobs-university.de (Postfix) with ESMTP id 9A33720031; Mon, 23 Apr 2018 22:25:11 +0200 (CEST)
Received: by elstar.local (Postfix, from userid 501) id 2F87E42BE14C; Mon, 23 Apr 2018 22:25:11 +0200 (CEST)
Date: Mon, 23 Apr 2018 22:25:11 +0200
From: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>
To: Kent Watsen <kwatsen@juniper.net>
Cc: "yang-doctors@ietf.org" <yang-doctors@ietf.org>
Message-ID: <20180423202511.omhs22xnios3itjw@elstar.local>
Reply-To: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>
Mail-Followup-To: Kent Watsen <kwatsen@juniper.net>, "yang-doctors@ietf.org" <yang-doctors@ietf.org>
References: <51E10A3A-FF6F-4A14-AAD6-BBD12041EF2F@juniper.net>
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Disposition: inline
In-Reply-To: <51E10A3A-FF6F-4A14-AAD6-BBD12041EF2F@juniper.net>
User-Agent: NeoMutt/20171215
Archived-At: <https://mailarchive.ietf.org/arch/msg/yang-doctors/IRU-Fz5i2fYrFxFaPQLoB5cHV4g>
Subject: Re: [yang-doctors] automating yang doctor reviews
X-BeenThere: yang-doctors@ietf.org
X-Mailman-Version: 2.1.22
Precedence: list
List-Id: Email list of the yang-doctors directorate <yang-doctors.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/yang-doctors>, <mailto:yang-doctors-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/yang-doctors/>
List-Post: <mailto:yang-doctors@ietf.org>
List-Help: <mailto:yang-doctors-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/yang-doctors>, <mailto:yang-doctors-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 23 Apr 2018 20:25:16 -0000
Kent, it seems that many of us manage several artefacts while producing an I-D (that is the .xml that is then rendered as an I-D). a) YANG modules b) derived artefacts such as tree diagrams c) examples snippets (XML or JSON) d) source of textual information (growing variety of formats used here) e) tooling to validate examples and YANG modules f) tooling to produce .xml out of a)-d) What you are proposing, if I understand correctly, is to extend the xml2rfc vocabulary such that we can reverse step f), at least partially, to extract a) and c) out of the xml2rfc format and perhaps generate b) automatically from a) and then do e) within the IETF infrastructure. I am not sure I am excited about turning a document markup format (xml2rfc) into a general container format and perhaps also into a (scriptable) data transformation format. (But yes, it sound much better than what we do today, extracting artefacts out of rendered and paginated text.) Perhaps things could be simpler if authors would be able to submit all pieces that make up an I-D as separate artefacts instead of first inlining all of the artefacts in some xml2rfc container format and then extracting them again out of this format to feed tool chains. The whole idea that a document is a single file using a single format really feels somewhat odd these days. (Well, it already felt odd when people were writing MIB modules and the RFC editor used nroff or plain text to start their editing. The pain isn't new, just coming along in a different flavor.) Perhaps all we need is a proper sourcecode include mechanism and a submission tool that allows to submit multiple artefacts so we do not need to first inline everything into xml2rfc and then extract things out of it again. /js On Mon, Apr 23, 2018 at 06:40:30PM +0000, Kent Watsen wrote: > > anyone interested in this draft? (draft attached in my previous message) > > /kw > > > ===== original message ===== > > Doctors, > > Here's a stab at how we might automate the basic parts of a YANG Doctor review, something I've mentioned wanting at the YD-lunch meeting at the last two IETF meetings. > > I'll be the first to say that this proposal has issues, but hopefully it's in the ballpark, and we can finish it off together, assuming there is interest in bringing it forward at all... > > Note, I assume that this document will be AD-sponsored, just like RFC 7991 was, hence why the draft name is what it is. > > Kent > > > > > _______________________________________________ > yang-doctors mailing list > yang-doctors@ietf.org > https://www.ietf.org/mailman/listinfo/yang-doctors -- Juergen Schoenwaelder Jacobs University Bremen gGmbH Phone: +49 421 200 3587 Campus Ring 1 | 28759 Bremen | Germany Fax: +49 421 200 3103 <https://www.jacobs-university.de/>
- [yang-doctors] automating yang doctor reviews Kent Watsen
- Re: [yang-doctors] automating yang doctor reviews Kent Watsen
- Re: [yang-doctors] automating yang doctor reviews Mahesh Jethanandani
- Re: [yang-doctors] automating yang doctor reviews Kent Watsen
- Re: [yang-doctors] automating yang doctor reviews Juergen Schoenwaelder
- Re: [yang-doctors] automating yang doctor reviews Benoit Claise
- Re: [yang-doctors] automating yang doctor reviews Andy Bierman
- Re: [yang-doctors] automating yang doctor reviews Kent Watsen
- Re: [yang-doctors] automating yang doctor reviews Kent Watsen
- Re: [yang-doctors] automating yang doctor reviews Andy Bierman
- Re: [yang-doctors] automating yang doctor reviews Andy Bierman
- Re: [yang-doctors] automating yang doctor reviews Martin Bjorklund
- Re: [yang-doctors] automating yang doctor reviews Kent Watsen
- Re: [yang-doctors] automating yang doctor reviews Reshad Rahman (rrahman)
- Re: [yang-doctors] automating yang doctor reviews Mahesh Jethanandani
- Re: [yang-doctors] automating yang doctor reviews Christian Hopps