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

john heasley <heas@shrubbery.net> Wed, 03 July 2019 23:54 UTC

Return-Path: <heas@shrubbery.net>
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 B91C31206E8 for <ietf@ietfa.amsl.com>; Wed, 3 Jul 2019 16:54:28 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.2
X-Spam-Level:
X-Spam-Status: No, score=-4.2 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_MED=-2.3, SPF_PASS=-0.001, URIBL_BLOCKED=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 XvvNJFFIZOPk for <ietf@ietfa.amsl.com>; Wed, 3 Jul 2019 16:54:25 -0700 (PDT)
Received: from guelah.shrubbery.net (guelah.shrubbery.net [198.58.5.1]) by ietfa.amsl.com (Postfix) with ESMTP id 9B9F0120697 for <ietf@ietf.org>; Wed, 3 Jul 2019 16:54:25 -0700 (PDT)
Received: by guelah.shrubbery.net (Postfix, from userid 7053) id 332BE1A3FD9; Wed, 3 Jul 2019 23:54:25 +0000 (UTC)
Date: Wed, 03 Jul 2019 23:54:25 +0000
From: john heasley <heas@shrubbery.net>
To: Warren Kumari <warren@kumari.net>
Cc: IETF Discuss <ietf@ietf.org>
Subject: Re: Evolving Documents (nee "Living Documents") side meeting at IETF105.
Message-ID: <20190703235425.GA84573@shrubbery.net>
References: <CAHw9_iKv7xDY-rT98F_BAEvGOGbWGL7UpXS42rSVLsHB+=SOZg@mail.gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <CAHw9_iKv7xDY-rT98F_BAEvGOGbWGL7UpXS42rSVLsHB+=SOZg@mail.gmail.com>
X-PGPkey: http://www.shrubbery.net/~heas/public-key.asc
X-note: live free, or die!
X-homer: i just want to have a beer while i am caring.
X-Claimation: an engineer needs a manager like a fish needs a bicycle
X-reality: only YOU can put an end to the embarrassment that is Tom Cruise
User-Agent: Mutt/1.11.4 (2019-03-13)
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf/0O9Jj3L__jtawOKjgpdOUhXy39Y>
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:54:31 -0000

Wed, Jul 03, 2019 at 01:04:56PM -0700, Warren Kumari:
> “Evolving” documents (there were originally called “Living documents”,
> but that name is already in use in the web community, and so we chose
> another name to make it less confusing).
> “State of Play” documents.

I wish that you would not create new terminology if it is the same idea.
It decreases accessibility, IMO.  Instead label it with IETF; "IETF
Evergreen Document", which seemed the most common term for this when I
looked a few weeks ago, or "IETF Evolving Document".  I do not understand
why it is relevant or how some other group's use of it creates baggage
for IETF.  Seems wholly a NiH problem.  Decide for yourself what the
most common term is and use that.

BTW, I read a page that seemed to suggest that the Canadian Gov't uses
all three terms.

> There are a number of topics / drafts where the best current practice
> changes over time - a simple example of this is something like routing
> security, and so I’ll use it as an example (also, the concept was
> first presented in GROW!), but the concept is applicable to all sorts
> of cases.
> 
> The best practices for routing security (what / how to filter,
> route-leak prevention, etc) change over time and it is not really
> feasible to document how to e.g build route filters and then release
> -bis documents quickly enough to keep up with how the operational
> advice changes; this means that much of this sort of information
> doesn’t get documented in the IETF, and instead is scattered around in
> institutional knowledge, personal blogs, IRC channels, etc.

This I'd like to see - a stable document name (URL) that documents an
ever evolving technology.  For example, RFC 7525 (TLS Recommendations)
attempts to document TLS standads; protocol revisions, cipher suites,
etc.  Tremendously useful RFC for developers and users, that seems already
out of date and probably was shortly after publication.

It would be useful to have a document like RFC7525 that could evolve
with TLS, but more nimbly than an RFC.  One that an RFC of another
discipline could reference, and follow the evolution without itself
needing updating.  The evolution needs to be captured in a public SCM,
so that previous versions can be retrieved.

I do not think that I've addressed any of your points, but this is
perhaps another use case.

https://www.w3.org/wiki/Evergreen_Standards

> 9: This ain’t new, $person proposed something similar at $meeting_or_list….
> Indeed. As an example, Phillip Hallam-Baker mentioned a desire for
> something similar at the IETF102 plenary; I think that this

1992: https://datatracker.ietf.org/wg/livdoc/about/