Re: is there a specific proposal for living ops docs?

Miles Fidelman <mfidelman@meetinghouse.net> Sat, 20 July 2019 20:54 UTC

Return-Path: <mfidelman@meetinghouse.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 5C26312019D for <ietf@ietfa.amsl.com>; Sat, 20 Jul 2019 13:54:10 -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, RCVD_IN_DNSWL_NONE=-0.0001, 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 ls9y9LI1WjOS for <ietf@ietfa.amsl.com>; Sat, 20 Jul 2019 13:54:08 -0700 (PDT)
Received: from server1.neighborhoods.net (server1.neighborhoods.net [207.154.13.48]) by ietfa.amsl.com (Postfix) with ESMTP id D099912006B for <ietf@ietf.org>; Sat, 20 Jul 2019 13:54:08 -0700 (PDT)
Received: from localhost (localhost.localdomain [127.0.0.1]) by server1.neighborhoods.net (Postfix) with ESMTP id ABEF34F8150 for <ietf@ietf.org>; Sat, 20 Jul 2019 16:54:03 -0400 (EDT)
X-Virus-Scanned: by amavisd-new-2.6.2 (20081215) (Debian) at neighborhoods.net
Received: from server1.neighborhoods.net ([127.0.0.1]) by localhost (server1.neighborhoods.net [127.0.0.1]) (amavisd-new, port 10024) with LMTP id GTJjJbKto8YZ for <ietf@ietf.org>; Sat, 20 Jul 2019 16:54:02 -0400 (EDT)
Received: from Miless-MBP.fios-router.home (pool-96-237-100-57.bstnma.fios.verizon.net [96.237.100.57]) by server1.neighborhoods.net (Postfix) with ESMTPSA id 2B0644F814F for <ietf@ietf.org>; Sat, 20 Jul 2019 16:54:02 -0400 (EDT)
Subject: Re: is there a specific proposal for living ops docs?
To: ietf@ietf.org
References: <F2D5DCCF-4051-444B-9522-9E11F9F93005@fugue.com> <869599E9-7571-4677-AB9A-961027549C54@network-heretics.com> <144ff436-a7a2-22f7-7b06-4d0b3bcfefac@joelhalpern.com> <20190719041456.GL33367@vurt.meerval.net> <254fc5f6-3576-a62f-b84f-a7c5d29b0055@joelhalpern.com> <a1561aa7-5f41-0e2a-1892-cfb587196ac0@gmail.com> <C3D53639-C2C0-42CE-9708-99294091E012@puck.nether.net> <a17a8648-14c8-1889-4ee3-86996ff6281e@gmail.com> <3B0C189A-D56B-430F-82FF-19DE0DC788DE@puck.nether.net> <BA80E73F53C26B9191294131@JcK-HP5.jck.com> <20190719190534.GG38674@shrubbery.net> <4f43fac6-ed7f-08ca-d5da-1e84b0a7b12b@network-heretics.com> <3a678b4a-1c9e-8a2a-ea02-ac32a07f3711@gmail.com> <CACWOCC8g_YXT9OU6NxuhFGkxuejxux_ykoKfA7i8cmZ73nWjeg@mail.gmail.com> <m2muh8valj.wl-randy@psg.com> <0FE0532C-28AF-47F6-8BED-D5C3E05216D1@puck.nether.net>
From: Miles Fidelman <mfidelman@meetinghouse.net>
Message-ID: <a11e1da0-618e-007e-4e32-ef98be4e8f1d@meetinghouse.net>
Date: Sat, 20 Jul 2019 16:54:01 -0400
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.12; rv:60.0) Gecko/20100101 Thunderbird/60.8.0
MIME-Version: 1.0
In-Reply-To: <0FE0532C-28AF-47F6-8BED-D5C3E05216D1@puck.nether.net>
Content-Type: text/plain; charset="utf-8"; format="flowed"
Content-Transfer-Encoding: 7bit
Content-Language: en-US
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf/nfT0tvOT3KN125WrTx46AS_6670>
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: Sat, 20 Jul 2019 20:54:10 -0000

I've been watching these go by, and I don't believe anyone has mentioned 
the HTML5 Living Standard as a model 
(https://html.spec.whatwg.org/multipage/). It has the advantage of 
working pretty well, over an extended period.

Miles Fidelman

On 7/20/19 2:16 PM, Jared Mauch wrote:
>
>> On Jul 20, 2019, at 2:12 PM, Randy Bush <randy@psg.com> wrote:
>>
>>>> That's exactly why I asked about RIPE's solution. Before proposing
>>>> a solution, don't we want to study one that apparently works?
>>> Works by what metric?
>> worked for us in publishing an op doc which was eventually followed by
>> an rfc
> I think an example of a RFC of this sort is 2182/BCP-16.
>
>>> IETF has take some responsibility for after-care here.
>> for ripe's doc repo?
> Heh :-)
>
> - Jared

-- 
In theory, there is no difference between theory and practice.
In practice, there is.  .... Yogi Berra

Theory is when you know everything but nothing works.
Practice is when everything works but no one knows why.
In our lab, theory and practice are combined:
nothing works and no one knows why.  ... unknown