<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Paul Adam on Medium]]></title>
        <description><![CDATA[Stories by Paul Adam on Medium]]></description>
        <link>https://medium.com/@padam_73259?source=rss-8c66ad141caf------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/0*5dCeVSeah2Dq9d3t</url>
            <title>Stories by Paul Adam on Medium</title>
            <link>https://medium.com/@padam_73259?source=rss-8c66ad141caf------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Wed, 18 Nov 2026 09:26:16 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@padam_73259/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Create accessible designs using the Figma A11y Annotation kit]]></title>
            <link>https://medium.com/designing-atlassian/create-accessible-designs-using-the-figma-a11y-annotation-kit-35371f00dac5?source=rss-8c66ad141caf------2</link>
            <guid isPermaLink="false">https://medium.com/p/35371f00dac5</guid>
            <category><![CDATA[figma]]></category>
            <category><![CDATA[a11y]]></category>
            <category><![CDATA[accessibility]]></category>
            <category><![CDATA[screen-reader]]></category>
            <category><![CDATA[technology-and-design]]></category>
            <dc:creator><![CDATA[Paul Adam]]></dc:creator>
            <pubDate>Fri, 03 Dec 2021 00:05:53 GMT</pubDate>
            <atom:updated>2021-12-03T00:05:53.277Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="Example showing heading and alt text annotations." src="https://cdn-images-1.medium.com/max/980/1*rMdOzK5nEgefRQ3MsiRoNg.png" /><figcaption>Design annotated with Heading and Image Alt Text properties</figcaption></figure><p>Accessible experiences don’t design themselves. If designers don’t annotate their designs with accessibility properties and behaviors then developers won’t code an accessible experience… and we’ve failed to shift accessibility to the left in the software development life cycle (SDLC).</p><h3>Shifting Accessibility to the left in the Software Development Life Cycle (SDLC)</h3><figure><img alt="Software Development Life Cycle flow chart showing stages Plan &gt; Design &gt; Develop &gt; Test &gt; Deploy and Shift Accessibility Left with an arrow pointing to the left side of the SDLC" src="https://cdn-images-1.medium.com/max/1024/1*F6PYIrGH_KniXf-fXI81Mw.png" /><figcaption>The <strong>Shift Left</strong> concept moves accessibility from the end stage of the SDLC to the beginning</figcaption></figure><p>The traditional way of managing accessibility has been to add it at the end of the software development lifecycle after all the design and development work has been completed. The accessibility team or QA testing team is usually involved at the end of a project after the site or app has been launched — when the team suddenly realizes accessibility was part of the legal or vendor software requirements.</p><p>Because the site was not designed with accessibility in mind the subsequent audit report generated by the accessibility testing team is huge, possibly highlighting more than 100 WCAG failures. At the end of the project, it’s many times more difficult, expensive, and time-consuming to fix 100 accessibility issues, many of which require design changes rather than simple code fixes.</p><p>Shift Left upends the traditional way of adding accessibility at the end of a project and instead requires the accessibility responsibilities to shift to the initial stages of software development or the left side of the SDLC. Therefore it’s everyone&#39;s responsibility to incorporate accessibility from the earliest stages of planning, design, coding, through to prototyping.</p><p>Project managers must define the accessibility requirements for the site or app and plan for the early, middle, and late stages of accessibility reviews and testing. Designers need to design not just the visual, mouse-based experience but also the experience for blind, screen reader users and keyboard-only users. Designers need to annotate their designs and mockups with accessibility properties and behavior like image alt text, icon button names, and keyboard operation so developers know exactly how to code the accessible experience. Developers need to implement the accessibility requirements and behaviors as defined by the designers and their annotated design files.</p><figure><img alt="Colour Contrast Analyser showing orange on white has a 1.9:1 contrast ratio which fails all WCAG success criteria for contrast" src="https://cdn-images-1.medium.com/max/1024/1*cSrTKNo7_JKcOsms8KshBg.png" /><figcaption>Colour Contrast Analyser showing the orange star icons fail contrast ratio requirements for Non-text Contrast</figcaption></figure><p>As part of shifting left, designers and developers need to conduct their own accessibility testing to find and fix issues before its reviewed by the accessibility QA team.</p><p>Designers can use contrast testing tools like the <a href="https://www.tpgi.com/color-contrast-checker/">Colour Contrast Analyser</a> or <a href="https://www.figma.com/community/search?model_type=public_plugins&amp;q=accessibility">Figma accessibility testing plugins</a>.</p><p>Developers must ensure they’re shipping clean, valid, accessible code and should use browser extensions like <a href="https://chrome.google.com/webstore/detail/axe-devtools-web-accessib/lhdoppojpmngadmnindnejefpokejbdd?hl=en-US">axe DevTools</a> and validate their code with the <a href="https://validator.w3.org/nu/">W3C validator</a>.</p><p>When everyone is responsible for accessibility most issues will be identified and fixed during the normal stages of design and development.</p><figure><img alt="axe DevTools showing 79 issues and an image failure is highlighted" src="https://cdn-images-1.medium.com/max/1024/1*Th5AKmnHw5h4aY2ZxoduWQ.png" /><figcaption>axe DevTools displaying 79 total accessibility issues and highlighting the first image alt text failure</figcaption></figure><p><em>Add accessibility properties and behaviors to your Figma designs using the </em><strong><em>A11y Annotation Kit</em></strong><em> from </em><strong><em>Indeed</em></strong><em>. The basic accessibility properties are </em><strong><em>Heading Levels, Image Alt Text</em></strong><em>, and</em><strong><em> Accessible Names for Icon Buttons</em></strong><em>.</em></p><h3>Getting started with the Figma A11y Annotation kit from Indeed</h3><figure><img alt="Accessibility Annotation Kit community file showing Duplicate into drafts process" src="https://cdn-images-1.medium.com/max/1024/1*_NA9v30z6YpAYxW2T3i9BA.png" /><figcaption>Duplicate the A11y Annotation Kit into your Figma Drafts</figcaption></figure><p>Find a design that needs accessibility annotations and then get the <a href="https://www.figma.com/community/file/953682768192596304">A11y Annotation Kit from Figma Community Files</a>. Duplicate the a11y annotation kit into your Figma drafts.</p><figure><img alt="Example of alt text annotations for a decorative paperplane icon and 2 image buttons" src="https://cdn-images-1.medium.com/max/1024/1*GXcv76PSdgxNHVfteiRySw.png" /><figcaption>Example of image and button Alt text annotations</figcaption></figure><p>Read the <strong>Abou</strong>t, <strong>How to</strong>, and review the <strong>example annotation</strong> pages in the kit to learn how to annotate and see example annotations.</p><h3>How to annotate a Design using the Kit</h3><ol><li>Open a design file that requires accessibility annotations.</li></ol><figure><img alt="Confluence home page screenshot that we’ll be annotating" src="https://cdn-images-1.medium.com/max/1024/1*VWlifglD8n4pf7Y6XWzO6A.png" /><figcaption>We will annotate the Confluence Cloud Home page with accessibility properties</figcaption></figure><p>2. Open the A11y Annotation Kit &gt; Assets page and find some accessibility callouts to copy and paste into the design file.</p><figure><img alt="Headings callouts showing H1 H2 H3 H4 etc with arrows pointing in 4 directions" src="https://cdn-images-1.medium.com/max/1024/1*QIMif3_gsT_g5D3fMK2-Fg.png" /><figcaption>Heading level annotation callouts on the Assets page</figcaption></figure><p>3. Copy a heading callout (in this instance, we’ll use H1) and paste it into the design file to specify what text needs to be coded as the &lt;h1&gt; element.</p><figure><img alt="H1 callout shown selected for copy/paste" src="https://cdn-images-1.medium.com/max/340/1*-7CWSYWTxyM5nXRnDUlx0A.png" /><figcaption>Select and Copy the H1 callout</figcaption></figure><p>The first heading element within the &lt;main&gt; content area needs to be defined as an &lt;h1&gt;.</p><figure><img alt="H1 callout points to the Spaces text" src="https://cdn-images-1.medium.com/max/1024/1*Ti6MWwO77wOcHZh51vYahQ.png" /><figcaption>Spaces has been defined as an H1 Heading Level 1 element</figcaption></figure><p>More heading level annotations can easily be generated by duplicating the first callout (⌘ + D) then dragging to the other headings and changing the Heading Level in the Design properties panel.</p><figure><img alt="H1, H2, and H3 heading callouts shown on the heading and subheadings" src="https://cdn-images-1.medium.com/max/1024/1*mUyA-LoD6qZ7Sc3dY5Xfxw.png" /><figcaption>Heading callouts duplicated and levels adjusted for subheading text</figcaption></figure><p>4. Annotate the <strong>image alt text</strong> into the design so developers know what to code for the accessible names of images and buttons.</p><figure><img alt="Buttons and Image annotation callouts from the assets page" src="https://cdn-images-1.medium.com/max/1024/1*6O5ZJKB1CpG4K1RiIqMTAw.png" /><figcaption>Find the Buttons and Image callouts in the Assets page of the A11y Annotation Kit</figcaption></figure><p>5. Define what images are pure decoration and should be ignored by screen reader users. If decorative images are not ignored i.e. with &lt;img alt=””&gt; then screen readers may speak the image filename or an incorrect alt text may be written into the alt attribute value by the developer.</p><p>Copy the Alt=”” callout and paste it above the first decorative image in the design which is the accessibility icon symbol. These images in the Spaces links are decorative because the links already have sufficient visible text to serve as their accessible names. If the accessibility icon image is not defined using &lt;img alt=””&gt;, the screen reader may duplicate the alt text when it focuses on the link, e.g. the screen reader might speak “Accessibility Accessibility, Link” repeating the word Accessibility because it was incorrectly written as alt text for the icon image. Duplicate the Alt=”” callout and drag it to all other decorative images in the design.</p><figure><img alt="Alt=”” callouts pointing to the decorative images" src="https://cdn-images-1.medium.com/max/1024/1*Se3n8AyzZ4ORi2cmHcX5qQ.png" /><figcaption>Decorative/redundant icon images defined with Alt=”” so they’re ignored by screen readers</figcaption></figure><p>6. Define alt text for <strong>informative images</strong> and <strong>icon</strong> buttons. The star icons visually convey to sighted users which spaces have been added to the Starred list. This is how to convey to screen reader users an informative alt text for the star icons.</p><figure><img alt="Alt=”Starred” callouts pointing to the star icons" src="https://cdn-images-1.medium.com/max/1024/1*ChuP56ofFyvik56F1JcnSg.png" /><figcaption>Informative star icon images annotated with Alt=”Starred”</figcaption></figure><p>Now for the Alt=”Starred” annotations, the screen reader will speak “Accessibility Starred, Link” and “Paul Adam Starred, Link” for the two links that have star icons.</p><p>7. Define the alt text/accessible name for the <strong>Create/+</strong> icon button.</p><figure><img alt="Create button shown with a C tooltip displayed" src="https://cdn-images-1.medium.com/max/462/1*iKrCtk-w1iqOJUKNcLaWNA.png" /><figcaption>Create button showing the keyboard shortcut letter “C” as a tooltip</figcaption></figure><p>The <strong>Create</strong> button normally doesn’t need an accessibility annotation because it shows the visible label text “Create”, however, the <strong>Create</strong> button also displays a tooltip shortcut letter “C” to let sighted users know they can type the letter C to activate the create button. Include that shortcut letter as part of the name spoken by screen readers so users know that C works as the shortcut key.</p><p>Another reason to define the accessible name of the create button is that it also turns into a<strong> +</strong> icon button in responsive views at narrow screen sizes. Annotating the button label text for the <strong>+</strong> button ensures that screen readers will not hear “Plus, button” spoken as the name of the <strong>Create</strong> button.</p><figure><img alt="Callout reads Button label=”Create, C” for the + button" src="https://cdn-images-1.medium.com/max/1024/1*VjWm01em4J1h_l9LsUUhtw.png" /><figcaption>+ icon button’s label defined as “Create, C”</figcaption></figure><p>There is a lot more work to be done to include all the required accessibility properties and behaviors into our annotations before we deliver them to developers. The hope is that this post will help you get started on the accessibility annotation process and highlight the importance of shifting accessibility left in the software development life cycle.</p><p>Below is a screenshot of a completed accessibility annotations file that goes beyond annotating just images and headings.</p><figure><img alt="Final annotated example with many accessibility callouts defining all accessibility properties of the design" src="https://cdn-images-1.medium.com/max/1024/1*oB4IUW1VfnB2zXBcw1ZvkA.png" /><figcaption>Final Completed Accessibility Annotations Example</figcaption></figure><h4>Sources:</h4><ul><li><a href="https://medium.com/indeed-design/building-an-accessibility-library-e134e9012c17">Building an Accessibility Library</a></li><li><a href="https://www.figma.com/community/file/953682768192596304">Figma</a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=35371f00dac5" width="1" height="1" alt=""><hr><p><a href="https://medium.com/designing-atlassian/create-accessible-designs-using-the-figma-a11y-annotation-kit-35371f00dac5">Create accessible designs using the Figma A11y Annotation kit</a> was originally published in <a href="https://medium.com/designing-atlassian">Designing Atlassian</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>