Re: [Ext] Re: [rfc-i] Evolving document sources over a long time (Re: Comments on draft-roach-bis-documents-00)

tom petch <> Thu, 23 May 2019 08:02 UTC

Return-Path: <>
Received: from localhost (localhost []) by (Postfix) with ESMTP id 96CB712018E for <>; Thu, 23 May 2019 01:02:24 -0700 (PDT)
X-Virus-Scanned: amavisd-new at
X-Spam-Flag: NO
X-Spam-Score: 0.247
X-Spam-Status: No, score=0.247 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, RATWARE_MS_HASH=2.148, RCVD_IN_DNSWL_NONE=-0.0001, SPF_PASS=-0.001] autolearn=no autolearn_force=no
Authentication-Results: (amavisd-new); dkim=pass (1024-bit key)
Received: from ([]) by localhost ( []) (amavisd-new, port 10024) with ESMTP id 0cWZj4hyEUSn for <>; Thu, 23 May 2019 01:02:20 -0700 (PDT)
Received: from ( []) (using TLSv1.2 with cipher ECDHE-RSA-AES256-SHA384 (256/256 bits)) (No client certificate requested) by (Postfix) with ESMTPS id 4FC33120137 for <>; Thu, 23 May 2019 01:02:20 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;; s=selector1-btconnect-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=waykMe6DWpRw97dF+jcP+r48jcvS+RsWXrFPzeomYS4=; b=AIKTx30kAZqLzzAcNWO6tgriPhjIbws02wnP3WTn1YfRlRzwFI2h4asU6iu3s2MQCL8J4dIo/XpVUgyIAvXWTVFFJTl8F4G8yhNn3CPVGPYXlrPsZcMXQjI8Oo4BkQaosbvn6tHSaYesaXofVSznUt7tnebsLHIFJkA46JHSTsQ=
Received: from ( by ( with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.1922.9; Thu, 23 May 2019 08:02:16 +0000
Received: from ([fe80::318c:8426:460c:9f4a]) by ([fe80::318c:8426:460c:9f4a%7]) with mapi id 15.20.1922.013; Thu, 23 May 2019 08:02:16 +0000
From: tom petch <>
To: "Andrew G. Malis" <>, David Noveck <>
CC: Michelle Cotton <>, IETF Discussion Mailing List <>
Subject: Re: [Ext] Re: [rfc-i] Evolving document sources over a long time (Re: Comments on draft-roach-bis-documents-00)
Thread-Topic: [Ext] Re: [rfc-i] Evolving document sources over a long time (Re: Comments on draft-roach-bis-documents-00)
Thread-Index: AQHVDmepQnIKJlbcUEu5TmOxj7a+pw==
Date: Thu, 23 May 2019 08:02:16 +0000
Message-ID: <00df01d5113d$49183c60$>
References: <> <> <> <> <> <> <> <> <> <> <> <>
Accept-Language: en-GB, en-US
Content-Language: en-US
x-clientproxiedby: LO2P265CA0341.GBRP265.PROD.OUTLOOK.COM (2603:10a6:600:d::17) To (2603:10a6:7:a0::23)
authentication-results: spf=none (sender IP is );
x-ms-exchange-messagesentrepresentingtype: 1
x-mailer: Microsoft Outlook Express 6.00.2800.1106
x-originating-ip: []
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: 10cc9ea0-b3f4-4e25-abe3-08d6df54f843
x-microsoft-antispam: BCL:0; PCL:0; RULEID:(2390118)(7020095)(4652040)(8989299)(4534185)(4627221)(201703031133081)(201702281549075)(8990200)(5600141)(711020)(4605104)(2017052603328)(7193020); SRVR:HE1PR07MB3145;
x-ms-traffictypediagnostic: HE1PR07MB3145:
x-microsoft-antispam-prvs: <>
x-ms-oob-tlc-oobclassifiers: OLM:10000;
x-forefront-prvs: 00462943DE
x-forefront-antispam-report: SFV:NSPM; SFS:(10019020)(136003)(346002)(376002)(366004)(396003)(39860400002)(15374003)(51914003)(13464003)(54164003)(199004)(189003)(68736007)(2906002)(61296003)(84392002)(50226002)(3846002)(6116002)(5660300002)(81156014)(81166006)(8676002)(8936002)(30864003)(316002)(25786009)(81686011)(76176011)(81816011)(4720700003)(86152003)(99286004)(6436002)(53546011)(52116002)(102836004)(26005)(186003)(6506007)(386003)(54906003)(4326008)(110136005)(305945005)(229853002)(6486002)(44736005)(7736002)(19627235002)(256004)(14444005)(71200400001)(71190400001)(14496001)(446003)(5024004)(486006)(1556002)(9686003)(6512007)(73956011)(66946007)(66476007)(66556008)(64756008)(66446008)(53936002)(478600001)(6246003)(62236002)(44716002)(86362001)(476003)(14454004)(66066001)(74416001)(7726001); DIR:OUT; SFP:1102; SCL:1; SRVR:HE1PR07MB3145;; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; A:0; MX:1;
received-spf: None ( does not designate permitted sender hosts)
x-ms-exchange-senderadcheck: 1
x-microsoft-antispam-message-info: NgHX1YlKAKfz7O1aBlLeova7a1hCP2aSIR8hjvCkfqk7+OmXFiCJFpauPUl2kvOch9520hrF+IVCIUH6SE7ijb3gdcHzvxk0IJvN9CTqeApmlOmoryo61SUbzLYWukwNcHzPNayt5EP/syDWMUFKiSbz8hxhk+7miEbHnAR3lB5TZa1By1dozl6YFQwCs8HqDQbUFgPeJKIXgIwzjZ8xfvJ1++K18uOcpJOOy+H5v9XIcDUKGhQFblRh6Avlg8L9oyOulCGfvC2Km+Lkj+7+cLrXkNYRvp4CzfvFaiY9YSbzIs73MjbNbNW7QfxlOf3gdJZY3XmqzEJHYpWDGINDgKDy6wmwo/qBEfVHUg2M8xd52ZOXkIRAPjXAHq8IruYg/q8/Rrn5bxgI69v8gvabATIqi4VIWkAmwRsqeNcu++w=
Content-Type: text/plain; charset="utf-8"
Content-ID: <>
Content-Transfer-Encoding: base64
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-Network-Message-Id: 10cc9ea0-b3f4-4e25-abe3-08d6df54f843
X-MS-Exchange-CrossTenant-originalarrivaltime: 23 May 2019 08:02:16.2930 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: cf8853ed-96e5-465b-9185-806bfe185e30
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-Transport-CrossTenantHeadersStamped: HE1PR07MB3145
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: Thu, 23 May 2019 08:02:26 -0000

----- Original Message -----
From: "Andrew G. Malis" <>;
Sent: Tuesday, May 21, 2019 7:13 PM


A good suggestion, but it might be easier for IANA to just have two
subsections in the IANA Considerations section:

- What IANA Now Needs to Do (this could be nothing, but should be

- What IANA Already Did in RFC XXXX

and keep this section identical to the original RFC.

Of course, we should ask Michelle what she would like to see! :-)



The purpose of an RFC is to provide information for the community so my
starting point is what is it that the community wants to see.  Once that
is determined, then then is the time to ask Michele and company what
they want to see to ensure that the section meets those requirements.

I make frequent reference to the IANA Considerations section of RFC
going back decades, because they constrain what can and cannot be done
now, and it is a pain when the information is scattered across multiple
RFC, or when the key RFC is badly worded, ambiguous.  Examples of  the
latter keep cropping up.

So, I would say that an IANA Considerations should be complete and
should never say this is what we did last time and here is a delta for
you to (mis-)apply.

A minor example of this is RFC7950 which many cite in the IANA
Considerations of an I-D containing a YANG module in order that the YANG
modules is registered with IANA.  Wrong!  All that RFC7950 says is that
the procedure is described in RFC6020 so you have to get out RFC6020 to
know what to do and the sort-of-obsolete RFC6020 then has to be a
Normative Reference of the new I-D.  Far better if the authors of
RFC7950 had included the procedure for registering a YANG module;
instead, RFC6020 remains a Normative Reference unless and until a YANG
1.2 or YANG 2.0 appears and addresses the problem.

Tom Petch.


On Tue, May 21, 2019 at 1:51 PM David Noveck <>;

> Good point.
> The IANA Considerations section in non-update RFC's primarily serves
as a
> means if requesting IANA actions.  When you consider how this maps to
> documents and bis-like updates, there is a conflict between IANA's
> expectations and Adam's desire to have the updated document be current
as a
> whole, with discussion of changes put in an appendix,  It might be
> to point out the actions required in the appendix but I have been
> of the following as an alternative:
>    - Create, at the start of the IANA Considerations section, a new
>    subsection entitled "What IANA now needs to do".
>    - For the rest of the section, organize as it would be with updates
>    included in appropriate places, but distinguish, using
>    between things that IANA has already done and those that it has yet
to do.
> On Tue, May 21, 2019 at 10:03 AM Michelle Cotton
> wrote:
>> Additional comments related to IANA Considerations for bis documents:
>> What is most important is that the document clearly states what
should be
>> updated and what should not.  We have seen varying instructions in
>> documents where some replace all references and some replace just
some.  If
>> authors can give clear and accurate instructions on what IANA is
>> requested to do, that is appreciated.
>> Hope this is helpful.
>> Thanks,
>> Michelle
>> *From: *ietf <>; on behalf of Adam Roach <
>> *Date: *Sunday, May 19, 2019 at 2:00 PM
>> *To: *David Noveck <>;, Magnus Westerlund <
>> *Cc: *Julian Reschke <>;, Carsten Bormann <
>>>;, IETF Discussion Mailing List <>;
>> *Subject: *[Ext] Re: [rfc-i] Evolving document sources over a long
>> (Re: Comments on draft-roach-bis-documents-00)
>> Thanks for the feedback! These seem like reasonable changes for the
>> version.
>> /a
>> On 5/19/19 9:54 AM, David Noveck wrote:
>> Thanks to everyone for their suggestions.   Now that I've followed up
>> many of them, I'd like to tell everybody what I've found so that
people can
>> consider the implicationss for Adam's document and for the processing
>> upcoming updates to RFC5661.   In particular, use of the existing v1
>> has proved quite helpful although it is not a panacea.
>> So what I've found is that:
>>    - Even with the v1 xml2rfc, the .xml that I have gotten for
>>    from the RFC editor cannot be successfully processed.   Whether
you use the
>>    existing v2 xml2rfc  or the v1 xml2rfc available on the web,
>>    effort is required to get to an xml that can be processed
>>     The xml file I received from the RFC editor is attached as
>>    while the one I arrived at is attached as rfc5661Ready.xml.
>>    - Processing of the best xml that I have been able to arrive at
>>    rfc5661 using the current v2 xml2rfc results in a document which,
>>    compared with rfc5661 using rfcdiff,  has a large number of
>>    which might be considered spurious.  Although I don't feel any of
these are
>>    in fact spurious, they are numerous enough that it might be hard
to make
>>    this determination quickly.  The largest part of these differences
>>    text tables which rfcdiff flags as different even in cases in
which the
>>    tables seem identical.   Also, there re small formtting
differences that
>>    resul from the use of the v2 xml2rfc as well as issues arsing from
>>    different handling policies for hyphenated words.  I've attached
>>    resulting .txt file as rfc5661Ready.txt so that people can rfcdiff
>>    against rfc5661.
>>    - Processing of the best xml that I have been able to arrive at
>>    rfc5661 using the v1 xml2rfc available on the web results in a
>>    which, when compared with rfc5661 using rfcdiff, shows a small
number of
>>    differences but is not identical to rfc5661.   Besides the small
set of
>>    difference mentioned below, common to both v1 and v2 xml2rfc, the
>>    issue concerns a number of cases in which the xml (and rfc5661)
has two
>>    spaces following a period while the v1 xml2rfc has only a single
>>     This is a formatting change but if it is considered "spurious",
then that
>>    spurious change is unavoidable when using the v1 xml2rfc.  It can
>>    avoided using the v2 xml2rfc but that causes many more differences
>>    rfc5661, as discusssed above.   I've attached the resulting .txt
file as
>>    rfc5661ReadyV1.txt so that people can rfcdiff it against rfc5661.
>>    - In addition there are a few differences that appear whether the
>>    or v2 xml2rfc is used.
>>    - One source of these concerrns the capitalization (or not) of the
>>       words "profile" and "type" in the titles of many
>>       sections.  Since RFC5661 uses different forms in the section
itself and in
>>       the table-of-contents, it is impossible to avoid one of those
>>       different from RFC5661.
>>       - Other problems arise from the different lengths of
>>       xml2rfc-generated introductory material before the table of
contents.   The
>>       page count is different for v1 and v2 but both differ from
>>       - References to ancohor are handled differently in v1 and v2
>>       neither can be made to match the results in rfc5661.
>>       - Another problem is that rfcdiff appears to have a bug
>>       in it showing that a significant piece of the definition of
>>       missing, even though the .txt file shows no such difference :-(
>> Based on my experences, I'd like to suggest:
>>    - That the following addition be made to item 3 in section 3.1 of
>>    Adam's document.
>> In evaluating whether such disqualifying changes have occurred, it is
>> intended that changes due solely to changes in the tools used to
>> RFC .txt files be allowed.  In addition, issues resulting from
changes made
>> by the RFC editor but not reflected in the xml file for the RFC not
>> interfere with IESG consideration of the document and can be made, if
>> necessary, by the RFC editor after the revised documment is approved
>> publication.
>>    - That the following addition be made to item 6 in section 3.1 of
>>    Adam's document.
>> This will include the AD's determination that the requirements of
item 3
>> above have been met.
>>    - That, if possible, somebody should fix the bug in rfcdiff noted
>>    above.
>> On Mon, May 13, 2019 at 5:22 AM David Noveck <
>> <>> wrote:
>> >> For RFC5661 and documents derived from it using Adam’s procedure,
>> ship has already sailed :-(..
>> > As the references section needs to be updated anyway (for the
>> I’m not sure this is really true.  Or, if it is,
>> > RFC 5661 maybe isn’t really a candidate for this process, because
>> may be impractical to re-generate the exact
>> > numbering that RFC 5661 used.
>> I had been assuming that you could turn off sortrefs and construct a
>> reference section in the exact order that the
>> v1 tool.   I'll try some experientsto validate that approach.
>> .> > > Since RFC 5661, we also got DOIs on RFCs, so it is inevitable
>> there are a lot of diffs.
>> >>
>> >> It is not inevitable as shown by the fact that I didn't run into
>> issue.   It's kind of nice to know that there was an issue out there
that I
>> didn't run into :-)
>> >>
>> >> For reasons I  really don't understand, the xml for rfc5661 does
>> include rfc reference from external libraries.   It includes them
>> so a new rfc derived from that xml  file will not include DOIs.
>> > Yes.  All these RFC references would be updated by the RFC editor
>> current references.
>> That's not a problem for Adam's procedure :-).   The RFC candidate
>> considred by the IESG would still match
>> rfc5661.   Then, during RFC editing, the reference section could be
>> revised to include the DOI's.
>> >> That is not a problem for Adam's procedure, but it may be for the
>> or the RFC editor.   I hope that, in processing RFC’s using Adam's
>> procedure, people will overlook the lack of DOIs in the same way that
>> overlook other aspects of the document that would prevent a new
document of
>> that form from being published.
>> >AFAICT, they can’t, as the RFC editor has committed to providing
>> Please see above:
>>    - The IESG doesn't have to deal with the DOI diffs, since it won't
>>    see them.
>>    - The RFC editor would create DOI diffs but not be bound by Adam's
>>    procedure in doing so.
>> Where this might be a problem is in document where the existing xml
>> external reference libraries.   That avoids the need for the RFC to
>> anything to provide the DOI's other that updating the libraries.
>> the IESG will see the diffs resulting from the inclusion of DOI's so
>> would hope that Adam's document is clear thar they should not be
>> "spurous".
>> On Sun, May 12, 2019 at 12:57 PM Carsten Bormann <>;
>> Hi Julian,
>> > FWIW, I disagree (but I realize that I'm probably in a minority).
>> > problem with Markdown is that the simple things are easy, but
>> > else gets messy. I'm looking forward to see how you kram (pun
>> > the V3 features into your tool…
>> Do I have to?
>> If an author wants to use a V3 feature that does not lend itself to
>> authoring in markdown, they can always put the XML tags right into
>> markdown source.
>> >>>> but that was the way things were done in 2010.
>> >>>
>> >>> I’m prepared to stick with that, unless there is something better
>> about the alternatives.
>> >>
>> >> Right, for a minor update, digging out the v1 tools and finding a
>> platform where they can still run may actually be the best way to
>> >
>> > All you need is a TCL processor. Works fine over here on a newly
>> > installed notebook with Windows 10 and Cygwin.
>> Haven’t tried that in a while…
>> Works for me, too (macOS 10.13.6, on a small document, with the usual
>> formatting differences from v2…).
>> Good to know.
>> (Although I have heard people have had problems on other platforms
>> recently.)
>> Grüße, Carsten