[tao-discuss] Progress on my suggested rewrite

Jay Daley <exec-director@ietf.org> Thu, 13 October 2022 11:17 UTC

Return-Path: <exec-director@ietf.org>
X-Original-To: tao-discuss@ietfa.amsl.com
Delivered-To: tao-discuss@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 0BFEFC14CE3F for <tao-discuss@ietfa.amsl.com>; Thu, 13 Oct 2022 04:17:02 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.91
X-Spam-Level:
X-Spam-Status: No, score=-1.91 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01] autolearn=ham autolearn_force=no
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 1b0DW4M2nR_z for <tao-discuss@ietfa.amsl.com>; Thu, 13 Oct 2022 04:17:01 -0700 (PDT)
Received: from ietfx.amsl.com (ietfx.amsl.com [50.223.129.196]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 83AA6C14CF11 for <tao-discuss@ietf.org>; Thu, 13 Oct 2022 04:17:01 -0700 (PDT)
Received: from localhost (localhost [127.0.0.1]) by ietfx.amsl.com (Postfix) with ESMTP id 72D7E408B836 for <tao-discuss@ietf.org>; Thu, 13 Oct 2022 04:17:01 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
Received: from ietfx.amsl.com ([50.223.129.196]) by localhost (ietfx.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id inuuwO0Tt_Nj for <tao-discuss@ietf.org>; Thu, 13 Oct 2022 04:17:01 -0700 (PDT)
Received: from smtpclient.apple (host-92-27-125-209.static.as13285.net [92.27.125.209]) by ietfx.amsl.com (Postfix) with ESMTPSA id 08F5A406551F for <tao-discuss@ietf.org>; Thu, 13 Oct 2022 04:17:00 -0700 (PDT)
From: Jay Daley <exec-director@ietf.org>
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: quoted-printable
Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3696.120.41.1.1\))
Message-Id: <5FEE89C8-CD42-445D-B747-078EA6CA2561@ietf.org>
Date: Thu, 13 Oct 2022 12:16:58 +0100
To: tao-discuss@ietf.org
X-Mailer: Apple Mail (2.3696.120.41.1.1)
Archived-At: <https://mailarchive.ietf.org/arch/msg/tao-discuss/GUKW5-S2-TGT6od0D9r-kFv97nA>
Subject: [tao-discuss] Progress on my suggested rewrite
X-BeenThere: tao-discuss@ietf.org
X-Mailman-Version: 2.1.39
Precedence: list
List-Id: Discussion of the Tao of the IETF <tao-discuss.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tao-discuss>, <mailto:tao-discuss-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tao-discuss/>
List-Post: <mailto:tao-discuss@ietf.org>
List-Help: <mailto:tao-discuss-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tao-discuss>, <mailto:tao-discuss-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 13 Oct 2022 11:17:02 -0000

As I mentioned in a previous message, I would like to see the Tao rewritten as a set of smaller documents that can be assembled into one when required.  Those documents would be something like:

- Introduction to the IETF
- How the IETF Works
- Participating in IETF Meetings
- Structure and Governance of the IETF
- Culture and Folklore of the IETF

I’ve now produced drafts of two of these: 

1. Introduction to the IETF  (shared before.)
	https://github.com/JayDaley/tao/blob/main/Introduction%20to%20the%20IETF.md

2. Participating in IETF Meetings (new)
	https://github.com/JayDaley/tao/blob/main/Participating%20in%20IETF%20Meetings.md

In this second document, there are too many changes from section 3 of the Tao to list them all but they include:

* different structure
* moving new participant info into a single block
* added details of several agenda elements that were not covered
* added details of onsite facilities that were not covered
* removed out-of-date stuff such as corkboards, jabber, etc
* added missing colour to the dots
* trimmed the existing text to remove repetition and "remarks I find offputting" (I have no better way to explain it but see https://github.com/ietf/tao/issues/57 for an example).

My intent is to produce text that is friendlier, easier to learn from, more up to date and with a better signal/noise ratio.  I would love to hear if you think I’ve achieved that.

cheers
Jay

-- 
Jay Daley
IETF Executive Director
exec-director@ietf.org