IETF Logo Mail Archive

Re: Document shepherd writeup formats

Yoav Nir <ynir.ietf@gmail.com> Mon, 25 November 2019 21:39 UTC

Return-Path: <ynir.ietf@gmail.com>
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 8EA67120F97 for <wgchairs@ietfa.amsl.com>; Mon, 25 Nov 2019 13:39:03 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.999
X-Spam-Level:
X-Spam-Status: No, score=-1.999 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.com
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 W05iBaalBXhR for <wgchairs@ietfa.amsl.com>; Mon, 25 Nov 2019 13:39:01 -0800 (PST)
Received: from mail-wr1-x42d.google.com (mail-wr1-x42d.google.com [IPv6:2a00:1450:4864:20::42d]) (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 8E61B120F71 for <wgchairs@ietf.org>; Mon, 25 Nov 2019 13:38:57 -0800 (PST)
Received: by mail-wr1-x42d.google.com with SMTP id t2so19995340wrr.1 for <wgchairs@ietf.org>; Mon, 25 Nov 2019 13:38:57 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:subject:from:in-reply-to:date:cc :content-transfer-encoding:message-id:references:to; bh=gnJAdJxagvCcbfQEqF63NrXx2gca6b09jFjIctky+uM=; b=lBmjkD1trPDwtMc51BFiMMU2CHS3PACUypCHTGBtOVUlrHonSH7Jm4dv5+zHhSCrjq bHwbqFTYkLbCY3qUU5O6DpxZTCoN0nIo0f50wqg94AgttXfNtu+eZXwjNGyPtQJ+Z92P axx3hkZzaJRIA7w2doUnbjX6pmTx5tAwKYAGL+d3KrKvHotkrmRW8MJxyUSZhnmkZMSu 3ZAgL5iS2j90sQmV5cVVwgBXn+mtxVIJd6yU7c+qipndQqPC6qfrdxYmyMnpGe6E9c4O C+lUrc6QN9v40oAkgVkZGZ6HOg7b7zHZBmN8+DzjKue7jgYy1e3ci//BK8igKsavMrvo ljtw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:subject:from:in-reply-to:date:cc :content-transfer-encoding:message-id:references:to; bh=gnJAdJxagvCcbfQEqF63NrXx2gca6b09jFjIctky+uM=; b=oxhWbfwjykCeAnYfUg47ws+s+qPBedarofUEbnSFsw2zb90AFMX5jf9incbvKtZB+T Fcw7ClhU8GhsWBrMPllj7OdRUjFr80s5dMXtuon7qd1dwayVZOcYDhxW2P6aSZQQS8sp Qn5dWNsmJObin7Mk3P9bfBASTbYyxQN7TSutYn5nq3wKWKMsBCZAYYlRLmiQ3Eqk3/dB bJHagTYqvK5oCktVMWTCqWIx8wggHhZR6b2MTfdOYXyUnB7Mq7KQoGHARablk/bBaMn7 JMutTZQhjlJfPrlNsJPJlDI24H0T4pJU0pPOCLVhJnd71M0F+KtwmCVe8Hv2k7sZnDP1 mk4w==
X-Gm-Message-State: APjAAAWwoTmKQg+Qci9bo+idytsbnfWxvblkt4d+6mTpOByc1ITKrTD8 +y7yWBEzAM3vIZ25CbwVPxWX2osi7/c=
X-Google-Smtp-Source: APXvYqwcoBN9+BJ7KCtmY4VLGKT0o36aiGhekz/6MU9vzeHoRAmFZMfSerTjicgUHI6rcWrvpQRl3Q==
X-Received: by 2002:adf:fd4a:: with SMTP id h10mr31887101wrs.90.1574717936087; Mon, 25 Nov 2019 13:38:56 -0800 (PST)
Received: from [192.168.1.12] ([46.120.57.147]) by smtp.gmail.com with ESMTPSA id p9sm12113955wrs.55.2019.11.25.13.38.54 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 25 Nov 2019 13:38:55 -0800 (PST)
Content-Type: text/plain; charset="utf-8"
Mime-Version: 1.0 (Mac OS X Mail 13.0 \(3601.0.10\))
Subject: Re: Document shepherd writeup formats
From: Yoav Nir <ynir.ietf@gmail.com>
In-Reply-To: <14334f87-1870-0aa2-d066-3cb2a417f649@bluepopcorn.net>
Date: Mon, 25 Nov 2019 23:38:53 +0200
Cc: IETF WG Chairs <wgchairs@ietf.org>
Content-Transfer-Encoding: quoted-printable
Message-Id: <84924E01-7890-42A3-B4AE-2AC979A089E4@gmail.com>
References: <14334f87-1870-0aa2-d066-3cb2a417f649@bluepopcorn.net>
To: Jim Fenton <fenton@bluepopcorn.net>
X-Mailer: Apple Mail (2.3601.0.10)
Archived-At: <https://mailarchive.ietf.org/arch/msg/wgchairs/W0YlomRHZQFnfYArQBVFmiERMEs>
X-BeenThere: wgchairs@ietf.org
X-Mailman-Version: 2.1.29
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: Mon, 25 Nov 2019 21:39:04 -0000

> On 25 Nov 2019, at 23:22, Jim Fenton <fenton@bluepopcorn.net> wrote:
> 
> I just completed a document shepherd writeup in the "newer essay-style
> version" described on the DocumentShepherding page of the Chairs' wiki.
> But when I went to submit it, the form popped up with a template for the
> question-and-answer format, which led me to believe that format is
> preferred.
> 
> Is the essay-style format actually preferred? I'm wondering if it's a
> good idea to have two writeup formats rather than a single one. Or do
> preferences vary by AD?
> 

I prefer the essay form. In my opinion, use whichever one you prefer, unless your AD yells at you.

IIRC this started out as Barry Leiba’s idea, 

Yoav

v2.23.0 | Report a Bug | By Email