[Rfc-markdown] 1.5.15: Discussion Venues

Carsten Bormann <cabo@tzi.org> Sat, 30 October 2021 07:44 UTC

Return-Path: <cabo@tzi.org>
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 2AC3E3A03EF for <rfc-markdown@ietfa.amsl.com>; Sat, 30 Oct 2021 00:44:37 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.899
X-Spam-Level:
X-Spam-Status: No, score=-1.899 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
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 nCD4y_oSGp7t for <rfc-markdown@ietfa.amsl.com>; Sat, 30 Oct 2021 00:44:32 -0700 (PDT)
Received: from gabriel-smtp.zfn.uni-bremen.de (gabriel-smtp.zfn.uni-bremen.de [134.102.50.15]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 864153A03EE for <rfc-markdown@ietf.org>; Sat, 30 Oct 2021 00:44:32 -0700 (PDT)
Received: from smtpclient.apple (p5089a10c.dip0.t-ipconnect.de [80.137.161.12]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by gabriel-smtp.zfn.uni-bremen.de (Postfix) with ESMTPSA id 4HhBC14Y4sz30bS; Sat, 30 Oct 2021 09:44:29 +0200 (CEST)
From: Carsten Bormann <cabo@tzi.org>
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: quoted-printable
Mime-Version: 1.0 (Mac OS X Mail 14.0 \(3654.120.0.1.13\))
Date: Sat, 30 Oct 2021 09:44:29 +0200
Message-Id: <8CD95027-4AC0-4108-8DFD-FF86C51DA3C7@tzi.org>
To: rfc-markdown@ietf.org
X-Mailer: Apple Mail (2.3654.120.0.1.13)
Archived-At: <https://mailarchive.ietf.org/arch/msg/rfc-markdown/aIRhhNYw0Ja8mtZyMXao55Zjef0>
Subject: [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: Sat, 30 Oct 2021 07:44:37 -0000

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