Re: [Tools-discuss] Draft name prefixes

Russ Housley <housley@vigilsec.com> Tue, 16 April 2019 19:07 UTC

Return-Path: <housley@vigilsec.com>
X-Original-To: tools-discuss@ietfa.amsl.com
Delivered-To: tools-discuss@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id DCC651205ED for <tools-discuss@ietfa.amsl.com>; Tue, 16 Apr 2019 12:07:44 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.899
X-Spam-Level:
X-Spam-Status: No, score=-1.899 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_NONE=-0.0001, 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 79xT_pdaH4ZI for <tools-discuss@ietfa.amsl.com>; Tue, 16 Apr 2019 12:07:43 -0700 (PDT)
Received: from mail.smeinc.net (mail.smeinc.net [209.135.209.11]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 6EBBC1205E6 for <tools-discuss@ietf.org>; Tue, 16 Apr 2019 12:07:43 -0700 (PDT)
Received: from localhost (localhost [127.0.0.1]) by mail.smeinc.net (Postfix) with ESMTP id 2CF69300AE6 for <tools-discuss@ietf.org>; Tue, 16 Apr 2019 14:49:25 -0400 (EDT)
X-Virus-Scanned: amavisd-new at mail.smeinc.net
Received: from mail.smeinc.net ([127.0.0.1]) by localhost (mail.smeinc.net [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id xysVDHLU-ngx for <tools-discuss@ietf.org>; Tue, 16 Apr 2019 14:49:23 -0400 (EDT)
Received: from a860b60074bd.fios-router.home (unknown [138.88.156.37]) by mail.smeinc.net (Postfix) with ESMTPSA id 888EC300201; Tue, 16 Apr 2019 14:49:23 -0400 (EDT)
Content-Type: text/plain; charset="utf-8"
Mime-Version: 1.0 (Mac OS X Mail 12.4 \(3445.104.8\))
From: Russ Housley <housley@vigilsec.com>
In-Reply-To: <87d0lsa2qw.fsf@fifthhorseman.net>
Date: Tue, 16 Apr 2019 15:07:40 -0400
Cc: Tools Discussion <tools-discuss@ietf.org>
Content-Transfer-Encoding: quoted-printable
Message-Id: <1A1C8CAD-3DFE-4F2B-B0DA-ADA52F515316@vigilsec.com>
References: <AFF936D0-DED8-4922-BAC1-DC44C438EE5A@mnot.net> <dbfc5845-a8be-481a-a242-2a38e29f5622@www.fastmail.com> <87d0lsa2qw.fsf@fifthhorseman.net>
To: Daniel Kahn Gillmor <dkg@fifthhorseman.net>, Martin Thomson <mt@lowentropy.net>
X-Mailer: Apple Mail (2.3445.104.8)
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/ZIguvt1RtEno3jCLVdV1syRVTYA>
Subject: Re: [Tools-discuss] Draft name prefixes
X-BeenThere: tools-discuss@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: IETF Tools Discussion <tools-discuss.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tools-discuss/>
List-Post: <mailto:tools-discuss@ietf.org>
List-Help: <mailto:tools-discuss-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 16 Apr 2019 19:07:45 -0000


> On Apr 11, 2019, at 1:08 PM, Daniel Kahn Gillmor <dkg@fifthhorseman.net> wrote:
> 
> On Tue 2019-04-09 22:47:45 -0400, Martin Thomson wrote:
>> Maybe with an "If this is your first Internet-Draft submission" around it.
>> 
>> There is a lot of noise on that page.  I wonder if it makes sense to
>> cut that down to the bare essentials.  New submitters don't need to
>> know about the API, for example.  There is an "Instructions" "tab".
> 
> It's almost as if that page was written as though it were an RFC :P It
> appears to think of itself as a reference, not a tutorial or a howto.
> 
> Fwiw, i agree with Martin that taking a vicious editor's knife to that
> and figuring out the most important stuff in a much simpler and shorter
> document would make it more useful to a first-timer audience.  (doesn't
> mean there's no place for a reference, of course).
> 
> I also note that https://www.ietf.org/standards/ids/guidelines/#6 says:
> 
>    It is strongly recommended that the draft include a notice (with
>    email address) of where comments should be sent. For example:
> 
>    "Comments are solicited and should be addressed to the working
>    group's mailing list at ___@______ and/or the author(s)."
> 
> And yet, it's not clear how to send edits to this 9-year-old document
> itself (it could use at least some http→https fixes in 2019).

The Tools Team might be able to offer some improvements to the web page, but the id-guideline belong to the IESG.  The Tools Team cannot take any actions there.

Russ