Re: [Rfc-markdown] 1.5.15: Discussion Venues

Martin Thomson <mt@lowentropy.net> Mon, 01 November 2021 23:42 UTC

Return-Path: <mt@lowentropy.net>
X-Original-To: rfc-markdown@ietfa.amsl.com
Delivered-To: rfc-markdown@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id B87443A30E5 for <rfc-markdown@ietfa.amsl.com>; Mon, 1 Nov 2021 16:42:26 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.101
X-Spam-Level:
X-Spam-Status: No, score=-2.101 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, RCVD_IN_MSPIKE_H2=-0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=lowentropy.net header.b=EFJmuUqe; dkim=pass (2048-bit key) header.d=messagingengine.com header.b=EvQbODY9
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 fr6vPWyUzNsX for <rfc-markdown@ietfa.amsl.com>; Mon, 1 Nov 2021 16:42:21 -0700 (PDT)
Received: from wout1-smtp.messagingengine.com (wout1-smtp.messagingengine.com [64.147.123.24]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id C7E0B3A30E3 for <rfc-markdown@ietf.org>; Mon, 1 Nov 2021 16:42:21 -0700 (PDT)
Received: from compute5.internal (compute5.nyi.internal [10.202.2.45]) by mailout.west.internal (Postfix) with ESMTP id E79E03201D70 for <rfc-markdown@ietf.org>; Mon, 1 Nov 2021 19:42:19 -0400 (EDT)
Received: from imap41 ([10.202.2.91]) by compute5.internal (MEProxy); Mon, 01 Nov 2021 19:42:20 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lowentropy.net; h=mime-version:message-id:in-reply-to:references:date:from:to :subject:content-type:content-transfer-encoding; s=fm3; bh=jHeg4 B3NoRlh4JMS9Fdphv/0izr/MC3yDoP/ylsXtfg=; b=EFJmuUqe/deC7125S0nEG Kd10GDFd6UuN/yYJDWuDzypTinxOo1vaFa11AFBOH9GTtuCq4YU27sko7RVV/ufg A47tM/OpyLig0fZDfeq6mf2C8c9d+vrNQFUYKrjt1buwXjqR4K7Pz5rzDrhbf4N+ Fp16e3GM7dbqCA1mumpSt+DUfTRPRE5qTlSR5S1dFq/kzrFgDljC4b3AVaXrCBV+ m8906+FvBkuq8neJUrAVh035LwfTMljRcwcB8dwpBcg64g1sZamkvhpuBz8A4BYK lp0bHO7RIwWveDfHh/r0AlapjXMi36ntMCxFu83S4LCoBBfv+eDnck4cmriZRUWw g==
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=content-transfer-encoding:content-type :date:from:in-reply-to:message-id:mime-version:references :subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm1; bh=jHeg4B3NoRlh4JMS9Fdphv/0izr/MC3yDoP/ylsXt fg=; b=EvQbODY9UAaz1AihVE+ozl8JR74J4ddSBmY6Nfp7U0M/K7k6krb26D1Gs 1AJCWcmB/Ou4yQGM/2d93s/KnsGdQWawsOwBIcA/bsiTRspCl312uq0CCbqM88ew FTg+z5nWi3j/DBXZFOEpw6vN3NpqFxfhhk4FhpSqp98d051M0IjT7knAGma4eaAX g5LmyDkgJXewRXuSS6D42yhKx1D0fve1tLk+LNsfoOf/zl/Yx/ZD8lQ4gDb0qq7l 5rNt5Wa1pNzeyC204Srw3lT++UXae5OWpaovObEqh1cmPY2f0B+xaMGJoL7+e2cL SYsa6rLhVikLyUONuslCVNaLGHd2A==
X-ME-Sender: <xms:W3uAYS7Fll_ti0MX31I90zNXosdBVVO3aj9Ltk8cUJB7Rk4RC1Ijdg> <xme:W3uAYb5ktxrlWxctEAEble0eWkDg1SO7a3p3K04FVd1qLKfnjnwWXVjSMZcTPDcMm ykDzQhz2pCZTlKwTTY>
X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvtddrvdehgedgtdekucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucenucfjughrpefofgggkfgjfhffhffvufgtgfesth hqredtreerjeenucfhrhhomhepfdforghrthhinhcuvfhhohhmshhonhdfuceomhhtsehl ohifvghnthhrohhphidrnhgvtheqnecuggftrfgrthhtvghrnhepgfdvtdehjeejhfffff egteehheeuleetgfdvgffhgfevgedvieeuudegueejgeeunecuffhomhgrihhnpehivght fhdrohhrghdpghhithhhuhgsrdgtohhmpdhgihhtlhgrsgdrtghomhenucevlhhushhtvg hrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehmtheslhhofigvnhhtrhho phihrdhnvght
X-ME-Proxy: <xmx:W3uAYRfxIL9P5wKLrrJiy1y82ikER2e-AQCYFTOt90umBOrTdgmsiA> <xmx:W3uAYfK8uHHrlWxu_9nr_Z9PyTyDlk44dxWfoVh-AFghl-5P56IFyQ> <xmx:W3uAYWKjxazz9Zpz2Py0yA-_FWnDZ1ZnzrbnEeShF7FABysAlnN_FQ> <xmx:W3uAYbVn3ZR1PDa1Ro1bvVydFBZrcmvrCUbjW39BJUWryWDcAsflNQ>
Received: by mailuser.nyi.internal (Postfix, from userid 501) id 492F03C044D; Mon, 1 Nov 2021 19:42:19 -0400 (EDT)
X-Mailer: MessagingEngine.com Webmail Interface
User-Agent: Cyrus-JMAP/3.5.0-alpha0-1369-gd055fb5e7c-fm-20211018.002-gd055fb5e
Mime-Version: 1.0
Message-Id: <2f8bbe9c-b7f5-4b99-b9ae-487ef5e26817@www.fastmail.com>
In-Reply-To: <8CD95027-4AC0-4108-8DFD-FF86C51DA3C7@tzi.org>
References: <8CD95027-4AC0-4108-8DFD-FF86C51DA3C7@tzi.org>
Date: Tue, 02 Nov 2021 10:41:59 +1100
From: Martin Thomson <mt@lowentropy.net>
To: rfc-markdown@ietf.org
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: quoted-printable
Archived-At: <https://mailarchive.ietf.org/arch/msg/rfc-markdown/lYKmSXC4M62j9nQbqDgr_1Cpdi4>
Subject: Re: [Rfc-markdown] 1.5.15: Discussion Venues
X-BeenThere: rfc-markdown@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "rfc-markdown is a discussion list for people writing I-Ds and RFCs in Markdown and the authors of the tools used for that." <rfc-markdown.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/rfc-markdown>, <mailto:rfc-markdown-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/rfc-markdown/>
List-Post: <mailto:rfc-markdown@ietf.org>
List-Help: <mailto:rfc-markdown-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/rfc-markdown>, <mailto:rfc-markdown-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 01 Nov 2021 23:42:27 -0000

Thanks for doing this Carsten.

This is definitely my preferred approach to including this sort of information; I'll keep the automation, but I recommend following this form.  If you are using the templates, using Carsten's tweak will disable that automated tweak.  I have some updates I'd like to do to make filling this in easier, but that will come later.

On Sat, Oct 30, 2021, at 18:44, Carsten Bormann wrote:
> 1.5.15 has basic support for generating discussion venue notes.
> The details are likely to further improve based on your input, which I 
> hereby request.
>
> Put this in your YAML front:
>
> venue:
>   group: JSON Path
>   mail: jsonpath@ietf.org
>   github: ietf-wg-jsonpath/draft-ietf-jsonpath-base
>
> And you get right after the abstract (looks nicer in HTML):
>
> Discussion Venues
>
>    This note is to be removed before publishing as an RFC.
>
>    Discussion of this document takes place on the JSON Path Working
>    Group mailing list (jsonpath@ietf.org), which is archived at
>    https://mailarchive.ietf.org/arch/browse/jsonpath/.
>
>    Source for this draft and an issue tracker can be found at
>    https://github.com/ietf-wg-jsonpath/draft-ietf-jsonpath-base.
>
> You can leave out “group:” if that is identical to the local part of 
> the mail address (here, I liked some extra spacing and capitalization).
> Put in an explicit “type:” if you don’t like the code to infer “Working 
> Group” from @ietf in the mail address, or “Research Group” from @irtf.
> Put in an explicit “arch:” if you don’t like inferring the mail archive 
> name from the mail address (is that ever wrong?).
>
> Todo: add a slash before the period (so the link works in .TXT as well 
> as it does in .HTML), and add in non-github git repos, as soon as 
> somebody tells me they use one :-).
>
>   git: https://gitlab.com/weird-wg/draft-ietf-weird-nonconformance/
>
> And thanks of course to Martin Thomson whose .note.xml function in 
> I-D-Template I stole this from (which gets most of this information in 
> an automated way, but makes the generated draft dependent on its 
> context).
>
> Grüße, Carsten
>
> _______________________________________________
> Rfc-markdown mailing list
> Rfc-markdown@ietf.org
> https://www.ietf.org/mailman/listinfo/rfc-markdown