[TOOLS-DEVELOPMENT] html-ized rfc output no longer uses <h1>, <h2>, etc

Jeff Martin <jeff.martin@comtechtel.com> Wed, 27 October 2021 15:08 UTC

Return-Path: <jeff.martin@comtechtel.com>
X-Original-To: tools-development@ietfa.amsl.com
Delivered-To: tools-development@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id B8B403A1014 for <tools-development@ietfa.amsl.com>; Wed, 27 Oct 2021 08:08:23 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.999
X-Spam-Level:
X-Spam-Status: No, score=-1.999 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, HTML_MESSAGE=0.001, HTTPS_HTTP_MISMATCH=0.1, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=comtechtel.com
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 SGmQ33adRWeB for <tools-development@ietfa.amsl.com>; Wed, 27 Oct 2021 08:08:19 -0700 (PDT)
Received: from GCC02-DM3-obe.outbound.protection.outlook.com (mail-dm3gcc02on20710.outbound.protection.outlook.com [IPv6:2a01:111:f400:7d04::710]) (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 2DD043A0FB6 for <tools-development@ietf.org>; Wed, 27 Oct 2021 08:08:19 -0700 (PDT)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=hj/MlZ3I4BoZJ57xTX+8Hl0j6vP262GCf8ZS+AE4zNeR/CocParXBQbOLXpkQfZZvdJQXg+cRctU4uYBWPlo2xGgvwOXZbaq3S/7NWBNYHkvrtNYQYkPBcS74W5ZpEnZdgvUo8VyG5y6SkWrVM67FzeZzcPf0ZVDkML7iWFuWO3JMFBhPCWHPUFyWihTQDt6SgRIPh6V3FjuekdaKLjFB8Eqxs/EoroPfUs41yNsjMsOZEAFNLIeQEElvX6yDVrliEkypOX1KUCxFKhAcMt+OkMvvPp3aGJiBapogM8tn8Cd5h8rBE8eg9IIHC6mmoQxXVrI7B4kC4zKP3JDZinzHw==
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-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=syS9Hlj7WDbS0fUB6179HVRckfcEX8QwuPux6mXrkLE=; b=dtrU4wlLHsD1ULL4dYmF+RuypEzABHr1W8eCtB46gUN/TzTNITa1KR2ubijJT69BepRXxHkkJfXjO37sQP+b5hQ/9eK2eQG3X5dAGhJj4KtQU/Ha6Eo/TrmrlmE725EC/R1NmLxrSvJlfqcXSVgyv+1YZ6FtllDnbt4yw1UgmRMHKHfPv/VrTiBlA+BKv2+kvVMQF0psbjEs8X4ciJd+/bQQ38FNG7Aq++asI+ZDVCwqtzCfCxO7jnH3FGnY072h1ZbFnq0l1nare6/rgFcYQFEftbvVoVwNifi+pCm1QHGQ4SE8+54J/xfWLNhzB7llipETUFf5qbYx9ikq0Gi5jw==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=comtechtel.com; dmarc=pass action=none header.from=comtechtel.com; dkim=pass header.d=comtechtel.com; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=comtechtel.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=syS9Hlj7WDbS0fUB6179HVRckfcEX8QwuPux6mXrkLE=; b=IMUPn2ETLnH40GtmSvSPQFJ64JtaeBoQAWB9ZzfkchWD7SY5zD9Q+1ggfkAmuSh2MZQDVn/R4LovH+mtomVJ9k7usUODUmRI4QYzCx+YfkWR5uluO7GrlrHBuN5oQEu5JYzNMhcSPTH0b8PIqBcM5MyE1/shTJI0eMMBdTVKnL5lu7yD3c5QEm3o++ZIx3+CPxOYodpDzVxXusZtluBEklBZ2yCJmcBu/mfw+uNA4NwMgmYtwshK401tmLti3EjNFlSwVJH5EUIrdHVkSUBsSoeLU9hs5fxJ0jRg1xJehflgNI4t6uOSTV13WDcCXLnsljEvABGU/5R3flfNRAU4Tg==
Received: from CO6PR09MB8600.namprd09.prod.outlook.com (2603:10b6:303:d3::6) by CO6PR09MB8822.namprd09.prod.outlook.com (2603:10b6:303:d0::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4649.15; Wed, 27 Oct 2021 15:08:10 +0000
Received: from CO6PR09MB8600.namprd09.prod.outlook.com ([fe80::ede7:aed6:4c3:ecdf]) by CO6PR09MB8600.namprd09.prod.outlook.com ([fe80::ede7:aed6:4c3:ecdf%7]) with mapi id 15.20.4649.015; Wed, 27 Oct 2021 15:08:10 +0000
From: Jeff Martin <jeff.martin@comtechtel.com>
To: "tools-development@ietf.org" <tools-development@ietf.org>
Thread-Topic: html-ized rfc output no longer uses <h1>, <h2>, etc
Thread-Index: AdfLQ0Ne/w0c3V0tT1y3ighQQ/We3w==
Date: Wed, 27 Oct 2021 15:08:10 +0000
Message-ID: <CO6PR09MB86005E364506EAC5365EFFCB9F859@CO6PR09MB8600.namprd09.prod.outlook.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
authentication-results: ietf.org; dkim=none (message not signed) header.d=none;ietf.org; dmarc=none action=none header.from=comtechtel.com;
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: bab645e9-519e-4b63-ca96-08d9995b9701
x-ms-traffictypediagnostic: CO6PR09MB8822:
x-microsoft-antispam-prvs: <CO6PR09MB88223F034C143D040B0B28D89F859@CO6PR09MB8822.namprd09.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:9508;
x-ms-exchange-senderadcheck: 1
x-ms-exchange-antispam-relay: 0
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: bDA3e1Ej9r2M4Pa8yN+4c/Db+jlrep/++b/Um2POvAJ3Gyenxu8TLgML47Rmi8PAYOj8V6sKpcwVxXcRi/b2Wkdr25MUk1+7lG9lnLB8bF/EpoCMNoqyBIFRu8xzTuExdKYTLK6eRihaKdCCW7aC21m9Ppmvf9IJ5GwBabM/wF/gqU8zozQpcgZLelqVmSV4tyl5c3w4FLGXIhjV3fVVBmGoT7eCh/sQl31mbUrVq9t8yja7B3mNQ2dyWA4AUEWyjBPtiTC5zMwwzQ389rBBK8ejST194ij3a9fzZpsvVDhvOiPKV+0+PS7cfO1I+jn7QyZFrgGVCbLje03lme85YAaxx2Trgwfmd9FgUeJ/vzvIPXirwhEixbi8Jlp/MtT23nl3MDQJ9/BbZtP0ghdYOkk2IZ8IUbDDcxiKwdtzIBaqYVFJJxBWsrr0zHHbu4xhKhuGBN3d4CPe9b0kPl7XT/KnF/tn6Xcic9HuQxYdryZuE8tkxZCxlCb1CP6CIUdPZ3QZBEVFSnbru7LWVrEJ3MhQx8ahwJdIYWMwrBiPXY1vBWFKBw8RTf1hYFibXdRGJYqlI5TwHcQ6mtw/R8kYT77tYBfLqfcJJqv716OjRGXWY2Qn/xfKHvQ3/p/yq+psZ/S+qKBSCB6fKsal+y+mthX699Yzk53mM2GFpY22E3xwl3fZNfc6GI/4lN2A4XXbQclbup9ms5gRRRKVGrkCheCfGBp0DhKv4Cf+DDII1z3ldzH3pN/lqDtegZrgWERd0j+w60llnrxGiaShtC7P7w==
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:CO6PR09MB8600.namprd09.prod.outlook.com; PTR:; CAT:NONE; SFS:(4636009)(366004)(8676002)(8936002)(66946007)(71200400001)(66446008)(66556008)(64756008)(66476007)(6506007)(7696005)(76116006)(166002)(38070700005)(86362001)(508600001)(122000001)(83380400001)(38100700002)(52536014)(44832011)(33656002)(9686003)(55016002)(316002)(26005)(966005)(186003)(6916009)(5660300002)(2906002); DIR:OUT; SFP:1102;
x-ms-exchange-antispam-messagedata-chunkcount: 1
x-ms-exchange-antispam-messagedata-0: xUjV8wEs+OGUcnsIHgmaJb6tJLtjGJgUDemGSiRM04M3wYIRBxRniL7t/S56XdeCXAMc94ECIYk+hsl1KmLaZfXIEapf3gzUaYTR0EXkIWHBm2CFYg3RyNJIS2NHnyRIk+yW6hCDP2DUMRzVXeluTk8f6b8qjKBYb+jLZyrK1zBkcHluh8BrS8JoMQ2nm17Itn1HOvHHQ7jgIT4njHTK6GuiwByLXnQqR/gVR5hwFhvnVUcXEGP3QzVuLg3nFdQZw+qcCBzdHH5F1V/+7K9MLAlYeCrNliqs2zFWRwjO84az5ZTuo3IJdkrAsW4K8rTPFskX9n+FKdPia3ImuWEpS5mY2ytDMM6IC2dl9N9rrsAtoAfZDzHn+M0iMkCunpmudgQAWytdlAzM8n3ddOnPQ2ncWSZ4MxJIPzrJWeHqHyDBMamkVPo3P4CXWHsHnaSx2pr3M9Gv31d/CcFUfSUC/LyqegRBmnKTCwGnF3lcHg+HCPHJLAaCMfzc8YjRBzbFGGPS4dBn/odTmap2lULKYIrVTiFx9xrUgEwIl5FhPRgnzBKe2m7XGd2PTYLwD33ADZqtVTJ8FeE3WWlZirtyL6paxUgoN29uXayoDSNuBueXTs0rTKBHBD9QVcdoVqqSp71OiILJGrPX9Q6QK9RsLMePuGN9F1/G5bFxiM/O+OzTmE/V6ZV0ofqb3QhXkIMckFD1/THbYyR8N9hbbUYFmHtyCg80XsEyxxmsfpr5mQLxrg5J3KRvSkPnJMgJM3ihFt28IhW6FXZVzwxy1YLJQlajOqSMimU7fN9wUvKOaoajLqL8a6e9o5haZl8gQfjGaQTDMI+WSNbc7Lqhn9vBR0Co83Yfs76nzR+DWy1MG75NLU+LZ34VTTFmbpZmnbXcOYLnipPQpKIKMdSkUcocY3CwQb/+BP89Si/W+EeQCe8qFUeNmkdf4zyDFAgIYx3WXxw5khFiYYuKLxTKVntfSv6CxIzVja2foXAynS4jYGOrB3Z9YjKsnI2F6pHRPza9K/rSWaimnCbmkbF8SiPwEabdm6rqxFrcc3KaKbCLHrI1DAXwVXgb7C0vmrEjYIA40fOhUvkKpyaM7puCyImRtKt88a57es1Jlbk1+BiIpOMYaJfhsEOWjzu3evhiCqa0MFKVttt+TLvd6oxLvmXgCFtdA+bcf4MOFlbjaC+RBRnuNy6VpuybFyTQTdNz+hO2ENC9MEBc5rYeIixC8xwEWRKYWskcPPObOQNYDvrtLsDSIalHjgn3hNUFY/LLG0K+D1xR+S0EDEOZkbS/qYDYXn0mP6mg0Ks1N51SxcNfAAFOHidCByLW6vYzaSjBWqQx
Content-Type: multipart/alternative; boundary="_000_CO6PR09MB86005E364506EAC5365EFFCB9F859CO6PR09MB8600namp_"
MIME-Version: 1.0
X-OriginatorOrg: comtechtel.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: CO6PR09MB8600.namprd09.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: bab645e9-519e-4b63-ca96-08d9995b9701
X-MS-Exchange-CrossTenant-originalarrivaltime: 27 Oct 2021 15:08:10.2006 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: a9a26e69-6ae0-40c1-bd80-1ca6cc677828
X-MS-Exchange-Transport-CrossTenantHeadersStamped: CO6PR09MB8822
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-development/r5Y7TFMYpfCBuRFwSbRBFKvUqwQ>
Subject: [TOOLS-DEVELOPMENT] html-ized rfc output no longer uses <h1>, <h2>, etc
X-BeenThere: tools-development@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Tools Development mail list <tools-development.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tools-development>, <mailto:tools-development-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tools-development/>
List-Post: <mailto:tools-development@ietf.org>
List-Help: <mailto:tools-development-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tools-development>, <mailto:tools-development-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 27 Oct 2021 15:08:24 -0000

Recently (May?) links like https://tools.ietf.org/html/rfc3261<https://gcc02.safelinks.protection.outlook.com/?url=https%3A%2F%2Ftools.ietf.org%2Fhtml%2Frfc3261&data=04%7C01%7Cjeff.martin%40comtechtel.com%7C2d032f16e2af40b7f55408d95091c907%7Ca9a26e696ae040c1bd801ca6cc677828%7C0%7C0%7C637629409329811014%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=hRiDZYhy2IH9N%2BNEfkrvN4BBlzLFrXueEzGgQrQbMbg%3D&reserved=0> started redirecting to https://datatracker.ietf.org/doc/html/rfc3261<https://gcc02.safelinks.protection.outlook.com/?url=https%3A%2F%2Fdatatracker.ietf.org%2Fdoc%2Fhtml%2Frfc3261&data=04%7C01%7Cjeff.martin%40comtechtel.com%7C2d032f16e2af40b7f55408d95091c907%7Ca9a26e696ae040c1bd801ca6cc677828%7C0%7C0%7C637629409329820971%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=Xip6tZi87MwHQEAwib8laAbfB5%2FqfuSpexER9gLuP1Y%3D&reserved=0>

The html-ized output is changed at this new location.   Prior to the May change, headings in the html used <h1>, <h2>, etc tags, as seen in this Wayback machine capture from April 29, 2021<https://web.archive.org/web/20210429024904/https:/tools.ietf.org/html/rfc3261>
<span class="h2"><h2><a class="selflink" name="section-1" href="#section-1">1</a>Introduction</h2></span>
Since May, the html no longer includes the <h2> elements, so now like the html looks like this:
<span class="h2">    <a class="selflink" id="section-1"   href="#section-1">1</a>Introduction     </span>

Visually there is no significant change.   However, removing the <h2> (and similar) HTML heading markup makes it harder for machine tools to deduce the structure of the page.  In particular I use a bookmarklet https://earshinov.github.io/tocit/<https://gcc02.safelinks.protection.outlook.com/?url=https%3A%2F%2Fearshinov.github.io%2Ftocit%2F&data=04%7C01%7Cjeff.martin%40comtechtel.com%7C2d032f16e2af40b7f55408d95091c907%7Ca9a26e696ae040c1bd801ca6cc677828%7C0%7C0%7C637629409329830928%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=kL9P60EEWu7I98XqqK73ty2EYdQWiVHVzx9uIwrOr0k%3D&reserved=0> to generate an interactive table of contents, which relies on <h1>, <h2>, and similar.  This removal of <h1> etc tags probably also affects "screen readers" used by people with visual impairments.

I'd like to suggest restoring use of HTML headings like <h1>, <h2>, etc to the html-ized output.  Is there a process I should follow for making this suggestion?

/Jeff/



NOTICE TO RECIPIENT: This email, including attachments, may contain information which is confidential, proprietary, attorney-client privileged and / or controlled under U.S. export laws and regulations and may be restricted from disclosure by applicable State and Federal law. Nothing in this email shall create any legal binding agreement between the parties unless expressly stated herein and provided by an authorized representative of Comtech Telecommunications Corp. or its subsidiaries. If you are not the intended recipient of this message, be advised that any dissemination, distribution, or use of the contents of this message is strictly prohibited. If you received this message in error, please notify us immediately by return email and permanently delete all copies of the original email and any attached documentation from any computer or other media.