IETF Logo Mail Archive

Re: [rfc-i] [Tools-discuss] contributors section & tools

Michael Richardson <mcr+ietf@sandelman.ca> Thu, 16 July 2020 21:01 UTC

Return-Path: <rfc-interest-bounces@rfc-editor.org>
X-Original-To: ietfarch-rfc-interest-archive@ietfa.amsl.com
Delivered-To: ietfarch-rfc-interest-archive@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id F40B53A0D24; Thu, 16 Jul 2020 14:01:04 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -0.864
X-Spam-Level:
X-Spam-Status: No, score=-0.864 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, HEADER_FROM_DIFFERENT_DOMAINS=0.001, LONGWORDS=2.035, MAILING_LIST_MULTI=-1, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=no 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 Q5jg9CaJc7Z9; Thu, 16 Jul 2020 14:01:03 -0700 (PDT)
Received: from rfc-editor.org (rfc-editor.org [4.31.198.49]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 4D25C3A0D01; Thu, 16 Jul 2020 14:01:03 -0700 (PDT)
Received: from rfcpa.amsl.com (localhost [IPv6:::1]) by rfc-editor.org (Postfix) with ESMTP id 06857F40750; Thu, 16 Jul 2020 14:00:57 -0700 (PDT)
X-Original-To: rfc-interest@rfc-editor.org
Delivered-To: rfc-interest@rfc-editor.org
Received: from localhost (localhost [127.0.0.1]) by rfc-editor.org (Postfix) with ESMTP id 0A000F40750 for <rfc-interest@rfc-editor.org>; Thu, 16 Jul 2020 14:00:56 -0700 (PDT)
X-Virus-Scanned: amavisd-new at rfc-editor.org
Received: from rfc-editor.org ([127.0.0.1]) by localhost (rfcpa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id mo9C-sYKLo7N for <rfc-interest@rfc-editor.org>; Thu, 16 Jul 2020 14:00:51 -0700 (PDT)
Received: from tuna.sandelman.ca (tuna.sandelman.ca [IPv6:2607:f0b0:f:3:216:3eff:fe7c:d1f3]) by rfc-editor.org (Postfix) with ESMTPS id 89EC7F4074E for <rfc-interest@rfc-editor.org>; Thu, 16 Jul 2020 14:00:51 -0700 (PDT)
Received: from localhost (localhost [127.0.0.1]) by tuna.sandelman.ca (Postfix) with ESMTP id 48217389A9; Thu, 16 Jul 2020 16:57:52 -0400 (EDT)
Received: from tuna.sandelman.ca ([127.0.0.1]) by localhost (localhost [127.0.0.1]) (amavisd-new, port 10024) with LMTP id dYr44kH7gTrE; Thu, 16 Jul 2020 16:57:50 -0400 (EDT)
Received: from sandelman.ca (obiwan.sandelman.ca [209.87.249.21]) by tuna.sandelman.ca (Postfix) with ESMTP id 83DC0389A8; Thu, 16 Jul 2020 16:57:50 -0400 (EDT)
Received: from localhost (localhost [IPv6:::1]) by sandelman.ca (Postfix) with ESMTP id 1C29748B; Thu, 16 Jul 2020 17:00:52 -0400 (EDT)
From: Michael Richardson <mcr+ietf@sandelman.ca>
To: Carsten Bormann <cabo@tzi.org>, Toerless Eckert <tte@cs.fau.de>, RFC Interest <rfc-interest@rfc-editor.org>, tools-discuss@ietf.org
In-Reply-To: <34B0AF82-777B-4C51-9853-832312325C3B@tzi.org>
References: <20200715174047.GF38490@faui48f.informatik.uni-erlangen.de> <0b4801d65ad2$66a268c0$33e73a40$@olddog.co.uk> <20200715181233.GH38490@faui48f.informatik.uni-erlangen.de> <0b5a01d65ad5$1763aaf0$462b00d0$@olddog.co.uk> <20200715185023.GI38490@faui48f.informatik.uni-erlangen.de> <34B0AF82-777B-4C51-9853-832312325C3B@tzi.org>
X-Mailer: MH-E 8.6+git; nmh 1.7+dev; GNU Emacs 26.1
X-Face: $\n1pF)h^`}$H>Hk{L"x@)JS7<%Az}5RyS@k9X%29-lHB$Ti.V>2bi.~ehC0; <'$9xN5Ub# z!G,p`nR&p7Fz@^UXIn156S8.~^@MJ*mMsD7=QFeq%AL4m<nPbLgmtKK-5dC@#:k
MIME-Version: 1.0
Date: Thu, 16 Jul 2020 17:00:52 -0400
Message-ID: <25009.1594933252@localhost>
Subject: Re: [rfc-i] [Tools-discuss] contributors section & tools
X-BeenThere: rfc-interest@rfc-editor.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "A list for discussion of the RFC series and RFC Editor functions." <rfc-interest.rfc-editor.org>
List-Unsubscribe: <https://www.rfc-editor.org/mailman/options/rfc-interest>, <mailto:rfc-interest-request@rfc-editor.org?subject=unsubscribe>
List-Archive: <http://www.rfc-editor.org/pipermail/rfc-interest/>
List-Post: <mailto:rfc-interest@rfc-editor.org>
List-Help: <mailto:rfc-interest-request@rfc-editor.org?subject=help>
List-Subscribe: <https://www.rfc-editor.org/mailman/listinfo/rfc-interest>, <mailto:rfc-interest-request@rfc-editor.org?subject=subscribe>
Cc: Warren Kumari <warren@kumari.net>
Content-Type: multipart/mixed; boundary="===============0336951084438051961=="
Errors-To: rfc-interest-bounces@rfc-editor.org
Sender: rfc-interest <rfc-interest-bounces@rfc-editor.org>

Carsten Bormann <cabo@tzi.org> wrote:
    >> On 2020-07-15, at 20:50, Toerless Eckert <tte@cs.fau.de> wrote:
    >>
    >>> Not sure whether xml2rfc v3 has special tags for contributors. If so, that
    >>> would solve the problem.
    >>
    >> Scanning through rfc7991 there seems to be no enhancements in this respect.

    > It does.  They are not very well documented.

    > Kramdown-rfc supports them by adding a YAML entry like the authors entry:

    > contributor:
    > - name: Peter Occil
    > email: poccil14 at gmail dot com
    > - name: Many More
    > org: To do

Thank you, I very much like this.
I also noticed today that there was an IESG todo item:
    Warren Kumari to work on acknowledging shepherds, directorate
    reviewers in a more standardized/formal way.
    - Added 2019-10-10 (18 telechats ago)

so, I tried this.

I had a section called "Contributors" already, in the old textual form.
And it actually details some major contributions, so I didn't want to remove
it, so I have slightly renamed it. ("Notable Contributions")

With just name:/email:, I get many complaints from xml2rfc:
 <string>: Line 1655: No declaration for element contact
 <string>: Line 1655: No declaration for attribute initials of element contact
 <string>: Line 1655: No declaration for attribute surname of element contact
 <string>: Line 1655: No declaration for attribute fullname of element contact

I obviously know how to solve this by putting more stuff in.
But, the bigger problem seems to be:

<string>: Line 1614: Element section content does not follow the DTD,
expecting ((t | figure | texttable | iref)* , section*), got (name contact
contact contact contact contact contact contact contact contact contact
contact contact contact)

kramdown-rfc2629-1.3.8
xml2rfc 2.23.1
... upgrading to 2.46.0.
    same result.

--
Michael Richardson <mcr+IETF@sandelman.ca>, Sandelman Software Works
 -= IPv6 IoT consulting =-

_______________________________________________
rfc-interest mailing list
rfc-interest@rfc-editor.org
https://www.rfc-editor.org/mailman/listinfo/rfc-interest

v2.23.0 | Report a Bug | By Email