New document shepherd writeup

Lars Eggert <lars@eggert.org> Tue, 03 May 2022 10:04 UTC

Return-Path: <lars@eggert.org>
X-Original-To: wgchairs@ietfa.amsl.com
Delivered-To: wgchairs@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 91CE6C159485; Tue, 3 May 2022 03:04:15 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.099
X-Spam-Level:
X-Spam-Status: No, score=-2.099 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=eggert.org
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 VYqIvodjAQSX; Tue, 3 May 2022 03:04:11 -0700 (PDT)
Received: from mail.eggert.org (mail.eggert.org [91.190.195.94]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 5E659C157B4A; Tue, 3 May 2022 03:04:11 -0700 (PDT)
Received: from smtpclient.apple (unknown [IPv6:2a00:ac00:4000:400:20e4:bed2:5053:c1c2]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.eggert.org (Postfix) with ESMTPSA id D8AE81DA589; Tue, 3 May 2022 13:04:02 +0300 (EEST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=eggert.org; s=dkim; t=1651572242; bh=SU//8Sobb6sxz4RduURVhwwBO0DdO8NI8e0RsZHGfyA=; h=From:Subject:Date:Cc:To; b=OeWo1KGrTLX13YVwSxGKVwBUgvc3FgipMotiVqbK/i8XqS5+QNG66g06Tt4g3gO/r 8XKaJeET0HReqciDLeKphGVbphRnEU8KRdK2ZJBUHg8fqK00elA4P2rJfNyoTgeB7c +pWXWaEiS+iioYRc79JQ3vP2y8R2bYovv6KEKhYQ=
From: Lars Eggert <lars@eggert.org>
Content-Type: multipart/signed; boundary="Apple-Mail=_B54AEF47-FB68-4E34-871B-873E6A437E6F"; protocol="application/pgp-signature"; micalg="pgp-sha512"
Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3696.80.82.1.1\))
Subject: New document shepherd writeup
Message-Id: <F4A44FCE-D31B-4FE8-9950-6C60CDD9DD36@eggert.org>
Date: Tue, 03 May 2022 13:04:02 +0300
To: IETF WG Chairs <wgchairs@ietf.org>
X-MailScanner-ID: D8AE81DA589.A42E7
X-MailScanner: Not scanned: please contact your Internet E-Mail Service Provider for details
X-MailScanner-From: lars@eggert.org
Archived-At: <https://mailarchive.ietf.org/arch/msg/wgchairs/xVrkyBmlmL8kuZ07Ac_s0U8mLPM>
X-BeenThere: wgchairs@ietf.org
X-Mailman-Version: 2.1.34
Precedence: list
List-Id: Working Group Chairs <wgchairs.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/wgchairs>, <mailto:wgchairs-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/wgchairs/>
List-Post: <mailto:wgchairs@ietf.org>
List-Help: <mailto:wgchairs-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/wgchairs>, <mailto:wgchairs-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 03 May 2022 10:04:15 -0000

Hi,

the IESG has recently made some changes to the document shepherd writeup template. The new template is at https://chairs.ietf.org/documents/qa-style-writeup-template (*) and will also be offered by the datatracker when a writeup is started there.

The main differences are that we're now using a single template for both WG and non-WG documents, which will make maintenance easier. We've also eliminated the option of the "essay-style" free-form writeup, because we found that those often did not cover all the points we'd like to see covered.

Please feel free to email the IESG with any questions or comments!

Thanks,
Lars

(*) There are currently some formatting issues on the wiki, but the content of the template is accurate.