Re: Things that used to be clear (was Re: Evolving Documents (nee "Living Documents") side meeting at IETF105.)

Michael Richardson <mcr+ietf@sandelman.ca> Fri, 05 July 2019 19:16 UTC

Return-Path: <mcr+ietf@sandelman.ca>
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 6E8F4120193 for <ietf@ietfa.amsl.com>; Fri, 5 Jul 2019 12:16:36 -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_HELO_NONE=0.001, SPF_PASS=-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 18xC10zc9YfR for <ietf@ietfa.amsl.com>; Fri, 5 Jul 2019 12:16:34 -0700 (PDT)
Received: from tuna.sandelman.ca (tuna.sandelman.ca [209.87.249.19]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 61BF6120186 for <ietf@ietf.org>; Fri, 5 Jul 2019 12:16:34 -0700 (PDT)
Received: from sandelman.ca (obiwan.sandelman.ca [209.87.249.21]) by tuna.sandelman.ca (Postfix) with ESMTP id 6CFE938196; Fri, 5 Jul 2019 15:14:36 -0400 (EDT)
Received: from localhost (localhost [IPv6:::1]) by sandelman.ca (Postfix) with ESMTP id 19352B26; Fri, 5 Jul 2019 15:16:33 -0400 (EDT)
From: Michael Richardson <mcr+ietf@sandelman.ca>
To: Ted Lemon <mellon@fugue.com>, Nico Williams <nico@cryptonector.com>, IETF discussion list <ietf@ietf.org>
Subject: Re: Things that used to be clear (was Re: Evolving Documents (nee "Living Documents") side meeting at IETF105.)
In-Reply-To: <129605FD-CA58-4B46-8942-D2BC9E7D6716@fugue.com>
References: <b18809df-ee98-fb29-b6c4-04ed579e163a@network-heretics.com> <20190704052335.GF3508@localhost> <CABcZeBOw6w2tm4YYFdmLwC23ufPDupt2D1Vzwjn4Pi9bbf6R-w@mail.gmail.com> <20190704192057.GI3508@localhost> <CABcZeBMC-VRfea3YqLSs6yhtEq4VtfdO5L56v87KH=vMR4y=+A@mail.gmail.com> <5c9048ef-ba2b-a362-3941-82eacc664b64@mnt.se> <CABcZeBPv8xUMbSt+SDL_X56SBB_CPyBMKZaQMbPd=6M-xT+hpQ@mail.gmail.com> <19233.1562339969@localhost> <20190705163101.GJ3508@localhost> <E49856E1-4DBC-488E-AE15-D48B5357E61D@fugue.com> <20190705172833.GK3508@localhost> <129605FD-CA58-4B46-8942-D2BC9E7D6716@fugue.com>
X-Mailer: MH-E 8.6; nmh 1.7+dev; GNU Emacs 24.5.1
X-Face: $\n1pF)h^`}$H>Hk{L"x@)JS7<%Az}5RyS@k9X%29-lHB$Ti.V>2bi.~ehC0; <'$9xN5Ub# z!G,p`nR&p7Fz@^UXIn156S8.~^@MJ*mMsD7=QFeq%AL4m<nPbLgmtKK-5dC@#:k
MIME-Version: 1.0
Content-Type: multipart/signed; boundary="=-=-="; micalg="pgp-sha256"; protocol="application/pgp-signature"
Date: Fri, 05 Jul 2019 15:16:33 -0400
Message-ID: <9791.1562354193@localhost>
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf/fRsHigGfn65gSpX0-SefudBpQwQ>
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: Fri, 05 Jul 2019 19:16:47 -0000

Ted Lemon <mellon@fugue.com> wrote:
    > A lot of times what stops me is that the document is badly written and
    > difficult to read, and so it’s so much work to read it that I put it
    > off until it’s too late, or give up.  It may be that it’s possible for
    > us to get better at writing understandable and readable documents, and
    > that this would have a greater positive impact on the process than
    > shoulding at directorates.

Me too.
So I wind up trying to do grammar edits while reading the document, and I
really want it to turn into Google-Doc-like github pull requests.

I want to see the review process/software the EKR described last year.
I mean to bug him over beer to see it.
It seems rather involved, but maybe would work for me too. I don't know yet.


--
Michael Richardson <mcr+IETF@sandelman.ca>, Sandelman Software Works
 -= IPv6 IoT consulting =-