IETF Logo Mail Archive

Re: [xml2rfc-dev] Please help review v3 files

"HANSEN, TONY L" <tony@att.com> Tue, 13 August 2019 22:08 UTC

Return-Path: <tony@att.com>
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 DCF831208E7 for <xml2rfc-dev@ietfa.amsl.com>; Tue, 13 Aug 2019 15:08:20 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.599
X-Spam-Level:
X-Spam-Status: No, score=-2.599 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_LOW=-0.7, 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 v6ayaAKM3qxj for <xml2rfc-dev@ietfa.amsl.com>; Tue, 13 Aug 2019 15:08:17 -0700 (PDT)
Received: from mx0a-00191d01.pphosted.com (mx0b-00191d01.pphosted.com [67.231.157.136]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 5A51D1208C2 for <xml2rfc-dev@ietf.org>; Tue, 13 Aug 2019 15:08:17 -0700 (PDT)
Received: from pps.filterd (m0083689.ppops.net [127.0.0.1]) by m0083689.ppops.net-00191d01. (8.16.0.27/8.16.0.27) with SMTP id x7DLxecf042416; Tue, 13 Aug 2019 18:08:15 -0400
Received: from alpi155.enaf.aldc.att.com (sbcsmtp7.sbc.com [144.160.229.24]) by m0083689.ppops.net-00191d01. with ESMTP id 2uc5kvr601-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Tue, 13 Aug 2019 18:08:14 -0400
Received: from enaf.aldc.att.com (localhost [127.0.0.1]) by alpi155.enaf.aldc.att.com (8.14.5/8.14.5) with ESMTP id x7DM8ETf029668; Tue, 13 Aug 2019 18:08:14 -0400
Received: from zlp27126.vci.att.com (zlp27126.vci.att.com [135.66.87.47]) by alpi155.enaf.aldc.att.com (8.14.5/8.14.5) with ESMTP id x7DM88KW029489 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO); Tue, 13 Aug 2019 18:08:09 -0400
Received: from zlp27126.vci.att.com (zlp27126.vci.att.com [127.0.0.1]) by zlp27126.vci.att.com (Service) with ESMTP id 8CCF54030710; Tue, 13 Aug 2019 22:08:08 +0000 (GMT)
Received: from MISOUT7MSGHUBAH.ITServices.sbc.com (unknown [130.9.129.152]) by zlp27126.vci.att.com (Service) with ESMTPS id 758B5403070D; Tue, 13 Aug 2019 22:08:08 +0000 (GMT)
Received: from MISOUT7MSGUSRCG.ITServices.sbc.com ([169.254.7.37]) by MISOUT7MSGHUBAH.ITServices.sbc.com ([130.9.129.152]) with mapi id 14.03.0439.000; Tue, 13 Aug 2019 18:08:07 -0400
From: "HANSEN, TONY L" <tony@att.com>
To: "xml2rfc-dev@ietf.org" <xml2rfc-dev@ietf.org>, RFC Editor <rfc-editor@rfc-editor.org>
Thread-Topic: [xml2rfc-dev] Please help review v3 files
Thread-Index: AQHVPTDF7Ezy9ewPy0CoNub4fFmRrabQPBQAgCnHlYD//8kegA==
Date: Tue, 13 Aug 2019 22:08:06 +0000
Message-ID: <D95AB52E-3333-44C9-81DB-81A98F994E22@att.com>
References: <62908E23-2FC0-4ED7-84B2-E86454020206@amsl.com> <3FA7D490-1D84-4E70-B3D0-997F3AF4F2C5@tzi.org> <F39EC291-7E37-49B4-831D-34BC42BBF092@amsl.com>
In-Reply-To: <F39EC291-7E37-49B4-831D-34BC42BBF092@amsl.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
x-originating-ip: [135.210.15.163]
Content-Type: multipart/alternative; boundary="_000_D95AB52E333344C981DB81A98F994E22attcom_"
MIME-Version: 1.0
X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-08-13_06:, , signatures=0
X-Proofpoint-Spam-Details: rule=outbound_policy_notspam policy=outbound_policy score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1011 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1906280000 definitions=main-1908130205
Archived-At: <https://mailarchive.ietf.org/arch/msg/xml2rfc-dev/gd4qur9xmBpKrdZETU3zZPuVg5w>
Subject: Re: [xml2rfc-dev] Please help review v3 files
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, 13 Aug 2019 22:08:21 -0000

