Re: [tao-discuss] [Gendispatch] Requests for IETF 114
Jay Daley <exec-director@ietf.org> Tue, 07 June 2022 11:04 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 E3D97C14792F; Tue, 7 Jun 2022 04:04:19 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.905
X-Spam-Level:
X-Spam-Status: No, score=-1.905 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_BLOCKED=0.001, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01, URIBL_BLOCKED=0.001, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] 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 My-yq_Nt3_WN; Tue, 7 Jun 2022 04:04:19 -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 4CB29C14CF13; Tue, 7 Jun 2022 04:04:19 -0700 (PDT)
Received: from localhost (localhost [127.0.0.1]) by ietfx.amsl.com (Postfix) with ESMTP id 11F1040A55B9; Tue, 7 Jun 2022 04:04:19 -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 y7Ai6gwQFiaQ; Tue, 7 Jun 2022 04:04:18 -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 DD76040A55B5; Tue, 7 Jun 2022 04:04:17 -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.100.31\))
Date: Tue, 07 Jun 2022 12:04:15 +0100
References: <CAC9wnY-03+ToGL4KjjRaXBquxV2DeBaax67bxJB9qZEj=PSELg@mail.gmail.com> <5C314F03-0C3D-4E1C-9AFE-BBCE8F775D8F@brianrosen.net> <7712AEA2-DDB3-4915-A060-9F3CACA9435E@akamai.com> <EB02214C-8DCC-41C1-A266-08A042AE6318@brianrosen.net> <48a0df92-497a-6747-a8e6-ba93abc7f3d8@joelhalpern.com> <1A1A07E4-A8A9-4D44-AC61-8CAE9B4D6DAC@akamai.com> <68405df2-2808-8739-9c7f-4fc04744f594@joelhalpern.com> <A68A6825-685F-40D6-8978-E853A62A5631@akamai.com> <e321e11e-a70f-e50c-c014-0891708c867a@joelhalpern.com> <145A06D8-7927-44C1-95B6-625529C91DDD@akamai.com> <CABcZeBMH32C2ogd8+hLt_6PEqVxSJV0tBAVygswLtSKhvpVs+Q@mail.gmail.com> <9a29ffe1-c78e-77ad-86ce-661265e5d2df@joelhalpern.com> <A9BAD84B-9228-494B-A988-8665768061B0@akamai.com> <340d6b2a-6cd2-ccdd-6d0b-a2a9ac44e7d8@gmail.com> <CABcZeBN_ATZbA+txPFH3F6OyTpn1WEZ3kC1hBvcvHoShFNibSw@mail.gmail.com> <CAChr6Sw8aMA68Pp5UJ2VDtFzsZ+WDJ2yOXFNgi=1qrEL4FtFMQ@mail.gmail.com> <CAHw9_iKOAkj1TAZ0fvDKi_x1gNs7jPBgt--_ZR99NLc-tUXOUw@mail.gmail.com> <90f43001-461a-5eff-ccb5-59ac70ec71df@gmail.com> <CA77A52B-370B-4366-828E-0C57E6234259@akamai.com>
To: Brian E Carpenter <brian.e.carpenter@gmail.com>, Warren Kumari <warren@kumari.net>, Rob Sayre <sayrer@gmail.com>, Eric Rescorla <ekr@rtfm.com>, GENDISPATCH List <gendispatch@ietf.org>, "tao-discuss@ietf.org" <tao-discuss@ietf.org>
In-Reply-To: <CA77A52B-370B-4366-828E-0C57E6234259@akamai.com>
Message-Id: <E095FA37-6C80-4014-865F-D09B9D784D3D@ietf.org>
X-Mailer: Apple Mail (2.3696.100.31)
Archived-At: <https://mailarchive.ietf.org/arch/msg/tao-discuss/sS6i2UmYkw0_nKVUIJzPsR7V2D8>
Subject: Re: [tao-discuss] [Gendispatch] Requests for IETF 114
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: Tue, 07 Jun 2022 11:04:20 -0000
I hope you will all forgive the liberty but I’m going to repost a slightly edited version of a message I sent to tao-discuss in April [1]. I’ve left off the bit about how content is reviewed by the community which, while relevant, is second order to this discussion: # Structure of our content We have a huge volume of content, written by many dedicated people over many years and there are a lot of positives in that: - lots of people voluntarily put huge effort into writing documentation - people keep an impressive array of knowledge in working memory that they can use both to author and review - people really care and are trying hard to provide people with useful info - great level of detail However, much of our content is written for "IETF participants" in the broadest sense, rather than more targeted at specific roles or tasks and that creates a range of issues. In other words, our content often seems to assume that all participants are going to speak in WGs, author drafts, be a scribe, ask questions at the plenary, etc, etc. The issues are: - our content often tries to cover everything that someone might possibly need to know, ever, - we say the same/similar thing in multiple places, which in turn makes it hard for people to find everything they need in one place - reading and understanding our content is overwhelming, there’s rarely an easy way in - leads to duplication as each of the locations tries to cover enough to be useful - when things change the incorrect text has to be tracked down in multiple places, which it rarely is and so stale content abounds What we need, and what Greg is working on with emodir, is a participant journey - a set of roles that participants take that we can flesh out and target our content at. To be clear, I don’t mean the difference between beginner and expert, those can still be interpreted as "need to know everything" just at different levels of detail. Instead I mean "roles" such as: mailing list lurker, in-person participant, author, wg chair, etc. The new authors.ietf.org and chairs.ietf.org follow that principle - they aggregate all the information for one specific role into one place. Those are not finished by any means, we don’t have a formal review team in place, there’s lots of old content around, we don’t have enough stratified content for beginners to experts, but they are getting there. # Our style of writing Most of our content, whoever the author, is written in a friendly open style. Authors have made a great effort to be clear and to be inclusive. However, despite that, there are two bad habits that fly underneath the radar. The first is to be defensive - must do this, don’t do this, avoid that, watch out for this, and so on. It’s as if successful participation in the IETF is predicated on learning all the rules not to break and the specific processes that must be followed to the letter. The second is to believe that IETF memes or in-jokes have the same (or any) meaning outside the IETF as they do within. The "many fine lunches" example captures that perfectly - a completely meaningless phrase unless you’ve been part of the IETF for at least 10? years. # Relating this all to the Tao For me, the Tao incorporates both the best snd the worst of the above. The effort and dedication that has gone into it are deeply admirable, the breadth of content is excellent and the tone is very friendly. The problems I have with it though are not minor. The name itself, ’Tao’, is a reference too far. Sure some of use have read "The Tao of Pooh" and get the allusion but for most people, it goes straight over their heads More importantly though, I sincerely doubt that it is of any practical use to its intended audience - it’s far too sprawling, detailed and full of rules to be of use to a newcomer. To be quite candid, every time someone recommends to a newcomer that they read the Tao, I cringe. What it does do is provide a useful reference for long-term participants (where else are the dot colours documented) but that’s not the intended audience. It’s become more a series of authoritative statements that can be referenced/found individually than a flowing document. While I admire the effort that has gone into the Tao, I think we need to move on from this style of documentation. Replacing it with several smaller documents/sites/pages would be much more useful: "Guide to the role and structure of the IETF", "Guide to participating in IETF working groups", "Guide to making the most of IETF meetings", and so on. Jay [1] https://mailarchive.ietf.org/arch/msg/tao-discuss/H3EPqJTO1V7OJL3f4_UtBo8IhbM/ > On 7 Jun 2022, at 00:32, Salz, Rich <rsalz=40akamai.com@dmarc.ietf.org> wrote: > >> As it happens, I drafted the original version of that page in 2013, and I > believe this text has survived pretty much unchanged: > >> "The Tao of the IETF is a must read document. If you read nothing else, read this." > >> The basic question here, where there appears to be genuine disagreement, is whether we want that statement to remain true. > > That's a pretty good summary of the disagreement. But "if you read nothing else" -- does watching video's count? > >> Personally, I think it's good to have a single document for this material, and that it should be printable. > > I'd like to know why it is important for someone new to the IETF to know that the first meeting was at a company that no longer exists. > > As for printable: this is not the Internet of 30 years ago. Video is commonplace. What is missing from this playlist: https://www.youtube.com/playlist?list=PLC86T-6ZTP5hFWNekiZYEYwEqVWB-cwfr which runs a total of 20 minutes? > > > > _______________________________________________ > tao-discuss mailing list > tao-discuss@ietf.org > https://www.ietf.org/mailman/listinfo/tao-discuss > -- Jay Daley IETF Executive Director exec-director@ietf.org
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Bob Hinden
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Lars Eggert
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Lars Eggert
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Salz, Rich
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Brian Rosen
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Salz, Rich
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Brian Rosen
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Joel Halpern
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Salz, Rich
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Salz, Rich
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Brian Rosen
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Bob Hinden
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Salz, Rich
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Joel Halpern
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Joel Halpern
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Salz, Rich
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Joel Halpern
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Salz, Rich
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Salz, Rich
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Eric Rescorla
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Joel Halpern
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Salz, Rich
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Joel Halpern
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Brian E Carpenter
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Eric Rescorla
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Rob Sayre
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Warren Kumari
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Salz, Rich
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Warren Kumari
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Rob Sayre
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Salz, Rich
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Brian E Carpenter
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Salz, Rich
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Jay Daley
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Niels ten Oever
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Warren Kumari
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Brian E Carpenter
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Salz, Rich
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Brian E Carpenter
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Rob Sayre
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Mark Nottingham
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Tony Rutkowski
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Salz, Rich
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Brian E Carpenter
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Salz, Rich
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Brian E Carpenter
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Salz, Rich
- Re: [tao-discuss] [Gendispatch] Requests for IETF… Lloyd W