Re: [xml2rfc] HTMLized format has changed!

Paul Kyzivat <pkyzivat@alum.mit.edu> Tue, 02 February 2021 17:03 UTC

Return-Path: <pkyzivat@alum.mit.edu>
X-Original-To: xml2rfc@ietfa.amsl.com
Delivered-To: xml2rfc@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 8F8653A0C38 for <xml2rfc@ietfa.amsl.com>; Tue, 2 Feb 2021 09:03:44 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.002
X-Spam-Level:
X-Spam-Status: No, score=-2.002 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, NICE_REPLY_A=-0.001, RCVD_IN_MSPIKE_H2=-0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=alum.mit.edu
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 OlE4YsJZEW7p for <xml2rfc@ietfa.amsl.com>; Tue, 2 Feb 2021 09:03:42 -0800 (PST)
Received: from NAM11-DM6-obe.outbound.protection.outlook.com (mail-dm6nam11on2044.outbound.protection.outlook.com [40.107.223.44]) (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 BB11D3A0C31 for <xml2rfc@ietf.org>; Tue, 2 Feb 2021 09:03:42 -0800 (PST)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=gTGJamIxqq5MuFYJfyBCv/bTNJ7QVfTwjD1CNF3TZtAUfAuvM3MN/Z8lJQ4clmV4i2Rz1uRRssgjOGSvK9mR53DUPmHa4bwr2uNxC0Y2AwMLCiBiOcuW7WN+vRPZQhdC73Rl+ywtMi8Dgo6wewYd6nJKLM4uMz0vjBmCZaVOzTi99tUsSoovzQMqnpjJpECvE3TMiKKw7YSz9+3snJxyIdu6NYXfTR9SABIv7ZRjMNNjjGs3S3621P9Bk4CPKG/50fSXYUU7eBFcTHUdLOcnCST+mrFUsXQJBgxB0DVw/Wsr9ejC1VGEJc7lm6+KZCzGqKXV5GplXwhcUaiEcYNUGg==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=vkvRtDxphegXiBBUp+xcI+fZjy5WNOvICygJL1bJc7A=; b=kZDZ4k9mY9H+CrBLa+3BUYjuYe6giLwlS//rSU17kZukDcBcgZzOlwvfFF5mzQxqmV2ehlYo0IoGM6oTICb9dlcodec3PDQIDvYQWOBG3K+djS7urkB+AgRMMRCsCYetFqrlUIITRV/0L2E48wGHfXvgmZ1+80XnQ66x7c69FHLtYUrNi2K9xd1Te+8vsBhuX2x966ghaiIp8uBex7rW5ypUByz+LmSxe+Pg1orpOnx8mfdzSnHn0aPtKTaQ28s8MjSlQZsh4bcTlVByjCI8rPJ24s4eus5Wurkwcmx83Y0A8ybye1e+nLTRV/7qDLWrs3VAGHjn4WtIhk3dRfC7mA==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 18.7.68.33) smtp.rcpttodomain=tzi.org smtp.mailfrom=alum.mit.edu; dmarc=bestguesspass action=none header.from=alum.mit.edu; dkim=none (message not signed); arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=alum.mit.edu; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=vkvRtDxphegXiBBUp+xcI+fZjy5WNOvICygJL1bJc7A=; b=cnOhJb9w9qOWSFyXT/M15U283CdZ83W+NMO5SCbHPcNmW1pmalQkvlxHsgjqp7hlfTQ1IBzv0qCEerpArlkzpIyt959A2d/uaJNFsnJtldGCDdNzEomEgdcLKdu7+/EiP9XGaK8E/DvPhyevK7fOxA/J8JqpJP3QoOOjZZQ/G4M=
Received: from SA9PR11CA0019.namprd11.prod.outlook.com (2603:10b6:806:6e::24) by MWHPR12MB1453.namprd12.prod.outlook.com (2603:10b6:301:e::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3805.17; Tue, 2 Feb 2021 17:03:38 +0000
Received: from SN1NAM02FT023.eop-nam02.prod.protection.outlook.com (2603:10b6:806:6e:cafe::12) by SA9PR11CA0019.outlook.office365.com (2603:10b6:806:6e::24) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3805.17 via Frontend Transport; Tue, 2 Feb 2021 17:03:38 +0000
X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 18.7.68.33) smtp.mailfrom=alum.mit.edu; tzi.org; dkim=none (message not signed) header.d=none;tzi.org; dmarc=bestguesspass action=none header.from=alum.mit.edu;
Received-SPF: Pass (protection.outlook.com: domain of alum.mit.edu designates 18.7.68.33 as permitted sender) receiver=protection.outlook.com; client-ip=18.7.68.33; helo=outgoing-alum.mit.edu;
Received: from outgoing-alum.mit.edu (18.7.68.33) by SN1NAM02FT023.mail.protection.outlook.com (10.152.72.156) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3784.12 via Frontend Transport; Tue, 2 Feb 2021 17:03:36 +0000
Received: from MacBook-Air.localdomain (c-24-62-227-142.hsd1.ma.comcast.net [24.62.227.142]) (authenticated bits=0) (User authenticated as pkyzivat@ALUM.MIT.EDU) by outgoing-alum.mit.edu (8.14.7/8.12.4) with ESMTP id 112H3YZK022085 (version=TLSv1/SSLv3 cipher=AES128-GCM-SHA256 bits=128 verify=NOT); Tue, 2 Feb 2021 12:03:34 -0500
To: Carsten Bormann <cabo@tzi.org>
Cc: XML2RFC Interest Group <xml2rfc@ietf.org>
References: <14327135-76c7-98c4-023b-a47991d1cc2d@alum.mit.edu> <900B2645-6BE6-482F-AF35-6B8DBA1D4D74@tzi.org>
From: Paul Kyzivat <pkyzivat@alum.mit.edu>
Message-ID: <52c3cb89-c6bd-2711-9bab-3935ab29b5d8@alum.mit.edu>
Date: Tue, 2 Feb 2021 12:03:34 -0500
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.16; rv:78.0) Gecko/20100101 Thunderbird/78.7.0
MIME-Version: 1.0
In-Reply-To: <900B2645-6BE6-482F-AF35-6B8DBA1D4D74@tzi.org>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Language: en-US
Content-Transfer-Encoding: 8bit
X-EOPAttributedMessage: 0
X-MS-PublicTrafficType: Email
X-MS-Office365-Filtering-Correlation-Id: 10916ffb-16e1-4924-5184-08d8c79c7b26
X-MS-TrafficTypeDiagnostic: MWHPR12MB1453:
X-LD-Processed: 3326b102-c043-408b-a990-b89e477d582f,ExtAddr,ExtFwd
X-MS-Exchange-Transport-Forked: True
X-Microsoft-Antispam-PRVS: <MWHPR12MB14538432B727291386D6F967F9B59@MWHPR12MB1453.namprd12.prod.outlook.com>
X-MS-Oob-TLC-OOBClassifiers: OLM:10000;
X-MS-Exchange-SenderADCheck: 1
X-Microsoft-Antispam: BCL:0;
X-Microsoft-Antispam-Message-Info: Vn7G0dWaD7gssYjzxuNq23ZObDi5xVaLrb1Nhzf8d457z8EnPRLPiA/jnSXqlVHpCFdUDHWxiuvrQ3LkW69o9VuGzhWKHude4aLwvAT0fgR/9GwH0jcGTHp+Wmp5/B45PiRAJMPtfjRLKEQcYPUkygeFz+gNuFH/F6QbMp7SzYvOcXTtWX8UOOjaHO5DYU3KnlvPgw+TNr5/U45jZ+5Luu9PBzmQSNS6JVpJb/E/Tmsg0EAFLsRIxUtLoJdiBjA3hEdmmp+p4jwVRALnbWrqPaV3oetsqY0MAltLO16d8KfK0pcUSG0uUil6CEUfJkh3ddK4vksvMKdyDrl8zygCeh+OoxQGICKENuFKDvylxDpRWZTpa98K3t2Lab7TbUImqOTf1YSMobNsUfho+qyji5gK2IJ01vgls/PBeDrZXXnVgh/RwUfYtFPum7on3/naYxpYACBl2npoGqzX4m5fQGjrqUjYQy/10Q1a5CcKsQZExswKH9q43JoGBtRSCZHPUkt3CgIxliqGxha9uN+LFZNOVEbLQYbWcn8fNtuU5VYRqvw/bZy3jumBaZ2ZBE2PjShFG4QnhMOmkLp2q1mClAM8prhWa9ywgrIvFa+iIiT1TkpeUtnoJhkiHfJ1DZ4Eeb6wHPNbQwjnsz3XGsf1GdZrmLzIeLj8Wh1Db2bU/yzVgt6GHHB1scwh4LPb7lM1sLv+lNTYTokaaPlWmc7aS41az3CjqwRtKYTw99iCu8tGMWodAqpesV/jOdhYzAu3
X-Forefront-Antispam-Report: CIP:18.7.68.33; CTRY:US; LANG:en; SCL:1; SRV:; IPV:CAL; SFV:NSPM; H:outgoing-alum.mit.edu; PTR:outgoing-alum.mit.edu; CAT:NONE; SFS:(396003)(346002)(376002)(39860400002)(136003)(36840700001)(46966006)(47076005)(70206006)(83380400001)(70586007)(186003)(8676002)(82740400003)(336012)(26005)(956004)(2616005)(2906002)(7596003)(356005)(82310400003)(86362001)(36906005)(966005)(8936002)(31696002)(478600001)(786003)(316002)(6916009)(31686004)(53546011)(75432002)(5660300002)(36860700001)(4326008)(43740500002); DIR:OUT; SFP:1101;
X-OriginatorOrg: alum.mit.edu
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 02 Feb 2021 17:03:36.5838 (UTC)
X-MS-Exchange-CrossTenant-Network-Message-Id: 10916ffb-16e1-4924-5184-08d8c79c7b26
X-MS-Exchange-CrossTenant-Id: 3326b102-c043-408b-a990-b89e477d582f
X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=3326b102-c043-408b-a990-b89e477d582f; Ip=[18.7.68.33]; Helo=[outgoing-alum.mit.edu]
X-MS-Exchange-CrossTenant-AuthSource: SN1NAM02FT023.eop-nam02.prod.protection.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Anonymous
X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem
X-MS-Exchange-Transport-CrossTenantHeadersStamped: MWHPR12MB1453
Archived-At: <https://mailarchive.ietf.org/arch/msg/xml2rfc/lxrDeUnwx6x_g95VlMUV02O1JVI>
Subject: Re: [xml2rfc] HTMLized format has changed!
X-BeenThere: xml2rfc@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: <xml2rfc.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/xml2rfc>, <mailto:xml2rfc-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/xml2rfc/>
List-Post: <mailto:xml2rfc@ietf.org>
List-Help: <mailto:xml2rfc-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/xml2rfc>, <mailto:xml2rfc-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 02 Feb 2021 17:03:45 -0000

