Re: Evolving Documents (nee "Living Documents") side meeting at IETF105.

Keith Moore <moore@network-heretics.com> Wed, 03 July 2019 23:21 UTC

Return-Path: <moore@network-heretics.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 5F47612065E for <ietf@ietfa.amsl.com>; Wed, 3 Jul 2019 16:21:32 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.597
X-Spam-Level:
X-Spam-Status: No, score=-2.597 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_LOW=-0.7, SPF_NONE=0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=messagingengine.com
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 yigXYbpJ3u7N for <ietf@ietfa.amsl.com>; Wed, 3 Jul 2019 16:21:29 -0700 (PDT)
Received: from out2-smtp.messagingengine.com (out2-smtp.messagingengine.com [66.111.4.26]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 9C730120483 for <ietf@ietf.org>; Wed, 3 Jul 2019 16:21:29 -0700 (PDT)
Received: from compute6.internal (compute6.nyi.internal [10.202.2.46]) by mailout.nyi.internal (Postfix) with ESMTP id 85123210D8; Wed, 3 Jul 2019 19:21:28 -0400 (EDT)
Received: from mailfrontend1 ([10.202.2.162]) by compute6.internal (MEProxy); Wed, 03 Jul 2019 19:21:28 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to:x-me-proxy :x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s=fm3; bh=J02e7L gHE4kJTQy4hr6ewtGxKmYYy/RUeAQS3ojt3zU=; b=Cx875h1ZQgPpTULV5rIZoV +Sn4/u9E5615PC+maRgPgTz0Bm4JUbnQw1nN8fjbdFS7rp/1EMOt6i4DPlLP6AeD g98MJTCpvVo/lsAObB9StPSuKU44Og0UyIHiJfz0RCUIqjo3Stv8GxGEPQDxREpj HZIfBOyPo4UDwyAOxAhDLRnFmBv9z88xZAbPT6+BR7xJ7+LB6CWzvlyUTT0z1eIL xvadCgCCiRbG9xHOAeJnxzTbTx0jpjGFhVm0LE0PUziojqxcwo6eNJwD92lZxWla Am1MwPiBQQ6EsDf1uPHnhS3opR3ytIV8iqQiaDXeLraM0dLroFjT47QqjcHVZpeg ==
X-ME-Sender: <xms:dzgdXebtlxoRmaRZX4Kqi2KD6eufYGjna5QBrE9wQzPsl2tWG53tIQ>
X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduvddrfedugddvudcutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecunecujfgurhepuffvfhfhkffffgggjggtsegrtderre dtfeejnecuhfhrohhmpefmvghithhhucfoohhorhgvuceomhhoohhrvgesnhgvthifohhr khdqhhgvrhgvthhitghsrdgtohhmqeenucfkphepuddtkedrvddvuddrudektddrudehne curfgrrhgrmhepmhgrihhlfhhrohhmpehmohhorhgvsehnvghtfihorhhkqdhhvghrvght ihgtshdrtghomhenucevlhhushhtvghrufhiiigvpedt
X-ME-Proxy: <xmx:dzgdXdvbH1iXpkRmJkpCi89NgWhjJZCo54jEH7bD96CKXlLON4IGlw> <xmx:dzgdXbtn-ssUjvI3sArWaeQiEocPqEharph8k8vtlxEk-MX5DE3nsQ> <xmx:dzgdXSfMx3XAIxembC_ZrNq06WLWo75xPGv0zpw3u_tXCa3NbfP4gA> <xmx:eDgdXTUWPKCcNe_dX9p_XitqnRoR0Y0DoXGnJclPmMRIP178ar4XTQ>
Received: from [192.168.1.66] (108-221-180-15.lightspeed.knvltn.sbcglobal.net [108.221.180.15]) by mail.messagingengine.com (Postfix) with ESMTPA id 6870480059; Wed, 3 Jul 2019 19:21:27 -0400 (EDT)
Subject: Re: Evolving Documents (nee "Living Documents") side meeting at IETF105.
To: ietf@ietf.org
References: <CAHw9_iKv7xDY-rT98F_BAEvGOGbWGL7UpXS42rSVLsHB+=SOZg@mail.gmail.com> <4567879e-aa29-aeae-72e9-33d148d30eed@network-heretics.com> <CAL02cgToQWmOrfOxS_dc4KRtT9e0PXNzmhWZHkRUyV_3V=E-mQ@mail.gmail.com> <0856af71-4d84-09d1-834d-12ac7252420c@network-heretics.com> <CAL02cgQ9qWVUTPW=Cpx=r32k3i1PLgfp5ax0pKMdH0nKObcKTg@mail.gmail.com> <e8d28a7f-128d-e8d0-17d3-146c6ff5b546@joelhalpern.com> <CAHw9_i+UBs85P+gjcF6BJd1_WD2qFrrYCnXb4rtcG9Hepqm37w@mail.gmail.com>
From: Keith Moore <moore@network-heretics.com>
Message-ID: <796c1f6c-cd67-2cd5-9a98-9059a0e516f8@network-heretics.com>
Date: Wed, 03 Jul 2019 19:21:26 -0400
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Thunderbird/60.7.1
MIME-Version: 1.0
In-Reply-To: <CAHw9_i+UBs85P+gjcF6BJd1_WD2qFrrYCnXb4rtcG9Hepqm37w@mail.gmail.com>
Content-Type: multipart/alternative; boundary="------------9CCEFC49D323A863B5C84F67"
Content-Language: en-US
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf/_TSf8LOxI6LKd-nMQ1_GyfL5_U0>
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: Wed, 03 Jul 2019 23:21:37 -0000

On 7/3/19 6:18 PM, Warren Kumari wrote:
>
>
> On Wed, Jul 3, 2019 at 1:34 PM Joel M. Halpern <jmh@joelhalpern.com 
> <mailto:jmh@joelhalpern.com>> wrote:
>
>     Let me phrase it differently, with a similar point to Keith's
>
>     An IETF working group can say "we think this has the right
>     content, but
>     we are not yet handing it to the AD because ..."
>     That is a form of stability
>     It is NOT a promise not to change the content before RFC publication.
>     As an example, I as co-chair thought the NSH spec was very stable,
>     and
>     then a technical issue was raised that required an incompatible
>     change.
>     It was still a working group document.  We made the change.
>
>
> Exactly.

Sure, that happens.  But we really don't want the public to think that 
the document is stable until it really is.

This is a longstanding problem in IETF - people implement things before 
they're ready, and this leads to incompatibilities and other operational 
difficulties.    It used to be clear that you didn't deploy 
implementations based on Proposed Standard, but people did anyway.   
IESG tried to keep up the quality by imposing more careful scrutiny, and 
people pushed back on that.  Now people want to justify deploying 
implementations based on Internet-Drafts.   Well, it's hard to stop them 
from doing so, but it certainly doesn't serve IETF's goal of promoting 
interoperability.

>
>
>     Further, a working group can not label a draft in a way that suggests
>     that there is IETF consensus in support of the document. That is not
>     its purview.  And is believe the implication that Keith is
>     concerned about.
>
>
> Yes, it is in no way appropriate to claim / imply that the document 
> has IETF consensus, any more than it is appropriate to claim that an 
> ID does. If this idea were to go ahead, we could adapt it to have 
> (more prominent, with asterisks and similar!) boilerplate to clarify 
> that this is only what the WG currently thinks, and isn’t an IETF 
> consensus, or an rfc or anything else...

Just to play devil's advocate (see, I can see multiple sides of a 
situation): if I intend to implement a WG's proposal, I would really 
like to have an idea when I could start implementing (NOT deploying) 
with some confidence that an implementation of the final version would 
be at worst a small change from an implementation of the current 
version.   What I'd like to avoid is implementing a proposal only to 
have to rip it up and start over later because some significant changes 
were agreed to.   But I'm not sure how a WG can know when it's at that 
point, especially in the absence of significant review from the wider 
community.   WGs work too much in silos as it is.