Thank you, Sandy.

There was a comment a week or so ago about not seeing the RFC number anywhere except at the very top. This is because we no longer have page headers and footers regularly. It struck a chord with me. Could “Table of Contents” become “RFC #### Table of Contents”?

Just a thought.

                Tony Hansen

From: xml2rfc-dev <xml2rfc-dev-bounces@ietf.org> on behalf of Sandy Ginoza <sginoza@amsl.com>
Date: Tuesday, August 13, 2019 at 5:24 PM
To: Carsten Bormann <cabo@tzi.org>
Cc: "xml2rfc-dev@ietf.org" <xml2rfc-dev@ietf.org>, RFC Editor <rfc-editor@rfc-editor.org>
Subject: Re: [xml2rfc-dev] Please help review v3 files

Hi all,

We have recreated files using the newest release of xml2rfc.  We believe this addresses the issue with the TOC on small devices - please review.

Note that there is still an issue with handling of “see Section N of [YYYY]”.

https://www.rfc-editor.org/v3test/draft-ietf-isis-l2bundles-07-SG.v2v3.v24.html<https://urldefense.proofpoint.com/v2/url?u=https-3A__www.rfc-2Deditor.org_v3test_draft-2Dietf-2Disis-2Dl2bundles-2D07-2DSG.v2v3.v24.html&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=Kz8VdgPVctDNSNPJ6PsBaw&m=9F6plUiKuzdKkYlynsEEoyUDwrTW5_rvs7F0WXmFi6s&s=ro0tROJJU8czR34OqZqKIvInGlVQ0qu0JYzlI1OKYAs&e=>

https://www.rfc-editor.org/v3test/draft-ietf-spring-segment-routing-msdc-11-MS.v2v3.v24.html<https://urldefense.proofpoint.com/v2/url?u=https-3A__www.rfc-2Deditor.org_v3test_draft-2Dietf-2Dspring-2Dsegment-2Drouting-2Dmsdc-2D11-2DMS.v2v3.v24.html&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=Kz8VdgPVctDNSNPJ6PsBaw&m=9F6plUiKuzdKkYlynsEEoyUDwrTW5_rvs7F0WXmFi6s&s=S1pxibFuqWc6pEYG5ZY65ABBJkdMbAdOnH4huzcuyes&e=>

https://www.rfc-editor.org/v3test/draft-ietf-avtcore-rtp-multi-stream-optimisation-12-KC.v2v3.v24.html<https://urldefense.proofpoint.com/v2/url?u=https-3A__www.rfc-2Deditor.org_v3test_draft-2Dietf-2Davtcore-2Drtp-2Dmulti-2Dstream-2Doptimisation-2D12-2DKC.v2v3.v24.html&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=Kz8VdgPVctDNSNPJ6PsBaw&m=9F6plUiKuzdKkYlynsEEoyUDwrTW5_rvs7F0WXmFi6s&s=qd5ifw64oiYY23J1iIQ35rM8k9P5fwJSP9AtD290VwY&e=>

https://www.rfc-editor.org/v3test/draft-ietf-roll-efficient-npdao-15-RE.v2v3.v24.html<https://urldefense.proofpoint.com/v2/url?u=https-3A__www.rfc-2Deditor.org_v3test_draft-2Dietf-2Droll-2Defficient-2Dnpdao-2D15-2DRE.v2v3.v24.html&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=Kz8VdgPVctDNSNPJ6PsBaw&m=9F6plUiKuzdKkYlynsEEoyUDwrTW5_rvs7F0WXmFi6s&s=boORUVhotq6a-pDsqDjuK00uAOGpTznAmZu38Wc15OQ&e=>