On 2/1/21 7:24 PM, Carsten Bormann wrote:
> On 2021-02-02, at 00:35, Paul Kyzivat <pkyzivat@alum.mit.edu> wrote:
>>
>> I notice today that HTMLized format has degraded from what it used to be. (I noticed this with https://tools.ietf.org/html/rfc8866.) I haven't extensively studied it, but what I notice is that the TOC is no longer hot linked to the corresponding sections of the text.
> 
> The TOC detector of the HTMLizer was killed by removing the page numbers from V3 .TXT RFCs.  So you will see this from RFC8650 onward.

I can see how that could happen. But of course the TOC is still there, 
just without page numbers, and linkage to the sections is still useful.

>> Is this an accident? Can it please be fixed?
> 
> It is a “small matter of programming” :-)
> But there is the cognitive dissonance of fixing an htmlizer when V3 has such a wonderful .HTML output.

I do like the new html output, and I preferentially use it when just 
reading or consulting a document. But when I am reviewing document 
changes, using the rfcdiff tool that works on txt format, and I need to 
consult more of the document to understand one of the changes I want to 
look at a version that matches the txt format line-for-line. Of course I 
could just look at the txt version, but it is harder to navigate. Using 
an HTMLized version with TOC links is ideal for this.

Also, I'll often start on a document from the HTMLized version because 
it has links at the top to all useful formats as well as the diffs. The 
new HTMLized version is also deficient in this regard because it doesn't 
have links to the diffs.

(A one click reference to the diffs is very convenient in contrast to 
using the rfcdiff home page and filling in the names of the docs to be 
compared.)

	Thanks,
	Paul