Skip to content

Latest commit

 

History

History
27 lines (21 loc) · 1.97 KB

alt_text.md

File metadata and controls

27 lines (21 loc) · 1.97 KB

Alternative Text

Please add alt text (alternative text) to all of your posted graphics for #TidyTuesday.

The DataViz Society/Nightingale has an article on writing good alt text for plots/graphs.

Here's a simple formula for writing alt text for data visualization:

Chart type

It's helpful for people with partial sight to know what chart type it is and gives context for understanding the rest of the visual. Example: Line graph

Type of data

What data is included in the chart? The x and y axis labels may help you figure this out. Example: number of bananas sold per day in the last year

Reason for including the chart

Think about why you're including this visual. What does it show that's meaningful. There should be a point to every visual and you should tell people what to look for. Example: the winter months have more banana sales

Link to data or source

Don't include this in your alt text, but it should be included somewhere in the surrounding text. People should be able to click on a link to view the source data or dig further into the visual. This provides transparency about your source and lets people explore the data. Example: Data from the USDA

Penn State has an article on writing alt text descriptions for charts and tables.

Charts, graphs and maps use visuals to convey complex images to users. But since they are images, these media provide serious accessibility issues to colorblind users and users of screen readers. See the examples on this page for details on how to make charts more accessible.

The {rtoot} package includes the ability to post to the Mastodon social network with alt text programmatically.

Need a reminder? Many social networks have settings to require alt text in your posts. We recommend turning them on when they are available!