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

Carsten Bormann cabo at tzi.org
Thu Jul 16 15:44:57 PDT 2020


Or - - v 3 in XXL rfc if you call that directly

Sent from mobile, sorry for terse and autocorrect

> On 17. Jul 2020, at 00:37, Carsten Bormann <cabo at tzi.org> wrote:
> 
> You need the -3 flag in kdrfc
> 
> Sent from mobile, sorry for terse
> 
>>> On 16. Jul 2020, at 23:01, Michael Richardson <mcr+ietf at sandelman.ca> wrote:
>>> 
>> 
>> Carsten Bormann <cabo at tzi.org> wrote:
>>>>> On 2020-07-15, at 20:50, Toerless Eckert <tte at 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 at sandelman.ca>, Sandelman Software Works
>> -= IPv6 IoT consulting =-
> _______________________________________________
> rfc-interest mailing list
> rfc-interest at rfc-editor.org
> https://www.rfc-editor.org/mailman/listinfo/rfc-interest
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.rfc-editor.org/pipermail/rfc-interest/attachments/20200717/f443423c/attachment.html>


More information about the rfc-interest mailing list