Subject: [Rfc-markdown] 1.3.37: Annotate contributors section (Re: [rfc-i] contacts section?)

From: Carsten Bormann <[email-masked]>
Date: Fri, 26 Feb 2021 16:07:44 +0100

1.3.37: contributors to be listed in the contributor section can now be annotated with text that will be added to that section after their contact information.

The text is entered in the “contribution” entry of the contact information for a contributor.
It is markdown and can contain paragraph breaks and other markup, as shown below (with some author information as context, which is not shown in the rendering).
Note that YAML has the “|” syntax that is strongly recommended for entering markdown text into YAML entries.

author:
  - name: Carsten Bormann
    org: Universität Bremen TZI
    email: [email-masked]
contributor:
  - name: Peter Occil
    email: poccil14 at gmail dot com
    contribution: |
      Peter Occil registered tags 30, 264, 265, 268–270
      ({{advanced-arithmetic}}), 38, 257, 266 and 267
      ({{domain-specific}}), and contributed much of the text about
      these tags in this document.
  - name: Jane Doe
    org: To do
    contribution: |
      Further contributors will be listed here as text is added.

      Plase stay tuned.

➔ 

Contributors

   Peter Occil

   Email: poccil14 at gmail dot com

   Peter Occil registered tags 30, 264, 265, 268-270 (Section 6.1), 38,
   257, 266 and 267 (Section 7), and contributed much of the text about
   these tags in this document.

   Jane Doe
   To do

   Further contributors will be listed here as text is added.

   Plase stay tuned.

Note that the text rendition of the XML generated contains some spurious empty lines between contact and text; there is no obvious workaround until this is fixed in xml2rfc.  The HTML seems fine.

Grüße, Carsten

> On 2021-02-26, at 13:18, Carsten Bormann <[email-masked]> wrote:
> 
> V3 has a contributors section.
> Kramdown-rfc can generate that from metadata that look exactly like author metadata (so it’s easy to shift back and forward).
> What we don’t have is a way to add annotations to that (no extra RFCXML support needed, as the kramdown-rfc result would then look a lot like the below).
> 
> Grüße, Carsten
> 
> 
>> On 26. Feb 2021, at 11:51, Julian Reschke <[email-masked]> wrote:
>> 
>> You can do something like:
>> 
>> <section name="Contacts">
>> <contact fullname="Sam Whatever" ...>
>> </contact>
>> <t>Sam wrote <xref. .../>.</t>
>> </section>
>