https://www.rfc-editor.org/v3test/draft-ietf-sipcore-rejected-09-LB.v2v3.v24.html<https://urldefense.proofpoint.com/v2/url?u=https-3A__www.rfc-2Deditor.org_v3test_draft-2Dietf-2Dsipcore-2Drejected-2D09-2DLB.v2v3.v24.html&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=Kz8VdgPVctDNSNPJ6PsBaw&m=9F6plUiKuzdKkYlynsEEoyUDwrTW5_rvs7F0WXmFi6s&s=OHawHFiYpBaFyO4HcPRMKIZG151BgfePq2TcgSUmpJo&e=>

https://www.rfc-editor.org/v3test/draft-ietf-lamps-pkix-shake-15-RV.v2v3.v24.html<https://urldefense.proofpoint.com/v2/url?u=https-3A__www.rfc-2Deditor.org_v3test_draft-2Dietf-2Dlamps-2Dpkix-2Dshake-2D15-2DRV.v2v3.v24.html&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=Kz8VdgPVctDNSNPJ6PsBaw&m=9F6plUiKuzdKkYlynsEEoyUDwrTW5_rvs7F0WXmFi6s&s=tAU0R09s5uU3AKnrUP1WDzsgn9xqG19ZVQCtwzLoPbY&e=>

https://www.rfc-editor.org/v3test/draft-ietf-lisp-introduction-13-MS.v2v3.v24.html<https://urldefense.proofpoint.com/v2/url?u=https-3A__www.rfc-2Deditor.org_v3test_draft-2Dietf-2Dlisp-2Dintroduction-2D13-2DMS.v2v3.v24.html&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=Kz8VdgPVctDNSNPJ6PsBaw&m=9F6plUiKuzdKkYlynsEEoyUDwrTW5_rvs7F0WXmFi6s&s=OKsE7GrPHbjAO81prAioGJ8fbISd-gqoLol5Zl7doOg&e=>

FYI - the full set of files (i.e., xml, html, pdf, txt) is available; just change the file extension.

Thank you,
Sandy



On Jul 18, 2019, at 12:23 AM, Carsten Bormann <cabo@tzi.org<mailto:cabo@tzi.org>> wrote:

The HTML form has an intrusive tablet of contents that is hiding a third of each line, is hard to get rid of, and that reappears on the slightest scrolling.  The page is essentially unusable.  (Viewed on an iPhone)
Sent from mobile

On 18. Jul 2019, at 08:19, Sandy Ginoza <sginoza@amsl.com<mailto:sginoza@amsl.com>> wrote:
Hi all,

As you know, the transition to XMLv3 is quickly approaching.  As part of our preparation, the RPC is  converting some XMLv2 files to XMLv3.  We’re hoping some of you will take the time to review the files and provide feedback regarding whether the updates are as expected and the XMLv3 files are considered “good” v3 files.

A couple of notes:
- we focused on format only; we did not make editorial updates.
- the diff files compare the initial v2v3 output with the files we edited.

Please review the following files:

1) draft-ietf-spring-segment-routing-msdc
https://www.ietf.org/id/draft-ietf-spring-segment-routing-msdc-11.txt<https://urldefense.proofpoint.com/v2/url?u=https-3A__www.ietf.org_id_draft-2Dietf-2Dspring-2Dsegment-2Drouting-2Dmsdc-2D11.txt&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=Kz8VdgPVctDNSNPJ6PsBaw&m=9F6plUiKuzdKkYlynsEEoyUDwrTW5_rvs7F0WXmFi6s&s=LsyTKYzz4LP8Dx4ezMRHnPAE4Qv2uGMM71UsEuuk0H0&e=>

