Re: [xml2rfc-dev] V3 breakage in formatting internet draft references

Heather Flanagan <rse@rfc-editor.org> Tue, 01 October 2019 20:03 UTC

Return-Path: <rse@rfc-editor.org>
X-Original-To: xml2rfc-dev@ietfa.amsl.com
Delivered-To: xml2rfc-dev@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 7B2C2120059 for <xml2rfc-dev@ietfa.amsl.com>; Tue, 1 Oct 2019 13:03:32 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.2
X-Spam-Level:
X-Spam-Status: No, score=-4.2 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_MED=-2.3, SPF_HELO_NONE=0.001, SPF_PASS=-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 tEOxKlTsyrBK for <xml2rfc-dev@ietfa.amsl.com>; Tue, 1 Oct 2019 13:03:30 -0700 (PDT)
Received: from mail.amsl.com (c8a.amsl.com [4.31.198.40]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id AF96B12001E for <xml2rfc-dev@ietf.org>; Tue, 1 Oct 2019 13:03:30 -0700 (PDT)
Received: from localhost (localhost [127.0.0.1]) by c8a.amsl.com (Postfix) with ESMTP id 90F04200034; Tue, 1 Oct 2019 13:03:08 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
Received: from c8a.amsl.com ([127.0.0.1]) by localhost (c8a.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 9ZrFa9pH93B4; Tue, 1 Oct 2019 13:03:08 -0700 (PDT)
Received: from [10.198.42.38] (c-71-231-216-10.hsd1.wa.comcast.net [71.231.216.10]) by c8a.amsl.com (Postfix) with ESMTPSA id 41C02200032; Tue, 1 Oct 2019 13:03:08 -0700 (PDT)
Content-Type: text/plain; charset="utf-8"
Mime-Version: 1.0 (Mac OS X Mail 12.4 \(3445.104.11\))
From: Heather Flanagan <rse@rfc-editor.org>
In-Reply-To: <7e8bb742-1939-b48c-e7f7-03f3bec6bd63@gmx.de>
Date: Tue, 01 Oct 2019 13:03:29 -0700
Cc: XML Developer List <xml2rfc-dev@ietf.org>
Content-Transfer-Encoding: quoted-printable
Message-Id: <6F5868A8-56F3-4E26-B297-2CE0BD765397@rfc-editor.org>
References: <7e8bb742-1939-b48c-e7f7-03f3bec6bd63@gmx.de>
To: Julian Reschke <julian.reschke@gmx.de>
X-Mailer: Apple Mail (2.3445.104.11)
Archived-At: <https://mailarchive.ietf.org/arch/msg/xml2rfc-dev/zA5D1x2bwLLzqRRQ6yl3mIAeiR0>
Subject: Re: [xml2rfc-dev] V3 breakage in formatting internet draft references
X-BeenThere: xml2rfc-dev@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "Discussion about particulars of xml2rfc V3 design, development and code." <xml2rfc-dev.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/xml2rfc-dev>, <mailto:xml2rfc-dev-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/xml2rfc-dev/>
List-Post: <mailto:xml2rfc-dev@ietf.org>
List-Help: <mailto:xml2rfc-dev-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/xml2rfc-dev>, <mailto:xml2rfc-dev-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 01 Oct 2019 20:03:33 -0000


> On Oct 1, 2019, at 8:01 AM, Julian Reschke <julian.reschke@gmx.de> wrote:
> 
> V3:
> 
>>   [Messaging]
>>              Fielding, R., Ed., Nottingham, M., Ed., and J. F. Reschke,
>>              Ed., "HTTP/1.1 Messaging", Internet-Draft, draft-ietf-
>>              httpbis-messaging-05, July 2019,
>>              <https://tools.ietf.org/html/draft-ietf-httpbis-messaging-
>>              99>.
> 
> V2:
> 
>>   [Messaging]
>>              Fielding, R., Ed., Nottingham, M., Ed., and J. Reschke,
>>              Ed., "HTTP/1.1 Messaging", draft-ietf-httpbis-messaging-
>>              05 (work in progress), July 2019.
> 
> Observations:
> 
> 1) author initials not restricted to one anymore (I'm open to change,
> but it should be properly documented)

That’s been in the draft style guide for a while.

"<t>The author's name (initial followed by family name) appears on the
first line of the heading.  Some variation, such as additional
initials or capitalization of family name, is acceptable.  Once the
author has selected how their name should appear, they should use
that display consistently in all of their documents.</t>"

> 
> 2) "Internet-Draft" is inserted

Yes.

> 
> 3) "(work in progress)" is missing

Bug.

> 
> 4) A URI on tools.ietf.org is inserted that I'd prefer not to have here.

Why not? I think having a URI makes a lot of sense.

> 
> Note: see <https://tools.ietf.org/html/rfc7322#section-4.8.6.4> which
> suggests:
> 
>>      [SYMBOLIC-TAG]  Last name, First initial., Ed. (if applicable)
>>                      and First initial. Last name, Ed. (if
>>                      applicable), "I-D Title", Work in Progress,
>>                      draft-string-NN, Month Year.
>> 
>>     Example:
>> 
>>      [RFC-STYLE] Flanagan, H. and S. Ginoza, "RFC Style Guide",
>>                  Work in Progress, draft-flanagan-style-01,
>>                  June 2013.
> 
> 


Stay tuned. About to post an updated version.

-Heather

> Best regards, Julian
> 
> PS: reported as <https://trac.tools.ietf.org/tools/xml2rfc/trac/ticket/436>
> 
> _______________________________________________
> xml2rfc-dev mailing list
> xml2rfc-dev@ietf.org
> https://www.ietf.org/mailman/listinfo/xml2rfc-dev
>