I think this is a fundamental problem with our process - we should be 
able to get increasing /community-wide/ confidence in a proposal as it 
matures, and right now we're just not set up to do that.

>
>     PS: I am not sure what the general benefit of marking an I-D as
>     'stable"
>     would be. 
>
>
> Primary, if you are external to the IETF, and want to get a “snapshot” 
> of what the WG has agreed to on a draft.

In practice, the WG doesn't come to agreement until its own Last Call.   
But the status of a draft is already available on the tracker page.   
IMO the LAST thing we need is to convey misleading impressions to those 
external to the IETF, and the potential for misinterpretation and 
deliberate misleading would be huge if such an indication were provided 
in the document ID.

> As an example, I was recently working on a draft where people started 
> implementing bits which were still very much under discussion - this 
> hurt the draft because it made it hard to change. I made some proposed 
> edits to this section anyway to get WG feedback... and implementers 
> suddenly changed to this...
> After a few rounds of “hey, we are changing this again” implementers 
> got annoyed, the WG got annoyed, and I got annoyed.

Well, sure, but was there any way to know "this version is finally 
stable" at the time that it happened?   I have often thought I had a 
document that was ready to pass Last Call only to find out otherwise.

> I would have liked to be able to easily signal “if you want to 
> implement, this version is mostly sane. It’s obviously still subject 
> to change, but at least more than the authors think it’s reasonable.” 
> versus “this version has many bits which we don’t have WG agreement 
> on: we put them in so they can be reviewed. Please wait till we agree 
> that it isn’t filled with craziness before implementing, etc.”

Fine.  Put that in the Abstract and/or the Introduction.   Don't try to 
formally codify it.

Keith