Differential D25007 Diff 23 src/docs/contributor/assistive_technologies.diviner

Changeset View

Standalone View

src/docs/contributor/assistive_technologies.diviner

@title Assistive Technologies		@title Assistive Technologies
@group developer		@group developer

Information about making Phabricator accessible to assistive technologies.		Information about making Phorge accessible to assistive technologies.

Overview		Overview
========		========

Assistive technologies help people with disabilities use the web. For example,		Assistive technologies help people with disabilities use the web. For example,
screen readers can assist people with limited or no eyesight by reading the		screen readers can assist people with limited or no eyesight by reading the
contents of pages aloud.		contents of pages aloud.

Phabricator has some support for assistive technologies, and we'd like to have		Phorge has some support for assistive technologies, and we'd like to have
more support. This document describes how to use the currently available		more support. This document describes how to use the currently available
features to improve the accessibility of Phabricator.		features to improve the accessibility of Phorge.


Aural-Only Elements		Aural-Only Elements
===================		===================

The most common issue assistive technologies encounter is buttons, links, or		The most common issue assistive technologies encounter is buttons, links, or
other elements which only convey information visually (usually through an icon		other elements which only convey information visually (usually through an icon
or image).		or image).
▲ Show 20 Lines • Show All 43 Lines • ▼ Show 20 Lines	javelin_tag(
),		),
$ascii_art);		$ascii_art);


Previewing Aural Pages		Previewing Aural Pages
======================		======================

To verify aural markup, you can add `?__aural__=1` to any page URI. This will		To verify aural markup, you can add `?__aural__=1` to any page URI. This will
make Phabricator render the page with styles that reveal aural-only elements and		make Phorge render the page with styles that reveal aural-only elements and
mute visual-only elements.		mute visual-only elements.