Re: On XML and $EDITORs (Re: Things that used to be clear (was ...)) "Living Documents") side meeting at IETF105.)

Phillip Hallam-Baker <phill@hallambaker.com> Thu, 11 July 2019 18:33 UTC

Return-Path: <hallam@gmail.com>
X-Original-To: ietf@ietfa.amsl.com
Delivered-To: ietf@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 961031202CA for <ietf@ietfa.amsl.com>; Thu, 11 Jul 2019 11:33:37 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -0.107
X-Spam-Level:
X-Spam-Status: No, score=-0.107 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, FREEMAIL_FORGED_FROMDOMAIN=0.247, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.249, HTML_MESSAGE=0.001, PDS_NO_HELO_DNS=1.295, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=no 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 X5OxqsShy-6K for <ietf@ietfa.amsl.com>; Thu, 11 Jul 2019 11:33:36 -0700 (PDT)
Received: from mail-ot1-f43.google.com (mail-ot1-f43.google.com [209.85.210.43]) (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 49A341200D7 for <ietf@ietf.org>; Thu, 11 Jul 2019 11:33:36 -0700 (PDT)
Received: by mail-ot1-f43.google.com with SMTP id q20so6869306otl.0 for <ietf@ietf.org>; Thu, 11 Jul 2019 11:33:36 -0700 (PDT)
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; bh=KIOrQ0K43yyTw6s40mBcO07EWGG6lC+kbynq3/aVDkg=; b=cV1Ozhy3rirSRYA1mY0D7SRcxVG9ZwvjGrGtH8xlmBSTaAQowkawbPVFVl9PBAueXT TG/nBRZL+Fq92aL4WOJngKRWIlgq0AT9pqY3m3crGpxGCxEE7UGDMj01Sxz1PKD/Ww2Y TI6DoEI3ViRu5qrk2IWjXb1SMgSyGQj5uC2lGi7BEzFJ7uaSu9bBsgWj5HSglxzGrDd0 GN6qsDe/Vs0H6sEM1VsztFyFlrJjcc3kpQ6awk6Lj0a5XjWC8ueMsI9i3SV11Qci6Vb/ ESdj34lOvpDxHc0UNVSGMVqQdRKXiAtefrETo9PbEffY1c4fgbcj6b07ClO+5pahaeR2 b6Aw==
X-Gm-Message-State: APjAAAU8s8eV4uGbh+hnghm8+9S6nGpjrFh87AlcCrrKYLyGDVIFYk+0 O3RMSFupAE4IeYHZvYrv86a9I09k5lOJL0ruWMs=
X-Google-Smtp-Source: APXvYqyUSbjBNJu9+/7cHS1MdB143BqWQq+w4md3mOWlAZ8qUQOyruIzMe10ZZnw0opLDibIc0emqDMgJrHYoHan5nk=
X-Received: by 2002:a05:6830:1206:: with SMTP id r6mr4749898otp.37.1562870015196; Thu, 11 Jul 2019 11:33:35 -0700 (PDT)
MIME-Version: 1.0
References: <9ae14ad1-f8d5-befb-64e4-fff063c88e02@network-heretics.com> <CABcZeBOH9LH8Jrz-A5eu9arqUb+bx8xs_eKWi0pyoh7a3qpOPA@mail.gmail.com> <20190708223350.GO3508@localhost> <af3b25d6-af16-a96a-c149-61d01afb4d01@network-heretics.com> <20190708233438.GP3508@localhost> <ea0b9894-ae9d-55a9-a082-af7aac5be66a@huitema.net> <20190710045202.GA3215@localhost> <20190710064451.GB3215@localhost> <06EF2608-038E-400F-86BA-34F57630B53F@fugue.com> <CAMm+LwjFgSK7DSaN2CpLxmL=PO22s2qjBvBHC48jH9UnFy8=wg@mail.gmail.com> <20190711172441.GN3215@localhost> <7FC9E7F4-FD46-4DD0-B623-D48647AC59FD@network-heretics.com>
In-Reply-To: <7FC9E7F4-FD46-4DD0-B623-D48647AC59FD@network-heretics.com>
From: Phillip Hallam-Baker <phill@hallambaker.com>
Date: Thu, 11 Jul 2019 14:33:25 -0400
Message-ID: <CAMm+Lwim17yG-6a6TTPZ_jWNEwJDNH8yntzcRXztxoHi9ofnkw@mail.gmail.com>
Subject: Re: On XML and $EDITORs (Re: Things that used to be clear (was ...)) "Living Documents") side meeting at IETF105.)
To: Keith Moore <moore@network-heretics.com>
Cc: Nico Williams <nico@cryptonector.com>, Ted Lemon <mellon@fugue.com>, Christian Huitema <huitema@huitema.net>, IETF Discussion Mailing List <ietf@ietf.org>
Content-Type: multipart/alternative; boundary="00000000000016032c058d6c0815"
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf/k8O6y-l779LhskCwGU104dQpDGU>
X-BeenThere: ietf@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: IETF-Discussion <ietf.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/ietf>, <mailto:ietf-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/ietf/>
List-Post: <mailto:ietf@ietf.org>
List-Help: <mailto:ietf-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/ietf>, <mailto:ietf-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 11 Jul 2019 18:33:37 -0000

The interface to the IETF document process is exactly what I use xml2rfc
for.

If I am producing a -bis document, I pull the .xml from wherever I can find
it and convert it to word. Then I convert it back to upload it.

But since we are discussing all this. How about we specify the rest of the
interface. I would really like it if I could make the document submission
from RFCtool.

So normally, I type
rfctool %DocSource%\hallambaker-mesh-5-protocol.docx  /auto /cache=bib.xml

It would be nice to be able to submit a changed document with something like
rfctool %DocSource%\hallambaker-mesh-5-protocol.docx  /auto /cache=bib.xml
/submit


There is a small corner case which is that if you have multiple documents
and you are submitting updates to three out of five, you want the new docs
to reference the new versions of the updates documents but the old versions
of the ones that are not being submitted.

So it is probably something a bit more git-like and there is a /stage
operation to mark the draft as one of the ones to be updated and a /submit
operation to ship them out.

[I would also prefer to be able to authenticate the submission by signing
it with a digital signature rather than the email callback scheme. Which
might sound like feature creep but could actually simplify providing the
capability as it would allow a stateless submission. The XML would have to
be expanded to specify the signature key(s) allowed.]




On Thu, Jul 11, 2019 at 1:32 PM Keith Moore <moore@network-heretics.com>
wrote:

>
>
> Sent from my iPhone
>
> > On Jul 11, 2019, at 1:24 PM, Nico Williams <nico@cryptonector.com>
> wrote:
> >
> >> On Thu, Jul 11, 2019 at 09:41:09AM -0400, Phillip Hallam-Baker wrote:
> >> But the bigger point here surely, is that this thread is now an editor
> war.
> >
> > Sigh.  That was not my intention, but the opposite.  My point was/is
> > that the choice of $EDITOR shouldn't matter, and that our choice of XML
> > as the canonical or submission format should not -and DO NOT- preclude
> > $EDITORs that hide the XML from the user.
>
> Actually the one thing that xml seems like it might be a decent choice
> for, is a stable back end interface that could accept input from a variety
> of editors and text processors and allow RFCs and I-Ds to be handled by a
> common toolset.  Except that it’s not stable.
>
> (It’s not a particularly good interface for that purpose, but it doesn’t
> have to be - the main requirements are that it be adequate and stable.)
>
> Keith
>
>
>