[rfc-i] Accessibility of RFC HTML
Martin Thomson <mt@lowentropy.net> Wed, 13 January 2021 06:10 UTC
Return-Path: <rfc-interest-bounces@rfc-editor.org>
X-Original-To: ietfarch-rfc-interest-archive@ietfa.amsl.com
Delivered-To: ietfarch-rfc-interest-archive@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 10F723A0BF6; Tue, 12 Jan 2021 22:10:05 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.452
X-Spam-Level:
X-Spam-Status: No, score=-2.452 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_INVALID=0.1, DKIM_SIGNED=0.1, HEADER_FROM_DIFFERENT_DOMAINS=0.248, MAILING_LIST_MULTI=-1, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=fail (2048-bit key) reason="fail (message has been altered)" header.d=lowentropy.net header.b=ZsadYcvB; dkim=fail (2048-bit key) reason="fail (message has been altered)" header.d=messagingengine.com header.b=qYbWfoex
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 sO6B6LE9yY88; Tue, 12 Jan 2021 22:10:02 -0800 (PST)
Received: from rfc-editor.org (rfc-editor.org [4.31.198.49]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id CDB1D3A0BF2; Tue, 12 Jan 2021 22:10:02 -0800 (PST)
Received: from rfcpa.amsl.com (localhost [IPv6:::1]) by rfc-editor.org (Postfix) with ESMTP id 1AC78F40738; Tue, 12 Jan 2021 22:09:52 -0800 (PST)
X-Original-To: rfc-interest@rfc-editor.org
Delivered-To: rfc-interest@rfc-editor.org
Received: from localhost (localhost [127.0.0.1]) by rfc-editor.org (Postfix) with ESMTP id 0122BF40738 for <rfc-interest@rfc-editor.org>; Tue, 12 Jan 2021 22:09:51 -0800 (PST)
X-Virus-Scanned: amavisd-new at rfc-editor.org
Authentication-Results: rfcpa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=lowentropy.net header.b=ZsadYcvB; dkim=pass (2048-bit key) header.d=messagingengine.com header.b=qYbWfoex
Received: from rfc-editor.org ([127.0.0.1]) by localhost (rfcpa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id Eyaytqzu94_w for <rfc-interest@rfc-editor.org>; Tue, 12 Jan 2021 22:09:46 -0800 (PST)
Received: from out5-smtp.messagingengine.com (out5-smtp.messagingengine.com [66.111.4.29]) by rfc-editor.org (Postfix) with ESMTPS id 2D08CF4072C for <rfc-interest@rfc-editor.org>; Tue, 12 Jan 2021 22:09:45 -0800 (PST)
Received: from compute1.internal (compute1.nyi.internal [10.202.2.41]) by mailout.nyi.internal (Postfix) with ESMTP id 8D9485C0571 for <rfc-interest@rfc-editor.org>; Wed, 13 Jan 2021 01:09:54 -0500 (EST)
Received: from imap10 ([10.202.2.60]) by compute1.internal (MEProxy); Wed, 13 Jan 2021 01:09:54 -0500
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lowentropy.net; h=mime-version:message-id:date:from:to:subject:content-type; s= fm1; bh=dmXp8AtKYhYjF6s9AOmI4qYb95y4ZDEwdmMvM4+dIfU=; b=ZsadYcvB SzwG0yss8DVkNuJ3BwY4oNUVtVzpFu8MEQSge5mKxONaZFTvkE6WHOJ9nV2EOXGz fBPiboN5ap0xT3FcMhp4h7ReMokJG+86koIsR991KQ/N75GtvA4VOkZMB1/yyo3k fzrfvXWOQYDKt1vGgKsxYQnmFPETuRh7AR30/9uTCkOpMd8V8q3lSlB8AMis7OAE ljmDW+lWRMz/gCev2TisBXapvRpnmaFGY6WD7wR+r5n67VKgnVji0v9rvxJx6jef Ys8UVcJrpPZcZ66z2ItWM9oelPd9CdRwpbxD/VFh9s6LKokuw6mM5bCQJRzZTo+e uy4lohCXRg/rCQ==
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=content-type:date:from:message-id :mime-version:subject:to:x-me-proxy:x-me-proxy:x-me-sender :x-me-sender:x-sasl-enc; s=fm1; bh=dmXp8AtKYhYjF6s9AOmI4qYb95y4Z DEwdmMvM4+dIfU=; b=qYbWfoexucBp4dWIUGbD+0ogvWUOmYjCatDVfztVYxhjN BEoPi4o39gzt2jstzXvcbAxVooXK69HRgR25QhGwpq4vM2+FSsjAUYLBcajrN+nD lYdNIXye/jHFzCoK/QqD5BihlmV2CXIgclW/9dl9nPzgPZ3ZyUOpE7fjGx7uQBMC 53P4hTYN5n1Rf/1+9VziE6BtfOkIy4Xs3x6jvgmOXn5m00iG5EfRQq48VWTTcAFs Iq2493f2fxdF+rr8krDkfM62Xy41Kc60i+Tvs3dbMpynCaCZBpIiC/OHrZBjrJb+ OhMUrCX3jP1rDvMBuyJsGeQpHbuLAzwIm5K4pqZMA==
X-ME-Sender: <xms:sY7-XwUvnOpvvzpn8f_luthhq775ZihBc9nI6-5QtM94EwJ0ak1WAQ> <xme:sY7-X0mfUC1eicFilQua0StvKyW7IQe7BDtvJbM-ffcBoOJNHtLbSzZw2uxgL-qkP aE769qNZb2BlyRyvjA>
X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedukedrtddugdelgecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecunecujfgurhepofgfggfkfffhvffutgesthdtredtre ertdenucfhrhhomhepfdforghrthhinhcuvfhhohhmshhonhdfuceomhhtsehlohifvghn thhrohhphidrnhgvtheqnecuggftrfgrthhtvghrnhepkeehiefgvefhveeluefhjeeugf euhfeiieeijeffiedtueduveeuleegtdelhfeknecuffhomhgrihhnpehnvhgrtggtvghs shdrohhrghenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhroh hmpehmtheslhhofigvnhhtrhhophihrdhnvght
X-ME-Proxy: <xmx:sY7-X0bAG9fhrPmrsJYVfwwcOcLzq3hmzDvrOB2VRiCdcHcLIYtF4A> <xmx:sY7-X_Ut-77SrFNecO4j0ccmd7sMlMxW4LiFiCN_NVFizYOagxr9xw> <xmx:sY7-X6lzXAyCVLZW9oLjVTvR8Avn9iHotEHZW9IXbJuZvwxi6Ie9ig> <xmx:so7-X2yVX7K9f6b05n1bkN5OiS2oC4G3SFugtBi0aPknPOLpb6P51w>
Received: by mailuser.nyi.internal (Postfix, from userid 501) id 73EBF2007E; Wed, 13 Jan 2021 01:09:53 -0500 (EST)
X-Mailer: MessagingEngine.com Webmail Interface
User-Agent: Cyrus-JMAP/3.5.0-alpha0-45-g4839256-fm-20210104.001-g48392560
Mime-Version: 1.0
Message-Id: <4fa761a9-5e45-4514-a35d-a25f6892e214@www.fastmail.com>
Date: Wed, 13 Jan 2021 17:09:34 +1100
From: Martin Thomson <mt@lowentropy.net>
To: rfc-interest@rfc-editor.org
Subject: [rfc-i] Accessibility of RFC HTML
X-BeenThere: rfc-interest@rfc-editor.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "A list for discussion of the RFC series and RFC Editor functions." <rfc-interest.rfc-editor.org>
List-Unsubscribe: <https://www.rfc-editor.org/mailman/options/rfc-interest>, <mailto:rfc-interest-request@rfc-editor.org?subject=unsubscribe>
List-Archive: <http://www.rfc-editor.org/pipermail/rfc-interest/>
List-Post: <mailto:rfc-interest@rfc-editor.org>
List-Help: <mailto:rfc-interest-request@rfc-editor.org?subject=help>
List-Subscribe: <https://www.rfc-editor.org/mailman/listinfo/rfc-interest>, <mailto:rfc-interest-request@rfc-editor.org?subject=subscribe>
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Errors-To: rfc-interest-bounces@rfc-editor.org
Sender: rfc-interest <rfc-interest-bounces@rfc-editor.org>
Hey folks, I thought I might report on some feedback that I sought regarding the accessibility of RFCs. I contacted Jamie Teh, who works on accessibility and is one of the people behind the excellent NVDA tool <https://www.nvaccess.org/about-nvda/>. He graciously provided some feedback on the HTML. Jamie was enthusiastic about using HTML as it provides much better availability to assistive technologies generally. Much better than text. And overall, the simplicity of what we are doing with HTML was pretty good. There were a few things that weren't ideal: * The per-paragraph "pilcrow" element remains a little tricky. Right now, we style this with visibility: hidden, which makes it inaccessible to assistive technologies. On the other hand, having it present adds noise. Jamie didn't have a good suggestion here. * The "toplink" includes a single opaque character, rather than text, which makes its purpose hard to discern. * We might consider providing a link to the table of contents as the first element in the HTML. There are some CSS tricks that can be used to keep that off-screen. I've opened issues on each of these with xml2rfc. I also managed to partly botch one other thing in my own stylesheet, which was good to identify and fix. There was a lot more than this, and there might be a few items that would benefit from following up. If anyone wants to dig further, I can provide a copy of Jamie's feedback. Cheers, Martin _______________________________________________ rfc-interest mailing list rfc-interest@rfc-editor.org https://www.rfc-editor.org/mailman/listinfo/rfc-interest
- [rfc-i] Accessibility of RFC HTML Martin Thomson