[Rfc-markdown] Contributors

Carsten Bormann <cabo@tzi.org> Thu, 12 March 2020 16:45 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 ECD2F3A0D8C for <rfc-markdown@ietfa.amsl.com>; Thu, 12 Mar 2020 09:45:27 -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 mKgz2pavNfjQ for <rfc-markdown@ietfa.amsl.com>; Thu, 12 Mar 2020 09:45:25 -0700 (PDT)
Received: from gabriel-vm-2.zfn.uni-bremen.de (gabriel-vm-2.zfn.uni-bremen.de [134.102.50.17]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id BE6463A0D8B for <rfc-markdown@ietf.org>; Thu, 12 Mar 2020 09:45:25 -0700 (PDT)
Received: from [172.16.42.113] (p548DCD70.dip0.t-ipconnect.de [84.141.205.112]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by gabriel-vm-2.zfn.uni-bremen.de (Postfix) with ESMTPSA id 48dZSh1HwtzykZ; Thu, 12 Mar 2020 17:45:24 +0100 (CET)
Content-Type: text/plain; charset="utf-8"
Mime-Version: 1.0 (Mac OS X Mail 13.0 \(3608.60.0.2.5\))
From: Carsten Bormann <cabo@tzi.org>
In-Reply-To: <48FE125D-32EC-4D52-A2AD-4AFE44A59409@tzi.org>
Date: Thu, 12 Mar 2020 17:45:23 +0100
X-Mao-Original-Outgoing-Id: 605724323.564814-66d198e9e67596d83565f0eb1c2766c7
Content-Transfer-Encoding: quoted-printable
Message-Id: <B4EE04EE-E6F9-4FA6-A419-67B02D6EAD7D@tzi.org>
References: <BN8PR15MB2644C01E60453D9CE2F00BE297FC0@BN8PR15MB2644.namprd15.prod.outlook.com> <04CD97D2-8AA3-4826-8A1E-9EC8D74B3947@amsl.com> <48FE125D-32EC-4D52-A2AD-4AFE44A59409@tzi.org>
To: RFC Markdown <rfc-markdown@ietf.org>
X-Mailer: Apple Mail (2.3608.60.0.2.5)
Archived-At: <https://mailarchive.ietf.org/arch/msg/rfc-markdown/noq-4H1GeNMmIy0FYrfQWC1elfM>
Subject: [Rfc-markdown] Contributors
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: Thu, 12 Mar 2020 16:45:28 -0000

On 2020-03-12, at 00:20, Carsten Bormann <cabo@tzi.org> wrote:
> 
> So the idea would be that you have an additional YAML section for contributors, like this:
> 
> author:
> - name: Henk Birkholz
> - name: Max Pritikin
> - name: Robert Moskowitz
> contributor:
> - name: Carsten Bormann

Done in 1.3.1.

Please update your local system using:

  gem update

Or more specifically

  gem update kramdown-rfc2629

Then move the authors that should be listed as contributors from author: to contributor:, as in:

author:
- name: Henk Birkholz
  org: Fraunhofer SIT
  abbrev: Fraunhofer SIT
  email: henk.birkholz@sit.fraunhofer.de
  street: Rheinstrasse 75
  code: '64295'
  city: Darmstadt
  country: Germany
contributor:
- name: Carsten Bormann
  org: Universität Bremen TZI
  street: Postfach 330440
  city: Bremen
  code: D-28359
  country: Germany
  phone: +49-421-218-63921
  email: cabo@tzi.org


This only works under v3 processing rules, as v2 does not have the <contact> element needed for that; so you have to run kdrfc with -3 (or use Martin Thomson’s template).

You also (or alternatively) can add some text in the front of the contributors section (before the contacts are listed) by marking it with --- contributor, e.g. before --- abstract:

--- contributor

Because of the straightjacket 5-authors rule, the following co-authors
are not listed under the front page co-authors:

--- abstract

…

Enjoy, and please report any weirdness.

Grüße, Carsten