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

Sandy Ginoza <sginoza@amsl.com> Tue, 13 August 2019 21:24 UTC

Return-Path: <sginoza@amsl.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 DBF801208E6 for <xml2rfc-dev@ietfa.amsl.com>; Tue, 13 Aug 2019 14:24:36 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.199
X-Spam-Level:
X-Spam-Status: No, score=-4.199 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, HTML_MESSAGE=0.001, 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 0aKpILozBChO for <xml2rfc-dev@ietfa.amsl.com>; Tue, 13 Aug 2019 14:24:33 -0700 (PDT)
Received: from mail.amsl.com (c8a.amsl.com [4.31.198.40]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 6BC981208C2 for <xml2rfc-dev@ietf.org>; Tue, 13 Aug 2019 14:24:33 -0700 (PDT)
Received: from localhost (localhost [127.0.0.1]) by c8a.amsl.com (Postfix) with ESMTP id 917AC1C1075; Tue, 13 Aug 2019 14:24:29 -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 vl8PS5vybhKb; Tue, 13 Aug 2019 14:24:29 -0700 (PDT)
Received: from [IPv6:2605:e000:1524:de:70e7:b623:5adb:3c2d] (unknown [IPv6:2605:e000:1524:de:70e7:b623:5adb:3c2d]) by c8a.amsl.com (Postfix) with ESMTPSA id 4713C1C1074; Tue, 13 Aug 2019 14:24:29 -0700 (PDT)
From: Sandy Ginoza <sginoza@amsl.com>
Message-Id: <F39EC291-7E37-49B4-831D-34BC42BBF092@amsl.com>
Content-Type: multipart/alternative; boundary="Apple-Mail=_1BB1AB18-0ADD-454D-892A-31740A2E3E38"
Mime-Version: 1.0 (Mac OS X Mail 10.3 \(3273\))
Date: Tue, 13 Aug 2019 14:24:31 -0700
In-Reply-To: <3FA7D490-1D84-4E70-B3D0-997F3AF4F2C5@tzi.org>
Cc: xml2rfc-dev@ietf.org, RFC Editor <rfc-editor@rfc-editor.org>
To: Carsten Bormann <cabo@tzi.org>
References: <62908E23-2FC0-4ED7-84B2-E86454020206@amsl.com> <3FA7D490-1D84-4E70-B3D0-997F3AF4F2C5@tzi.org>
X-Mailer: Apple Mail (2.3273)
Archived-At: <https://mailarchive.ietf.org/arch/msg/xml2rfc-dev/KdauE1MOy4TEYGwSYtMFSZUpkZI>
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 21:24:37 -0000

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://www.rfc-editor.org/v3test/draft-ietf-isis-l2bundles-07-SG.v2v3.v24.html> 

https://www.rfc-editor.org/v3test/draft-ietf-spring-segment-routing-msdc-11-MS.v2v3.v24.html <https://www.rfc-editor.org/v3test/draft-ietf-spring-segment-routing-msdc-11-MS.v2v3.v24.html> 

https://www.rfc-editor.org/v3test/draft-ietf-avtcore-rtp-multi-stream-optimisation-12-KC.v2v3.v24.html <https://www.rfc-editor.org/v3test/draft-ietf-avtcore-rtp-multi-stream-optimisation-12-KC.v2v3.v24.html>

https://www.rfc-editor.org/v3test/draft-ietf-roll-efficient-npdao-15-RE.v2v3.v24.html <https://www.rfc-editor.org/v3test/draft-ietf-roll-efficient-npdao-15-RE.v2v3.v24.html>

https://www.rfc-editor.org/v3test/draft-ietf-sipcore-rejected-09-LB.v2v3.v24.html <https://www.rfc-editor.org/v3test/draft-ietf-sipcore-rejected-09-LB.v2v3.v24.html> 

https://www.rfc-editor.org/v3test/draft-ietf-lamps-pkix-shake-15-RV.v2v3.v24.html <https://www.rfc-editor.org/v3test/draft-ietf-lamps-pkix-shake-15-RV.v2v3.v24.html> 

https://www.rfc-editor.org/v3test/draft-ietf-lisp-introduction-13-MS.v2v3.v24.html <https://www.rfc-editor.org/v3test/draft-ietf-lisp-introduction-13-MS.v2v3.v24.html> 

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> 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://www.ietf.org/id/draft-ietf-spring-segment-routing-msdc-11.txt>
>> 
>> https://www.rfc-editor.org/v3test/draft-ietf-spring-segment-routing-msdc-11-MS.v2v3.html <https://www.rfc-editor.org/v3test/draft-ietf-spring-segment-routing-msdc-11-MS.v2v3.html>
>> https://www.rfc-editor.org/v3test/draft-ietf-spring-segment-routing-msdc-11-MS.v2v3.pdf <https://www.rfc-editor.org/v3test/draft-ietf-spring-segment-routing-msdc-11-MS.v2v3.pdf>
>> https://www.rfc-editor.org/v3test/draft-ietf-spring-segment-routing-msdc-11-MS.v2v3.txt <https://www.rfc-editor.org/v3test/draft-ietf-spring-segment-routing-msdc-11-MS.v2v3.txt>
>> https://www.rfc-editor.org/v3test/draft-ietf-spring-segment-routing-msdc-11-MS.v2v3.xml <https://www.rfc-editor.org/v3test/draft-ietf-spring-segment-routing-msdc-11-MS.v2v3.xml>
>> 
>> rfc-xmldiff:
>> https://www.rfc-editor.org/v3test/draft-ietf-spring-segment-routing-msdc-11-MS.v2v3-xmldiff.html <https://www.rfc-editor.org/v3test/draft-ietf-spring-segment-routing-msdc-11-MS.v2v3-xmldiff.html>
>> 
>> 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://www.ietf.org/id/draft-ietf-isis-l2bundles-07.txt>
>> 
>> 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://www.rfc-editor.org/v3test/draft-ietf-isis-l2bundles-07-SG.v2v3.html>
>> https://www.rfc-editor.org/v3test/draft-ietf-isis-l2bundles-07-SG.v2v3.pdf <https://www.rfc-editor.org/v3test/draft-ietf-isis-l2bundles-07-SG.v2v3.pdf>
>> https://www.rfc-editor.org/v3test/draft-ietf-isis-l2bundles-07-SG.v2v3.txt <https://www.rfc-editor.org/v3test/draft-ietf-isis-l2bundles-07-SG.v2v3.txt>
>> https://www.rfc-editor.org/v3test/draft-ietf-isis-l2bundles-07-SG.v2v3.xml <https://www.rfc-editor.org/v3test/draft-ietf-isis-l2bundles-07-SG.v2v3.xml>
>> 
>> rfc-xmldiff:
>> https://www.rfc-editor.org/v3test/draft-ietf-isis-l2bundles-07-SG.orignal.v2v3-xmldiff.html <https://www.rfc-editor.org/v3test/draft-ietf-isis-l2bundles-07-SG.orignal.v2v3-xmldiff.html>
>> 
>> htmlwdiff:
>> https://www.rfc-editor.org/v3test/draft-ietf-isis-l2bundles-07-SG.orignal.v2v3-htmlwdiff.html <https://www.rfc-editor.org/v3test/draft-ietf-isis-l2bundles-07-SG.orignal.v2v3-htmlwdiff.html>
>> 
>> 
>> 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://www.ietf.org/mailman/listinfo/xml2rfc-dev>
>> 
>>