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

Julian Reschke <julian.reschke@gmx.de> Tue, 15 October 2019 04:06 UTC

Return-Path: <julian.reschke@gmx.de>
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 7F13D1208B7 for <xml2rfc-dev@ietfa.amsl.com>; Mon, 14 Oct 2019 21:06:13 -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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=gmx.net
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 sxqQFrIt_nPR for <xml2rfc-dev@ietfa.amsl.com>; Mon, 14 Oct 2019 21:06:10 -0700 (PDT)
Received: from mout.gmx.net (mout.gmx.net [212.227.15.19]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id CE515120111 for <xml2rfc-dev@ietf.org>; Mon, 14 Oct 2019 21:06:09 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1571112365; bh=gjElKxBKh9/JbiYzHjb86/11j+Q+Zku8nZrTP4ae0u4=; h=X-UI-Sender-Class:Subject:From:To:Cc:References:Date:In-Reply-To; b=ZwYPKgm0EloSrcRVAqHC17rcV7PYYexqH+tOUDtiF8iQEqoURbSiLQSquq+cfrIXh cxfdYMk9kI+cUKM93+Veltwj/O3xzJGT9QxriWCq1oO9Cq+i2KkNV89rDfm4By5d8N EXNUag3gy8bKwOCMpnZYBtRqW3bcIarQn0zad3lw=
X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c
Received: from [192.168.178.124] ([84.171.152.211]) by mail.gmx.com (mrgmx004 [212.227.17.190]) with ESMTPSA (Nemesis) id 1MDhlV-1iAdJ41Rqh-00AnNd; Tue, 15 Oct 2019 06:06:05 +0200
From: Julian Reschke <julian.reschke@gmx.de>
To: Heather Flanagan <rse@rfc-editor.org>
Cc: XML Developer List <xml2rfc-dev@ietf.org>
References: <7e8bb742-1939-b48c-e7f7-03f3bec6bd63@gmx.de> <6F5868A8-56F3-4E26-B297-2CE0BD765397@rfc-editor.org> <b750c06e-caab-40e9-617d-57e0f79ff585@gmx.de> <DD4A3091-9E2B-417A-AF3A-8A44AFBBE60E@rfc-editor.org> <db200ee8-e042-cdc1-2058-5afcc4d4cd57@gmx.de>
Message-ID: <7dc9d867-8025-47ed-bc33-d9fabf523588@gmx.de>
Date: Tue, 15 Oct 2019 06:06:01 +0200
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:60.0) Gecko/20100101 Thunderbird/60.9.0
MIME-Version: 1.0
In-Reply-To: <db200ee8-e042-cdc1-2058-5afcc4d4cd57@gmx.de>
Content-Type: text/plain; charset="utf-8"; format="flowed"
Content-Language: en-US
Content-Transfer-Encoding: quoted-printable
X-Provags-ID: V03:K1:Xv/W2s2zQXhbOa8NFd/7OalpVYCFukt2z1biYUiJCY0Cg+PGFK6 okX8hPX4YL9xqdPPeYfwsTl3cGofeRfGXayhCKTNsId5ztQatVAbB9rAysKG00LZD/xy1Xx q3O2ySZAddH0qmyuL6kDfWanzqQ4B7qBsGzHlHVKi01SuhEKZckUvhjx7CFhOS70slsIb2e 1bTk7iRr2keZzQ4WEEWVQ==
X-UI-Out-Filterresults: notjunk:1;V03:K0:6SD2vklAI80=:tiPetkNavwXPosfmLan86y wVjUG+T0/1yhCE+dVNg0Fm7j4LwAv+hA/YlqYz0IAv3Rx3tBu0ZSsTIBHbQgMA87LjU8wDkO7 t8LK4Y1fRWsso+tPRh5a+8ZrmhZiXX1NcPEMMmbB+pQcJ+OTwIKzxSHqgCsMa+IlA2WWMusiU FMRdy6JIPmjHb8pQhz/JDzfl1GflyuHLOTI28fUN0UbnMDtour4s6VN2v8iquSOyG6oYNIOJg Jg4bOn2578EX9BJ0MJbH/W8+dgXojRvOpdeyJxJJMMaZeqY5w+qJUYPincNwZ/eAfQktdDTTd Vy4UjGcAzdPZvmf2NiVCXjQlQyD8b0yby3jmSnHtZAncx5vV37BbcfWv0d2VAtMblufD1K5kz x0e/qMa1FL5iRNs1HAkg9S3dtrTZclTbCGmzhwoMHRm1hCME0qyVxUWCxA6uq6cgzSm72jtVe RdzWarSm5yU172wJGgDivVK13gwtJo2TQJJC1A3c/12n1/4rUscffKmB43owl1yHxWdjCWkqp CW4BAn/Hv6UEdqyeFql3Vic2q5/jdVS6cTo+BimhjOOIxjhc4RoAY/xU+SMS+fJt/N7vz+LT6 /pmrmTXQFwxr4QVTv7ljIDbXU1TS0/RNLKNeS22kpATURznJ1jc54SWpY61yPNQxQT63ZIHbw PMqZsGfEVBKCuFndBT5dFYdKMu6LbC60RW1aDyJ1s2eKjuMbDRLHCpzkJecHBC8g7+3Qq7CCA sJ9LY1claRPzbfw2YigRJlzZOc4P7eaVlxsnPI/WmrW1CVGKlilzV+P/5V22Ur9D4W8mLbS5s D5iRlsuzMJglAUaws1WEgmu3FBJOlD+ToZeuLg1zWbf4K6KYjs+b+Ut2BXrcetEkTpfBHQgyX bCsNvVk/nzNgbzlYyUJzJdc6NXljLawwb/6XM07hJXeXprJUSSYC7OUgwC3eQGKn0pYmQ7zXQ sIP2yEKesSEtc2S3/dJllMt/c37B/ygmGL5Bv91NY/mSZ87MpiKjniOn2hRGC58IGRUUQK7Q+ abxNyCVXzLsfGMa2+iMOndpX5cgNgEVE/b1/uCkiTPd5sSfJIZg+sP3ZHranGLIj/7uxQ8Ek1 ZyjlbpvX5V10noLy6BpS0bylxc6GDuulFOEmwJT3FH/c6k2+DmJORD51a6+0BvD/o4jq6RoOF 2wbI+Q4iJd7cIHLDcCptI07L8mfTwuEihodNspB2x+UpYj5qgCVdX0NePSmIT0/44GaWmqTN7 TPBZ7BI4o6wKmDFOmiwBMNbywFczBL9I4LF6iFBwEILxgxQHWciDihZ05DVM=
Archived-At: <https://mailarchive.ietf.org/arch/msg/xml2rfc-dev/UVhFfr0K_ZlRtcIhde_Z0cU1kpU>
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, 15 Oct 2019 04:06:14 -0000