https://www.rfc-editor.org/v3test/draft-ietf-spring-segment-routing-msdc-11-MS.v2v3.html<https://urldefense.proofpoint.com/v2/url?u=https-3A__www.rfc-2Deditor.org_v3test_draft-2Dietf-2Dspring-2Dsegment-2Drouting-2Dmsdc-2D11-2DMS.v2v3.html&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=Kz8VdgPVctDNSNPJ6PsBaw&m=9F6plUiKuzdKkYlynsEEoyUDwrTW5_rvs7F0WXmFi6s&s=-WRqBtwAdJYGxf0l-YTBkWkARB-E1CnDwg7f-zPsFMk&e=>
https://www.rfc-editor.org/v3test/draft-ietf-spring-segment-routing-msdc-11-MS.v2v3.pdf<https://urldefense.proofpoint.com/v2/url?u=https-3A__www.rfc-2Deditor.org_v3test_draft-2Dietf-2Dspring-2Dsegment-2Drouting-2Dmsdc-2D11-2DMS.v2v3.pdf&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=Kz8VdgPVctDNSNPJ6PsBaw&m=9F6plUiKuzdKkYlynsEEoyUDwrTW5_rvs7F0WXmFi6s&s=W0Dd3tX7V9LyXdyBxGdLtH5koLTtY3AYPMW_NikMui8&e=>
https://www.rfc-editor.org/v3test/draft-ietf-spring-segment-routing-msdc-11-MS.v2v3.txt<https://urldefense.proofpoint.com/v2/url?u=https-3A__www.rfc-2Deditor.org_v3test_draft-2Dietf-2Dspring-2Dsegment-2Drouting-2Dmsdc-2D11-2DMS.v2v3.txt&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=Kz8VdgPVctDNSNPJ6PsBaw&m=9F6plUiKuzdKkYlynsEEoyUDwrTW5_rvs7F0WXmFi6s&s=N0qQSrbTYAlA71nUcXrBBfQwbg6qo-UQOwGCgYxr1Fk&e=>
https://www.rfc-editor.org/v3test/draft-ietf-spring-segment-routing-msdc-11-MS.v2v3.xml<https://urldefense.proofpoint.com/v2/url?u=https-3A__www.rfc-2Deditor.org_v3test_draft-2Dietf-2Dspring-2Dsegment-2Drouting-2Dmsdc-2D11-2DMS.v2v3.xml&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=Kz8VdgPVctDNSNPJ6PsBaw&m=9F6plUiKuzdKkYlynsEEoyUDwrTW5_rvs7F0WXmFi6s&s=dO1wMk-7Ncz6UbzVaGQgO3UVZedckw7JQ3TRTwXi9wk&e=>

rfc-xmldiff:
https://www.rfc-editor.org/v3test/draft-ietf-spring-segment-routing-msdc-11-MS.v2v3-xmldiff.html<https://urldefense.proofpoint.com/v2/url?u=https-3A__www.rfc-2Deditor.org_v3test_draft-2Dietf-2Dspring-2Dsegment-2Drouting-2Dmsdc-2D11-2DMS.v2v3-2Dxmldiff.html&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=Kz8VdgPVctDNSNPJ6PsBaw&m=9F6plUiKuzdKkYlynsEEoyUDwrTW5_rvs7F0WXmFi6s&s=f0OgdiKGTEbieCpN6i-C3buQnZdbiSud2IUXPrsv7LY&e=>

htmlwdiff:
file:///Volumes/rfcpa/inc-work/v3test/draft-ietf-spring-segment-routing-msdc-11-MS.v2v3-htmlwdiff.html


2) draft-ietf-isis-l2bundles
https://www.ietf.org/id/draft-ietf-isis-l2bundles-07.txt<https://urldefense.proofpoint.com/v2/url?u=https-3A__www.ietf.org_id_draft-2Dietf-2Disis-2Dl2bundles-2D07.txt&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=Kz8VdgPVctDNSNPJ6PsBaw&m=9F6plUiKuzdKkYlynsEEoyUDwrTW5_rvs7F0WXmFi6s&s=YVa49hVTWLZy7TDaiT9O-eaWsMDJnJ1a4r9MQ2g2SbY&e=>

Please pay particular attention to lists and the use of <aside>.  We experimented with list styles and used <aside> for notes.  Using <aside> in this way required some changes because <aside> can’t be used within lists.

