Re: [Tools-discuss] Draft name prefixes

Daniel Kahn Gillmor <dkg@fifthhorseman.net> Thu, 11 April 2019 17:54 UTC

Return-Path: <dkg@fifthhorseman.net>
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 DFC8B1205F8 for <tools-discuss@ietfa.amsl.com>; Thu, 11 Apr 2019 10:54:59 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2
X-Spam-Level:
X-Spam-Status: No, score=-2 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=neutral reason="invalid (unsupported algorithm ed25519-sha256)" header.d=fifthhorseman.net header.b=5lQFB8bH; dkim=pass (2048-bit key) header.d=fifthhorseman.net header.b=lw6YSKLB
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 crrBzSBoUE8z for <tools-discuss@ietfa.amsl.com>; Thu, 11 Apr 2019 10:54:57 -0700 (PDT)
Received: from che.mayfirst.org (che.mayfirst.org [162.247.75.118]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 8B1A5120106 for <tools-discuss@ietf.org>; Thu, 11 Apr 2019 10:54:57 -0700 (PDT)
DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/simple; d=fifthhorseman.net; i=@fifthhorseman.net; q=dns/txt; s=2019; t=1555005296; h=from : to : subject : in-reply-to : references : date : message-id : mime-version : content-type : content-transfer-encoding : from; bh=q0GIi6NC4gfyEDLZNnKENbbya1nE+uSsYKJY3jJUrlU=; b=5lQFB8bHclmAvGqHBjT9IC1nfc19JbsUJ1QLArYSNrIOMF+LlkLx4tp8 QYZy4PEaXPI5gOsdwo6c2nM204ZoAQ==
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=fifthhorseman.net; i=@fifthhorseman.net; q=dns/txt; s=2019rsa; t=1555005296; h=from : to : subject : in-reply-to : references : date : message-id : mime-version : content-type : content-transfer-encoding : from; bh=q0GIi6NC4gfyEDLZNnKENbbya1nE+uSsYKJY3jJUrlU=; b=lw6YSKLBb12CPdbXgS+6icS6G/V0lgaDk8Jq/lSrRGKfTlsGrCS2WTrg fLNkk+K4aHAD19mO7lujZ2A6yA+OPpjVodgCAZiokFKXtym+ARTFg+p1m3 lE5LcrImBuggXCQ4G4c4jAtBaz6wRT7v8RzfZ7bAShMJdeLWd4YlxbQVOV LuAeXeXtg4XKg8zqTdiAbEMWhDe7jTdmA0sfigqUvQn7rvpotmXX77Jppr Rn4Bqg7rjCMUEG3kuvKO8l2ffPl7CJkc0ca/H5URPy4w6NBc4TWWccKaO+ pFxLbpmj3UIbQuSwS+U6shH4uyr/7Yf7oRoqYBHNY0cW+1gqDhtg2Q==
Received: from fifthhorseman.net (unknown [38.109.115.130]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by che.mayfirst.org (Postfix) with ESMTPSA id 0AEFFF99F; Thu, 11 Apr 2019 13:54:55 -0400 (EDT)
Received: by fifthhorseman.net (Postfix, from userid 1000) id 49A3A201AC; Thu, 11 Apr 2019 13:08:39 -0400 (EDT)
From: Daniel Kahn Gillmor <dkg@fifthhorseman.net>
To: Martin Thomson <mt@lowentropy.net>, tools-discuss@ietf.org
In-Reply-To: <dbfc5845-a8be-481a-a242-2a38e29f5622@www.fastmail.com>
References: <AFF936D0-DED8-4922-BAC1-DC44C438EE5A@mnot.net> <dbfc5845-a8be-481a-a242-2a38e29f5622@www.fastmail.com>
Autocrypt: addr=dkg@fifthhorseman.net; prefer-encrypt=mutual; keydata= mDMEXEK/AhYJKwYBBAHaRw8BAQdAr/gSROcn+6m8ijTN0DV9AahoHGafy52RRkhCZVwxhEe0K0Rh bmllbCBLYWhuIEdpbGxtb3IgPGRrZ0BmaWZ0aGhvcnNlbWFuLm5ldD6ImQQTFggAQQIbAQUJA8Jn AAULCQgHAgYVCgkICwIEFgIDAQIeAQIXgBYhBMS8Lds4zOlkhevpwvIGkReQOOXGBQJcQsbzAhkB AAoJEPIGkReQOOXG4fkBAO1joRxqAZY57PjdzGieXLpluk9RkWa3ufkt3YUVEpH/AP9c+pgIxtyW +FwMQRjlqljuj8amdN4zuEqaCy4hhz/1DbgzBFxCv4sWCSsGAQQB2kcPAQEHQERSZxSPmgtdw6nN u7uxY7bzb9TnPrGAOp9kClBLRwGfiPUEGBYIACYWIQTEvC3bOMzpZIXr6cLyBpEXkDjlxgUCXEK/ iwIbAgUJAeEzgACBCRDyBpEXkDjlxnYgBBkWCAAdFiEEyQ5tNiAKG5IqFQnndhgZZSmuX/gFAlxC v4sACgkQdhgZZSmuX/iVWgD/fCU4ONzgy8w8UCHGmrmIZfDvdhg512NIBfx+Mz9ls5kA/Rq97vz4 z48MFuBdCuu0W/fVqVjnY7LN5n+CQJwGC0MIA7QA/RyY7Sz2gFIOcrns0RpoHr+3WI+won3xCD8+ sVXSHZvCAP98HCjDnw/b0lGuCR7coTXKLIM44/LFWgXAdZjm1wjODbg4BFxCv50SCisGAQQBl1UB BQEBB0BG4iXnHX/fs35NWKMWQTQoRI7oiAUt0wJHFFJbomxXbAMBCAeIfgQYFggAJhYhBMS8Lds4 zOlkhevpwvIGkReQOOXGBQJcQr+dAhsMBQkB4TOAAAoJEPIGkReQOOXGe/cBAPlek5d9xzcXUn/D kY6jKmxe26CTws3ZkbK6Aa5Ey/qKAP0VuPQSCRxA7RKfcB/XrEphfUFkraL06Xn/xGwJ+D0hCw==
Date: Thu, 11 Apr 2019 13:08:39 -0400
Message-ID: <87d0lsa2qw.fsf@fifthhorseman.net>
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 8bit
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/ZY-hApXpWX3sQ_sAL1nYjxGM13A>
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: Thu, 11 Apr 2019 17:55:00 -0000

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).

         --dkg