On 02.10.2019 05:45, Julian Reschke wrote:
> On 01.10.2019 23:19, Heather Flanagan wrote:
>> ...
>>>> "<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>"
>>>
>>> That's about the front page, not for references.
>>
>> Iirc, we’ve always tried to be consistent between what’s on the front
>> page and what’s in the references.
>> ...
>
> Well, but we are not consistent right now.
>
>>> For the latter, the draft style guide says in
>>> <https://tools.ietf.org/html/draft-flanagan-7322bis-03#section-4.8.6.4>:
>>>
>>>>   [SYMBOLIC-TAG]  Last name, First initial., Ed. (if applicable) and
>>>>   First initial.  Last name, Ed. (if applicable), "I-D Title", Internet
>>>>   Draft, draft-string-NN, Month Year.
>>>
>>> Note: "first initial”.
>>
>> “Second initial if provided” is a really ugly example, but I can add it
>> if you think it’s critical.
>
> That would still be inconsistent with the front page, no?
>
>> ...
>>>>> 4) A URI ontools.ietf.org <http://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.
>>>
>>> The style guide doesn't say so. The author didn't provide one. Why is
>>> the tool inserting something automatically? Also, why totools.ietf.org
>>> <http://tools.ietf.org/>?
>>> Are you planning to put that into the style guide?
>>
>> Well, there are always things the authors don’t provide that are
>> automatically added. And since we’ve been talking about making sure that
>> internal links to specific sections are included (which perforce MUST go
>> to tools references) the thought was to be consistent and have the
>> reference point to the same place that the internal section pointers are
>> going to send people. I think it would be confusing to have one set of
>> links go one place, and another set of links to somewhere entirely
>> different.
>
> Well.
>
> Right now the tools target is only inserted when none is specified, so
> this is not in line what you're arguing for.
>
> Also, for RFCs the target uses https://www.rfc-editor.org/info/rfcNNNN,
> which also is not the URI used for the section links.
>
> Best regards, Julian
> ...

FWIW, tracked at
<https://trac.tools.ietf.org/tools/xml2rfc/trac/ticket/436>. Would be
awesome to make some progress here.

Best regards, Julian