https://www.rfc-editor.org/v3test/draft-ietf-isis-l2bundles-07-SG.v2v3.html<https://urldefense.proofpoint.com/v2/url?u=https-3A__www.rfc-2Deditor.org_v3test_draft-2Dietf-2Disis-2Dl2bundles-2D07-2DSG.v2v3.html&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=Kz8VdgPVctDNSNPJ6PsBaw&m=9F6plUiKuzdKkYlynsEEoyUDwrTW5_rvs7F0WXmFi6s&s=3cT3G_0kZ-wZqV9r38COSms96pt5_nFdptcAEBqJXco&e=>
https://www.rfc-editor.org/v3test/draft-ietf-isis-l2bundles-07-SG.v2v3.pdf<https://urldefense.proofpoint.com/v2/url?u=https-3A__www.rfc-2Deditor.org_v3test_draft-2Dietf-2Disis-2Dl2bundles-2D07-2DSG.v2v3.pdf&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=Kz8VdgPVctDNSNPJ6PsBaw&m=9F6plUiKuzdKkYlynsEEoyUDwrTW5_rvs7F0WXmFi6s&s=Y3_JxLEEhlJSRVw14iB_K9dDytRYYsTM5fRdthMM9NM&e=>
https://www.rfc-editor.org/v3test/draft-ietf-isis-l2bundles-07-SG.v2v3.txt<https://urldefense.proofpoint.com/v2/url?u=https-3A__www.rfc-2Deditor.org_v3test_draft-2Dietf-2Disis-2Dl2bundles-2D07-2DSG.v2v3.txt&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=Kz8VdgPVctDNSNPJ6PsBaw&m=9F6plUiKuzdKkYlynsEEoyUDwrTW5_rvs7F0WXmFi6s&s=41bESquvtsFRher1ErgA8pdReP4UXO5A-MCElxDW73E&e=>
https://www.rfc-editor.org/v3test/draft-ietf-isis-l2bundles-07-SG.v2v3.xml<https://urldefense.proofpoint.com/v2/url?u=https-3A__www.rfc-2Deditor.org_v3test_draft-2Dietf-2Disis-2Dl2bundles-2D07-2DSG.v2v3.xml&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=Kz8VdgPVctDNSNPJ6PsBaw&m=9F6plUiKuzdKkYlynsEEoyUDwrTW5_rvs7F0WXmFi6s&s=8PlBWgpCZWxQ6UE5PjYDBvIawQYnHg9IZsaNpY18AqI&e=>

rfc-xmldiff:
https://www.rfc-editor.org/v3test/draft-ietf-isis-l2bundles-07-SG.orignal.v2v3-xmldiff.html<https://urldefense.proofpoint.com/v2/url?u=https-3A__www.rfc-2Deditor.org_v3test_draft-2Dietf-2Disis-2Dl2bundles-2D07-2DSG.orignal.v2v3-2Dxmldiff.html&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=Kz8VdgPVctDNSNPJ6PsBaw&m=9F6plUiKuzdKkYlynsEEoyUDwrTW5_rvs7F0WXmFi6s&s=s7meUAMFBJEIF8sQh2eII-VoBsVFcnxP3B7x3lk_Fv4&e=>

htmlwdiff:
https://www.rfc-editor.org/v3test/draft-ietf-isis-l2bundles-07-SG.orignal.v2v3-htmlwdiff.html<https://urldefense.proofpoint.com/v2/url?u=https-3A__www.rfc-2Deditor.org_v3test_draft-2Dietf-2Disis-2Dl2bundles-2D07-2DSG.orignal.v2v3-2Dhtmlwdiff.html&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=Kz8VdgPVctDNSNPJ6PsBaw&m=9F6plUiKuzdKkYlynsEEoyUDwrTW5_rvs7F0WXmFi6s&s=5fDGgpfsT0rUrIT7Llo3Dhtg_VvB79r4m1mrdG14wHM&e=>


Thanks for your help!
Sandy

_______________________________________________
xml2rfc-dev mailing list
xml2rfc-dev@ietf.org<mailto:xml2rfc-dev@ietf.org>
https://www.ietf.org/mailman/listinfo/xml2rfc-dev<https://urldefense.proofpoint.com/v2/url?u=https-3A__www.ietf.org_mailman_listinfo_xml2rfc-2Ddev&d=DwMFaQ&c=LFYZ-o9_HUMeMTSQicvjIg&r=Kz8VdgPVctDNSNPJ6PsBaw&m=9F6plUiKuzdKkYlynsEEoyUDwrTW5_rvs7F0WXmFi6s&s=eQewqycP3XwzILuUibgNdF-XGZSipYmtt4eZcNvVFXs&e=>

v2.23.0 | Report a Bug | By Email