<?xml version="1.0" encoding="utf-8"?>
<rss xmlns:atom="http://www.w3.org/2005/Atom" xmlns:webfeeds="http://webfeeds.org/rss/1.0" version="2.0">
  <channel>
    <atom:link href="http://pubsubhubbub.appspot.com/" rel="hub"/>
    <atom:link href="https://f43.me/a-list-apart.xml" rel="self" type="application/rss+xml"/>
    <title>A List Apart</title>
    <description>Articles for people who make web sites.</description>
    <link>http://alistapart.com</link>
    <webfeeds:icon>https://s2.googleusercontent.com/s2/favicons?alt=feed&amp;domain=alistapart.com</webfeeds:icon>
    <generator>f43.me</generator>
    <lastBuildDate>Fri, 13 Mar 2026 06:00:18 +0100</lastBuildDate>
    <item>
      <title><![CDATA[Design for Amiability: Lessons from Vienna]]></title>
      <description><![CDATA[<p>Today’s web is not always an amiable place. Sites greet you with a popover that demands assent to their cookie policy, and leave you with Taboola ads promising “One Weird Trick!” to cure your ailments. Social media sites are tuned for engagement, and few things are more engaging than a fight. Today it seems that people want to quarrel; I have seen flame wars among birders.  </p>


<p>These tensions are often at odds with a site’s goals. If we are providing support and advice to customers, we don’t want those customers to wrangle with each other. If we offer news about the latest research, we want readers to feel at ease; if we promote upcoming marches, we want our core supporters to feel comfortable and we want curious newcomers to feel welcome. </p>
<p>In a study for a conference on the History of the Web, I looked to the origins of Computer Science in Vienna <a href="tel:19281934">(1928-1934</a>)  for a case study of the importance of amiability in a research community and the disastrous consequences of its loss. That story has interesting implications for web environments that promote amiable interaction among disparate, difficult (and sometimes disagreeable) people.</p>
<h2 id="section2" class="wp-block-heading">The Vienna Circle</h2>
<p>Though people had been thinking about calculating engines and thinking machines from antiquity, Computing really got going in Depression-era Vienna.  The people who worked out the theory had no interest in building machines; they wanted to puzzle out the limits of reason in the absence of divine authority. If we could not rely on God or Aristotle to tell us how to think, could we instead build arguments that were self-contained and demonstrably correct? Can we be sure that mathematics is consistent? Are there things that are true but that cannot be expressed in language? </p>
<p>The core ideas were worked out in the weekly meetings (Thursdays at 6) of a group remembered as the Vienna Circle. They got together in the office of Professor Moritz Schlick at the University of Vienna to discuss problems in philosophy, math, and language. The intersection of physics and philosophy had long been a specialty of this Vienna department, and this work had placed them among the world leaders.  Schlick’s colleague Hans Hahn was a central participant, and by 1928 Hahn brought along his graduate students Karl Menger and Kurt Gödel. Other frequent participants included philosopher Rudolf Carnap, psychologist Karl Popper, economist Ludwig von Mises (brought by his brother Frederick, a physicist),  graphic designer Otto Neurath (inventor of infographics), and architect Josef Frank (brought by his physicist brother, Phillip).  Out-of-town visitors often joined, including the young Johnny von Neumann, Alfred Tarski, and the irascible Ludwig Wittgenstein. </p>
<p>When Schlick’s office grew too dim, participants adjourned to a nearby café for additional discussion with an even larger circle of participants.  This convivial circle was far from unique.  An intersecting circle–Neurath, von Mises, Oskar Morgenstern–established the Austrian School of free-market economics. There were theatrical circles (Peter Lorre, Hedy Lamarr, Max Reinhardt), and literary circles. The café was where things happened.</p>
<p>The interdisciplinarity of the group posed real challenges of temperament and understanding. Personalities were often a challenge. Gödel was convinced people were trying to poison him. Architect Josef Frank depended on contracts for public housing, which Mises opposed as wasteful. Wittgenstein’s temper had lost him his job as a secondary school teacher, and for some of these years he maintained a detailed list of whom he was willing to meet. Neurath was eager to detect muddled thinking and would interrupt a speaker with a shouted “Metaphysics!” The continuing amity of these meetings was facilitated by the personality of their leader, Moritz Schlick, who would be remembered as notably adept in keeping disagreements from becoming quarrels.</p>
<h2 id="section3" class="wp-block-heading">In the Café</h2>
<p>The Viennese café of this era was long remembered as a particularly good place to argue with your friends, to read, and to write. Built to serve an imperial capital, the cafés found themselves with too much space and too few customers now that the Empire was gone. There was no need to turn tables: a café could only survive by coaxing customers to linger. Perhaps they would order another coffee, or one of their friends might drop by. One could play chess, or billiards, or read newspapers from abroad. Coffee was invariably served with a glass of purified spring water, still a novelty in an era in which most water was still unsafe to drink. That water glass would be refilled indefinitely. </p>
<p>In the basement of one café, the poet Jura Soyfer staged “The End Of The World,” a musical comedy in which Professor Peep has discovered a comet heading for earth.</p>
<blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow">
<blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow">
</blockquote>
<blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow">
<blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow">
<p>Prof. Peep: The comet is going to destroy everybody!</p>
<p>Hitler:  Destroying everybody is my business.</p>
</blockquote>
</blockquote>
<p>Of course, coffee can be prepared in many ways, and the Viennese café developed a broad vocabulary to represent precisely how one preferred to drink it: melange, Einspänner, Brauner, Schwarzer, Kapuziner. This extensive customization, with correspondingly esoteric conventions of service, established the café as a comfortable and personal third space, a neutral ground in which anyone who could afford a coffee would be welcome. Viennese of this era were fastidious in their use of personal titles, of which an abundance were in common use. Café waiters greeted regular customers with titles too, but were careful to address their patrons with titles a notch or two greater than they deserved. A graduate student would be Doktor, an unpaid postdoc Professor.  This assurance mattered all the more because so many members of the Circle (and so many other Viennese) came from elsewhere: Carnap from Wuppertal, Gödel from Brno, von Neumann from Budapest. No one was going to make fun of your clothes, mannerisms, or accent. Your friends wouldn’t be bothered by the pram in the hall. Everyone shared a Germanic Austrian literary and philosophical culture, not least those whose ancestors had been Eastern European Jews who knew that culture well, having read all about it in books.</p>
<p>The amiability of the café circle was enhanced by its openness. Because the circle sometimes extended to architects and actors, people could feel less constrained to admit shortfalls in their understanding. It was soon discovered that marble tabletops made a useful surface for pencil sketches, serving all as an improvised and accessible blackboard.</p>
<p>Comedies like “The End Of The World” and fictional newspaper sketches or feuilletons of writers like Joseph Roth and Stefan Zweig served as a second defense against disagreeable or churlish behavior. The knowledge that, if one got carried away, a parody of one’s remarks might shortly appear in Neue Freie Presse surely helped Professor Schlick keep matters in hand.</p>
<h2 id="section4" class="wp-block-heading">The End Of Red Vienna</h2>
<p>Though Austria’s government drifted to the right after the War, Vienna’s city council had been Socialist, dedicated to public housing based on user-centered design, and embracing  ambitious programs of public outreach and adult education. In 1934 the Socialists lost a local election, and this era soon came to its end as the new administration focused on the imagined threat of the International Jewish Conspiracy. Most members of the Circle fled within months: von Neumann to Princeton, Neurath to Holland and Oxford, Popper to New Zealand, Carnap to Chicago. Prof. Schlick was murdered on the steps of the University by a student outraged by his former association with Jews.  Jura Soyfer, who wrote “The End Of The World,” died in Buchenwald.</p>
<p>In 1939, von Neumann finally convinced Gödel to accept a job in Princeton. Gödel was required to pay large fines to emigrate. The officer in charge of these fees would look back on this as the best posting of his career; his name was Eichmann.</p>
<h2 id="section5" class="wp-block-heading">Design for Amiability</h2>
<p>An impressive literature recounts those discussions and the environment that facilitated the development of computing. How can we design for amiability?  This is not just a matter of choosing rounded typefaces and a cheerful pastel palette. I believe we may identify eight distinct issues that exert design forces in usefully amiable directions.</p>
<p><strong>Seriousness</strong>: The Vienna Circle was wrestling with a notoriously difficult book—Wittgenstein’s Tractus Logico-Philosophicus—and a catalog of outstanding open questions in mathematics. They were concerned with consequential problems, not merely scoring points for debating. Constant reminders that the questions you are considering matter—not only that they are consequential or that those opposing you are scoundrels—help promote amity.</p>
<p><strong>Empiricism</strong>: The characteristic approach of the Vienna Circle demanded that knowledge be grounded either in direct observation or in rigorous reasoning. Disagreement, when it arose, could be settled by observation or by proof. If neither seemed ready to hand, the matter could not be settled. On these terms, one can seldom if ever demolish an opposing argument, and trolling is pointless.</p>
<p><strong>Abstraction</strong>: Disputes grow worse when losing the argument entails lost face or lost jobs. The Vienna Circle’s focus on theory—the limits of mathematics, the capability of language—promoted amity. Without seriousness, abstraction could have been merely academic, but the limits of reason and the consistency of mathematics were clearly serious.</p>
<p><strong>Formality</strong>: The punctilious demeanor of waiters and the elaborated rituals of coffee service helped to establish orderly attitudes amongst the argumentative participants. This stands in contrast to the contemptuous sneer that now dominates social media.  </p>
<p><strong>Schlamperei</strong>: Members of the Vienna Circle maintained a global correspondence, and they knew their work was at the frontier of research. Still, this was Vienna, at the margins of Europe: old-fashioned, frumpy, and dingy. Many participants came from even more obscure backwaters. Most or all harbored the suspicion that they were really schleppers, and a tinge of the ridiculous helped to moderate tempers. The director of “The End Of The World” had to pass the hat for money to purchase a moon for the set, and thought it was funny enough to write up for publication.</p>
<p><strong>Openness</strong>: All sorts of people were involved in discussion, anyone might join in. Each week would bring different participants. Fluid borders reduce tension, and provide opportunities to broaden the range of discussion and the terms of engagement. Low entrance friction was characteristic of the café: anyone could come, and if you came twice you were virtually a regular. Permeable boundaries and café culture made it easier for moderating influences to draw in raconteurs and storytellers to defuse awkward moments, and Vienna’s cafés had no shortage of humorists. Openness counteracts the suspicion that promoters of amiability are exerting censorship.</p>
<p><strong>Parody</strong>: The environs of the Circle—the university office and the café—were unmistakably public. There were writers about, some of them renowned humorists. The prospect that one’s bad taste or bad behavior might be ridiculed in print kept discussion within bounds. The sanction of public humiliation, however, was itself made mild by the veneer of fiction; even if you got a little carried away and a character based on you made a splash in some newspaper fiction, it wasn’t the end of the world.</p>
<p><strong>Engagement</strong>: The subject matter was important to the participants, but it was esoteric: it did not matter very much to their mothers or their siblings. A small stumble or a minor humiliation could be shrugged off in ways that major media confrontations cannot.</p>
<p>I believe it is notable that this environment was designed to promote amiability through several different voices.  The café waiter flattered each newcomer and served everyone, and also kept out local pickpockets and drunks who would be mere disruptions. Schlick and other regulars kept discussion moving and on track. The fiction writers and raconteurs—perhaps the most peripheral of the participants—kept people in a good mood and reminded them that bad behavior could make anyone ridiculous.  Crucially, each of these voices were human: you could reason with them. Algorithmic or AI moderators, however clever, are seldom perceived as reasonable. The café circles had no central authority or Moderator against whom everyone’s resentments might be focused. Even after the disaster of 1934, what people remembered were those cheerful arguments.</p>


</blockquote>]]></description>
      <link>https://alistapart.com/article/design-for-amiability-lessons-from-vienna/</link>
      <guid>https://alistapart.com/article/design-for-amiability-lessons-from-vienna/</guid>
      <pubDate>Wed, 15 Oct 2025 17:35:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Design Dialects: Breaking the Rules, Not the System]]></title>
      <description><![CDATA[<p><em>“Language is not merely a set of unrelated sounds, clauses, rules, and meanings; it is a totally coherent system bound to context and behavior.”</em> — Kenneth L. Pike</p>


<p>The web has accents. So should our design systems.</p>
<h2 id="section2" class="wp-block-heading"><strong>Design Systems as Living Languages</strong></h2>
<p>Design systems aren’t component libraries—they’re living languages. <a href="https://m3.material.io/foundations/design-tokens/overview"><strong>Tokens</strong></a> are phonemes, <a href="https://atlassian.design/components"><strong>components</strong></a> are words, <a href="https://designsystem.university/glossary#pattern"><strong>patterns</strong></a> are phrases, <a href="https://www.figma.com/blog/design-systems-102-how-to-build-your-design-system/#use-layout-grids-and-spacing-to-create-visual"><strong>layouts</strong></a> are sentences. The conversations we build with users become the stories our products tell.</p>
<p>But here’s what we’ve forgotten: the more fluently a language is spoken, the more accents it can support without losing meaning. English in Scotland differs from English in Sydney, yet both are unmistakably English. The language adapts to context while preserving core meaning. This couldn’t be more obvious to me, a Brazilian Portuguese speaker, who learned English with an American accent, and lives in Sydney.</p>
<p>Our design systems must work the same way. Rigid adherence to visual rules creates brittle systems that break under contextual pressure. Fluent systems bend without breaking.</p>
<p><strong>Consistency becomes a prison</strong></p>
<p>The promise of design systems was simple: consistent components would accelerate development and unify experiences. But as systems matured and products grew more complex, that promise has become a prison. <a href="https://adobe.design/stories/design-for-scale/designing-design-systems-supporting-implementation-and-adoption">Teams file “exception” requests by the hundreds</a>. Products launch with workarounds instead of system components. Designers spend more time defending consistency than solving user problems.</p>
<p>Our design systems must learn to speak <strong>dialects</strong>.</p>
<p><strong>A design dialect is a systematic adaptation of a design system that maintains core principles while developing new patterns for specific contexts.</strong> Unlike one-off customizations or brand themes, dialects preserve the system’s essential grammar while expanding its vocabulary to serve different users, environments, or constraints.</p>
<h2 id="section3" class="wp-block-heading"><strong>When Perfect Consistency Fails</strong></h2>
<p>At <a href="https://booking.com">Booking.com</a>, I learned this lesson the hard way. We A/B-tested everything—color, copy, button shapes, even logo colors. As a professional with a graphic design education and experience building brand style guides, I found this shocking. While everyone fell in love with Airbnb’s pristine design system, Booking grew into a giant without ever considering visual consistency.  </p>
<p>The chaos taught me something profound: <strong>consistency isn’t ROI; solved problems are.</strong></p>
<p>At Shopify. Polaris (<a href="https://polaris-react.shopify.com/">https://polaris-react.shopify.com/</a>) was our crown jewel—a mature design language perfect for merchants on laptops. As a product team, we were expected to adopt Polaris as-is. Then my fulfillment team hit an “Oh, Ship!” moment, as we faced the challenge of building an app for warehouse pickers using our interface on shared, battered Android scanners in dim aisles, wearing thick gloves, scanning dozens of items per minute, many with limited levels of English understanding.</p>
<p>Task completion with standard Polaris: <strong>0%</strong>.</p>
<p>Every component that worked beautifully for merchants failed completely for pickers. White backgrounds created glare. 44px tap targets were invisible to gloved fingers. Sentence-case labels took too long to parse. Multi-step flows confused non-native speakers.</p>
<p>We faced a choice: abandon Polaris entirely, or <em>teach it to speak warehouse</em>.</p>
<h2 id="section4" class="wp-block-heading"><strong>The Birth of a Dialect</strong></h2>
<p>We chose evolution over revolution. Working within Polaris’s core principles—clarity, efficiency, consistency—we developed what we now call a <strong>design dialect</strong>:</p>
<figure id="figure1" class="wp-block-table"><table class="has-fixed-layout"><tbody><tr><td><strong>Constraint</strong></td>
<td><strong>Fluent Move</strong></td>
<td><strong>Rationale</strong></td>
</tr><tr><td>Glare &amp; low light</td>
<td>Dark surfaces + light text</td>
<td>Reduce glare on low-DPI screens</td>
</tr><tr><td>Gloves &amp; haste</td>
<td>90px tap targets (~2cm)</td>
<td>Accommodate thick gloves</td>
</tr><tr><td>Multilingual</td>
<td>Single-task screens, plain language</td>
<td>Reduce cognitive load</td>
</tr></tbody></table></figure><p><strong>Result:</strong> Task completion jumped from <strong>0% to 100%</strong>. Onboarding time dropped from three weeks to one shift.</p>
<p>This wasn’t customization or theming—this was a <strong>dialect</strong>: a systematic adaptation that maintained Polaris’s core grammar while developing new vocabulary for a specific context. Polaris hadn’t failed; it had learned to speak warehouse.</p>
<h2 id="section5" class="wp-block-heading"><strong>The Flexibility Framework</strong></h2>
<p>At <a href="http://www.atlassian.com">Atlassian</a>, working on the Jira platform—itself a system within the larger Atlassian system—I pushed for formalizing this insight. With dozens of products sharing a design language across different codebases, we needed systematic flexibility so we built directly into our ways of working. The old model—exception requests and special approvals—was failing at scale.</p>
<p>We developed the <strong>Flexibility Framework</strong> to help designers define how flexible they wanted their components to be:</p>
<figure id="figure2" class="wp-block-table"><table class="has-fixed-layout"><tbody><tr><td><strong>Tier</strong></td>
<td><strong>Action</strong></td>
<td><strong>Ownership</strong></td>
</tr><tr><td><strong>Consistent</strong></td>
<td>Adopt unchanged</td>
<td>Platform locks design + code</td>
</tr><tr><td><strong>Opinionated</strong></td>
<td>Adapt within bounds</td>
<td>Platform provides smart defaults, products customize</td>
</tr><tr><td><strong>Flexible</strong></td>
<td>Extend freely</td>
<td>Platform defines behavior, products own presentation</td>
</tr></tbody></table></figure><p>During a navigation redesign, we tiered every element. Logo and global search stayed Consistent. Breadcrumbs and contextual actions became Flexible. Product teams could immediately see where innovation was welcome and where consistency mattered.</p>
<h2 id="section6" class="wp-block-heading"><strong>The Decision Ladder</strong></h2>
<p>Flexibility needs boundaries. We created a simple ladder for evaluating when rules should bend:</p>
<p><strong>Good:</strong> Ship with existing system components. Fast, consistent, proven.</p>
<p><strong>Better:</strong> Stretch a component slightly. Document the change. Contribute improvements back to the system for all to use.</p>
<p><strong>Best:</strong> Prototype the ideal experience first. If user testing validates the benefit, update the system to support it.</p>
<p>The key question: “Which option lets users succeed fastest?”</p>
<p>Rules are tools, not relics.</p>
<h2 id="section7" class="wp-block-heading"><strong>Unity Beats Uniformity</strong></h2>
<p>Gmail, Drive, and Maps are unmistakably Google—yet each speaks with its own accent. They achieve unity through shared principles, not cloned components. One extra week of debate over button color costs roughly $30K in engineer time.</p>
<p>Unity is a brand outcome; <strong>fluency is a user outcome.</strong> When the two clash, side with the user.</p>
<h2 id="section8" class="wp-block-heading"><strong>Governance Without Gates</strong></h2>
<p>How do you maintain coherence while enabling dialects? Treat your system like a living vocabulary:</p>
<p><strong>Document every deviation</strong> – e.g., dialects/warehouse.md with before/after screenshots and rationale.</p>
<p><strong>Promote shared patterns</strong> – when three teams adopt a dialect independently, review it for core inclusion.</p>
<p><strong>Deprecate with context</strong> – retire old idioms via flags and migration notes, never a big-bang purge.</p>
<p>A living dictionary scales better than a frozen rulebook.</p>
<h2 id="section9" class="wp-block-heading"><strong>Start Small: Your First Dialect</strong></h2>
<p>Ready to introduce dialects? Start with one broken experience:</p>
<p><strong>This week:</strong> Find one user flow where perfect consistency blocks task completion. Could be mobile users struggling with desktop-sized components, or accessibility needs your standard patterns don’t address.</p>
<p><strong>Document the context:</strong> What makes standard patterns fail here? Environmental constraints? User capabilities? Task urgency?</p>
<p><strong>Design one systematic change:</strong> Focus on behavior over aesthetics. If gloves are the problem, bigger targets aren’t “”breaking the system””—they’re serving the user. Earn the variations and make them intentional.</p>
<p><strong>Test and measure:</strong> Does the change improve task completion? Time to productivity? User satisfaction?</p>
<p><strong>Show the savings:</strong> If that dialect frees even half a sprint, fluency has paid for itself.</p>
<h2 id="section10" class="wp-block-heading"><strong>Beyond the Component Library</strong></h2>
<p>We’re not managing design systems anymore—<strong>we’re cultivating design languages.</strong> Languages that grow with their speakers. Languages that develop accents without losing meaning. Languages that serve human needs over aesthetic ideals.</p>
<p>The warehouse workers who went from 0% to 100% task completion didn’t care that our buttons broke the style guide. They cared that the buttons finally worked.</p>
<p>Your users feel the same way. Give your system permission to speak their language.</p>]]></description>
      <link>https://alistapart.com/article/design-dialects-breaking-the-rules-not-the-system/</link>
      <guid>https://alistapart.com/article/design-dialects-breaking-the-rules-not-the-system/</guid>
      <pubDate>Fri, 26 Sep 2025 18:48:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[An Holistic Framework for Shared Design Leadership]]></title>
      <description><![CDATA[<p>Picture this: You’re in a meeting room at your tech company, and two people are having what looks like the same conversation about the same design problem. One is talking about whether the team has the right skills to tackle it. The other is diving deep into whether the solution actually solves the user’s problem. Same room, same problem, completely different lenses.</p>


<p>This is the beautiful, sometimes messy reality of having both a Design Manager and a Lead Designer on the same team. And if you’re wondering how to make this work without creating confusion, overlap, or the dreaded “too many cooks” scenario, you’re asking the right question.</p>
<p>The traditional answer has been to draw clean lines on an org chart. The Design Manager handles people, the Lead Designer handles craft. Problem solved, right? Except clean org charts are fantasy. In reality, both roles care deeply about team health, design quality, and shipping great work. </p>
<p>The magic happens when you embrace the overlap instead of fighting it—when you start thinking of your design org as a design organism.</p>
<h2 id="section2" class="wp-block-heading"><strong>The Anatomy of a Healthy Design Team</strong></h2>
<p>Here’s what I’ve learned from years of being on both sides of this equation: think of your design team as a living organism. The Design Manager tends to the mind (the psychological safety, the career growth, the team dynamics). The Lead Designer tends to the body (the craft skills, the design standards, the hands-on work that ships to users).</p>
<p>But just like mind and body aren’t completely separate systems, so, too, do these roles overlap in important ways. You can’t have a healthy person without both working in harmony. The trick is knowing where those overlaps are and how to navigate them gracefully.</p>
<p>When we look at how healthy teams actually function, three critical systems emerge. Each requires both roles to work together, but with one taking primary responsibility for keeping that system strong.</p>
<h3 id="section3" class="wp-block-heading"><strong>The Nervous System: People &amp; Psychology</strong></h3>
<p><strong>Primary caretaker: Design Manager</strong><strong><br /></strong><strong>Supporting role: Lead Designer</strong></p>
<p>The nervous system is all about signals, feedback, and psychological safety. When this system is healthy, information flows freely, people feel safe to take risks, and the team can adapt quickly to new challenges.</p>
<p>The Design Manager is the primary caretaker here. They’re monitoring the team’s psychological pulse, ensuring feedback loops are healthy, and creating the conditions for people to grow. They’re hosting career conversations, managing workload, and making sure no one burns out.</p>
<p>But the Lead Designer plays a crucial supporting role. They’re providing sensory input about craft development needs, spotting when someone’s design skills are stagnating, and helping identify growth opportunities that the Design Manager might miss.</p>
<p><strong>Design Manager tends to:</strong></p>
<ul class="wp-block-list"><li>Career conversations and growth planning</li>
<li>Team psychological safety and dynamics</li>
<li>Workload management and resource allocation</li>
<li>Performance reviews and feedback systems</li>
<li>Creating learning opportunities</li>
</ul><p><strong>Lead Designer supports by:</strong></p>
<ul class="wp-block-list"><li>Providing craft-specific feedback on team member development</li>
<li>Identifying design skill gaps and growth opportunities</li>
<li>Offering design mentorship and guidance</li>
<li>Signaling when team members are ready for more complex challenges</li>
</ul><h3 id="section4" class="wp-block-heading"><strong>The Muscular System: Craft &amp; Execution</strong></h3>
<p><strong>Primary caretaker: Lead Designer</strong><strong><br /></strong><strong>Supporting role: Design Manager</strong></p>
<p>The muscular system is about strength, coordination, and skill development. When this system is healthy, the team can execute complex design work with precision, maintain consistent quality, and adapt their craft to new challenges.</p>
<p>The Lead Designer is the primary caretaker here. They’re setting design standards, providing craft coaching, and ensuring that shipping work meets the quality bar. They’re the ones who can tell you if a design decision is sound or if we’re solving the right problem.</p>
<p>But the Design Manager plays a crucial supporting role. They’re ensuring the team has the resources and support to do their best craft work, like proper nutrition and recovery time for an athlete.</p>
<p><strong>Lead Designer tends to:</strong></p>
<ul class="wp-block-list"><li>Definition of design standards and system usage</li>
<li>Feedback on what design work meets the standard</li>
<li>Experience direction for the product</li>
<li>Design decisions and product-wide alignment</li>
<li>Innovation and craft advancement</li>
</ul><p><strong>Design Manager supports by:</strong></p>
<ul class="wp-block-list"><li>Ensuring design standards are understood and adopted across the team</li>
<li>Confirming experience direction is being followed</li>
<li>Supporting practices and systems that scale without bottlenecking</li>
<li>Facilitating design alignment across teams</li>
<li>Providing resources and removing obstacles to great craft work</li>
</ul><h3 id="section5" class="wp-block-heading"><strong>The Circulatory System: Strategy &amp; Flow</strong></h3>
<p><strong>Shared caretakers: Both Design Manager and Lead Designer</strong></p>
<p>The circulatory system is about how information, decisions, and energy flow through the team. When this system is healthy, strategic direction is clear, priorities are aligned, and the team can respond quickly to new opportunities or challenges.</p>
<p>This is where true partnership happens. Both roles are responsible for keeping the circulation strong, but they’re bringing different perspectives to the table.</p>
<p><strong>Lead Designer contributes:</strong></p>
<ul class="wp-block-list"><li>User needs are met by the product</li>
<li>Overall product quality and experience</li>
<li>Strategic design initiatives</li>
<li>Research-based user needs for each initiative</li>
</ul><p><strong>Design Manager contributes:</strong></p>
<ul class="wp-block-list"><li>Communication to team and stakeholders</li>
<li>Stakeholder management and alignment</li>
<li>Cross-functional team accountability</li>
<li>Strategic business initiatives</li>
</ul><p><strong>Both collaborate on:</strong></p>
<ul class="wp-block-list"><li>Co-creation of strategy with leadership</li>
<li>Team goals and prioritization approach</li>
<li>Organizational structure decisions</li>
<li>Success measures and frameworks</li>
</ul><h2 id="section6" class="wp-block-heading"><strong>Keeping the Organism Healthy</strong></h2>
<p>The key to making this partnership sing is understanding that all three systems need to work together. A team with great craft skills but poor psychological safety will burn out. A team with great culture but weak craft execution will ship mediocre work. A team with both but poor strategic circulation will work hard on the wrong things.</p>
<h3 id="section7" class="wp-block-heading"><strong>Be Explicit About Which System You’re Tending</strong></h3>
<p>When you’re in a meeting about a design problem, it helps to acknowledge which system you’re primarily focused on. “I’m thinking about this from a team capacity perspective” (nervous system) or “I’m looking at this through the lens of user needs” (muscular system) gives everyone context for your input.</p>
<p>This isn’t about staying in your lane. It’s about being transparent as to which lens you’re using, so the other person knows how to best add their perspective.</p>
<h3 id="section8" class="wp-block-heading"><strong>Create Healthy Feedback Loops</strong></h3>
<p>The most successful partnerships I’ve seen establish clear feedback loops between the systems:</p>
<p><strong>Nervous system signals to muscular system:</strong> “The team is struggling with confidence in their design skills” → Lead Designer provides more craft coaching and clearer standards.</p>
<p><strong>Muscular system signals to nervous system:</strong> “The team’s craft skills are advancing faster than their project complexity” → Design Manager finds more challenging growth opportunities.</p>
<p><strong>Both systems signal to circulatory system:</strong> “We’re seeing patterns in team health and craft development that suggest we need to adjust our strategic priorities.”</p>
<h3 id="section9" class="wp-block-heading"><strong>Handle Handoffs Gracefully</strong></h3>
<p>The most critical moments in this partnership are when something moves from one system to another. This might be when a design standard (muscular system) needs to be rolled out across the team (nervous system), or when a strategic initiative (circulatory system) needs specific craft execution (muscular system).</p>
<p>Make these transitions explicit. “I’ve defined the new component standards. Can you help me think through how to get the team up to speed?” or “We’ve agreed on this strategic direction. I’m going to focus on the specific user experience approach from here.”</p>
<h3 id="section10" class="wp-block-heading"><strong>Stay Curious, Not Territorial</strong></h3>
<p>The Design Manager who never thinks about craft, or the Lead Designer who never considers team dynamics, is like a doctor who only looks at one body system. Great design leadership requires both people to care about the whole organism, even when they’re not the primary caretaker.</p>
<p>This means asking questions rather than making assumptions. “What do you think about the team’s craft development in this area?” or “How do you see this impacting team morale and workload?” keeps both perspectives active in every decision.</p>
<h2 id="section11" class="wp-block-heading"><strong>When the Organism Gets Sick</strong></h2>
<p>Even with clear roles, this partnership can go sideways. Here are the most common failure modes I’ve seen:</p>
<h3 id="section12" class="wp-block-heading"><strong>System Isolation</strong></h3>
<p>The Design Manager focuses only on the nervous system and ignores craft development. The Lead Designer focuses only on the muscular system and ignores team dynamics. Both people retreat to their comfort zones and stop collaborating.</p>
<p><strong>The symptoms:</strong> Team members get mixed messages, work quality suffers, morale drops.</p>
<p><strong>The treatment:</strong> Reconnect around shared outcomes. What are you both trying to achieve? Usually it’s great design work that ships on time from a healthy team. Figure out how both systems serve that goal.</p>
<h3 id="section13" class="wp-block-heading"><strong>Poor Circulation</strong></h3>
<p>Strategic direction is unclear, priorities keep shifting, and neither role is taking responsibility for keeping information flowing.</p>
<p><strong>The symptoms:</strong> Team members are confused about priorities, work gets duplicated or dropped, deadlines are missed.</p>
<p><strong>The treatment:</strong> Explicitly assign responsibility for circulation. Who’s communicating what to whom? How often? What’s the feedback loop?</p>
<h3 id="section14" class="wp-block-heading"><strong>Autoimmune Response</strong></h3>
<p>One person feels threatened by the other’s expertise. The Design Manager thinks the Lead Designer is undermining their authority. The Lead Designer thinks the Design Manager doesn’t understand craft.</p>
<p><strong>The symptoms:</strong> Defensive behavior, territorial disputes, team members caught in the middle.</p>
<p><strong>The treatment:</strong> Remember that you’re both caretakers of the same organism. When one system fails, the whole team suffers. When both systems are healthy, the team thrives.</p>
<h2 id="section15" class="wp-block-heading"><strong>The Payoff</strong></h2>
<p>Yes, this model requires more communication. Yes, it requires both people to be secure enough to share responsibility for team health. But the payoff is worth it: better decisions, stronger teams, and design work that’s both excellent and sustainable.</p>
<p>When both roles are healthy and working well together, you get the best of both worlds: deep craft expertise and strong people leadership. When one person is out sick, on vacation, or overwhelmed, the other can help maintain the team’s health. When a decision requires both the people perspective and the craft perspective, you’ve got both right there in the room.</p>
<p>Most importantly, the framework scales. As your team grows, you can apply the same system thinking to new challenges. Need to launch a design system? Lead Designer tends to the muscular system (standards and implementation), Design Manager tends to the nervous system (team adoption and change management), and both tend to circulation (communication and stakeholder alignment).</p>
<h2 id="section16" class="wp-block-heading"><strong>The Bottom Line</strong></h2>
<p>The relationship between a Design Manager and Lead Designer isn’t about dividing territories. It’s about multiplying impact. When both roles understand they’re tending to different aspects of the same healthy organism, magic happens.</p>
<p>The mind and body work together. The team gets both the strategic thinking and the craft excellence they need. And most importantly, the work that ships to users benefits from both perspectives.</p>
<p>So the next time you’re in that meeting room, wondering why two people are talking about the same problem from different angles, remember: you’re watching shared leadership in action. And if it’s working well, both the mind and body of your design team are getting stronger.</p>]]></description>
      <link>https://alistapart.com/article/an-holistic-framework-for-shared-design-leadership/</link>
      <guid>https://alistapart.com/article/an-holistic-framework-for-shared-design-leadership/</guid>
      <pubDate>Wed, 23 Jul 2025 16:10:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[From Beta to Bedrock: Build Products that Stick.]]></title>
      <description><![CDATA[<p>As a product builder over too many years to mention, I’ve lost count of the number of times I’ve seen promising ideas go from zero to hero in a few weeks, only to fizzle out within months.</p>


<p>Financial products, which is the field I work in, are no exception. With people’s real hard-earned money on the line, user expectations running high, and a crowded market, it’s tempting to throw as many features at the wall as possible and hope something sticks. But this approach is a recipe for disaster. Here’s why:</p>
<h2 id="section2" class="wp-block-heading">The pitfalls of feature-first development</h2>
<p>When you start building a financial product from the ground up, or are migrating existing customer journeys from paper or telephony channels onto online banking or mobile apps, it’s easy to get caught up in the excitement of creating new features. You might think, “If I can just add one more thing that solves this particular user problem, they’ll love me!” But what happens when you inevitably hit a roadblock because the narcs (your security team!) don’t like it? When a hard-fought feature isn’t as popular as you thought, or it breaks due to unforeseen complexity?</p>
<p>This is where the concept of Minimum Viable Product (MVP) comes in. Jason Fried’s book <a href="https://basecamp.com/gettingreal"><em>Getting Real</em></a> and his podcast <a href="https://37signals.com/podcast/">Rework</a> often touch on this idea, even if he doesn’t always call it that. An MVP is a product that provides just enough value to your users to keep them engaged, but not so much that it becomes overwhelming or difficult to maintain. It sounds like an easy concept but it requires a razor sharp eye, a ruthless edge and having the courage to stick by your opinion because it is easy to be seduced by “the Columbo Effect”… when there’s always “<a href="https://www.youtube.com/watch?v=vYgUPD2khtw">just one more thing…</a>” that someone wants to add.</p>
<p>The problem with most finance apps, however, is that they often become a reflection of the internal politics of the business rather than an experience solely designed around the customer. This means that the focus is on delivering as many features and functionalities as possible to satisfy the needs and desires of competing internal departments, rather than providing a clear value proposition that is focused on what the people out there in the real world want. As a result, these products can very easily bloat to become a mixed bag of confusing, unrelated and ultimately unlovable customer experiences—a feature salad, you might say.</p>
<h2 id="section3" class="wp-block-heading">The importance of bedrock</h2>
<p>So what’s a better approach? How can we build products that are stable, user-friendly, and—most importantly—stick?</p>
<p>That’s where the concept of “bedrock” comes in. Bedrock is the core element of your product that truly matters to users. It’s the fundamental building block that provides value and stays relevant over time.</p>
<p>In the world of retail banking, which is where I work, the bedrock has got to be in and around the regular servicing journeys. People open their current account once in a blue moon but they look at it every day. They sign up for a credit card every year or two, but they check their balance and pay their bill at least once a month.</p>
<p>Identifying the core tasks that people want to do and then relentlessly striving to make them easy to do, dependable, and trustworthy is where the gravy’s at.</p>
<p>But how do you get to bedrock? By focusing on the “MVP” approach, prioritizing simplicity, and iterating towards a clear value proposition. This means cutting out unnecessary features and focusing on delivering real value to your users.</p>
<p>It also means having some guts, because your colleagues might not always instantly share your vision to start with. And controversially, sometimes it can even mean making it clear to customers that you’re not going to come to their house and make their dinner. The occasional “opinionated user interface design” (i.e. clunky workaround for edge cases) might sometimes be what you need to use to test a concept or buy you space to work on something more important.</p>
<h2 id="section4" class="wp-block-heading">Practical strategies for building financial products that stick</h2>
<p>So what are the key strategies I’ve learned from my own experience and research?</p>
<ol class="wp-block-list"><li>Start with a clear “why”: What problem are you trying to solve? For whom? Make sure your mission is crystal clear before building anything. Make sure it aligns with your company’s objectives, too.</li>
<li>Focus on a single, core feature and obsess on getting that right before moving on to something else: Resist the temptation to add too many features at once. Instead, choose one that delivers real value and iterate from there.</li>
<li>Prioritize simplicity over complexity: Less is often more when it comes to financial products. Cut out unnecessary bells and whistles and keep the focus on what matters most.</li>
<li>Embrace continuous iteration: Bedrock isn’t a fixed destination—it’s a dynamic process. Continuously gather user feedback, refine your product, and iterate towards that bedrock state.</li>
<li>Stop, look and listen: Don’t just test your product as part of your delivery process—test it repeatedly in the field. Use it yourself. Run A/B tests. Gather user feedback. Talk to people who use it, and refine accordingly.</li>
</ol><h2 id="section5" class="wp-block-heading">The bedrock paradox</h2>
<p>There’s an interesting paradox at play here: building towards bedrock means sacrificing some short-term growth potential in favour of long-term stability. But the payoff is worth it—products built with a focus on bedrock will outlast and outperform their competitors, and deliver sustained value to users over time.</p>
<p>So, how do you start your journey towards bedrock? Take it one step at a time. Start by identifying those core elements that truly matter to your users. Focus on building and refining a single, powerful feature that delivers real value. And above all, test obsessively—for, in the words of Abraham Lincoln, Alan Kay, or Peter Drucker (whomever you believe!!), “The best way to predict the future is to create it.”</p>]]></description>
      <link>https://alistapart.com/article/from-beta-to-bedrock-build-products-that-stick/</link>
      <guid>https://alistapart.com/article/from-beta-to-bedrock-build-products-that-stick/</guid>
      <pubDate>Wed, 23 Apr 2025 20:04:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[User Research Is Storytelling]]></title>
      <description><![CDATA[<p>Ever since I was a boy, I’ve been fascinated with movies. I loved the characters and the excitement—but most of all the stories. I wanted to be an actor. And I believed that I’d get to do the things that Indiana Jones did and go on exciting adventures. I even dreamed up ideas for movies that my friends and I could make and star in. But they never went any further. I did, however, end up working in user experience (UX). Now, I realize that there’s an element of theater to UX—I hadn’t really considered it before, but user research is storytelling. And to get the most out of user research, you need to tell a good story where you bring stakeholders—the product team and decision makers—along and get them interested in learning more.</p>


<p>Think of your favorite movie. More than likely it follows a <a href="https://www.studiobinder.com/blog/three-act-structure/">three-act structure</a> that’s commonly seen in storytelling: the setup, the conflict, and the resolution. The first act shows what exists today, and it helps you get to know the characters and the challenges and problems that they face. Act two introduces the conflict, where the action is. Here, problems grow or get worse. And the third and final act is the resolution. This is where the issues are resolved and the characters learn and change. I believe that this structure is also a great way to think about user research, and I think that it can be especially helpful in explaining user research to others.</p>
<figure id="figure1" class="wp-block-image size-large"><img width="960" height="367" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2024/05/user-research-is-storytelling-1.png?resize=960%2C367&amp;ssl=1" alt="A detailed graph that shows the narrative structure of The Godfather and The Dark Knight across three acts. The graph is divided into segments labeled “Act 1,” “Act 2,” and “Act 3” for each film. The purple line represents narrative elements, pacing, and rise in tension and excitement within the movies. For The Godfather, in Act 1, the line rises and then dips slightly before entering Act 2. Act 2 sees the line rise, before reaching a crescendo in Act 3. The line then declines steadily until the end of Act 3. For The Dark Knight, in Act 1, the line rises and then dips slightly before entering Act 2. Act 2 the line rises and dips slightly before entering Act 3. The line then rises again and peaks, which is followed by decline until the end of Act 3." class="wp-image-7174425" srcset="https://i0.wp.com/alistapart.com/wp-content/uploads/2024/05/user-research-is-storytelling-1.png?resize=1024%2C391&amp;ssl=1 1024w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/05/user-research-is-storytelling-1.png?resize=300%2C115&amp;ssl=1 300w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/05/user-research-is-storytelling-1.png?resize=768%2C293&amp;ssl=1 768w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/05/user-research-is-storytelling-1.png?resize=1536%2C587&amp;ssl=1 1536w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/05/user-research-is-storytelling-1.png?w=1600&amp;ssl=1 1600w" sizes="(max-width: 960px) 100vw, 960px" data-recalc-dims="1" /><figcaption class="wp-element-caption">Three-act structure in movies (© 2024 <a href="https://www.studiobinder.com/">StudioBinder</a>. Image used with permission from StudioBinder.).</figcaption></figure><h2 id="section2" class="wp-block-heading"><strong>Use storytelling as a structure to do research</strong></h2>
<p>It’s sad to say, but many have come to see research as being expendable. If budgets or timelines are tight, research tends to be one of the first things to go. Instead of investing in research, some product managers rely on designers or—worse—their own opinion to make the “right” choices for users based on their experience or accepted best practices. That may get teams some of the way, but that approach can so easily miss out on solving users’ real problems. To remain user-centered, this is something we should avoid. User research elevates design. It keeps it on track, pointing to problems and opportunities. Being aware of the issues with your product and reacting to them can help you stay ahead of your competitors.</p>
<p>In the three-act structure, each act corresponds to a part of the process, and each part is critical to telling the whole story. Let’s look at the different acts and how they align with user research.</p>
<h3 id="section3" class="wp-block-heading">Act one: setup</h3>
<p>The setup is all about understanding the background, and that’s where foundational research comes in. <em>Foundational research</em> (also called <em>generative</em>, <em>discovery</em>, or <em>initial</em> research) helps you understand users and identify their problems. You’re learning about what exists today, the challenges users have, and how the challenges affect them—just like in the movies. To do foundational research, you can conduct <a href="https://www.nngroup.com/videos/what-are-contextual-inquiries/">contextual inquiries</a> or <a href="https://uxdesign.cc/diary-studies-cd65a61a4f89">diary studies</a> (or both!), which can help you start to identify problems as well as opportunities. It doesn’t need to be a huge investment in time or money.</p>
<p>Erika Hall writes about <a href="https://medium.com/mule-design/minimum-viable-ethnography-a047e9358df0">minimum viable ethnography</a>, which can be as simple as spending 15 minutes with a user and asking them one thing: “‘Walk me through your day yesterday.’ That’s it. Present that one request. Shut up and listen to them for 15 minutes. Do your damndest to keep yourself and your interests out of it. Bam, you’re doing ethnography.” According to Hall, <em>“</em>[This] will probably prove quite illuminating. In the highly unlikely case that you didn’t learn anything new or useful, carry on with enhanced confidence in your direction.”  </p>
<p>This makes total sense to me. And I love that this makes user research so accessible. You don’t need to prepare a lot of documentation; you can just recruit participants and do it! This can yield a wealth of information about your users, and it’ll help you better understand them and what’s going on in their lives. That’s really what act one is all about: understanding where users are coming from. </p>
<p><a href="https://www.looppanel.com/blog/strategic-ux-research-is-the-future-with-jared-spool">Jared Spool talks about the importance of foundational research</a> and how it should form the bulk of your research. If you can draw from any additional user data that you can get your hands on, such as surveys or analytics, that can supplement what you’ve heard in the foundational studies or even point to areas that need further investigation. Together, all this data paints a clearer picture of the state of things and all its shortcomings. And that’s the beginning of a compelling story. It’s the point in the plot where you realize that the main characters—or the users in this case—are facing challenges that they need to overcome. Like in the movies, this is where you start to build empathy for the characters and root for them to succeed. And hopefully stakeholders are now doing the same. Their sympathy may be with their business, which could be losing money because users can’t complete certain tasks. Or maybe they do empathize with users’ struggles. Either way, act one is your initial hook to get the stakeholders interested and invested.</p>
<p>Once stakeholders begin to understand the value of foundational research, that can open doors to more opportunities that involve users in the decision-making process. And that can guide product teams toward being more user-centered. This benefits everyone—users, the product, and stakeholders. It’s like winning an Oscar in movie terms—it often leads to your product being well received and successful. And this can be an incentive for stakeholders to repeat this process with other products. Storytelling is the key to this process, and knowing how to tell a good story is the only way to get stakeholders to really care about doing more research. </p>
<p>This brings us to act two, where you iteratively evaluate a design or concept to see whether it addresses the issues.</p>
<h3 id="section4" class="wp-block-heading">Act two: conflict</h3>
<p>Act two is all about digging deeper into the problems that you identified in act one. This usually involves <em>directional research</em>, such as usability tests, where you assess a potential solution (such as a design) to see whether it addresses the issues that you found. The issues could include unmet needs or problems with a flow or process that’s tripping users up. Like act two in a movie, more issues will crop up along the way. It’s here that you learn more about the characters as they grow and develop through this act. </p>
<p>Usability tests <a href="https://www.nngroup.com/articles/why-you-only-need-to-test-with-5-users/">should typically include around five participants</a> according to Jakob Nielsen, who found that that number of users can usually identify most of the problems: “As you add more and more users, you learn less and less because you will keep seeing the same things again and again… After the fifth user, you are wasting your time by observing the same findings repeatedly but not learning much new.” </p>
<p>There are parallels with storytelling here too; if you try to tell a story with too many characters, the plot may get lost. Having fewer participants means that each user’s struggles will be more memorable and easier to relay to other stakeholders when talking about the research. This can help convey the issues that need to be addressed while also highlighting the value of doing the research in the first place.</p>
<p>Researchers have run usability tests in person for decades, but you can also <a href="https://www.nngroup.com/articles/moderated-remote-usability-test/">conduct usability tests remotely</a> using tools like Microsoft Teams, Zoom, or other teleconferencing software. This approach has become increasingly popular since the beginning of the pandemic, and it works well. You can think of in-person usability tests like going to a play and remote sessions as more like watching a movie. There are advantages and disadvantages to each. In-person usability research is a much richer experience. Stakeholders can experience the sessions with other stakeholders. You also get real-time reactions—including surprise, agreement, disagreement, and discussions about what they’re seeing. Much like going to a play, where audiences get to take in the stage, the costumes, the lighting, and the actors’ interactions, in-person research lets you see users up close, including their body language, how they interact with the moderator, and how the scene is set up.</p>
<p>If in-person usability testing is like watching a play—staged and controlled—then conducting usability testing in the field is like <a href="https://en.wikipedia.org/wiki/Immersive_theater">immersive theater</a> where any two sessions might be very different from one another. You can take usability testing into the field by <a href="https://boxesandarrows.com/taking-research-out-of-the-lab/">creating a replica of the space where users interact</a> with the product and then conduct your research there. Or you can go out to meet users at their location to do your research. With either option, you get to see how things work in context, things come up that wouldn’t have in a lab environment—and conversion can shift in entirely different directions. As researchers, you have less control over how these sessions go, but this can sometimes help you understand users even better. Meeting users where they are can provide clues to the external forces that could be affecting how they use your product. In-person usability tests provide another level of detail that’s often missing from remote usability tests. </p>
<p>That’s not to say that the “movies”—remote sessions—aren’t a good option. Remote sessions can reach a wider audience. They allow a lot more stakeholders to be involved in the research and to see what’s going on. And they open the doors to a much wider geographical pool of users. But with any remote session there is the potential of time wasted if participants can’t log in or get their microphone working. </p>
<p>The benefit of <a href="https://boxesandarrows.com/usability-testing-guide/">usability testing, whether remote or in person</a>, is that you get to see real users interact with the designs in real time, and you can ask them questions to understand their thought processes and grasp of the solution. This can help you not only identify problems but also glean why they’re problems in the first place. Furthermore, you can test hypotheses and gauge whether your thinking is correct. By the end of the sessions, you’ll have a much clearer picture of how usable the designs are and whether they work for their intended purposes. Act two is the heart of the story—where the excitement is—but there can be surprises too. This is equally true of usability tests. <a href="https://articles.centercentre.com/three_hund_million_button/">Often, participants will say unexpected things</a>, which change the way that you look at things—and these twists in the story can move things in new directions. </p>
<p>Unfortunately, user research is sometimes seen as expendable. And too often usability testing is the only research process that some stakeholders think that they ever need. In fact, if the designs that you’re evaluating in the usability test aren’t grounded in a solid understanding of your users (foundational research), there’s not much to be gained by doing usability testing in the first place. That’s because you’re narrowing the focus of what you’re getting feedback on, without understanding the users’ needs. As a result, there’s no way of knowing whether the designs might solve a problem that users have. It’s only feedback on a particular design in the context of a usability test.  </p>
<p>On the other hand, if you only do foundational research, while you might have set out to solve the right problem, you won’t know whether the thing that you’re building will actually solve that. This illustrates the importance of doing both foundational and directional research. </p>
<p>In act two, stakeholders will—hopefully—get to watch the story unfold in the user sessions, which creates the conflict and tension in the current design by surfacing their highs and lows. And in turn, this can help motivate stakeholders to address the issues that come up.</p>
<h3 id="section5" class="wp-block-heading">Act three: resolution</h3>
<p>While the first two acts are about understanding the background and the tensions that can propel stakeholders into action, the third part is about resolving the problems from the first two acts. While it’s important to have an audience for the first two acts, it’s crucial that they stick around for the final act. That means the whole product team, including developers, UX practitioners, business analysts, delivery managers, product managers, and any other stakeholders that have a say in the next steps. It allows the whole team to hear users’ feedback together, ask questions, and discuss what’s possible within the project’s constraints. And it lets the UX research and design teams clarify, suggest alternatives, or give more context behind their decisions. So you can get everyone on the same page and get agreement on the way forward.</p>
<p>This act is mostly told in voiceover with some audience participation. The researcher is the narrator, who paints a picture of the issues and what the future of the product could look like given the things that the team has learned. They give the stakeholders their recommendations and their guidance on creating this vision.</p>
<p>Nancy Duarte in the <em>Harvard Business Review</em> offers an approach to <a href="https://hbr.org/2012/10/structure-your-presentation-li">structuring presentations that follow a persuasive story</a>. “The <a href="http://en.wikipedia.org/wiki/I_Have_a_Dream">most effective presenters</a> use the same techniques as great storytellers: By reminding people of the status quo and then revealing the path to a better way, they set up a conflict that needs to be resolved,” writes Duarte. “That tension helps them persuade the audience to adopt a new mindset or behave differently.”</p>
<figure id="figure2" class="wp-block-image size-large"><img width="960" height="263" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2024/05/user-research-is-storytelling-2.jpg?resize=960%2C263&amp;ssl=1" alt="A diagram, depicting a persuasive story pattern, segmented into distinct sections that outline a narrative flow. Starting with “Beginning,” followed by “Middle,” and concluding with “End.” The “Beginning” starts with a box labeled “What is.” A line rises up to the box labeled “What could be.” A line goes from this box into “Middle” and back down to “What is” and then back up to “What could be.” This repeats one more time in “Middle,” before a line goes from “What could be” up to a box labeled “Vision of the future” in “End.” “'Call to action” is written below the “Vision of the future” box to signify that the vision is a call to action." class="wp-image-7174426" srcset="https://i0.wp.com/alistapart.com/wp-content/uploads/2024/05/user-research-is-storytelling-2.jpg?resize=1024%2C280&amp;ssl=1 1024w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/05/user-research-is-storytelling-2.jpg?resize=300%2C82&amp;ssl=1 300w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/05/user-research-is-storytelling-2.jpg?resize=768%2C210&amp;ssl=1 768w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/05/user-research-is-storytelling-2.jpg?resize=1536%2C420&amp;ssl=1 1536w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/05/user-research-is-storytelling-2.jpg?w=1600&amp;ssl=1 1600w" sizes="(max-width: 960px) 100vw, 960px" data-recalc-dims="1" /><figcaption class="wp-element-caption">A persuasive story pattern.</figcaption></figure><p>This type of structure aligns well with research results, and particularly results from usability tests. It provides evidence for “what is”—the problems that you’ve identified. And “what could be”—your recommendations on how to address them. And so on and so forth.</p>
<p>You can reinforce your recommendations with examples of things that competitors are doing that could address these issues or with examples where competitors are gaining an edge. Or they can be visual, like quick mockups of how a new design could look that solves a problem. These can help generate conversation and momentum. And this continues until the end of the session when you’ve wrapped everything up in the conclusion by summarizing the main issues and suggesting a way forward. This is the part where you reiterate the main themes or problems and what they mean for the product—the denouement of the story. This stage gives stakeholders the next steps and hopefully the momentum to take those steps!</p>
<p>While we are nearly at the end of this story, let’s reflect on the idea that user research is storytelling. All the elements of a good story are there in the three-act structure of user research: </p>
<ul><li><strong>Act one</strong>: You meet the protagonists (the users) and the antagonists (the problems affecting users). This is the beginning of the plot. In act one, researchers might use methods including contextual inquiry, ethnography, diary studies, surveys, and analytics. The output of these methods can include personas, empathy maps, user journeys, and analytics dashboards.</li>
</ul><ul><li><strong>Act two</strong>: Next, there’s character development. There’s conflict and tension as the protagonists encounter problems and challenges, which they must overcome. In act two, researchers might use methods including usability testing, competitive benchmarking, and heuristics evaluation. The output of these can include usability findings reports, UX strategy documents, usability guidelines, and best practices.</li>
</ul><ul><li><strong>Act three</strong>: The protagonists triumph and you see what a better future looks like. In act three, researchers may use methods including presentation decks, storytelling, and digital media. The output of these can be: presentation decks, video clips, audio clips, and pictures. </li>
</ul><p>The researcher has multiple roles: they’re the storyteller, the director, and the producer. The participants have a small role, but they are significant characters (in the research). And the stakeholders are the audience. But the most important thing is to get the story right and to use storytelling to tell users’ stories through research. By the end, the stakeholders should walk away with a purpose and an eagerness to resolve the product’s ills. </p>
<p>So the next time that you’re planning research with clients or you’re speaking to stakeholders about research that you’ve done, think about how you can weave in some storytelling. Ultimately, user research is a win-win for everyone, and you just need to get stakeholders interested in how the story ends.</p>]]></description>
      <link>https://alistapart.com/article/user-research-is-storytelling/</link>
      <guid>https://alistapart.com/article/user-research-is-storytelling/</guid>
      <pubDate>Thu, 30 May 2024 20:04:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[To Ignite a Personalization Practice, Run this Prepersonalization Workshop]]></title>
      <description><![CDATA[<p>Picture this. You’ve joined a squad at your company that’s designing new product features with an emphasis on automation or AI. Or your company has just implemented a <a href="https://en.wikipedia.org/wiki/Personalization_management_system">personalization engine</a>. Either way, you’re designing with data. Now what? When it comes to <a href="https://alistapart.com/article/personalization-pyramid/">designing for personalization</a>, there are many cautionary tales, no overnight successes, and few guides for the perplexed. </p>


<p>Between the fantasy of getting it right and the fear of it going wrong—like when we encounter “<a href="https://visit.bucketbriga.de/c/personalization-failure-persofail/">persofails</a>” in the vein of a company <a href="https://twitter.com/jeffmacintyre/status/1505878250937061378">repeatedly imploring everyday consumers to buy additional toilet seats</a>—the personalization gap is real. It’s an especially confounding place to be a digital professional without a map, a compass, or a plan.</p>
<p>For those of you venturing into personalization, there’s no <em>Lonely Planet</em> and few tour guides because effective personalization is so specific to each organization’s talent, technology, and market position. </p>
<p>But you can ensure that your team has packed its bags sensibly.</p>
<figure id="figure1" class="wp-block-image size-large"><img width="960" height="641" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/suggested-vistas.jpg?resize=960%2C641&amp;ssl=1" alt="A sign at a mountain scene says “People who liked this also liked,” which is followed by photographs of other scenic landscapes. Satirical art installation by Scott Kelly and Ben Polkinghome." class="wp-image-7174341" srcset="https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/suggested-vistas.jpg?resize=1024%2C684&amp;ssl=1 1024w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/suggested-vistas.jpg?resize=300%2C201&amp;ssl=1 300w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/suggested-vistas.jpg?resize=768%2C513&amp;ssl=1 768w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/suggested-vistas.jpg?w=1200&amp;ssl=1 1200w" sizes="(max-width: 960px) 100vw, 960px" data-recalc-dims="1" /><figcaption class="wp-element-caption"><em>Designing for personalization makes for strange bedfellows. A savvy art-installation satire on the challenges of humane design in the era of the algorithm. Credit:</em> <a href="https://www.scottconradkelly.com/signs-of-the-times"><em>Signs of the Times</em></a><em>,</em> <em>Scott Kelly and Ben Polkinghome.</em></figcaption></figure><p>There’s a DIY formula to increase your chances for success. At minimum, you’ll defuse your boss’s irrational exuberance. Before the party you’ll need to effectively prepare.</p>
<p>We call it <strong>prepersonalization</strong>.</p>
<h2 id="section2" class="wp-block-heading"><strong>Behind the music</strong></h2>
<p>Consider Spotify’s DJ feature, which debuted this past year.</p>
<figure id="figure2" class="wp-block-embed is-type-video is-provider-youtube wp-block-embed-youtube wp-embed-aspect-16-9 wp-has-aspect-ratio"><div class="wp-block-embed__wrapper jetpack-video-wrapper"><iframe class="youtube-player c1" width="960" height="540" src="https://www.youtube.com/embed/ok-aNnc0Dko?version=3&amp;rel=1&amp;showsearch=0&amp;showinfo=1&amp;iv_load_policy=1&amp;fs=1&amp;hl=en-US&amp;autohide=2&amp;wmode=transparent" allowfullscreen="allowfullscreen" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox">[embedded content]</iframe></div>
</figure><p>We’re used to seeing the polished final result of a personalization feature. Before <a href="https://www.linkedin.com/posts/daniel-ek-1b52093a_spotify-dj-the-200-best-inventions-of-2023-activity-7122612194923483137-rRNc/">the year-end award</a>, the <a href="https://newsroom.spotify.com/2023-10-18/how-spotify-uses-design-to-make-personalization-features-delightful/">making-of backstory</a>, or the behind-the-scenes <a href="https://newsroom.spotify.com/2023-03-08/spotify-new-personalized-ai-dj-how-it-works/">victory lap</a>, a personalized feature had to be conceived, budgeted, and prioritized. Before any personalization feature goes live in your product or service, it lives amid a backlog of worthy ideas for expressing customer experiences more dynamically.</p>
<p>So how do you know where to place your personalization bets? How do you design consistent interactions that won’t trip up users or—worse—breed mistrust? We’ve found that for many budgeted programs to justify their ongoing investments, they first needed one or more workshops to convene key stakeholders and internal customers of the technology. Make yours count.</p>
<p>​From <a href="https://en.wikipedia.org/wiki/Big_Tech#:~:text=Alphabet%2C%20the%20parent%20company%20of,Amazon%2C%20Netflix%2C%20and%20Google.">Big Tech</a> to fledgling startups, we’ve seen the same evolution up close with our clients. In our experiences with working on small and large personalization efforts, a program’s ultimate track record—and its ability to weather tough questions, work steadily toward shared answers, and organize its design and technology efforts—turns on how effectively these prepersonalization activities play out.</p>
<p>Time and again, we’ve seen effective workshops separate future success stories from unsuccessful efforts, saving countless time, resources, and collective well-being in the process.</p>
<p>A personalization practice involves a multiyear effort of testing and feature development. It’s not a switch-flip moment in your tech stack. It’s best managed as a backlog that often evolves through three steps: </p>
<ol><li>customer experience optimization (CXO, also known as A/B testing or experimentation)</li>
<li>always-on automations (whether rules-based or machine-generated)</li>
<li>mature features or standalone product development (such as Spotify’s DJ experience)</li>
</ol><p>This is why we created our progressive personalization framework and why we’re field-testing an accompanying <a href="https://progressivepersonalization.com/">deck of cards</a>: we believe that <em>there’s a base grammar, a set of “nouns and verbs” that your organization can use to design experiences that are customized, personalized, or automated</em>. You won’t need these cards. But we strongly recommend that you create something similar, whether that might be digital or physical.</p>
<h2 id="section3" class="wp-block-heading">Set your kitchen timer</h2>
<p>How long does it take to cook up a prepersonalization workshop? The surrounding assessment activities that we recommend including can (and often do) span weeks. For the core workshop, we recommend aiming for two to three days. Here’s a summary of our broader approach along with details on the essential first-day activities.</p>
<p>The full arc of the wider workshop is threefold:</p>
<ol><li><strong>Kickstart:</strong> This sets the terms of engagement as you focus on the opportunity as well as the readiness and drive of your team and your leadership. .</li>
<li><strong>Plan your work:</strong> This is the heart of the card-based workshop activities where you specify a plan of attack and the scope of work.</li>
<li><strong>Work your plan:</strong> This phase is all about creating a competitive environment for team participants to individually pitch their own pilots that each contain a proof-of-concept project, its business case, and its operating model.</li>
</ol><p>Give yourself at least a day, split into two large time blocks, to power through a concentrated version of those first two phases.</p>
<h2 id="section4" class="wp-block-heading">Kickstart: Whet your appetite</h2>
<p>We call the first lesson the “landscape of connected experience.” It explores the personalization possibilities in your organization. A <strong>connected experience</strong>, in our parlance, is <em>any UX requiring the orchestration of multiple systems of record</em> on the backend. This could be a content-management system combined with a marketing-automation platform. It could be a digital-asset manager combined with a customer-data platform.</p>
<p>Spark conversation by naming consumer examples and business-to-business examples of connected experience interactions that you admire, find familiar, or even dislike. This should cover a representative range of personalization patterns, including automated app-based interactions (such as onboarding sequences or wizards), notifications, and recommenders. We have a catalog of these in the cards. Here’s a list of <a href="https://www.dynamicyield.com/personalization-examples/">142 different interactions</a> to jog your thinking.</p>
<p>This is all about setting the table. What are the possible paths for the practice in your organization? If you want a broader view, here’s a <a href="https://visit.bucketbriga.de/c/field-notes/navigating-the-personalization-gap-a-field-guide">long-form primer</a> and a <a href="https://visit.bucketbriga.de/c/field-notes/progressive-personalization-a-decisionmaking-model-for-better-outcomes-in-personalized-ux">strategic framework</a>.</p>
<p>Assess each example that you discuss for its complexity and the level of effort that you estimate that it would take for your team to deliver that feature (or something similar). In our cards, we divide connected experiences into five levels: functions, features, experiences, complete products, and portfolios. Size your own build here. This will help to focus the conversation on the merits of ongoing investment as well as the gap between what you deliver today and what you want to deliver in the future.</p>
<p>Next, have your team plot each idea on the following 2×2 grid, which lays out the <strong>four enduring arguments</strong> for a personalized experience. This is critical because it emphasizes how personalization can not only help your external customers but also affect your own ways of working. It’s also a reminder (which is why we used the word <em>argument</em> earlier) of the broader effort beyond these tactical interventions.</p>
<figure id="figure3" class="wp-block-image size-large"><img width="960" height="539" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/arguments-for-personalization.jpg?resize=960%2C539&amp;ssl=1" alt="A two-by-two grid shows the four areas of emphasis for a personalization program in an organization: Business efficiency, customer experience, business orchestration, and customer understanding. The focus varies from front-stage to back-stage and from business-focused to customer-focused outcomes." class="wp-image-7174342" srcset="https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/arguments-for-personalization.jpg?resize=1024%2C575&amp;ssl=1 1024w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/arguments-for-personalization.jpg?resize=300%2C168&amp;ssl=1 300w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/arguments-for-personalization.jpg?resize=768%2C431&amp;ssl=1 768w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/arguments-for-personalization.jpg?resize=1536%2C862&amp;ssl=1 1536w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/arguments-for-personalization.jpg?w=1600&amp;ssl=1 1600w" sizes="(max-width: 960px) 100vw, 960px" data-recalc-dims="1" /><figcaption class="wp-element-caption"><em>Getting intentional about the desired outcomes is an important component to a large-scale personalization program. Credit:</em> <a href="https://bucket.studio/"><em>Bucket Studio</em></a><em>.</em></figcaption></figure><p>Each team member should vote on where they see your product or service putting its emphasis. Naturally, you can’t prioritize all of them. The intention here is to flesh out how different departments may view their own upsides to the effort, which can vary from one to the next. Documenting your desired outcomes lets you know how the team internally aligns across representatives from different departments or functional areas.</p>
<p>The third and final kickstart activity is about naming your <strong>personalization gap</strong>. Is your customer journey well documented? Will data and privacy compliance be too big of a challenge? Do you have <a href="https://aws.amazon.com/blogs/machine-learning/selecting-the-right-metadata-to-build-high-performing-recommendation-models-with-amazon-personalize/">content metadata needs</a> that you have to address? (We’re pretty sure that you do: it’s just a matter of recognizing the relative size of that need and its remedy.) In our cards, we’ve noted a number of program risks, including common team dispositions. Our Detractor card, for example, lists six stakeholder behaviors that hinder progress.</p>
<p>Effectively collaborating and managing expectations is critical to your success. Consider the potential barriers to your future progress. Press the participants to name specific steps to overcome or mitigate those barriers in your organization. As studies have shown, personalization efforts face many common barriers.</p>
<figure id="figure4" class="wp-block-image size-large"><img width="960" height="453" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/barriers-to-personalization.jpg?resize=960%2C453&amp;ssl=1" alt="Barriers to personalization according to a Boston Consulting Group 2016 research study. The top items include “too few personnel dedicated to personalization,” “lack of a clear roadmap,” and “inadequate cross-functional coordination and project management.”" class="wp-image-7174343" srcset="https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/barriers-to-personalization.jpg?resize=1024%2C483&amp;ssl=1 1024w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/barriers-to-personalization.jpg?resize=300%2C142&amp;ssl=1 300w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/barriers-to-personalization.jpg?resize=768%2C363&amp;ssl=1 768w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/barriers-to-personalization.jpg?w=1436&amp;ssl=1 1436w" sizes="(max-width: 960px) 100vw, 960px" data-recalc-dims="1" /><figcaption class="wp-element-caption"><em>The largest management consultancies have established practice areas in personalization, and they regularly research program risks and challenges. Credit:</em> <a href="https://www.bcg.com/publications/2017/retail-marketing-sales-profiting-personalization"><em>Boston Consulting Group</em></a><em>.</em></figcaption></figure><p>At this point, you’ve hopefully discussed sample interactions, emphasized a key area of benefit, and flagged key gaps? Good—you’re ready to continue.</p>
<h2 id="section5" class="wp-block-heading">Hit that test kitchen</h2>
<p>Next, let’s look at what you’ll need to bring your personalization recipes to life. Personalization engines, which are robust software suites for automating and expressing dynamic content, can intimidate new customers. Their capabilities are sweeping and powerful, and they present broad options for how your organization can conduct its activities. This presents the question: Where do you begin when you’re configuring a connected experience?</p>
<p>What’s important here is to avoid treating the installed software like it were a dream kitchen from some fantasy remodeling project (as one of our client executives memorably put it). These software engines are more like <strong>test kitchens</strong> where your team can begin devising, tasting, and refining the snacks and meals that will become a part of your personalization program’s regularly evolving menu.</p>
<figure id="figure5" class="wp-block-image size-large"><img width="960" height="540" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/personalization-pyramid.jpg?resize=960%2C540&amp;ssl=1" alt="The Progressive Personalization Model v2: A pyramid with the following layers, starting at the base and working up: Raw Data (millions), Actionable Data (hundreds of thousands), Segments (thousands), Customer Experience Patterns (many), Interactions (dozens), and Goals (handful)." class="wp-image-7174344" srcset="https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/personalization-pyramid.jpg?resize=1024%2C576&amp;ssl=1 1024w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/personalization-pyramid.jpg?resize=300%2C169&amp;ssl=1 300w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/personalization-pyramid.jpg?resize=768%2C432&amp;ssl=1 768w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/personalization-pyramid.jpg?resize=1536%2C864&amp;ssl=1 1536w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/personalization-pyramid.jpg?w=1600&amp;ssl=1 1600w" sizes="(max-width: 960px) 100vw, 960px" data-recalc-dims="1" /><figcaption class="wp-element-caption"><em>Progressive personalization, a framework for designing connected experiences. Credit:</em> <a href="https://bucket.studio/"><em>Bucket Studio</em></a> <em>and Colin Eagan.</em></figcaption></figure><p>The ultimate menu of the prioritized backlog will come together over the course of the workshop. And creating “dishes” is the way that you’ll have individual team stakeholders construct personalized interactions that serve their needs or the needs of others.</p>
<p>The dishes will come from recipes, and those recipes have set ingredients.</p>
<figure id="figure6" class="wp-block-image size-large"><img width="960" height="540" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/personalization-poker-deck.jpg?resize=960%2C540&amp;ssl=1" alt="A photo of the Progressive Personalization deck of cards with accompanying text reading: Align on key terms and tactics. Draft and groom a full backlog, designing with data." class="wp-image-7174345" srcset="https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/personalization-poker-deck.jpg?resize=1024%2C576&amp;ssl=1 1024w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/personalization-poker-deck.jpg?resize=300%2C169&amp;ssl=1 300w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/personalization-poker-deck.jpg?resize=768%2C432&amp;ssl=1 768w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/personalization-poker-deck.jpg?resize=1536%2C864&amp;ssl=1 1536w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/personalization-poker-deck.jpg?w=1600&amp;ssl=1 1600w" sizes="(max-width: 960px) 100vw, 960px" data-recalc-dims="1" /></figure><figure id="figure7" class="wp-block-image size-large"><img width="960" height="619" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/poker-deck-cards.jpg?resize=960%2C619&amp;ssl=1" alt="A zoomed out view of many of the cards in the deck. Cards have colors corresponding to the layers of the personalization pyramid and include actionable details." class="wp-image-7174346" srcset="https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/poker-deck-cards.jpg?resize=1024%2C660&amp;ssl=1 1024w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/poker-deck-cards.jpg?resize=300%2C194&amp;ssl=1 300w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/poker-deck-cards.jpg?resize=768%2C495&amp;ssl=1 768w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/poker-deck-cards.jpg?resize=1536%2C991&amp;ssl=1 1536w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/poker-deck-cards.jpg?w=1600&amp;ssl=1 1600w" sizes="(max-width: 960px) 100vw, 960px" data-recalc-dims="1" /></figure><figure id="figure8" class="wp-block-image size-large"><img width="960" height="536" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/poker-deck-recipes.jpg?resize=960%2C536&amp;ssl=1" alt="Progressive personalization is a model of designing for personalized interactions that uses playing cards to assemble the typical parts for such features and functionality." class="wp-image-7174347" srcset="https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/poker-deck-recipes.jpg?resize=1024%2C572&amp;ssl=1 1024w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/poker-deck-recipes.jpg?resize=300%2C168&amp;ssl=1 300w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/poker-deck-recipes.jpg?resize=768%2C429&amp;ssl=1 768w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/poker-deck-recipes.jpg?resize=1536%2C858&amp;ssl=1 1536w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/poker-deck-recipes.jpg?w=1600&amp;ssl=1 1600w" sizes="(max-width: 960px) 100vw, 960px" data-recalc-dims="1" /><figcaption class="wp-element-caption"><em>In the same way that ingredients form a recipe, you can also create</em> <a href="http://progressivepersonalization.com/"><em>cards</em></a> <em>to break down a personalized interaction into its constituent parts. Credit:</em> <a href="https://bucket.studio/"><em>Bucket Studio</em></a> <em>and Colin Eagan.</em></figcaption></figure><h2 id="section6" class="wp-block-heading">Verify your ingredients</h2>
<p>Like a good product manager, you’ll make sure—andyou’ll validate with the right stakeholders present—that you have all the ingredients on hand to cook up your desired interaction (or that you can work out what needs to be added to your pantry). These ingredients include the audience that you’re targeting, content and design elements, the context for the interaction, and your measure for how it’ll come together. </p>
<p>This isn’t just about discovering requirements. Documenting your personalizations as a series of if-then statements lets the team: </p>
<ol><li>compare findings toward a unified approach for developing features, not unlike when artists paint with the same palette; </li>
<li>specify a consistent set of interactions that users find uniform or familiar; </li>
<li>and develop parity across performance measurements and key performance indicators too. </li>
</ol><p>This helps you streamline your designs and your technical efforts while you deliver a shared palette of core motifs of your personalized or automated experience.</p>
<h2 id="section7" class="wp-block-heading">Compose your recipe</h2>
<p>What ingredients are important to you? Think of a who-what-when-why <a href="https://en.wikipedia.org/wiki/Five_Ws">construct</a>: </p>
<ul><li>Who are your key audience segments or groups?</li>
<li>What kind of content will you give them, in what design elements, and under what circumstances?</li>
<li>And for which business and user benefits?</li>
</ul><p>We first developed these <a href="https://alistapart.com/article/personalization-pyramid/">cards and card categories</a> five years ago. We regularly play-test their fit with conference audiences and clients. And we still encounter new possibilities. But they all follow an underlying who-what-when-why logic.</p>
<p>Here are three examples for a subscription-based reading app, which you can generally follow along with right to left in the cards in the accompanying photo below. </p>
<ol><li>Nurture personalization: When a guest or an unknown visitor interacts with  a product title, a banner or alert bar appears that makes it easier for them to encounter a related title they may want to read, saving them time.</li>
<li>Welcome automation: When there’s a newly registered user, an email is generated to call out the breadth of the content catalog and to make them a happier subscriber.</li>
<li>Winback automation: Before their subscription lapses or after a recent failed renewal, a user is sent an email that gives them a promotional offer to suggest that they reconsider renewing or to remind them to renew.</li>
</ol><figure id="figure9" class="wp-block-image size-large"><img width="960" height="537" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/recipe-nurture.jpg?resize=960%2C537&amp;ssl=1" alt="A selection of prompt cards assembled to represent the key parameters of a “nurture” user flow." class="wp-image-7174348" srcset="https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/recipe-nurture.jpg?resize=1024%2C573&amp;ssl=1 1024w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/recipe-nurture.jpg?resize=300%2C168&amp;ssl=1 300w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/recipe-nurture.jpg?resize=768%2C430&amp;ssl=1 768w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/recipe-nurture.jpg?resize=1536%2C859&amp;ssl=1 1536w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/recipe-nurture.jpg?w=1600&amp;ssl=1 1600w" sizes="(max-width: 960px) 100vw, 960px" data-recalc-dims="1" /><figcaption class="wp-element-caption"><em>A “nurture” automation may trigger a banner or alert box that promotes content that makes it easier for users to complete a common task, based on behavioral profiling of two user types. Credit:</em> <a href="https://bucket.studio/"><em>Bucket Studio</em></a><em>.</em></figcaption></figure><figure id="figure10" class="wp-block-image size-large"><img width="960" height="538" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/recipe-welcome.jpg?resize=960%2C538&amp;ssl=1" alt="A selection of prompt cards assembled to represent the key parameters of a “welcome”, or onboarding, user flow." class="wp-image-7174349" srcset="https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/recipe-welcome.jpg?resize=1024%2C574&amp;ssl=1 1024w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/recipe-welcome.jpg?resize=300%2C168&amp;ssl=1 300w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/recipe-welcome.jpg?resize=768%2C431&amp;ssl=1 768w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/recipe-welcome.jpg?resize=1536%2C861&amp;ssl=1 1536w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/recipe-welcome.jpg?w=1600&amp;ssl=1 1600w" sizes="(max-width: 960px) 100vw, 960px" data-recalc-dims="1" /><figcaption class="wp-element-caption"><em>A “welcome” automation may be triggered for any user that sends an email to help familiarize them with the breadth of a content library, and this email ideally helps them consider selecting various titles (no matter how much time they devote to reviewing the email’s content itself). Credit:</em> <a href="https://bucket.studio/"><em>Bucket Studio</em></a><em>.</em></figcaption></figure><figure id="figure11" class="wp-block-image size-large"><img width="960" height="537" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/recipe-winback.jpg?resize=960%2C537&amp;ssl=1" alt="A selection of prompt cards assembled to represent the key parameters of a “winback”, or customer-churn risk, user flow." class="wp-image-7174350" srcset="https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/recipe-winback.jpg?resize=1024%2C573&amp;ssl=1 1024w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/recipe-winback.jpg?resize=300%2C168&amp;ssl=1 300w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/recipe-winback.jpg?resize=768%2C430&amp;ssl=1 768w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/recipe-winback.jpg?resize=1536%2C859&amp;ssl=1 1536w, https://i0.wp.com/alistapart.com/wp-content/uploads/2024/04/recipe-winback.jpg?w=1600&amp;ssl=1 1600w" sizes="(max-width: 960px) 100vw, 960px" data-recalc-dims="1" /><figcaption class="wp-element-caption"><em>A “winback” automation may be triggered for a specific group, such as users with recently failed credit-card transactions or users at risk of churning out of active usage, that present them with a specific offer to mitigate near-future inactivity. Credit:</em> <a href="https://bucket.studio/"><em>Bucket Studio</em></a><em>.</em></figcaption></figure><p>A useful preworkshop activity may be to think through a first draft of what these cards might be for your organization, although we’ve also found that this process sometimes flows best through cocreating the recipes themselves. Start with a set of blank cards, and begin labeling and grouping them through the design process, eventually distilling them to a refined subset of highly useful candidate cards.</p>
<p>You can think of the later stages of the workshop as <a href="https://visit.bucketbriga.de/c/field-notes/pre-personalization-workshop">moving from recipes toward a cookbook</a> in focus—like a more nuanced customer-journey mapping. Individual “cooks” will pitch their recipes to the team, using a common <a href="https://hbr.org/2016/09/know-your-customers-jobs-to-be-done">jobs-to-be-done</a> format so that measurability and results are baked in, and from there, the resulting collection will be prioritized for finished design and delivery to production.</p>
<h2 id="section8" class="wp-block-heading">Better kitchens require better architecture</h2>
<p>Simplifying a customer experience is a complicated effort for those who are inside delivering it. Beware anyone who says otherwise. With that being said,  “Complicated problems can be hard to solve, but <a href="https://sloanreview.mit.edu/article/the-critical-difference-between-complex-and-complicated/">they are addressable with rules and recipes</a>.”</p>
<p>When personalization becomes a laugh line, it’s because a team is <a href="https://aws.amazon.com/what-is/overfitting/">overfitting</a>: they aren’t designing with their best data. Like a sparse pantry, every organization has metadata debt to go along with its technical debt, and this creates a drag on personalization effectiveness. Your AI’s output quality, for example, is indeed limited by your <a href="https://en.wikipedia.org/wiki/Information_architecture">IA</a>. Spotify’s poster-child prowess today was unfathomable before they <a href="https://www.theguardian.com/technology/2014/mar/06/spotify-echo-nest-streaming-music-deal">acquired</a> a seemingly modest <a href="https://en.wikipedia.org/wiki/The_Echo_Nest">metadata startup</a> that now <a href="https://techcrunch.com/2014/10/19/the-sonic-mad-scientists/">powers</a> its underlying information architecture.</p>
<h2 id="section9" class="wp-block-heading">You can definitely stand the heat…</h2>
<p>Personalization technology opens a doorway into a confounding ocean of possible designs. Only a disciplined and highly collaborative approach will bring about the necessary focus and intention to succeed. So banish the dream kitchen. Instead, hit the test kitchen to save time, preserve job satisfaction and security, and safely dispense with the fanciful ideas that originate upstairs of the doers in your organization. There are meals to serve and mouths to feed.</p>
<p>This workshop framework gives you a fighting shot at lasting success as well as sound beginnings. Wiring up your information layer isn’t an overnight affair. But if you use the same cookbook and shared recipes, you’ll have solid footing for success. We designed these activities to make your organization’s needs concrete and clear, long before the hazards pile up.</p>
<p>While there are associated costs toward investing in this kind of technology and product design, your ability to size up and confront your unique situation and your digital capabilities is time well spent. Don’t squander it. The proof, as they say, is in the pudding.</p>]]></description>
      <link>https://alistapart.com/article/prepersonalization-workshop/</link>
      <guid>https://alistapart.com/article/prepersonalization-workshop/</guid>
      <pubDate>Tue, 16 Apr 2024 21:51:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[The Wax and the Wane of the Web]]></title>
      <description><![CDATA[<p>I offer a single bit of advice to friends and family when they become new parents: <strong>When you start to think that you’ve got everything figured out, everything will change.</strong> Just as you start to get the hang of feedings, diapers, and regular naps, it’s time for solid food, potty training, and overnight sleeping. When you figure those out, it’s time for preschool and rare naps. The cycle goes on and on.</p>


<p>The same applies for those of us working in design and development these days. Having worked on the web for almost three decades at this point, I’ve seen the regular wax and wane of ideas, techniques, and technologies. Each time that we as developers and designers get into a regular rhythm, some new idea or technology comes along to shake things up and remake our world.</p>
<h2 id="section2" class="wp-block-heading"><strong>How we got here</strong></h2>
<p>I built my first website in the mid-’90s. Design and development on the web back then was a free-for-all, with few established norms. For any layout aside from a single column, we used <code>table</code> elements, often with empty cells containing a single pixel spacer GIF to add empty space. We styled text with numerous <code>font</code> tags, nesting the tags every time we wanted to vary the font style. And we had only three or four typefaces to choose from: Arial, Courier, or Times New Roman. When Verdana and Georgia came out in 1996, we rejoiced because our options had nearly doubled. The only safe colors to choose from were the 216 “web safe” colors known to work across platforms. The few interactive elements (like contact forms, guest books, and counters) were mostly powered by CGI scripts (predominantly written in Perl at the time). Achieving any kind of unique look involved a pile of hacks all the way down. Interaction was often limited to specific pages in a site.</p>
<h3 id="section3" class="wp-block-heading"><strong>The birth of web standards</strong></h3>
<p>At the turn of the century, a new cycle started. Crufty code littered with <code>table</code> layouts and <code>font</code> tags waned, and a push for web standards waxed. <a href="https://alistapart.com/article/fear/">Newer technologies like CSS</a> got more widespread adoption by browsers makers, developers, and designers. This shift toward standards didn’t happen accidentally or overnight. It took active engagement between the <a href="https://www.w3.org/">W3C</a> and browser vendors and heavy evangelism from folks like the <a href="https://www.webstandards.org/"><em>Web Standards Project</em></a> to build standards. <a href="https://alistapart.com/"><em>A List Apart</em></a> and books like <em>Designing with Web Standards</em> by Jeffrey Zeldman played key roles in teaching developers and designers why standards are important, how to implement them, and how to sell them to their organizations. And approaches like <a href="http://hesketh.com/publications/progressive_enhancement_and_the_future_of_web_design.html">progressive enhancement</a> introduced the idea that content should be available for all browsers—with additional enhancements available for more advanced browsers. Meanwhile, sites like the <a href="https://csszengarden.com/"><em>CSS Zen Garden</em></a> showcased just how powerful and versatile CSS can be when combined with a solid semantic HTML structure.</p>
<p>Server-side languages like PHP, Java, and .NET overtook Perl as the predominant back-end processors, and the cgi-bin was tossed in the trash bin. With these better server-side tools came the first era of web applications, starting with content-management systems (particularly in the blogging space with tools like <a href="https://web.archive.org/web/19991012022531/http://blogger.com/">Blogger</a>, <a href="https://web.archive.org/web/20010124065100/http://noahgrey.com/greysoft/">Grey Matter</a>, <a href="https://web.archive.org/web/20101206044705/http://www.movabletype.com/blog/2001/10/please-read-before-downloading.html">Movable Type</a>, and <a href="https://wordpress.org/news/2003/05/wordpress-now-available/">WordPress</a>). In the mid-2000s, <a href="https://alistapart.com/article/gettingstartedwithajax/">AJAX</a> opened doors for asynchronous interaction between the front end and back end. Suddenly, pages could update their content without needing to reload. A crop of JavaScript frameworks like <a href="http://prototypejs.org/">Prototype</a>, <a href="https://web.archive.org/web/20080611093629/http://yuiblog.com/blog/2006/02/13/the-yahoo-user-interface-library/">YUI</a>, and <a href="https://web.archive.org/web/20060204064635/https://jquery.com/">jQuery</a> arose to help developers build more reliable client-side interaction across browsers that had wildly varying levels of standards support. Techniques like <a href="https://alistapart.com/article/dynatext/">image replacement</a> let crafty designers and developers display fonts of their choosing. And technologies like Flash made it possible to add animations, games, and even more interactivity.</p>
<p>These new technologies, standards, and techniques reinvigorated the industry in many ways. Web design flourished as designers and developers explored more diverse styles and layouts. But we still relied on tons of hacks. Early CSS was a huge improvement over table-based layouts when it came to basic layout and text styling, but its limitations at the time meant that designers and developers still relied heavily on images for <a href="https://alistapart.com/article/slidingdoors/">complex shapes (such as rounded or angled corners)</a> and tiled backgrounds for <a href="https://alistapart.com/article/fauxcolumns/">the appearance of full-length columns</a> (among other hacks). Complicated layouts required all manner of nested floats or absolute positioning (or both). Flash and image replacement for custom fonts was a great start toward varying the typefaces from the big five, but both hacks introduced accessibility and performance problems. And JavaScript libraries made it easy for anyone to add a dash of interaction to pages, although at the cost of doubling or even quadrupling the download size of simple websites.</p>
<h3 id="section4" class="wp-block-heading"><strong>The web as software platform</strong></h3>
<p>The symbiosis between the front end and back end continued to improve, and that led to the current era of modern web applications. Between expanded server-side programming languages (which kept growing to include Ruby, Python, Go, and others) and newer front-end tools like React, Vue, and Angular, we could build fully capable software on the web. Alongside these tools came others, including collaborative version control, build automation, and shared package libraries. What was once primarily an environment for linked documents became a realm of infinite possibilities.</p>
<p>At the same time, mobile devices became more capable, and they gave us internet access in our pockets. <a href="https://abookapart.com/products/mobile-first">Mobile apps</a> and <a href="https://alistapart.com/article/responsive-web-design/">responsive design</a> opened up opportunities for new interactions anywhere and any time.</p>
<p>This combination of capable mobile devices and powerful development tools contributed to the waxing of social media and other centralized tools for people to connect and consume. As it became easier and more common to connect with others directly on Twitter, Facebook, and even Slack, the desire for hosted personal sites waned. Social media offered connections on a global scale, with both the good and bad that that entails.</p>
<p>Want a much more extensive history of how we got here, with some other takes on ways that we can improve? Jeremy Keith wrote “<a href="https://adactio.com/articles/20638">Of Time and the Web</a>.” Or check out the “<a href="https://www.webdesignmuseum.org/web-design-history">Web Design History Timeline</a>” at the <a href="https://www.webdesignmuseum.org/">Web Design Museum</a>. Neal Agarwal also has a fun tour through “<a href="https://neal.fun/internet-artifacts/">Internet Artifacts</a>.”</p>
<h2 id="section5" class="wp-block-heading"><strong>Where we are now</strong></h2>
<p>In the last couple of years, it’s felt like we’ve begun to reach another major inflection point. As <a href="https://techcrunch.com/2024/02/07/how-twitters-descent-into-chaos-is-paving-the-way-for-a-new-web/">social-media platforms fracture</a> and wane, there’s been a <a href="https://matthiasott.com/articles/into-the-personal-website-verse">growing interest in owning our own content</a> again. There are many different ways to make a website, from the tried-and-true classic of hosting plain HTML files to <a href="https://www.cloudflare.com/learning/performance/static-site-generator/">static site generators</a> to content management systems of all flavors. The fracturing of social media also comes with a cost: we lose crucial infrastructure for discovery and connection. <a href="https://indieweb.org/Webmention">Webmentions</a>, <a href="https://www.rssboard.org/rss-specification">RSS</a>, <a href="https://activitypub.rocks/">ActivityPub</a>, and other tools of the <a href="https://indieweb.org/">IndieWeb</a> can help with this, but they’re still relatively underimplemented and <a href="https://mxb.dev/blog/the-indieweb-for-everyone/#h-lowering-the-barrier">hard to use for the less nerdy</a>. We can build amazing personal websites and add to them regularly, but without discovery and connection, it can sometimes feel like we may as well be shouting into the void.</p>
<p>Browser support for CSS, JavaScript, and other standards like web components has accelerated, especially through efforts like <a href="https://github.com/web-platform-tests/interop">Interop</a>. New technologies gain support across the board in a fraction of the time that they used to. I often learn about a new feature and <a href="https://caniuse.com/">check its browser support</a> only to find that its coverage is already above 80 percent. Nowadays, the barrier to using newer techniques often isn’t browser support but simply the limits of how quickly designers and developers can learn what’s available and how to adopt it.</p>
<p>Today, with <a href="https://daverupert.com/2024/01/time-to-unmaintainable/">a few commands and a couple of lines of code</a>, we can prototype almost any idea. All the tools that we now have available make it easier than ever to start something new. But the upfront cost that these frameworks may save in initial delivery eventually comes due as upgrading and maintaining them becomes a part of our technical debt.</p>
<p>If we rely on third-party frameworks, adopting new standards can sometimes take longer since we may have to wait for those frameworks to adopt those standards. These frameworks—which used to let us adopt new techniques sooner—have now become hindrances instead. These same frameworks often come with <a href="https://tonsky.me/blog/js-bloat/">performance costs</a> too, forcing users to wait for scripts to load before they can read or interact with pages. And when <a href="https://www.kryogenix.org/code/browser/everyonehasjs.html">scripts fail</a> (whether through poor code, network issues, or other environmental factors), there’s often no alternative, leaving users with blank or broken pages.</p>
<h2 id="section6" class="wp-block-heading"><strong>Where do we go from here?</strong></h2>
<p>Today’s hacks help to shape tomorrow’s standards. And there’s nothing inherently wrong with embracing hacks—for now—to move the present forward. Problems only arise when we’re unwilling to admit that they’re hacks or we hesitate to replace them. So what can we do to create the future we want for the web?</p>
<p><strong>Build for the long haul.</strong> Optimize for performance, for accessibility, and for the user. Weigh the costs of those developer-friendly tools. They may make your job a little easier today, but how do they affect everything else? What’s the cost to users? To future developers? To standards adoption? Sometimes the convenience may be worth it. Sometimes it’s just a hack that you’ve grown accustomed to. And sometimes it’s holding you back from even better options.</p>
<p><strong>Start from standards.</strong> Standards continue to evolve over time, but browsers have done a remarkably good job of continuing to support older standards. The same isn’t always true of third-party frameworks. Sites built with even the hackiest of HTML from the ’90s still <a href="https://www.vortex.com/">work just fine</a> today. The same can’t always be said of sites built with frameworks even after just a couple years.</p>
<p><strong>Design with care.</strong> Whether your craft is code, pixels, or processes, consider the impacts of each decision. The convenience of many a modern tool comes at the cost of not always understanding the underlying decisions that have led to its design and not always considering the impact that those decisions can have. Rather than rushing headlong to “move fast and break things,” use the time saved by modern tools to consider more carefully and design with deliberation.</p>
<p><strong>Always be learning.</strong> If you’re always learning, you’re also growing. Sometimes it may be hard to pinpoint what’s worth learning and what’s just today’s hack. You might end up focusing on something that won’t matter next year, even if you were to focus solely on learning standards. (<a href="https://alistapart.com/article/webstandards2008/">Remember XHTML?</a>) But constant learning opens up new connections in your brain, and the hacks that you learn one day may help to inform different experiments another day.</p>
<p><strong>Play, experiment, and be weird!</strong> This web that we’ve built is the ultimate experiment. It’s the single largest human endeavor in history, and yet each of us can create our own pocket within it. <a href="https://www.rollingstone.com/culture/culture-commentary/internet-future-about-to-get-weird-1234938403/">Be courageous and try new things</a>. Build a <a href="https://lynnandtonic.com/work/">playground</a> for ideas. Make <a href="https://a-k-apart.com/">goofy experiments</a> in your own mad <a href="https://neal.fun/">science</a> <a href="https://labs.jensimmons.com/">lab</a>. Start your own <a href="https://www.zeldman.com/2023/11/28/fly-my-designers-fly/">small business</a>. There has never been a more empowering place to be creative, take risks, and explore what we’re capable of.</p>
<p><strong>Share and amplify.</strong> As you experiment, play, and learn, share what’s worked for you. Write on your own website, post on whichever social media site you prefer, or shout it from a TikTok. <a href="https://alistapart.com/about/contribute/">Write something for <em>A List Apart</em></a>! But take the time to <a href="https://hidde.blog/sharing-links/">amplify others</a> too: find new voices, learn from them, and share what they’ve taught you.</p>
<h3 id="section7" class="wp-block-heading"><strong>Go forth and make</strong></h3>
<p>As designers and developers for the web (and beyond), we’re responsible for building the future every day, whether that may take the shape of personal websites, social media tools used by billions, or anything in between. Let’s imbue our values into the things that we create, and let’s make the web a better place for everyone. Create that thing that only you are uniquely qualified to make. Then share it, make it better, make it again, or make something new. Learn. Make. Share. Grow. Rinse and repeat. Every time you think that you’ve mastered the web, everything will change.</p>]]></description>
      <link>https://alistapart.com/article/the-wax-and-the-wane-of-the-web/</link>
      <guid>https://alistapart.com/article/the-wax-and-the-wane-of-the-web/</guid>
      <pubDate>Thu, 29 Feb 2024 15:45:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[Opportunities for AI in Accessibility]]></title>
      <description><![CDATA[<p>In reading <a href="https://www.joedolson.com/2023/06/accessibility-and-artificial-intelligence/">Joe Dolson’s recent piece on the intersection of AI and accessibility</a>, I absolutely appreciated the skepticism that he has for AI in general as well as for the ways that many have been using it. In fact, I’m very skeptical of AI myself, despite my role at Microsoft as an accessibility innovation strategist who helps run the AI for Accessibility grant program. As with any tool, AI can be used in very constructive, inclusive, and accessible ways; and it can also be used in destructive, exclusive, and harmful ones. And there are a ton of uses somewhere in the mediocre middle as well.</p>


<p>I’d like you to consider this a “yes… and” piece to complement Joe’s post. I’m not trying to refute any of what he’s saying but rather provide some visibility to projects and opportunities where AI can make meaningful differences for people with disabilities. To be clear, I’m not saying that there aren’t real risks or pressing issues with AI that need to be addressed—there are, and we’ve needed to address them, like, yesterday—but I want to take a little time to talk about what’s possible in hopes that we’ll get there one day.</p>
<h2 id="section2" class="wp-block-heading"><strong>Alternative text</strong></h2>
<p>Joe’s piece spends a lot of time talking about computer-vision models generating alternative text. He highlights a ton of valid issues with the current state of things. And while computer-vision models continue to improve in the quality and richness of detail in their descriptions, their results aren’t great. As he rightly points out, the current state of image analysis is pretty poor—especially for certain image types—in large part because current AI systems examine images in isolation rather than within the contexts that they’re in (which is a consequence of having separate “foundation” models for text analysis and image analysis). Today’s models aren’t trained to distinguish between images that are contextually relevant (that should probably have descriptions) and those that are purely decorative (which might not need a description) either. Still, I still think there’s potential in this space.</p>
<p>As Joe mentions, human-in-the-loop authoring of alt text should absolutely be a thing. And if AI can pop in to offer a starting point for alt text—even if that starting point might be a prompt saying <em>What is this BS? That’s not right at all… Let me try to offer a starting point</em>—I think that’s a win.</p>
<p>Taking things a step further, if we can specifically train a model to analyze image usage in context, it could help us more quickly identify which images are likely to be decorative and which ones likely require a description. That will help reinforce which contexts call for image descriptions <em>and</em> it’ll improve authors’ efficiency toward making their pages more accessible.</p>
<p>While complex images—like graphs and charts—are challenging to describe in any sort of succinct way (even for humans), <a href="https://openai.com/research/gpt-4#:~:text=Visual%20inputs:%20VGA%20charger">the image example shared in the GPT4 announcement</a> points to an interesting opportunity as well. Let’s suppose that you came across a chart whose description was simply the title of the chart and the kind of visualization it was, such as: <em>Pie chart comparing smartphone usage to feature phone usage among US households making under $30,000 a year.</em> (That would be a pretty awful alt text for a chart since that would tend to leave many questions about the data unanswered, but then again, let’s suppose that that was the description that was in place.) If your browser knew that that image was a pie chart (because an onboard model concluded this), imagine a world where users could ask questions like these about the graphic:</p>
<ul><li><em>Do more people use smartphones or feature phones?</em></li>
<li><em>How many more?</em></li>
<li><em>Is there a group of people that don’t fall into either of these buckets?</em></li>
<li><em>How many is that?</em></li>
</ul><p>Setting aside the realities of <a href="https://machinelearningmastery.com/a-gentle-introduction-to-hallucinations-in-large-language-models/">large language model (LLM) hallucinations</a>—where a model just makes up plausible-sounding “facts”—for a moment, the opportunity to learn more about images and data in this way could be revolutionary for blind and low-vision folks as well as for people with various forms of color blindness, cognitive disabilities, and so on. It could also be useful in educational contexts to help people who <em>can</em> see these charts, as is, to understand the data in the charts.</p>
<p>Taking things a step further: What if you could ask your browser to simplify a complex chart? What if you could ask it to isolate a single line on a line graph? What if you could ask your browser to transpose the colors of the different lines to work better for form of color blindness you have? What if you could ask it to swap colors for patterns? Given these tools’ chat-based interfaces and our existing ability to manipulate images in today’s AI tools, that seems like a possibility.</p>
<p>Now imagine a purpose-built model that could extract the information from that chart and convert it to another format. For example, perhaps it could turn that pie chart (or better yet, a series of pie charts) into more accessible (and useful) formats, like spreadsheets. That would be amazing!</p>
<h2 id="section3" class="wp-block-heading"><strong>Matching algorithms</strong></h2>
<p>Safiya Umoja Noble absolutely hit the nail on the head when she titled her book <a href="http://algorithmsofoppression.com/"><em>Algorithms of Oppression</em></a>. While her book was focused on the ways that search engines reinforce racism, I think that it’s equally true that all computer models have the potential to amplify conflict, bias, and intolerance. Whether it’s Twitter always showing you the latest tweet from a bored billionaire, YouTube sending us into a Q-hole, or Instagram warping our ideas of what natural bodies look like, we know that poorly authored and maintained algorithms are incredibly harmful. A lot of this stems from a lack of diversity among the people who shape and build them. When these platforms are built with inclusively baked in, however, there’s real potential for algorithm development to help people with disabilities.</p>
<p>Take <a href="https://www.mentra.com/">Mentra</a>, for example. They are an employment network for neurodivergent people. They use an algorithm to match job seekers with potential employers based on over 75 data points. On the job-seeker side of things, it considers each candidate’s strengths, their necessary and preferred workplace accommodations, environmental sensitivities, and so on. On the employer side, it considers each work environment, communication factors related to each job, and the like. As a company run by neurodivergent folks, Mentra made the decision to flip the script when it came to typical employment sites. They use their algorithm to propose available candidates to companies, who can then connect with job seekers that they are interested in; reducing the emotional and physical labor on the job-seeker side of things.</p>
<p>When more people with disabilities are involved in the creation of algorithms, that can reduce the chances that these algorithms will inflict harm on their communities. That’s why diverse teams are so important.</p>
<p>Imagine that a social media company’s recommendation engine was tuned to analyze who you’re following and if it was tuned to priorite follow recommendations for people who talked about similar things but who were different in some key ways from your existing sphere of influence. For example, if you were to follow a bunch of nondisabled white male academics who talk about AI, it could suggest that you follow academics who are disabled or aren’t white or aren’t male who also talk about AI. If you took its recommendations, perhaps you’d get a more holistic and nuanced understanding of what’s happening in the AI field. These same systems should also use their understanding of biases about particular communities—including, for instance, the disability community—to make sure that they aren’t recommending any of their users follow accounts that perpetuate biases against (or, worse, spewing hate toward) those groups.</p>
<h2 id="section4" class="wp-block-heading"><strong>Other ways that AI can helps people with disabilities</strong></h2>
<p>If I weren’t trying to put this together between other tasks, I’m sure that I could go on and on, providing all kinds of examples of how AI could be used to help people with disabilities, but I’m going to make this last section into a bit of a lightning round. In no particular order:</p>
<ul><li>Voice preservation. You may have seen <a href="https://arxiv.org/abs/2301.02111">the VALL-E paper</a> or <a href="https://www.apple.com/newsroom/2023/05/apple-previews-live-speech-personal-voice-and-more-new-accessibility-features/">Apple’s Global Accessibility Awareness Day announcement</a> or you may be familiar with the voice-preservation offerings from <a href="https://learn.microsoft.com/en-us/azure/cognitive-services/speech-service/custom-neural-voice">Microsoft</a>, <a href="https://www.acapela-group.com/voices/voice-banking/">Acapela</a>, or others. It’s possible to train an AI model to replicate your voice, which can be a tremendous boon for people who have ALS (Lou Gehrig’s disease) or motor-neuron disease or other medical conditions that can lead to an inability to talk. This is, of course, the same tech that can also be used to create audio deepfakes, so it’s something that we need to approach <a href="https://www.microsoft.com/en-us/ai/responsible-ai"><em>responsibly</em></a>, but the tech has truly transformative potential.</li>
<li>Voice recognition. Researchers like those in the <a href="https://speechaccessibilityproject.beckman.illinois.edu/">Speech Accessibility Project</a> are paying people with disabilities for their help in collecting recordings of people with atypical speech. As I type, they are actively recruiting people with Parkinson’s and related conditions, and they have plans to expand this to other conditions as the project progresses. This research will result in more inclusive data sets that will let more people with disabilities use voice assistants, dictation software, and voice-response services as well as control their computers and other devices more easily, using only their voice.</li>
<li>Text transformation. The current generation of LLMs is quite capable of adjusting existing text content without injecting hallucinations. This is hugely empowering for people with cognitive disabilities who may benefit from text summaries or simplified versions of text or even text that’s prepped for <a href="https://bionic-reading.com/">Bionic Reading</a>.</li>
</ul><h2 id="section5" class="wp-block-heading"><strong>The importance of diverse teams and data</strong></h2>
<p>We need to recognize that our differences matter. Our lived experiences are influenced by the intersections of the identities that we exist in. These lived experiences—with all their complexities (and joys and pain)—are valuable inputs to the software, services, and societies that we shape. Our differences need to be represented in the data that we use to train new models, and the folks who contribute that valuable information need to be compensated for sharing it with us. Inclusive data sets yield more robust models that foster more equitable outcomes.</p>
<p>Want a model that doesn’t demean or patronize or objectify people with disabilities? Make sure that you have content about disabilities that’s authored by people with a range of disabilities, and make sure that that’s well represented in the training data.</p>
<p>Want a model that doesn’t use ableist language? You may be able to use <a href="https://www.selfdefined.app/">existing data sets</a> to build a filter that can intercept and remediate ableist language before it reaches readers. That being said, when it comes to sensitivity reading, AI models won’t be replacing human copy editors anytime soon. </p>
<p>Want a coding copilot that gives you accessible recommendations from the jump? Train it on code that you know to be accessible.</p>
<hr class="wp-block-separator has-alpha-channel-opacity is-style-dots" /><p>I have no doubt that AI can and will harm people… today, tomorrow, and well into the future. But I also believe that we can acknowledge that and, with an eye towards accessibility (and, more broadly, inclusion), make thoughtful, considerate, and intentional changes in our approaches to AI that will reduce harm over time as well. Today, tomorrow, and well into the future.</p>
<hr class="wp-block-separator has-alpha-channel-opacity is-style-dots" /><p>Many thanks to Kartik Sawhney for helping me with the development of this piece, Ashley Bischoff for her invaluable editorial assistance, and, of course, Joe Dolson for the prompt.</p>]]></description>
      <link>https://alistapart.com/article/opportunities-for-ai-in-accessibility/</link>
      <guid>https://alistapart.com/article/opportunities-for-ai-in-accessibility/</guid>
      <pubDate>Wed, 07 Feb 2024 15:00:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[I am a creative.]]></title>
      <description><![CDATA[<p>I am a creative. What I do is alchemy. It is a mystery. I do not so much do it, as let it be done through me.</p>


<p>I am a creative. Not all creative people like this label. Not all see themselves this way. Some creative people see science in what they do. That is their truth, and I respect it. Maybe I even envy them, a little. But my process is different—my being is different.</p>
<p>Apologizing and qualifying in advance is a distraction. That’s what my brain does to sabotage me. I set it aside for now. I can come back later to apologize and qualify. After I’ve said what I came to say. Which is hard enough. </p>
<p><em>Except when it is easy and flows like a river of wine.</em></p>
<p>Sometimes it <em>does</em> come that way. Sometimes what I need to create comes in an instant. I have learned not to say it at that moment, because if you admit that sometimes the idea just comes and it is the best idea and you know it is the best idea, they think you don’t work hard enough.</p>
<p>Sometimes I work and work and work until the idea comes. Sometimes it comes instantly and I don’t tell anyone for three days. Sometimes I’m so excited by the idea that came instantly that I blurt it out, can’t help myself. Like a boy who found a prize in his Cracker Jacks. Sometimes I get away with this. Sometimes other people agree: yes, that <em>is</em> the best idea. Most times they don’t and I regret having  given way to enthusiasm. </p>
<p>Enthusiasm is best saved for the meeting where it will make a difference. Not the casual get-together that proceeds that meeting by two other meetings. Nobody knows why we have all these meetings. We keep saying we’re doing away with them, but then just finding other ways to have them. Sometimes they are even good. But other times they are a distraction from the actual work. The proportion between when meetings are useful, and when they are a pitiful distraction, varies, depending on what you do and where you do it. And who you are and how you do it. Again I digress. I am a creative. That is the theme.</p>
<p>Sometimes many hours of hard and patient work produce something that is barely serviceable. Sometimes I have to accept that and move on to the next project.</p>
<h2 id="section2" class="wp-block-heading">Don’t ask about process. I am a creative. </h2>
<p>I am a creative. I don’t control my dreams. And I don’t control my best ideas.</p>
<p>I can hammer away, surround myself with facts or images, and sometimes that works. I can go for a walk, and sometimes that works. I can be making dinner and there’s a Eureka having nothing to do with sizzling oil and bubbling pots. Often I know what to do the instant I wake up. And then almost as often, as I become conscious and part of the world again, the idea that would have saved me turns to vanishing dust in a mindless yet evil wind of oblivion. For creativity, I believe, comes from that other world. The one we enter in dreams, and perhaps, before birth and after death. But that’s for poets to wonder, and I am not a poet. I am a creative. And it’s for theologians to mass armies about in their creative world that they insist is real. But that is another digression. And a depressing one. Maybe on a much more important topic than whether I am a creative or not. But still a digression from what I came here to say.</p>
<p>Sometimes the process is avoidance. And agony. You know the cliché about the tortured artist? It’s true, even when the artist (and let’s put that noun in quotes) is trying to write a soft drink jingle, a callback in a tired sitcom, a budget request.</p>
<p>Some people who hate being called creative may be closeted creatives, but that’s between them and their gods. No offense meant. Your truth is true too. But mine is for me. </p>
<h2 id="section3" class="wp-block-heading">Creatives recognize creatives.</h2>
<p>Creatives recognize creatives like queers recognize queers, like real rappers recognize real rappers, like cons know cons. Creatives feel massive respect for creatives. We love, honor, emulate, and practically deify the great ones. To deify any human is, of course, a tragic mistake. We have been warned. We know better. We know people are just people. They squabble, they are lonely, they regret their most important decisions, they are poor and hungry, they can be cruel, they can be just as stupid as we can, because, like us, they are clay. But. But. But they make this amazing thing. They birth something that did not exist before them, and could not exist without them. They are the mothers of ideas. And I suppose, since it’s just there, I have to add that they are mothers of invention. <em>Ba dum bum!</em> OK, that’s done. Continue.</p>
<p>Creatives belittle our own small achievements, because we compare them to those of the great ones. Beautiful animation! Well, I’m no Miyazaki. Now THAT is greatness. That is greatness straight from the mind of God. This half-starved little thing I made? It more or less fell off the back of the turnip truck. And the turnips weren’t even fresh.</p>
<p>Creatives knows that, at best, they are <a href="https://www.wikiwand.com/en/Antonio_Salieri">Salieri</a>. Even the creatives who are Mozart believe that. </p>
<p>I am a creative. I haven’t worked in advertising in 30 years, but in my nightmares, it’s my former creative directors who judge me. And they are right to do so. I am too lazy, too facile, and when it really counts, my mind goes blank. There is no pill for creative dysfunction.</p>
<p>I am a creative. Every deadline I make is an adventure that makes Indiana Jones look like a pensioner snoozing in a deck chair. The longer I remain a creative, the faster I am when I do my work and the longer I brood and walk in circles and stare blankly before I do that work. </p>
<p>I am still 10 times faster than people who are not creative, or people who have only been creative a short while, or people who have only been professionally creative a short while. It’s just that, before I work 10 times as fast as they do, I spend twice as long as they do putting the work off. I am that confident in my ability to do a great job when I put my mind to it. I am that addicted to the adrenaline rush of postponement. I am still that afraid of the jump.</p>
<h2 id="section4" class="wp-block-heading">I am not an artist.</h2>
<p>I am a creative. Not an artist. Though I dreamed, as a lad, of someday being that. Some of us belittle our gifts and dislike ourselves, because we are not Michelangelos and Warhols. This is narcissism, but at least we aren’t in politics.</p>
<p>I am a creative. Though I believe in reason and science, I decide by intuition and impulse. And live with what follows. The catastrophes as well as the triumphs. </p>
<p>I am a creative. Every word I’ve said here will anger some other creatives, who see things differently. Ask two creatives a question, get three opinions. Our disagreement, our passion about it, and our commitment to our own truth are, at least to me, the very proofs that we are creatives, no matter how we may feel about that.</p>
<p>I am a creative. I lament my lack of taste in the areas about which I know very little, which is to say almost all areas of human knowledge. And I trust my taste above all other things in the areas closest to my heart, or perhaps, more accurately, to my obsessions. Without my obsessions, I would probably have to spend my time looking life in the eye, and almost none of us can do that for long. Not honestly. Not really. Because much in life, if you really look at it, is unbearable.</p>
<p>I am a creative. I believe, as a parent believes, that when I am gone, some small good part of me will carry on in the mind of at least one other person.</p>
<h2 id="section5" class="wp-block-heading">Working saves me from worrying about work.</h2>
<p>I am a creative. I live in dread of my small gift suddenly going away.</p>
<p>I am a creative. I am too busy making the next thing to spend too much time deeply considering that almost nothing I make will come anywhere near the greatness I comically aspire to.</p>
<p>I am a creative. I believe in the ultimate mystery of process. I believe in it so much, I am even fool enough to publish an essay I dictated into a tiny machine and didn’t take time to review or revise. I won’t do this often, I promise. But I did it just now, because, as afraid as I may be of your seeing through my pitiful gestures toward the beautiful, I was even more afraid of forgetting what I came to say. </p>
<p>There. I think I’ve said it. </p>]]></description>
      <link>https://alistapart.com/article/i-am-a-creative/</link>
      <guid>https://alistapart.com/article/i-am-a-creative/</guid>
      <pubDate>Mon, 29 Jan 2024 16:53:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[Humility: An Essential Value]]></title>
      <description><![CDATA[<p>Humility, a designer’s essential value—that has a nice ring to it. What about humility, an office manager’s essential value? Or a dentist’s? Or a librarian’s? They all sound great. When humility is our guiding light, the path is always open for fulfillment, evolution, connection, and engagement. In this chapter, we’re going to talk about why.</p>


<p>That said, this is a book for designers, and to that end, I’d like to start with a story—well, a journey, really. It’s a personal one, and I’m going to make myself a bit vulnerable along the way. I call it:</p>
<h2 id="section2" class="wp-block-heading"><strong>The Tale of Justin’s Preposterous Pate</strong></h2>
<p>When I was coming out of art school, a long-haired, goateed neophyte, print was a known quantity to me; design on the web, however, was rife with complexities to navigate and discover, a problem to be solved. Though I had been formally trained in graphic design, typography, and layout, what fascinated me was how these traditional skills might be applied to a fledgling digital landscape. This theme would ultimately shape the rest of my career.</p>
<p>So rather than graduate and go into print like many of my friends, I devoured HTML and JavaScript books into the wee hours of the morning and taught myself how to code during my senior year. I wanted—nay, needed—to better understand the underlying implications of what my design decisions would mean once rendered in a browser.</p>
<p>The late ’90s and early 2000s were the so-called “Wild West” of web design. Designers at the time were all figuring out how to apply design and visual communication to the digital landscape. What were the rules? How could we break them and still engage, entertain, and convey information? At a more macro level, how could my values, inclusive of humility, respect, and connection, align in tandem with that? I was hungry to find out.</p>
<p>Though I’m talking about a different era, those are timeless considerations between non-career interactions and the world of design. What are your core passions, or values, that transcend medium? It’s essentially the same concept we discussed earlier on the direct parallels between what fulfills you, agnostic of the tangible or digital realms; the core themes are all the same.</p>
<p>First within tables, animated GIFs, Flash, then with Web Standards, <code>div</code>s, and CSS, there was personality, raw unbridled creativity, and unique means of presentment that often defied any semblance of a visible grid. Splash screens and “browser requirement” pages aplenty. Usability and accessibility were typically victims of such a creation, but such paramount facets of any digital design were largely (and, in hindsight, unfairly) disregarded at the expense of experimentation.</p>
<p>For example, this iteration of my personal portfolio site (“the pseudoroom”) from that era was experimental, if not a bit heavy- handed, in the visual communication of the concept of a living sketchbook. Very skeuomorphic. I collaborated with fellow designer and dear friend Marc Clancy (now a co-founder of the creative project organizing app Milanote) on this one, where we’d first sketch and then pass a Photoshop file back and forth to trick things out and play with varied user interactions. Then, I’d break it down and code it into a digital layout.</p>
<figure id="figure1" class="wp-block-image size-full is-resized"><img src="https://i0.wp.com/alistapart.com/wp-content/uploads/2023/06/designers-journey-2-1.jpg?w=846&amp;ssl=1" alt="" class="wp-image-7173967" data-recalc-dims="1" /><figcaption class="wp-element-caption">Figure 1: “the pseudoroom” website, hitting the sketchbook metaphor hard.</figcaption></figure><p>Along with design folio pieces, the site also offered free downloads for Mac OS customizations: desktop wallpapers that were effectively design experimentation, custom-designed typefaces, and desktop icons.</p>
<p>From around the same time, GUI Galaxy was a design, pixel art, and Mac-centric news portal some graphic designer friends and I conceived, designed, developed, and deployed.</p>
<figure id="figure2" class="wp-block-image size-large is-resized"><img src="https://i0.wp.com/alistapart.com/wp-content/uploads/2023/06/designers-journey-2-2.jpg?w=846&amp;ssl=1" alt="" class="wp-image-7173968" data-recalc-dims="1" /><figcaption class="wp-element-caption">Figure 2: GUI Galaxy, web standards-compliant design news portal</figcaption></figure><p>Design news portals were incredibly popular during this period, featuring (what would now be considered) Tweet-size, small-format snippets of pertinent news from the categories I previously mentioned. If you took Twitter, curated it to a few categories, and wrapped it in a custom-branded experience, you’d have a design news portal from the late 90s / early 2000s.</p>
<p>We as designers had evolved and created a bandwidth-sensitive, web standards award-winning, much more accessibility-conscious website. Still ripe with experimentation, yet more mindful of equitable engagement. You can see a couple of content panes here, noting general news (tech, design) and Mac-centric news below. We also offered many of the custom downloads I cited before as present on my folio site but branded and themed to GUI Galaxy.</p>
<p>The site’s backbone was a homegrown CMS, with the presentation layer consisting of global design + illustration + news author collaboration. And the collaboration effort here, in addition to experimentation on a ‘brand’ and content delivery, was hitting my core. We were designing something bigger than any single one of us and connecting with a global audience.</p>
<p>Collaboration and connection transcend medium in their impact, immensely fulfilling me as a designer.</p>
<p>Now, why am I taking you down this trip of design memory lane? Two reasons.</p>
<p>First, there’s a reason for the nostalgia for that design era (the “Wild West” era, as I called it earlier): the inherent exploration, personality, and creativity that saturated many design portals and personal portfolio sites. Ultra-finely detailed pixel art UI, custom illustration, bespoke vector graphics, all underpinned by a strong design community.</p>
<p>Today’s web design has been in a period of stagnation. I suspect there’s a strong chance you’ve seen a site whose structure looks something like this: a hero image / banner with text overlaid, perhaps with a lovely rotating carousel of images (laying the snark on heavy there), a call to action, and three columns of sub-content directly beneath. Maybe an icon library is employed with selections that vaguely relate to their respective content.</p>
<p>Design, as it’s applied to the digital landscape, is in dire need of thoughtful layout, typography, and visual engagement that goes hand-in-hand with all the modern considerations we now know are paramount: usability. Accessibility. Load times and bandwidth- sensitive content delivery. A responsive presentation that meets human beings wherever they’re engaging from. We must be mindful of, and respectful toward, those concerns—but not at the expense of creativity of visual communication or via replicating cookie-cutter layouts.</p>
<h2 id="section3" class="wp-block-heading">Pixel Problems</h2>
<p>Websites during this period were often designed and built on Macs whose OS and desktops looked something like this. This is Mac OS 7.5, but 8 and 9 weren’t that different.</p>
<figure id="figure3" class="wp-block-image size-large is-resized"><img src="https://i0.wp.com/alistapart.com/wp-content/uploads/2023/06/designers-journey-2-3.jpg?w=846&amp;ssl=1" alt="" class="wp-image-7173969" data-recalc-dims="1" /><figcaption class="wp-element-caption">Figure 3: A Mac OS 7.5-centric desktop.</figcaption></figure><p>Desktop icons fascinated me: how could any single one, at any given point, stand out to get my attention? In this example, the user’s desktop is tidy, but think of a more realistic example with icon pandemonium. Or, say an icon was part of a larger system grouping (fonts, extensions, control panels)—how did it also maintain cohesion amongst a group?</p>
<p>These were 32 x 32 pixel creations, utilizing a 256-color palette, designed pixel-by-pixel as mini mosaics. To me, this was the embodiment of digital visual communication under such ridiculous constraints. And often, ridiculous restrictions can yield the purification of concept and theme.</p>
<p>So I began to research and do my homework. I was a student of this new medium, hungry to dissect, process, discover, and make it my own.</p>
<p>Expanding upon the notion of exploration, I wanted to see how I could push the limits of a 32×32 pixel grid with that 256-color palette. Those ridiculous constraints forced a clarity of concept and presentation that I found incredibly appealing. The digital gauntlet had been tossed, and that challenge fueled me. And so, in my dorm room into the wee hours of the morning, I toiled away, bringing conceptual sketches into mini mosaic fruition.</p>
<p>These are some of my creations, utilizing the only tool available at the time to create icons called ResEdit. ResEdit was a clunky, built-in Mac OS utility not really made for exactly what we were using it for. At the core of all of this work: Research. Challenge. Problem- solving. Again, these core connection-based values are agnostic of medium.</p>
<figure id="figure4" class="wp-block-image size-large is-resized"><img src="https://i0.wp.com/alistapart.com/wp-content/uploads/2023/06/designers-journey-2-4.png?w=846&amp;ssl=1" alt="" class="wp-image-7173970" data-recalc-dims="1" /><figcaption class="wp-element-caption">Figure 4: A selection of my pixel art design, 32×32 pixel canvas, 8-bit palette</figcaption></figure><p>There’s one more design portal I want to talk about, which also serves as the second reason for my story to bring this all together.</p>
<p>This is K10k, short for Kaliber 1000. K10k was founded in 1998 by Michael Schmidt and Toke Nygaard, and was <strong>the</strong> design news portal on the web during this period. With its pixel art-fueled presentation, ultra-focused care given to every facet and detail, and with many of the more influential designers of the time who were invited to be news authors on the site, well… it was the place to be, my friend. With respect where respect is due, GUI Galaxy’s concept was inspired by what these folks were doing.</p>
<figure id="figure5" class="wp-block-image size-full is-resized"><img src="https://i0.wp.com/alistapart.com/wp-content/uploads/2023/06/designers-journey-2-5.png?w=846&amp;ssl=1" alt="" class="wp-image-7173971" data-recalc-dims="1" /><figcaption class="wp-element-caption">Figure 5: The K10k website</figcaption></figure><p>For my part, the combination of my web design work and pixel art exploration began to get me some notoriety in the design scene. Eventually, K10k noticed and added me as one of their very select group of news authors to contribute content to the site.</p>
<p>Amongst my personal work and side projects—and now with this inclusion—in the design community, this put me on the map. My design work also began to be published in various printed collections, in magazines domestically and overseas, and featured on other design news portals. With that degree of success while in my early twenties, something else happened:</p>
<p>I evolved—devolved, really—into a colossal asshole (and in just about a year out of art school, no less). The press and the praise became what fulfilled me, and they went straight to my head. They inflated my ego. I actually felt somewhat superior to my fellow designers.</p>
<p>The casualties? My design stagnated. Its evolution—my evolution— stagnated.</p>
<p>I felt so supremely confident in my abilities that I effectively stopped researching and discovering. When previously sketching concepts or iterating ideas in lead was my automatic step one, I instead leaped right into Photoshop. I drew my inspiration from the smallest of sources (and with blinders on). Any critique of my work from my peers was often vehemently dismissed. The most tragic loss: I had lost touch with my values.</p>
<p>My ego almost cost me some of my friendships and burgeoning professional relationships. I was toxic in talking about design and in collaboration. But thankfully, those same friends gave me a priceless gift: candor. They called me out on my unhealthy behavior.</p>
<p>Admittedly, it was a gift I initially did not accept but ultimately was able to deeply reflect upon. I was soon able to accept, and process, and course correct. The realization laid me low, but the re-awakening was essential. I let go of the “reward” of adulation and re-centered upon what stoked the fire for me in art school. Most importantly: I got back to my core values.</p>
<h2 id="section4" class="wp-block-heading">Always Students</h2>
<p>Following that short-term regression, I was able to push forward in my personal design and career. And I could self-reflect as I got older to facilitate further growth and course correction as needed.</p>
<p>As an example, let’s talk about the Large Hadron Collider. The LHC was designed <em>“to help answer some of the fundamental open questions in physics, which concern the basic laws governing the interactions and forces among the elementary objects, the deep structure of space and time, and in particular the interrelation between quantum mechanics and general relativity.”</em> Thanks, Wikipedia.</p>
<p>Around fifteen years ago, in one of my earlier professional roles, I designed the interface for the application that generated the LHC’s particle collision diagrams. These diagrams are the rendering of what’s actually happening inside the Collider during any given particle collision event and are often considered works of art unto themselves.</p>
<p>Designing the interface for this application was a fascinating process for me, in that I worked with Fermilab physicists to understand what the application was trying to achieve, but also how the physicists themselves would be using it. To that end, in this role,</p>
<p>I cut my teeth on usability testing, working with the Fermilab team to iterate and improve the interface. How they spoke and what they spoke about was like an alien language to me. And by making myself humble and working under the mindset that I was but a student, I made myself available to be a part of their world to generate that vital connection.</p>
<p>I also had my first ethnographic observation experience: going to the Fermilab location and observing how the physicists used the tool in their actual environment, on their actual terminals. For example, one takeaway was that due to the level of ambient light-driven contrast within the facility, the data columns ended up using white text on a dark gray background instead of black text-on-white. This enabled them to pore over reams of data during the day and ease their eye strain. And Fermilab and CERN are government entities with rigorous accessibility standards, so my knowledge in that realm also grew. The barrier-free design was another essential form of connection.</p>
<p>So to those core drivers of my visual problem-solving soul and ultimate fulfillment: discovery, exposure to new media, observation, human connection, and evolution. What opened the door for those values was me checking my ego before I walked through it.</p>
<p>An evergreen willingness to listen, learn, understand, grow, evolve, and connect yields our best work. In particular, I want to focus on the words ‘grow’ and ‘evolve’ in that statement. If we are always students of our craft, we are also continually making ourselves available to evolve. Yes, we have years of applicable design study under our belt. Or the focused lab sessions from a UX bootcamp. Or the monogrammed portfolio of our work. Or, ultimately, decades of a career behind us.</p>
<p>But all that said: experience does not equal “expert.”</p>
<p>As soon as we close our minds via an inner monologue of ‘knowing it all’ or branding ourselves a “#thoughtleader” on social media, the designer we <strong>are</strong> is our final form. The designer we <strong>can be</strong> will never exist.</p>]]></description>
      <link>https://alistapart.com/article/humility-an-essential-value/</link>
      <guid>https://alistapart.com/article/humility-an-essential-value/</guid>
      <pubDate>Thu, 22 Jun 2023 15:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Personalization Pyramid: A Framework for Designing with User Data]]></title>
      <description><![CDATA[<p>As a UX professional in today’s data-driven landscape, it’s increasingly likely that you’ve been asked to design a personalized digital experience, whether it’s a public website, user portal, or native application. Yet while there continues to be no shortage of marketing hype around personalization platforms, we still have very few standardized approaches for implementing personalized UX.</p>


<p>That’s where we come in. After completing dozens of personalization projects over the past few years, we gave ourselves a goal: could you create a holistic personalization framework specifically for UX practitioners? The <strong>Personalization Pyramid</strong> is a designer-centric model for standing up human-centered personalization programs, spanning data, segmentation, content delivery, and overall goals. By using this approach, you will be able to understand the core components of a contemporary, UX-driven personalization program (or at the very least know enough to get started). </p>
<figure id="figure1" class="wp-block-image size-large"><img width="960" height="558" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image20.png?resize=960%2C558&amp;ssl=1" alt="A chart answering the question Do you have the resources you need to run personalization in your organization? Globally, 13% don’t 33% have limited access, 39% have it (on demand), and 15% have it dedicated." class="wp-image-7173666" data-recalc-dims="1" /><figcaption class="wp-element-caption"><strong>Growing tools for personalization:</strong> According to a Dynamic Yield survey, 39% of respondents felt support is available on-demand when a business case is made for it (up 15% from 2020).
<small>Source: “The State of Personalization Maturity – Q4 2021” Dynamic Yield conducted its annual maturity survey across roles and sectors in the Americas (AMER), Europe and the Middle East (EMEA), and the Asia-Pacific (APAC) regions. This marks the fourth consecutive year publishing our research, which includes more than 450 responses from individuals in the C-Suite, Marketing, Merchandising, CX, Product, and IT.</small>
</figcaption></figure><h2 id="section2"><strong>Getting Started</strong></h2>
<p>For the sake of this article, we’ll assume you’re already familiar with the basics of digital personalization. A good overview can be found here: <a href="https://www.uxbooth.com/articles/website-personalization-planning/">Website Personalization Planning</a>. While UX projects in this area can take on many different forms, they often stem from similar starting points.      </p>
<p><strong>Common scenarios for starting a personalization project:</strong></p>
<ul><li>Your organization or client purchased a content management system (CMS) or marketing automation platform (MAP) or related technology that supports personalization</li>
<li>The CMO, CDO, or CIO has identified personalization as a goal</li>
<li>Customer data is disjointed or ambiguous</li>
<li>You are running some isolated targeting campaigns or A/B testing</li>
<li>Stakeholders disagree on personalization approach</li>
<li>Mandate of customer privacy rules (e.g. GDPR) requires revisiting existing user targeting practices</li>
</ul><figure id="figure2" class="wp-block-image size-full is-resized"><img src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image22.png?resize=768%2C576&amp;ssl=1" alt="Two men and a woman discussing personalization using a card deck. They are seated at a round table in a hotel conference room. The workshop leaders, two women, are at a podium in the background." class="wp-image-7173667" width="768" height="576" data-recalc-dims="1" /><figcaption class="wp-element-caption">Workshopping personalization at a conference.</figcaption></figure><p>Regardless of where you begin, a successful personalization program will require the same core building blocks. We’ve captured these as the “levels” on the pyramid. Whether you are a UX designer, researcher, or strategist, understanding the core components can help make your contribution successful.  </p>
<figure id="figure3" class="wp-block-image size-large is-resized"><img src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image14.png?resize=488%2C512&amp;ssl=1" alt="The Personalization Pyramid visualized. The pyramid is stacks labeled, from the bottom, raw data (1m+), actionable data (100k+), user segments (1k+), contexts &amp; campaigns (100s), touchpoints (dozens), goals (handful). The North Star (one) is above. An arrow for prescriptive, business driven data goes up the left side and an arrow for adaptive user-driven data goes down the right side." class="wp-image-7173665" width="488" height="512" data-recalc-dims="1" /><figcaption class="wp-element-caption">From the ground up: Soup-to-nuts personalization, without going nuts.</figcaption></figure><p>From top to bottom, the levels include:</p>
<ol><li><strong>North Star:</strong> What larger strategic objective is driving the personalization program? </li>
<li><strong>Goals:</strong> What are the specific, measurable outcomes of the program? </li>
<li><strong>Touchpoints:</strong> Where will the personalized experience be served?</li>
<li><strong>Contexts and Campaigns:</strong> What personalization content will the user see?</li>
<li><strong>User Segments:</strong> What constitutes a unique, usable audience? </li>
<li><strong>Actionable Data:</strong> What reliable and authoritative data is captured by our technical platform to drive personalization?  </li>
<li><strong>Raw Data:</strong> What wider set of data is conceivably available (already in our setting) allowing you to personalize?</li>
</ol><p>We’ll go through each of these levels in turn. To help make this actionable, we created an accompanying <strong>deck of cards</strong> to illustrate specific examples from each level. We’ve found them helpful in personalization brainstorming sessions, and will include examples for you here.</p>
<figure id="figure4" class="wp-block-image size-full"><img width="320" height="215" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image2.png?resize=320%2C215&amp;ssl=1" alt="A deck of personalization brainstorming cards (the size of playing cards) against a black background." class="wp-image-7173668" data-recalc-dims="1" /><figcaption class="wp-element-caption"><strong>Personalization pack:</strong> Deck of cards to help kickstart your personalization brainstorming.</figcaption></figure><h2 id="section3"><strong>Starting at the Top</strong></h2>
<p>The components of the pyramid are as follows:</p>
<h3 id="section4">North Star</h3>
<p>A north star is what you are aiming for overall with your personalization program (big or small). The North Star defines the (one) overall mission of the personalization program. What do you wish to accomplish? North Stars cast a shadow. The bigger the star, the bigger the shadow. Example of North Starts might include: </p>
<ol><li><strong>Function:</strong> Personalize based on basic user inputs. Examples: “Raw” notifications, basic search results, system user settings and configuration options, general customization, basic optimizations</li>
<li><strong>Feature:</strong> Self-contained personalization componentry. Examples: “Cooked” notifications, advanced optimizations (geolocation), basic dynamic messaging, customized modules, automations, recommenders</li>
<li><strong>Experience:</strong> Personalized user experiences across multiple interactions and user flows. Examples: Email campaigns, landing pages, advanced messaging (i.e. C2C chat) or conversational interfaces, larger user flows and content-intensive optimizations (localization).</li>
<li><strong>Product:</strong> Highly differentiating personalized product experiences. Examples: Standalone, branded experiences with personalization at their core, like the “algotorial” playlists by Spotify such as Discover Weekly.</li>
</ol><figure id="figure5" class="is-layout-flex wp-block-gallery-1 wp-block-gallery has-nested-images columns-default is-cropped"><figure id="figure6" class="wp-block-image size-large"><img width="656" height="1024" data-id="7173669" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image7.jpg?resize=656%2C1024&amp;ssl=1" alt="Function: React to basic user inputs" class="wp-image-7173669" data-recalc-dims="1" /></figure><figure id="figure7" class="wp-block-image size-large"><img width="656" height="1024" data-id="7173670" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image18.jpg?resize=656%2C1024&amp;ssl=1" alt="Feature: personalized modules" class="wp-image-7173670" data-recalc-dims="1" /></figure><figure id="figure8" class="wp-block-image size-large"><img width="656" height="1024" data-id="7173671" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image8.jpg?resize=656%2C1024&amp;ssl=1" alt="Experience: Integrated personalization" class="wp-image-7173671" data-recalc-dims="1" /></figure><figcaption class="blocks-gallery-caption wp-element-caption"><strong>North star cards.</strong> These can help orient your team towards a common goal that personalization will help achieve; Also, these are useful for characterizing the end-state ambition of the presently stated personalization effort.</figcaption></figure><h3 id="section5">Goals</h3>
<p>As in any good UX design, personalization can help accelerate <a href="https://www.uxbooth.com/articles/designing-for-customer-intentions-part-1/">designing with customer intentions</a><strong>. Goals</strong> are the tactical and measurable metrics that will prove the overall program is successful. A good place to start is with your current analytics and measurement program and metrics you can benchmark against. In some cases, new goals may be appropriate. The key thing to remember is that <em>personalization itself is not a goal</em>, rather it is a means to an end. Common goals include:</p>
<ul><li>Conversion</li>
<li>Time on task</li>
<li>Net promoter score (NPS)</li>
<li>Customer satisfaction </li>
</ul><figure id="figure9" class="is-layout-flex wp-block-gallery-3 wp-block-gallery has-nested-images columns-default is-cropped"><figure id="figure10" class="wp-block-image size-large"><img width="656" height="1024" data-id="7173674" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image12.jpg?resize=656%2C1024&amp;ssl=1" alt="NPS: Net Promoter Score" class="wp-image-7173674" data-recalc-dims="1" /></figure><figure id="figure11" class="wp-block-image size-large"><img width="656" height="1024" data-id="7173672" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image23.jpg?resize=656%2C1024&amp;ssl=1" alt="Time on Task: Users move quicker" class="wp-image-7173672" data-recalc-dims="1" /></figure><figure id="figure12" class="wp-block-image size-large"><img width="656" height="1024" data-id="7173673" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image13.jpg?resize=656%2C1024&amp;ssl=1" alt="Conversion: Move more of the thing" class="wp-image-7173673" data-recalc-dims="1" /></figure><figcaption class="blocks-gallery-caption wp-element-caption"><strong>Goal cards.</strong> Examples of some common KPIs related to personalization that are concrete and measurable.</figcaption></figure><h3 id="section6">Touchpoints</h3>
<p>Touchpoints are where the personalization happens. As a UX designer, this will be one of your largest areas of responsibility. The touchpoints available to you will depend on how your personalization and associated technology capabilities are instrumented, and should be rooted in improving a user’s experience at a particular point in the journey. Touchpoints can be multi-device (mobile, in-store, website) but also more granular (web banner, web pop-up etc.). Here are some examples:</p>
<p><strong>Channel-level</strong> Touchpoints</p>
<ul><li>Email: Role</li>
<li>Email: Time of open</li>
<li>In-store display (JSON endpoint)</li>
<li>Native app</li>
<li>Search</li>
</ul><p><strong>Wireframe-level</strong> Touchpoints</p>
<ul><li>Web overlay</li>
<li>Web alert bar</li>
<li>Web banner</li>
<li>Web content block</li>
<li>Web menu</li>
</ul><figure id="figure13" class="is-layout-flex wp-block-gallery-5 wp-block-gallery has-nested-images columns-default is-cropped"><figure id="figure14" class="wp-block-image size-large"><img width="656" height="1024" data-id="7173677" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image25.jpg?resize=656%2C1024&amp;ssl=1" alt="In-store Display: End-cap interfaces" class="wp-image-7173677" data-recalc-dims="1" /></figure><figure id="figure15" class="wp-block-image size-large"><img width="656" height="1024" data-id="7173675" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image11.jpg?resize=656%2C1024&amp;ssl=1" alt="Email: Time, personalize at time of open" class="wp-image-7173675" data-recalc-dims="1" /></figure><figure id="figure16" class="wp-block-image size-large"><img width="656" height="1024" data-id="7173676" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image19.jpg?resize=656%2C1024&amp;ssl=1" alt="Content Block: Into the woodwork" class="wp-image-7173676" data-recalc-dims="1" /></figure><figcaption class="blocks-gallery-caption wp-element-caption"><strong>Touchpoint cards.</strong> Examples of common personalization touchpoints: these can vary from narrow (e.g., email) to broad (e.g., in-store).</figcaption></figure><p>If you’re designing for web interfaces, for example, you will likely need to include personalized “zones” in your wireframes. The content for these can be presented programmatically in touchpoints based on our next step, contexts and campaigns.</p>
<figure id="figure17" class="is-layout-flex wp-block-gallery-7 wp-block-gallery has-nested-images columns-default is-cropped"><figure id="figure18" class="wp-block-image size-large"><img width="732" height="974" data-id="7173678" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image21.png?resize=732%2C974&amp;ssl=1" alt="" class="wp-image-7173678" data-recalc-dims="1" /></figure><figure id="figure19" class="wp-block-image size-large"><img width="708" height="922" data-id="7173679" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image17.png?resize=708%2C922&amp;ssl=1" alt="" class="wp-image-7173679" data-recalc-dims="1" /></figure><figcaption class="blocks-gallery-caption wp-element-caption"><strong>Targeted Zones:</strong> Examples from Kibo of personalized “zones” on page-level wireframes occurring at various stages of a user journey (Engagement phase at left and Purchase phase at right.)
Source: “Essential Guide to End-to-End Personaliztion” by Kibo.
</figcaption></figure><h3 id="section7">Contexts and Campaigns</h3>
<p>Once you’ve outlined some touchpoints, you can consider the actual personalized content a user will receive. Many personalization tools will refer to these as “campaigns” (so, for example, a campaign on a web banner for new visitors to the website). These will programmatically be shown at certain touchpoints to certain user segments, as defined by user data. At this stage, we find it helpful to consider two separate models: a <strong>context model</strong> and a <strong>content model</strong>. The context helps you consider the level of engagement of the user at the personalization moment, for example a user casually browsing information vs. doing a deep-dive. Think of it in terms of information retrieval behaviors. The content model can then help you determine what type of personalization to serve based on the context (for example, an “Enrich” campaign that shows related articles may be a suitable supplement to extant content).</p>
<p>Personalization <strong>Context</strong> Model:</p>
<ol><li>Browse</li>
<li>Skim</li>
<li>Nudge</li>
<li>Feast</li>
</ol><p>Personalization <strong>Content</strong> Model:</p>
<ol><li>Alert</li>
<li>Make Easier</li>
<li>Cross-Sell</li>
<li>Enrich</li>
</ol><p>We’ve written extensively about each of these models elsewhere, so if you’d like to read more you can check out Colin’s <a href="https://alistapart.com/article/emerging-ux-role-in-personalization/">Personalization Content Model</a> and Jeff’s <a href="https://bucket.circle.so/c/field-notes/progressive-personalization-a-decisionmaking-model-for-better-outcomes-in-personalized-ux">Personalization Context Model</a>. </p>
<figure id="figure20" class="is-layout-flex wp-block-gallery-9 wp-block-gallery has-nested-images columns-default is-cropped"><figure id="figure21" class="wp-block-image size-large"><img width="656" height="1024" data-id="7173681" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image28.jpg?resize=656%2C1024&amp;ssl=1" alt="Cross Sell: You may also like…" class="wp-image-7173681" data-recalc-dims="1" /></figure><figure id="figure22" class="wp-block-image size-large"><img width="656" height="1024" data-id="7173682" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image3.jpg?resize=656%2C1024&amp;ssl=1" alt="Enrich: You might find this interesting" class="wp-image-7173682" data-recalc-dims="1" /></figure><figure id="figure23" class="wp-block-image size-large"><img width="656" height="1024" data-id="7173680" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image27.jpg?resize=656%2C1024&amp;ssl=1" alt="Browse: Lean back, shallow engagement" class="wp-image-7173680" data-recalc-dims="1" /></figure><figcaption class="blocks-gallery-caption wp-element-caption"><strong>Campaign and Context cards:</strong> This level of the pyramid can help your team focus around the types of personalization to deliver end users and the use-cases in which they will experience it.</figcaption></figure><h3 id="section8">User Segments</h3>
<p>User segments can be created prescriptively or adaptively, based on user research (e.g. via rules and logic tied to set user behaviors or via A/B testing). At a minimum you will likely need to consider how to treat the <em>unknown</em> or first-time visitor, the <em>guest</em> or returning visitor for whom you may have a stateful cookie (or equivalent post-cookie identifier), or the <em>authenticated</em> visitor who is logged in. Here are some examples from the personalization pyramid:</p>
<ul><li>Unknown</li>
<li>Guest</li>
<li>Authenticated</li>
<li>Default</li>
<li>Referred</li>
<li>Role</li>
<li>Cohort</li>
<li>Unique ID</li>
</ul><figure id="figure24" class="is-layout-flex wp-block-gallery-11 wp-block-gallery has-nested-images columns-default is-cropped"><figure id="figure25" class="wp-block-image size-large"><img width="656" height="1024" data-id="7173685" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image16.jpg?resize=656%2C1024&amp;ssl=1" alt="Authenticated: Logged in with token" class="wp-image-7173685" data-recalc-dims="1" /></figure><figure id="figure26" class="wp-block-image size-large"><img width="656" height="1024" data-id="7173683" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image10.jpg?resize=656%2C1024&amp;ssl=1" alt="Unknown: Could be anyone really" class="wp-image-7173683" data-recalc-dims="1" /></figure><figure id="figure27" class="wp-block-image size-large"><img width="656" height="1024" data-id="7173684" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image9.jpg?resize=656%2C1024&amp;ssl=1" alt="Guest: Dropped a cookie" class="wp-image-7173684" data-recalc-dims="1" /></figure><figcaption class="blocks-gallery-caption wp-element-caption"><strong>Segment cards.</strong> Examples of common personalization segments: at a minimum, you will need to consider the anonymous, guest, and logged in user types. Segmentation can get dramatically more complex from there.</figcaption></figure><h3 id="section9">Actionable Data</h3>
<p>Every organization with any digital presence has data. It’s a matter of asking what data you can ethically collect on users, its inherent reliability and value, as to how can you use it (sometimes known as “data activation.”) Fortunately, the tide is turning to first-party data: a recent study by Twilio estimates some <strong>80% of businesses are using at least some type of first-party data</strong> to personalize the customer experience. </p>
<figure id="figure28" class="wp-block-image size-large"><img width="960" height="669" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image6.png?resize=960%2C669&amp;ssl=1" alt="Chart that answers the question &quot;Why is your company focusing on using first-party data for personalization?&quot; The top answer (at 53%) is &quot;it’s higher quality.&quot; That is followed by &quot;It’s easier to manage&quot; (46%), &quot;it provides better privacy&quot; (45%), &quot;it’s easier to obtain&quot; (42%), &quot;it’s more cost-effective&quot; (40%), &quot;it’s more ethical&quot; (37%), &quot;our customers want us to&quot; (36%), &quot;it’s the industry norm&quot; (27%), &quot;it’s easier to comply with regulations&quot; (27%), and &quot;we are phasing out 3rd party cookies&quot; (21%)." class="wp-image-7173686" data-recalc-dims="1" /><figcaption class="wp-element-caption"><small>Source: “The State of Personalization 2021” by Twilio. Survey respondents were n=2,700 adult consumers who have purchased something online in the past 6 months, and n=300 adult manager+ decision-makers at consumer-facing companies that provide goods and/or services online. Respondents were from the United States, United Kingdom, Australia, and New Zealand.Data was collected from April 8 to April 20, 2021.</small></figcaption></figure><p>First-party data represents multiple advantages on the UX front, including being relatively simple to collect, more likely to be accurate, and less susceptible to the “creep factor” of third-party data. So a key part of your UX strategy should be to determine what the best form of data collection is on your audiences. Here are some examples:</p>
<figure id="figure29" class="is-layout-flex wp-block-gallery-13 wp-block-gallery has-nested-images columns-default is-cropped"><figure id="figure30" class="wp-block-image size-large"><img width="656" height="1024" data-id="7173691" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image15.jpg?resize=656%2C1024&amp;ssl=1" alt="Quizes: Tell us what you like" class="wp-image-7173691" data-recalc-dims="1" /></figure><figure id="figure31" class="wp-block-image size-large"><img width="656" height="1024" data-id="7173689" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image5.jpg?resize=656%2C1024&amp;ssl=1" alt="Behavioral profiling: Males 40+ who wear fedoras" class="wp-image-7173689" data-recalc-dims="1" /></figure><figure id="figure32" class="wp-block-image size-large"><img width="656" height="1024" data-id="7173688" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image1.jpg?resize=656%2C1024&amp;ssl=1" alt="Campaign Source: Your discount code 29780…" class="wp-image-7173688" data-recalc-dims="1" /></figure></figure><figure id="figure33" class="wp-block-image size-full"><img width="822" height="568" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image4.png?resize=822%2C568&amp;ssl=1" alt="Chart showing the impact of personalization across different phases of personalization maturity. It shows that effort is high in the early phases, but drops off quickly starting in phase 3 (machine learning) while at the same time conversion rates, AOV, and ROI increase from a relatively low level to off the chart." class="wp-image-7173692" data-recalc-dims="1" /><figcaption class="wp-element-caption"><strong>Figure 1.1.2:</strong> Example of a personalization maturity curve, showing progression from basic recommendations functionality to true individualization. Credit: https://kibocommerce.com/blog/kibos-personalization-maturity-chart/</figcaption></figure><p>There is a progression of profiling when it comes to recognizing and making decisioning about different audiences and their signals. It tends to move towards more granular constructs about smaller and smaller cohorts of users as time and confidence and data volume grow.</p>
<p>While some combination of <strong>implicit / explicit</strong> <strong>data</strong> is generally a prerequisite for any implementation (more commonly referred to as first party and third-party data) <strong>ML efforts</strong> are typically not cost-effective directly out of the box. This is because a strong data backbone and content repository is a prerequisite for optimization. But these approaches should be considered as part of the larger roadmap and may indeed help accelerate the organization’s overall progress. Typically at this point you will partner with key stakeholders and product owners to design a <strong>profiling model</strong>. The profiling model includes defining approach to configuring profiles, profile keys, profile cards and pattern cards. A multi-faceted approach to profiling which makes it scalable.</p>
<h2 id="section10">Pulling it Together</h2>
<p>While the cards comprise the starting point to an inventory of sorts (we provide blanks for you to tailor your own), a set of potential levers and motivations for the style of personalization activities you aspire to deliver, they are more valuable when thought of in a grouping. </p>
<p>In assembling a card “hand”, one can begin to trace the entire trajectory from leadership focus down through a strategic and tactical execution. It is also at the heart of the way both co-authors have conducted workshops in assembling a program backlog—which is a fine subject for another article.</p>
<p>In the meantime, what is important to note is that each colored class of card is helpful to survey in understanding the range of choices potentially at your disposal, it is threading through and making concrete decisions about for whom this decisioning will be made: where, when, and how.</p>
<figure id="figure34" class="wp-block-image size-full"><img width="960" height="578" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/12/image26.jpg?resize=960%2C578&amp;ssl=1" alt="Cards on a table. At the top: Function is the north star &amp; customer satisfaction is the goal. User segment is unknown, the actionable data is a quiz, context is a nudge, campaign is to make something easier, and the touchpoint is a banner." class="wp-image-7173693" data-recalc-dims="1" /><figcaption class="wp-element-caption"><strong>Scenario A:</strong> We want to use personalization to improve customer satisfaction on the website. For unknown users, we will create a short quiz to better identify what the user has come to do. This is sometimes referred to as “badging” a user in onboarding contexts, to better characterize their present intent and context.</figcaption></figure><h2 id="section11">Lay Down Your Cards</h2>
<p>Any sustainable personalization strategy must consider near, mid and long-term goals. Even with the leading CMS platforms like Sitecore and Adobe or the most exciting composable CMS DXP out there, there is simply no “easy button” wherein a personalization program can be stood up and immediately view meaningful results. That said, there is a common grammar to all personalization activities, just like every sentence has nouns and verbs. These cards attempt to map that territory.</p>]]></description>
      <link>https://alistapart.com/article/personalization-pyramid/</link>
      <guid>https://alistapart.com/article/personalization-pyramid/</guid>
      <pubDate>Thu, 08 Dec 2022 16:00:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[Mobile-First CSS: Is It Time for a Rethink?]]></title>
      <description><![CDATA[<p class="intro">The mobile-first design methodology is great—it focuses on what really matters to the user, it’s well-practiced, and it’s been a common design pattern for years. So developing your CSS mobile-first should also be great, too…right? </p>


<p>Well, not necessarily. Classic mobile-first CSS development is based on the principle of overwriting style declarations: you begin your CSS with default style declarations, and overwrite and/or add new styles as you add breakpoints with <code>min-width</code> media queries for larger viewports (for a good overview see “<a href="https://www.mightyminnow.com/2013/11/what-is-mobile-first-css-and-why-does-it-rock/">What is Mobile First CSS and Why Does It Rock?</a>”). But all those exceptions create complexity and inefficiency, which in turn can lead to an increased testing effort and a code base that’s harder to maintain. Admit it—how many of us willingly want that?</p>
<p>On your own projects, mobile-first CSS may yet be the best tool for the job, but first you need to evaluate just how appropriate it is in light of the visual design and user interactions you’re working on. To help you get started, here’s how I go about tackling the factors you need to watch for, and I’ll discuss some alternate solutions if mobile-first doesn’t seem to suit your project.</p>
<h2 id="section2">Advantages of mobile-first</h2>
<p>Some of the things to like with mobile-first CSS development—and why it’s been the de facto development methodology for so long—make a lot of sense:</p>
<p><strong>Development hierarchy.</strong> One thing you undoubtedly get from mobile-first is a nice development hierarchy—you just focus on the mobile view and get developing. </p>
<p><strong>Tried and tested.</strong> It’s a tried and tested methodology that’s worked for years for a reason: it solves a problem really well.</p>
<p><strong>Prioritizes the mobile view</strong>. The mobile view is thesimplestand arguably the most important, as it <strong>encompasses all the key user journeys</strong>, and often accounts for a <strong>higher proportion of user visits</strong> (depending on the project). </p>
<p><strong>Prevents desktop-centric development.</strong> As development is done using desktop computers, it can be tempting to initially focus on the desktop view. But thinking about mobile from the start prevents us from getting stuck later on; no one wants to spend their time retrofitting a desktop-centric site to work on mobile devices!</p>
<h2 id="section3">Disadvantages of mobile-first</h2>
<p>Setting style declarations and then overwriting them at higher breakpoints can lead to undesirable ramifications:</p>
<p><strong>More complexity.</strong> The farther up the breakpoint hierarchy you go, the more unnecessary code you inherit from lower breakpoints. </p>
<p><strong>Higher CSS specificity.</strong> Styles that have been reverted to their browser default value in a class name declaration now have a higher specificity. This can be a headache on large projects when you want to keep the CSS selectors as simple as possible.</p>
<p><strong>Requires more regression testing.</strong> Changes to the CSS at a lower view (like adding a new style) requires all higher breakpoints to be regression tested.</p>
<p><strong>The browser can’t prioritize CSS downloads.</strong> At wider breakpoints, classic mobile-first <code>min-width</code> media queries don’t leverage the browser’s capability to download CSS files in priority order.</p>
<h2 id="section4">The problem of property value overrides</h2>
<p>There is nothing inherently wrong with overwriting values; CSS was designed to do just that. Still, inheriting incorrect values is unhelpful and can be burdensome and inefficient. It can also lead to increased style specificity when you have to overwrite styles to reset them back to their defaults, something that may cause issues later on, especially if you are using a combination of bespoke CSS and utility classes. We won’t be able to use a utility class for a style that has been reset with a higher specificity.</p>
<p>With this in mind, I’m developing CSS with a focus on the default values much more these days. Since there’s no specific order, and no chains of specific values to keep track of, this frees me to develop breakpoints <em>simultaneously</em>. I concentrate on finding common styles and isolating the specific exceptions in closed media query ranges (that is, any range with a <code>max-width</code> set). </p>
<p>This approach opens up some opportunities, as you can look at each breakpoint as a clean slate. If a component’s layout looks like it should be based on Flexbox at all breakpoints, it’s fine and can be coded in the default style sheet. But if it looks like Grid would be much better for large screens and Flexbox for mobile, these can both be done entirely independently when the CSS is put into closed media query ranges. Also, developing simultaneously requires you to have a good understanding of any given component in all breakpoints up front. This can help surface issues in the design earlier in the development process. We don’t want to get stuck down a rabbit hole building a complex component for mobile, and then get the designs for desktop and find they are equally complex and incompatible with the HTML we created for the mobile view! </p>
<p>Though this approach isn’t going to suit everyone, I encourage you to give it a try. There are plenty of tools out there to help with concurrent development, such as <a href="https://responsively.app/">Responsively App</a>, <a href="https://blisk.io/">Blisk</a>, and many others. </p>
<p>Having said that, I don’t feel the order itself is particularly relevant. If you are comfortable with focusing on the mobile view, have a good understanding of the requirements for other breakpoints, and prefer to work on one device at a time, then by all means stick with the classic development order. The important thing is to identify common styles and exceptions so you can put them in the relevant stylesheet—a sort of manual tree-shaking process! Personally, I find this a little easier when working on a component across breakpoints, but that’s by no means a requirement.</p>
<h2 id="section5">Closed media query ranges in practice </h2>
<p>In classic mobile-first CSS we overwrite the styles, but we can avoid this by using media query ranges. To illustrate the difference (I’m using SCSS for brevity), let’s assume there are three visual designs: </p>
<ul><li>smaller than 768</li>
<li>from 768 to below 1024</li>
<li>1024 and anything larger </li>
</ul><p>Take a simple example where a block-level element has a default <code>padding</code> of “20px,” which is overwritten at tablet to be “40px” and set back to “20px” on desktop.</p>
<figure id="figure1" class="wp-block-table"><table><tbody><tr><td valign="top">
<p>Classic <code>min-width</code> mobile-first</p>
<pre id="snippet1"><code class="language-css">.my-block {
  padding: 20px;
  @media (min-width: 768px) {
    padding: 40px;
  }
  @media (min-width: 1024px) {
    padding: 20px;
  }
}</code></pre></td>
<td valign="top">
<p>Closed media query range</p>
<pre id="snippet2"><code class="language-css">.my-block {
  padding: 20px;
  @media (min-width: 768px) and (max-width: 1023.98px) {
    padding: 40px;
  }
}</code></pre></td>
</tr></tbody></table></figure><p>The subtle difference is that the mobile-first example sets the default <code>padding</code> to “20px” and then overwrites it at each breakpoint, setting it three times in total. In contrast, the second example sets the default <code>padding</code> to “20px” and only overrides it at the relevant breakpoint where it isn’t the default value (in this instance, tablet is the exception).</p>
<p>The goal is to: </p>
<ul><li>Only set styles when needed. </li>
<li>Not set them with the <em>expectation</em> of overwriting them later on, again and again. </li>
</ul><p>To this end, closed media query ranges are our best friend. If we need to make a change to any given view, we make it in the CSS media query range that applies to the specific breakpoint. We’ll be much less likely to introduce unwanted alterations, and our regression testing only needs to focus on the breakpoint we have actually edited. </p>
<p>Taking the above example, if we find that <code>.my-block</code> spacing on desktop is already accounted for by the margin at that breakpoint, and since we want to remove the padding altogether, we could do this by setting the mobile <code>padding</code> in a closed media query range.<br /></p>
<figure id="figure2" class="wp-block-table"><pre id="snippet3"><code class="language-css">.my-block {
  @media (max-width: 767.98px) {
    padding: 20px;
  }
  @media (min-width: 768px) and (max-width: 1023.98px) {
    padding: 40px;
  }
}</code></pre></figure><p>The browser default <code>padding</code> for our block is “0,” so instead of adding a desktop media query and using <code>unset</code> or “0” for the <code>padding</code> value (which we would need with mobile-first), we can wrap the mobile <code>padding</code> in a closed media query (since it is now also an exception) so it won’t get picked up at wider breakpoints. At the desktop breakpoint, we won’t need to set any <code>padding</code> style, as we want the browser default value.</p>
<h2 id="section6">Bundling versus separating the CSS</h2>
<p>Back in the day, keeping the number of requests to a minimum was very important due to the browser’s limit of concurrent requests (typically around six). As a consequence, the use of image sprites and CSS bundling was the norm, with all the CSS being downloaded in one go, as one stylesheet with highest priority. </p>
<p>With HTTP/2 and HTTP/3 now on the scene, the number of requests is no longer the big deal it used to be. This allows us to separate the CSS into multiple files by media query. The clear benefit of this is the browser can now request the CSS it currently needs with a higher priority than the CSS it doesn’t. This is more performant and can reduce the overall time <a href="https://web.dev/critical-rendering-path-render-blocking-css/">page rendering is blocked</a>.</p>
<h3 id="section7">Which HTTP version are you using?</h3>
<p>To determine which version of HTTP you’re using, go to your website and open your browser’s dev tools. Next, select the <strong>Network</strong> tab and make sure the <strong>Protocol</strong> column is visible. If “h2” is listed under <strong>Protocol</strong>, it means HTTP/2 is being used. </p>
<p><em>Note: to view the Protocol in your browser’s dev tools, go to the</em> <strong><em>Network</em></strong> <em>tab, reload your page, right-click any column header (e.g.,</em> <strong><em>Name</em></strong><em>), and check the</em> <strong><em>Protocol</em></strong> <em>column.</em></p>
<figure id="figure3" class="wp-block-image"><img src="https://lh4.googleusercontent.com/O8lxNeIY3Hb0YDs2EP7QFhGdGsBXOG7mSTCdAJBd5xkm-6RwrpkS1BN63W7RurVCP3nOH9sNpAR9JNGvIGnUTzG0NYm4sUqI5bU2QPhXYEawmKfeUJ_6YwWAIid2ZDHEdRzaQ1LxzUNTGbGk5g" alt="Chrome dev tools, Network tab filtered by document, Protocol column" /><figcaption><em>Note: for a summarized comparison, see ImageKit’s “</em><a href="https://imagekit.io/blog/http2-vs-http1-performance/"><em>HTTP/2 vs. HTTP/1</em></a><em>.”</em></figcaption></figure><p>Also, if your site is still using HTTP/1...WHY?!! What are you waiting for? There is <a href="https://caniuse.com/http2">excellent user support for HTTP/2</a>.</p>
<h2 id="section8">Splitting the CSS</h2>
<p>Separating the CSS into individual files is a worthwhile task. Linking the separate CSS files using the relevant <code>media</code> attribute allows the browser to identify which files are needed immediately (because they’re render-blocking) and which can be deferred. Based on this, it allocates each file an appropriate priority.</p>
<p>In the following example of a website visited on a mobile breakpoint, we can see the mobile and default CSS are loaded with “Highest” priority, as they are currently needed to render the page. The remaining CSS files (print, tablet, and desktop) are still downloaded in case they’ll be needed later, but with “Lowest” priority. </p>
<figure id="figure4" class="wp-block-image"><img src="https://lh5.googleusercontent.com/RZOq-S7kbVsavDiFctQl6STFgGm6puwG8L22V6j6U1vUfo73Opq3Cspj2N94T2BU5lpYUD7Bb_4krFCXlePvBE8xXJVMFwbc_At8pzc-C5ug-6lrPViwMIIXgbKiJA-2fQ3beDoYfkCflCVgwg" alt="Chrome dev tools, Network tab filtered by css, Priority column" /></figure><p>With <strong>bundled CSS</strong>, the browser will have to download the CSS file and parse it before rendering can start.</p>
<p>While, as noted, with the <strong>CSS separated into different files</strong> linked and marked up with the relevant <code>media</code> attribute, the browser can prioritize the files it currently needs. Using closed media query ranges allows the browser to do this at all widths, as opposed to classic mobile-first <code>min-width</code> queries, where the desktop browser would have to download all the CSS with Highest priority. We can’t assume that desktop users always have a fast connection. For instance, in many rural areas, internet connection speeds are still slow. </p>
<p>The media queries and number of separate CSS files will vary from project to project based on project requirements, but might look similar to the example below.</p>
<figure id="figure5" class="wp-block-table"><table><tbody><tr><td valign="top">
<p>Bundled CSS</p>
<code>&lt;link href="site.css" rel="stylesheet"&gt;</code>
<p>This single file contains all the CSS, including all media queries, and it will be downloaded with Highest priority.</p>
</td>
<td valign="top">
<p>Separated CSS</p>
<code>&lt;link href="default.css" rel="stylesheet"&gt;&lt;link href="mobile.css" media="screen and (max-width: 767.98px)" rel="stylesheet"&gt;&lt;link href="tablet.css" media="screen and (min-width: 768px) and (max-width: 1083.98px)" rel="stylesheet"&gt;&lt;link href="desktop.css" media="screen and (min-width: 1084px)" rel="stylesheet"&gt;&lt;link href="print.css" media="print" rel="stylesheet"&gt;</code>
<p>Separating the CSS and specifying a <code>media</code> attribute value on each <code>link</code> tag allows the browser to prioritize what it currently needs. Out of the five files listed above, two will be downloaded with Highest priority: the default file, and the file that matches the current media query. The others will be downloaded with Lowest priority.</p>
</td>
</tr></tbody></table></figure><p>Depending on the project’s deployment strategy, a change to one file (<code>mobile.css</code>, for example) would only require the QA team to regression test on devices in that specific media query range. Compare that to the prospect of deploying the single bundled <code>site.css</code> file, an approach that would normally trigger a full regression test.</p>
<h2 id="section9">Moving on</h2>
<p>The uptake of mobile-first CSS was a really important milestone in web development; it has helped front-end developers focus on mobile web applications, rather than developing sites on desktop and then attempting to retrofit them to work on other devices.</p>
<p>I don’t think anyone wants to return to that development model again, but it’s important we don’t lose sight of the issue it highlighted: that things can easily get convoluted and less efficient if we prioritize one particular device—any device—over others. For this reason, focusing on the CSS in its own right, always mindful of what is the default setting and what’s an exception, seems like the natural next step. I’ve started noticing small simplifications in my own CSS, as well as other developers’, and that testing and maintenance work is also a bit more simplified and productive. </p>
<p>In general, simplifying CSS rule creation whenever we can is ultimately a cleaner approach than going around in circles of overrides. But whichever methodology you choose, it needs to suit the project. Mobile-first may—or may not—turn out to be the best choice for what’s involved, but first you need to solidly understand the trade-offs you’re stepping into.</p>]]></description>
      <link>https://alistapart.com/article/mobile-first-css-is-it-time-for-a-rethink/</link>
      <guid>https://alistapart.com/article/mobile-first-css-is-it-time-for-a-rethink/</guid>
      <pubDate>Thu, 09 Jun 2022 04:13:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Designers, (Re)define Success First]]></title>
      <description><![CDATA[<p>About two and a half years ago, I introduced the idea of <a href="https://alistapart.com/article/daily-ethical-design/">daily ethical design</a>. It was born out of my frustration with the many obstacles to achieving design that’s usable and equitable; protects people’s privacy, agency, and focus; benefits society; and restores nature. I argued that we need to overcome the inconveniences that prevent us from acting ethically and that we need to elevate design ethics to a more practical level by structurally integrating it into our daily work, processes, and tools.</p>


<p>Unfortunately, we’re still very far from this ideal. </p>
<p>At the time, I didn’t know yet <em>how</em> to structurally integrate ethics. Yes, I had found some tools that had worked for me in previous projects, such as using checklists, assumption tracking, and “dark reality” sessions, but I didn’t manage to apply those in <em>every</em> project. I was still struggling for time and support, and at best I had only partially achieved a higher (moral) quality of design—which is far from my definition of <em>structurally integrated</em>.</p>
<p>I decided to dig deeper for the root causes in business that prevent us from practicing daily ethical design. Now, after much research and experimentation, I believe that I’ve found the key that will let us structurally integrate ethics. And it’s surprisingly simple! But first we need to zoom out to get a better understanding of what we’re up against.</p>
<h2 id="section2">Influence the system</h2>
<p>Sadly, we’re trapped in a capitalistic system that reinforces <a href="https://www.nature.com/articles/s41467-020-16941-y">consumerism</a> and <a href="https://www.aljazeera.com/economy/2022/1/11/brace-yourself-for-an-even-more-unequal-post-pandemic-world-wef">inequality</a>, and it’s obsessed with the <a href="https://www.goodreads.com/book/show/53328332-less-is-more">fantasy of endless growth</a>. Sea levels, temperatures, and our demand for energy continue to rise unchallenged, while the gap between rich and poor continues to widen. Shareholders expect ever-higher returns on their investments, and companies feel forced to set short-term objectives that reflect this. Over the last decades, those objectives have <a href="https://creativegood.com/blog/21/losing-faith-in-ux.html">twisted our well-intended human-centered mindset into a powerful machine</a> that promotes ever-higher levels of consumption. When we’re working for an organization that pursues “double-digit growth” or “aggressive sales targets” (which is 99 percent of us), that’s very hard to resist while remaining human <em>friendly</em>. Even with our best intentions, and even though we like to say that we create solutions for people, we’re a part of the problem.</p>
<p>What can we do to change this?</p>
<p>We can start by acting on the right level of the system. Donella H. Meadows, a system thinker, once listed <a href="https://www.goodreads.com/book/show/3828902-thinking-in-systems">ways to influence a system</a> in order of effectiveness. When you apply these to design, you get:</p>
<ul><li>At the lowest level of effectiveness, you can affect <strong>numbers</strong> such as usability scores or the number of design critiques. But none of that will change the direction of a company.</li>
<li>Similarly, affecting <strong>buffers</strong> (such as team budgets), <strong>stocks</strong> (such as the number of designers), <strong>flows</strong> (such as the number of new hires), and <strong>delays</strong> (such as the time that it takes to hear about the effect of design) won’t significantly affect a company.</li>
<li>Focusing instead on <strong>feedback loops</strong> such as management control, employee recognition, or design-system investments can help a company become better at achieving its objectives. But that doesn’t change the objectives themselves, which means that the organization will still work against your ethical-design ideals.</li>
<li>The next level, <strong>information flows</strong>,is what most ethical-design initiatives focus on now: the exchange of ethical methods, toolkits, articles, conferences, workshops, and so on. This is also where ethical design has remained mostly <em>theoretical</em>. We’ve been focusing on the wrong level of the system all this time.</li>
<li>Take <strong>rules,</strong> for example—they beat knowledge every time. There can be widely accepted rules, such as how finance works, or a scrum team’s definition of done. But ethical design can also be smothered by unofficial rules meant to maintain profits, often revealed through comments such as “the client didn’t ask for it” or “don’t make it too big.”</li>
<li>Changing the rules without holding official power is very hard. That’s why the next level is so influential: <strong>self-organization</strong>. Experimentation, bottom-up initiatives, passion projects, self-steering teams—all of these are examples of self-organization that improve the resilience and creativity of a company. It’s exactly this diversity of viewpoints that’s needed to structurally tackle big systemic issues like consumerism, wealth inequality, and climate change.</li>
<li>Yet even stronger than self-organization are <strong>objectives</strong> and <strong>metrics</strong>. Our companies want to make more money, which means that everything and everyone in the company does their best to… make the company more money. And once I realized that profit is nothing more than a measurement, I understood how crucial a very specific, defined metric can be toward pushing a company in a certain direction.</li>
</ul><p>The takeaway? If we truly want to incorporate ethics into our daily design practice, we must first change the measurable objectives of the company we work for, from the bottom up.</p>
<h2 id="section3">Redefine success</h2>
<p>Traditionally, <a href="https://designthinking.ideo.com/">we consider a product or service successful if it’s desirable to humans, technologically feasible, and financially viable</a>. You tend to see these represented as equals; if you type the three words in a search engine, you’ll find diagrams of three equally sized, evenly arranged circles.</p>
<figure id="figure1" class="wp-block-image size-large"><img width="960" height="540" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/05/image01.png?resize=960%2C540&amp;ssl=1" alt="A Venn diagram with three overlapping circles representing Viable, Desirable, and Feasible with the target directly in the central intersection of all three." class="wp-image-7173407" data-recalc-dims="1" /></figure><p>But in our hearts, we all know that the three dimensions aren’t equally weighted: it’s viability that ultimately controls whether a product will go live. So a more realistic representation might look like this:</p>
<figure id="figure2" class="wp-block-image size-large"><img width="960" height="540" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/05/image02.png?resize=960%2C540&amp;ssl=1" alt="A Venn diagram with two circles (Desirable and Feasible) overlapping. An arrow points from their intersection to a separate circle marked as Viable, with a target inside it." class="wp-image-7173408" data-recalc-dims="1" /></figure><p>Desirability and feasibility are the <em>means</em>; viability is the <em>goal</em>. Companies—outside of nonprofits and charities—exist to make money.</p>
<p>A genuinely purpose-driven company would try to reverse this dynamic: it would recognize finance for what it was intended for: a <em>means</em>. So both feasibility and viability are means to achieve what the company set out to achieve. It makes intuitive sense: to achieve most anything, you need resources, people, and money. (Fun fact: the Italian language knows no difference between feasibility and viability; both are simply <em>fattibilità</em>.)</p>
<figure id="figure3" class="wp-block-image size-large"><img width="960" height="540" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/05/image03.png?resize=960%2C540&amp;ssl=1" alt="A Venn diagram with two circles (Viable and Feasible) overlapping. An arrow points from their intersection to a separate circle marked as Desirable, with a target inside it." class="wp-image-7173409" data-recalc-dims="1" /></figure><p>But simply swapping <em>viable</em> for <em>desirable</em> isn’t enough to achieve an ethical outcome. Desirability is still linked to consumerism because the associated activities aim to identify what people want—<em>whether it’s good for them or not</em>. Desirability objectives, such as user satisfaction or conversion, don’t consider whether a product is healthy for people. They don’t prevent us from creating products that distract or manipulate people or stop us from contributing to society’s wealth inequality. They’re unsuitable for establishing a healthy balance with nature.</p>
<p>There’s a fourth dimension of success that’s missing: our designs also need to be <em>ethical</em> in the effect that they have on the world.</p>
<figure id="figure4" class="wp-block-image size-large"><img width="960" height="540" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/05/image04.png?resize=960%2C540&amp;ssl=1" alt="The original Venn diagram of three circles (Desirable, Viable, and Feasible) overlapping with the target in their central intersection. This time, a fourth circle named Ethical encompasses all three." class="wp-image-7173410" data-recalc-dims="1" /></figure><p>This is hardly a new idea. Many similar models exist, some calling the fourth dimension <em>accountability</em>, <em>integrity</em>, or <em>responsibility</em>. What I’ve never seen before, however, is the necessary step that comes after: to influence the system as designers and to make ethical design more practical, we must create objectives for ethical design that are achievable and inspirational. There’s no one way to do this because it highly depends on your culture, values, and industry. But I’ll give you the version that I developed with a group of colleagues at a design agency. Consider it a template to get started.</p>
<h2 id="section4">Pursue well-being, equity, and sustainability</h2>
<p>We created objectives that address design’s effect on three levels: individual, societal, and global.</p>
<p>An objective on the individual level tells us what success is beyond the typical focus of usability and satisfaction—instead considering matters such as how much time and attention is required from users. We pursued <strong>well-being</strong>:</p>
<blockquote class="wp-block-quote">
<p>We create products and services that allow for people’s health and happiness. Our solutions are calm, transparent, nonaddictive, and nonmisleading. We respect our users’ time, attention, and privacy, and help them make healthy and respectful choices.</p>
</blockquote>
<p>An objective on the societal level forces us to consider our impact beyond just the user, widening our attention to the economy, communities, and other indirect stakeholders. We called this objective <strong>equity</strong>:</p>
<blockquote class="wp-block-quote">
<p>We create products and services that have a positive social impact. We consider economic equality, racial justice, and the inclusivity and diversity of people as teams, users, and customer segments. We listen to local culture, communities, and those we affect.</p>
</blockquote>
<p>Finally, the objective on the global level aims to ensure that we remain in balance with the only home we have as humanity. Referring to it simply as <strong>sustainability</strong>, our definition was:</p>
<blockquote class="wp-block-quote">
<p>We create products and services that reward sufficiency and reusability. Our solutions support the circular economy: we create value from waste, repurpose products, and prioritize sustainable choices. We deliver functionality instead of ownership, and we limit energy use.</p>
</blockquote>
<p>In short, ethical design (to us) meant achieving wellbeing for each user and an equitable value distribution within society through a design that can be sustained by our living planet. When we introduced these objectives in the company, for many colleagues, <em>design ethics</em> and <em>responsible design</em> suddenly became tangible and achievable through practical—and even familiar—actions.</p>
<h2 id="section5">Measure impact </h2>
<p>But defining these objectives still isn’t enough. What truly caught the attention of senior management was the fact that we created a way to <em>measure</em> every design project’s well-being, equity, and sustainability.</p>
<p>This overview lists example metrics that you can use as you pursue well-being, equity, and sustainability:</p>
<figure id="figure5" class="wp-block-image size-large"><img width="960" height="540" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/05/image05.png?resize=960%2C540&amp;ssl=1" alt="A list of example metrics for ethical impact at individual, societal, and planetary levels. Individual well-being examples include increased calmness, lower screen time, improved safety and privacy. Societal equity examples include improved accessibility, increased team and stakeholder diversity, and increased progressive enhancement. Finally, planetary sustainability examples include reduced energy use, reduced website carbon emissions and device turnover, and increased expert involvement." class="wp-image-7173411" data-recalc-dims="1" /></figure><p>There’s a lot of power in measurement. As the saying goes, what gets measured gets done. <a href="https://www.goodreads.com/book/show/3828902-thinking-in-systems">Donella Meadows</a> once shared this example:</p>
<blockquote class="wp-block-quote">
<p>“If the desired system state is national security, and that is defined as the amount of money spent on the military, the system will produce military spending. It may or may not produce national security.”</p>
</blockquote>
<p>This phenomenon explains why <em>desirability</em> is a poor indicator of success: it’s typically <a href="https://www.interaction-design.org/literature/article/google-s-heart-framework-for-measuring-ux">defined as the increase in customer satisfaction, session length, frequency of use, conversion rate, churn rate, download rate</a>, and so on. But none of these metrics increase the health of people, communities, or ecosystems. What if instead we measured success through metrics for (digital) well-being, such as (reduced) <a href="https://en.wikipedia.org/wiki/Screen_time#Physical_health_effects">screen time</a> or software energy consumption?</p>
<p>There’s another important message here. Even if we set an objective to build a calm interface, if we were to choose the wrong metric for calmness—say, the number of interface elements—we could still end up with a screen that induces anxiety. Choosing the wrong metric can completely undo good intentions. </p>
<p>Additionally, choosing the right metric is enormously helpful in <em>focusing</em> the design team. Once you go through the exercise of <a href="https://www.franklincovey.com/the-4-disciplines-old/discipline-2-act/">choosing metrics for our objectives</a>, you’re forced to consider what success looks like <em>concretely</em> and how you can prove that you’ve reached your ethical objectives. It also forces you to consider what we as designers have <em>control</em> over: what can I include in my design or change in my process that will lead to the right type of success? The answer to this question brings a lot of clarity and focus.</p>
<p>And finally, it’s good to remember that traditional businesses run on measurements, and managers love to spend much time discussing charts (ideally hockey-stick shaped)—especially if they concern profit, the one-above-all of metrics. For good or ill, to improve the system, to have a serious discussion about ethical design with managers, we’ll need to speak that business language.</p>
<h2 id="section6">Practice daily ethical design</h2>
<p>Once you’ve defined your objectives and you have a reasonable idea of the potential metrics for your design project, <em>only</em> then do you have a chance to structurally practice ethical design. It “simply” becomes a matter of using your creativity and choosing from all the knowledge and toolkits already available to you.</p>
<figure id="figure6" class="wp-block-image size-large"><img width="960" height="540" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/05/image06.png?resize=960%2C540&amp;ssl=1" alt="A set of example methods and tools for practicing at the individual, societal, and planetary level. Individual tools include the principle of minimum necessary data, white-hat persuasion techniques, calm-technology guidelines, and more. Societal tools include stakeholder mapping, inclusive sampling and testing, progressive enhancement, accessibility principles, and more. Planetary tools include the flourishing business canvas, extended-service blueprint, website carbon calculators, product-lifecycle mapping, and more." class="wp-image-7173412" data-recalc-dims="1" /></figure><p>I think this is quite exciting! It opens a whole new set of challenges and considerations for the design process. Should you go with that energy-consuming video or would a simple illustration be enough? Which typeface is the most calm and inclusive? Which new tools and methods do you use? When is the website’s end of life? How can you provide the same service while requiring less attention from users? How do you make sure that those who are affected by decisions are there when those decisions are made? How can you measure our effects?</p>
<p>The redefinition of success will completely change what it means to do good design.</p>
<p>There is, however, a final piece of the puzzle that’s missing: convincing your client, product owner, or manager to be mindful of well-being, equity, and sustainability. For this, it’s essential to engage stakeholders in a dedicated kickoff session.</p>
<h2 id="section7">Kick it off or fall back to status quo</h2>
<p>The kickoff is the most important meeting that can be so easy to forget to include. It consists of two major phases: 1) the alignment of <em>expectations</em>, and 2) the definition of <em>success</em>.</p>
<p>In the first phase, the entire (design) team goes over the project brief and meets with all the relevant stakeholders. Everyone gets to know one another and express their expectations on the outcome and their contributions to achieving it. Assumptions are raised and discussed. The aim is to get on the same level of understanding and to in turn avoid preventable miscommunications and surprises later in the project.</p>
<p>For example, for a recent freelance project that aimed to design a digital platform that facilitates US student advisors’ documentation and communication, we conducted an online kickoff with the client, a subject-matter expert, and two other designers. We used a combination of canvases on Miro: one with questions from “<a href="https://www.manualof.me/">Manual of Me</a>” (to get to know each other), a <a href="https://www.theteamcanvas.com/">Team Canvas</a> (to express expectations), and a version of the <a href="http://www.projectcanvas.dk/">Project Canvas</a> to align on scope, timeline, and other practical matters.</p>
<p>The above is the traditional purpose of a kickoff. But just as important as expressing expectations is agreeing on what <em>success</em> means for the project—in terms of desirability, viability, feasibility, and ethics. What are the objectives in each dimension?</p>
<p>Agreement on what success means at such an early stage is crucial because you can rely on it for the remainder of the project. If, for example, the design team wants to build an inclusive app for a diverse user group, they can raise diversity as a specific success criterion during the kickoff. If the client agrees, the team can refer back to that promise throughout the project. “As we agreed in our first meeting, having a diverse user group that includes A and B is necessary to build a successful product. So we do activity X and follow research process Y.” Compare those odds to a situation in which the team didn’t agree to that beforehand and had to ask for permission halfway through the project. The client might argue that that came <em>on top</em> of the agreed scope—and she’d be right.</p>
<p>In the case of this freelance project, to define success I prepared a round canvas that I call the <em>Wheel of Success</em>. It consists of an inner ring, meant to capture ideas for objectives, and a set of outer rings, meant to capture ideas on how to measure those objectives. The rings are divided into five dimensions of successful design: healthy, equitable, sustainable, desirable, feasible, and viable.</p>
<figure id="figure7" class="wp-block-image size-large"><img width="956" height="1024" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/05/image07.jpg?resize=956%2C1024&amp;ssl=1" alt="The wheel of success. The central circle reads 'The product is a success when it is'. The next ring outside lists example values such as healthy, equitable, sustainable, viable, feasible, and desirable. The next ring out lists out measurable objectives for those values, and the outermost ring lists tools that can measure those objectives." class="wp-image-7173413" data-recalc-dims="1" /></figure><p>We went through each dimension, writing down ideas on digital sticky notes. Then we discussed our ideas and verbally agreed on the most important ones. For example, our client agreed that sustainability and progressive enhancement are important success criteria for the platform. And the subject-matter expert emphasized the importance of including students from low-income and disadvantaged groups in the design process.</p>
<p>After the kickoff, we summarized our ideas and shared understanding in a project brief that captured these aspects:</p>
<ul><li>the project’s origin and purpose: <strong><em>why</em></strong> <em>are we doing this project?</em></li>
<li>the problem definition: <em>what do we want to</em> <strong><em>solve</em></strong><em>?</em></li>
<li>the concrete goals and metrics for each success dimension: <em>what do we want to</em> <strong><em>achieve</em></strong><em>?</em></li>
<li>the scope, process, and role descriptions: <strong><em>how</em></strong> <em>will we achieve it?</em></li>
</ul><p>With such a brief in place, you can use the agreed-upon objectives and concrete metrics as a checklist of success, and your design team will be ready to pursue the right objective—using the tools, methods, and metrics at their disposal to achieve ethical outcomes.</p>
<figure id="figure8" class="wp-block-image size-large"><img width="960" height="540" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2022/05/image08.png?resize=960%2C540&amp;ssl=1" alt="A drawing of a set of mountains that also looks vaguely like a graph. The leftmost valley has 'Pursue the right objective' pointing at it. The middle valley has 'Solve the right problem' and the rightmost valley is labelled 'Build the right solution.' Below the mountains, a timeline shows from left to right: Kick-off, Problem space, Solution space, and Development." class="wp-image-7173414" data-recalc-dims="1" /></figure><h2 id="section8">Conclusion</h2>
<p>Over the past year, quite a few colleagues have asked me, “Where do I start with ethical design?” My answer has always been the same: organize a session with your stakeholders to (re)define success. Even though you might not always be 100 percent successful in agreeing on goals that cover all responsibility objectives, that beats the alternative (the status quo) every time. If you want to be an ethical, responsible designer, there’s no skipping this step.</p>
<p>To be even more specific: if you consider yourself a <em>strategic designer</em>, your challenge is to define ethical objectives, set the right metrics, and conduct those kick-off sessions. If you consider yourself a <em>system designer</em>, your starting point is to understand how your industry contributes to consumerism and inequality, understand how finance drives business, and brainstorm which levers are available to influence the system on the highest level. Then redefine success to create the space to exercise those levers.</p>
<p>And for those who consider themselves service designers or UX designers or UI designers: if you truly want to have a positive, meaningful impact, stay away from the toolkits and meetups and conferences for a while. Instead, gather your colleagues and define goals for well-being, equity, and sustainability through design. Engage your stakeholders in a workshop and challenge them to think of ways to achieve and measure those ethical goals. Take their input, make it concrete and visible, ask for their agreement, and hold them to it.</p>
<p>Otherwise, I’m genuinely sorry to say, you’re wasting your precious time and creative energy.</p>
<p>Of course, engaging your stakeholders in this way can be uncomfortable. Many of my colleagues expressed doubts such as “What will the client think of this?,” “Will they take me seriously?,” and “Can’t we just do it within the design team instead?” In fact, a product manager once asked me why ethics couldn’t just be a structured part of the design <em>process</em>—to just do it without spending the effort to define ethical objectives. It’s a tempting idea, right? We wouldn’t have to have difficult discussions with stakeholders about what values or which key-performance indicators to pursue. It would let us focus on what we like and do best: designing.</p>
<p>But as systems theory tells us, that’s not enough. For those of us who aren’t from marginalized groups and have the privilege to be able to speak up and be heard, that uncomfortable space is exactly where we need to be if we truly want to make a difference. We can’t remain within the design-for-designers bubble, enjoying our privileged working-from-home situation, disconnected from the real world out there. For those of us who have the possibility to speak up and be heard: if we solely keep <em>talking</em> about ethical design and it remains at the level of articles and toolkits—we’re not designing ethically. It’s just theory. We need to actively engage our colleagues and clients by challenging them to redefine success in business.</p>
<p>With a bit of courage, determination, and focus, we can break out of this cage that finance and business-as-usual have built around us and become facilitators of a new type of business that can see beyond financial value. We just need to agree on the right objectives at the start of each design project, find the right metrics, and realize that we already have everything that we need to get started. That’s what it means to do daily ethical design.</p>
<p><em>For their inspiration and support over the years, I would like to thank Emanuela Cozzi Schettini, José Gallegos, Annegret Bönemann, Ian Dorr, Vera Rademaker, Virginia Rispoli, Cecilia Scolaro, Rouzbeh Amini, and many others.</em></p>]]></description>
      <link>https://alistapart.com/article/redefine-success-first/</link>
      <guid>https://alistapart.com/article/redefine-success-first/</guid>
      <pubDate>Thu, 12 May 2022 16:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Breaking Out of the Box]]></title>
      <description><![CDATA[<p>CSS is about styling boxes. In fact, the whole web is made of boxes, from the browser viewport to elements on a page. But every once in a while a new feature comes along that makes us rethink our design approach.</p>


<p><a href="https://www.w3.org/TR/css-round-display-1/">Round displays</a>, for example, make it fun to play with circular clip areas. <a href="https://css-tricks.com/the-notch-and-css/">Mobile screen notches</a> and <a href="https://www.w3.org/TR/virtual-keyboard/">virtual keyboards</a> offer challenges to best organize content that stays clear of them. And <a href="https://blogs.windows.com/msedgedev/2020/09/14/introducing-dual-screen-foldable-web-apis/">dual screen or foldable devices</a> make us rethink how to best use available space in a number of different <a href="https://w3c.github.io/device-posture/">device postures</a>.</p>
<figure id="figure1" class="wp-block-image size-large"><img width="960" height="452" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2021/12/fig1.png?resize=960%2C452&amp;ssl=1" alt="" class="wp-image-7173226" data-recalc-dims="1" /><figcaption><em>Sketches of a round display, a common rectangular mobile display, and a device with a foldable display.</em></figcaption></figure><p>These recent evolutions of the web platform made it both more challenging and more interesting to design products. They’re great opportunities for us to break out of our rectangular boxes.</p>
<p>I’d like to talk about a new feature similar to the above: the Window Controls Overlay for Progressive Web Apps (PWAs).</p>
<p><a href="https://alistapart.com/article/yes-that-web-project-should-be-a-pwa/">Progressive Web Apps</a> are blurring the lines between apps and websites. They combine the best of both worlds. On one hand, they’re stable, linkable, searchable, and responsive just like websites. On the other hand, they provide additional powerful capabilities, work offline, and read files just like native apps.</p>
<p>As a design surface, PWAs are really interesting because they challenge us to think about what mixing web and device-native user interfaces can be. On desktop devices in particular, we have more than <a href="https://en.wikipedia.org/wiki/History_of_the_graphical_user_interface">40 years of history</a> telling us what applications should look like, and it can be hard to break out of this mental model.</p>
<p>At the end of the day though, PWAs on desktop are constrained to the window they appear in: a rectangle with a title bar at the top.</p>
<p>Here’s what a typical desktop PWA app looks like:</p>
<figure id="figure2" class="wp-block-image size-large"><img width="960" height="303" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2021/12/fig2.png?resize=960%2C303&amp;ssl=1" alt="" class="wp-image-7173227" data-recalc-dims="1" /><figcaption><em>Sketches of two rectangular user interfaces representing the desktop Progressive Web App status quo on the macOS and Windows operating systems, respectively. </em></figcaption></figure><p>Sure, as the author of a PWA, you get to choose the color of the title bar (using the Web Application Manifest <a href="https://developer.mozilla.org/en-US/docs/Web/Manifest/theme_color"><strong>theme_color</strong></a> property), but that’s about it.</p>
<p>What if we could think outside this box, and reclaim the real estate of the app’s entire window? Doing so would give us a chance to make our apps more beautiful and feel more integrated in the operating system.</p>
<p>This is exactly what the <a href="https://web.dev/window-controls-overlay/">Window Controls Overlay</a> offers. This new PWA functionality makes it possible to take advantage of the full surface area of the app, including where the title bar normally appears.</p>
<h2 id="section2">About the title bar and window controls</h2>
<p>Let’s start with an explanation of what the title bar and window controls are.</p>
<p>The <em>title bar</em> is the area displayed at the top of an app window, which usually contains the app’s name. <em>Window controls</em> are the affordances, or buttons, that make it possible to minimize, maximize, or close the app’s window, and are also displayed at the top.</p>
<figure id="figure3" class="wp-block-image"><img src="https://lh5.googleusercontent.com/1s_lFmqiRm6Fv3wzeELtsDDiDvOkEJuSRH5K9YIrZZ8rh8rYCxUqbSnfd-f7YrsRvcDzF67fexnEJFlDtw53SKKmOgVk8sv_VUyCQveoR18HkNgACPxcQTtEOb6SmEuRIDlX3EcI" alt="" /><figcaption><em>A sketch of a rectangular application user interface highlighting the title bar area and window control buttons.</em></figcaption></figure><p>Window Controls Overlay removes the physical constraint of the title bar and window controls areas. It frees up the full height of the app window, enabling the title bar and window control buttons to be overlaid on top of the application’s web content. </p>
<figure id="figure4" class="wp-block-image"><img src="https://lh6.googleusercontent.com/k_6o1fBePhbjvtmxoTW3tG1134Gvbo31r2fy7zxmOB39d_eKpjThbh7QL8pVXrA1aLvEWzkoJ_rY4af451BU9XyKZXbSouCTvDJMnRKGlcOhcEpXw_rjQAR8_SFjhrm_-22OxKiR" alt="" /><figcaption><em>A sketch of a rectangular application user interface using Window Controls Overlay. The title bar and window controls are no longer in an area separated from the app’s content.</em></figcaption></figure><p>If you are reading this article on a desktop computer, take a quick look at other apps. Chances are they’re already doing something similar to this. In fact, the very web browser you are using to read this uses the top area to display tabs.</p>
<figure id="figure5" class="wp-block-image"><img src="https://lh6.googleusercontent.com/BLL9Rc5othPsw6xYApyyNOZ73j32wi4XkyoZpl4QOv0OL4MnxMe3bl1xLR0O7WSoAvi3KhyeP83hUh4-EezTmGg2axN4RiOVtgiF5ZiapcjUL6gtLqExZOHGCtkOBbthMTgh5Tmr" alt="" /><figcaption><em>A screenshot of the top area of a browser’s user interface showing a group of tabs that share the same horizontal space as the app window controls.</em></figcaption></figure><p>Spotify displays album artwork all the way to the top edge of the application window.</p>
<figure id="figure6" class="wp-block-image"><img src="https://lh3.googleusercontent.com/SzPcq94_7Yu_ARf13Z6dRD0tpdlPM_MdrY-7CA_mv4Yu3fBIL3pJnXirP83cCDVoQxnnIEwDoBwbGzfftHmZ3PZZUfsw_oP-m4QLkB2SqekX8JupR9_xmI0tG1q65IfNFbnXIHUh" alt="" /><figcaption><em>A screenshot of an album in Spotify’s desktop application. Album artwork spans the entire width of the main content area, all the way to the top and right edges of the window, and the right edge of the main navigation area on the left side. The application and album navigation controls are overlaid directly on top of the album artwork.</em></figcaption></figure><p>Microsoft Word uses the available title bar space to display the auto-save and search functionalities, and more.</p>
<figure id="figure7" class="wp-block-image"><img src="https://lh6.googleusercontent.com/VdREVwFFjYHxHF0Gg3l079hxsa8WKPEWiuvuL7cWbGnEDJ2yc3JiOWQK5lUyaeEgzpd1Przji0cNLeooPD7riPKbcMixa6IkXanprdqPJVkQrYSerxSaNmzbJPd1YsA55mlYd9xt" alt="" /><figcaption><em>A screenshot of Microsoft Word’s toolbar interface. Document file information, search, and other functionality appear at the top of the window, sharing the same horizontal space as the app’s window controls.</em></figcaption></figure><p>The whole point of this feature is to allow you to make use of this space with your own content while providing a way to account for the window control buttons. And it enables you to offer this modified experience on a range of platforms while not adversely affecting the experience on browsers or devices that don’t support Window Controls Overlay. After all, PWAs are all about <a href="https://alistapart.com/article/understandingprogressiveenhancement/">progressive enhancement</a>, so this feature is a chance to enhance your app to use this extra space when it’s available.</p>
<h2 id="section3">Let’s use the feature</h2>
<p>For the rest of this article, we’ll be working on a demo app to learn more about using the feature.</p>
<p>The demo app is called <a href="https://stupefied-edison-a4ee55.netlify.app/">1DIV</a>. It’s a simple CSS playground where users can create designs using CSS and a single HTML element.</p>
<p>The app has two pages. The first lists the existing CSS designs you’ve created:</p>
<figure id="figure8" class="wp-block-image"><img src="https://lh3.googleusercontent.com/pW2iUTucKfwMJZrAlPGK19vVnEPaHjYT4N-18P-vm9qkhAdGJcRBMexOCu1q9nN9BAfZ7MH6itNP__kY4HPl9uVPucXkbmSX-E9g6AdVAI_uu6TyEsEdH0LUCXdN1f4kqZNgDr30" alt="" /><figcaption><em>A screenshot of the 1DIV app displaying a thumbnail grid of CSS designs a user created.</em></figcaption></figure><p>The second page enables you to create and edit CSS designs:</p>
<figure id="figure9" class="wp-block-image"><img src="https://lh5.googleusercontent.com/faaJ3uHbzXg-TFinvOqR_7gyjVPvlk7fuVWuN4aIH6IUxXNAp4GXtIcuVPpo6bd1IOKO1_EMDt4pUgErUh_X2_2r3WnkQ4PzovPp6Zjg0l98W9NBrHA0xAuTNf0uNVBatRsMJzEm" alt="" /><figcaption><em>A screenshot of the 1DIV app editor page. The top half of the window displays a rendered CSS design, and a text editor on the bottom half of the window displays the CSS used to create it.</em></figcaption></figure><p>Since I’ve added a simple web manifest and service worker, we can install the app as a PWA on desktop. Here is what it looks like on macOS:</p>
<figure id="figure10" class="wp-block-image size-large"><img width="960" height="466" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2021/12/fig10.png?resize=960%2C466&amp;ssl=1" alt="" class="wp-image-7173228" data-recalc-dims="1" /><figcaption><em>Screenshots of the 1DIV app thumbnail view and CSS editor view on macOS. This version of the app’s window has a separate control bar at the top for the app name and window control buttons.</em></figcaption></figure><p>And on Windows:</p>
<figure id="figure11" class="wp-block-image size-large"><img width="960" height="501" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2021/12/fig11.png?resize=960%2C501&amp;ssl=1" alt="" class="wp-image-7173229" data-recalc-dims="1" /><figcaption><em>Screenshots of the 1DIV app thumbnail view and CSS editor view on the Windows operating system. This version of the app’s window also has a separate control bar at the top for the app name and window control buttons.</em></figcaption></figure><p>Our app is looking good, but the white title bar in the first page is wasted space. In the second page, it would be really nice if the design area went all the way to the top of the app window.</p>
<p>Let’s use the Window Controls Overlay feature to improve this.</p>
<h2 id="section4">Enabling Window Controls Overlay</h2>
<p>The feature is still experimental at the moment. To try it, you need to enable it in one of the supported browsers.</p>
<p>As of now, it has been implemented in Chromium, as a collaboration between Microsoft and Google. We can therefore use it in Chrome or Edge by going to the internal <strong>about://flags</strong> page, and enabling the <strong>Desktop PWA Window Controls Overlay</strong> flag.</p>
<h2 id="section5">Using Window Controls Overlay</h2>
<p>To use the feature, we need to add the following <strong>display_override</strong> member to our web app’s manifest file:</p>
<pre id="snippet1"><code class="language-javascript">{
  "name": "1DIV",
  "description": "1DIV is a mini CSS playground",
  "lang": "en-US",
  "start_url": "/",
  "theme_color": "#ffffff",
  "background_color": "#ffffff",
  "display_override": [
    "window-controls-overlay"
  ],
  "icons": [
    ...
  ]
}
</code></pre>
<p>On the surface, the feature is really simple to use. This manifest change is the only thing we need to make the title bar disappear and turn the window controls into an overlay.</p>
<p>However, to provide a great experience for all users regardless of what device or browser they use, and to make the most of the title bar area in our design, we’ll need a bit of CSS and JavaScript code.</p>
<p>Here is what the app looks like now:</p>
<figure id="figure12" class="wp-block-image"><img src="https://lh6.googleusercontent.com/YbSJ4vMtrc88Jr8sh7F8uWED-9OVFvLkXNT3xVP9gdmQt9XwC-wGHPmaspcKnfSpPMjSotYzRISGPag1Ugq3mxWTslaVhPK9iP8IHLjFnE_FcIkM0y3olJ4Gzw5ejrZFTRbz9avF" alt="" /><figcaption><em>Screenshot of the 1DIV app thumbnail view using Window Controls Overlay on macOS. The separate top bar area is gone, but the window controls are now blocking some of the app’s interface</em></figcaption></figure><p>The title bar is gone, which is what we wanted, but our logo, search field, and <strong>NEW</strong> button are partially covered by the window controls because now our layout starts at the top of the window.</p>
<p>It’s similar on Windows, with the difference that the close, maximize, and minimize buttons appear on the right side, grouped together with the PWA control buttons:</p>
<figure id="figure13" class="wp-block-image"><img src="https://lh6.googleusercontent.com/ytqSauTsKKNI6N7YzxlIqhNatK7LwaPw6yY74jq2egOsBIHbzl2vFGPMRK6dqx6tE-UqSCCWS8f1YftsXZygxEB6KALUYfGU9XW4poE1NPpjYKV66bk1k6dy91rh6TMZ1qb3Rph-" alt="" /><figcaption><em>Screenshot of the 1DIV app thumbnail display using Window Controls Overlay on the Windows operating system. The separate top bar area is gone, but the window controls are now blocking some of the app’s content.</em></figcaption></figure><h2 id="section6">Using CSS to keep clear of the window controls</h2>
<p>Along with the feature, new CSS environment variables have been introduced:</p>
<ul><li><strong><code>titlebar-area-x</code></strong></li>
<li><code><strong>titlebar-area-y</strong></code></li>
<li><code><strong>titlebar-area-width</strong></code></li>
<li><strong><code>titlebar-area-height</code></strong></li>
</ul><p>You use these variables with the CSS <a href="https://developer.mozilla.org/en-US/docs/Web/CSS/env()"><strong>env()</strong></a> function to position your content where the title bar would have been while ensuring it won’t overlap with the window controls. In our case, we’ll use two of the variables to position our header, which contains the logo, search bar, and <strong>NEW</strong> button. </p>
<pre id="snippet2"><code class="language-css">header {
  position: absolute;
  left: env(titlebar-area-x, 0);
  width: env(titlebar-area-width, 100%);
  height: var(--toolbar-height);
}
</code></pre>
<p>The <code><strong>titlebar-area-x</strong></code> variable gives us the distance from the left of the viewport to where the title bar would appear, and <strong><code>titlebar-area-width</code></strong> is its width. (Remember, this is not equivalent to the width of the entire viewport, just the title bar portion, which as noted earlier, doesn’t include the window controls.)</p>
<p>By doing this, we make sure our content remains fully visible. We’re also defining fallback values (the second parameter in the <strong><code>env()</code></strong> function) for when the variables are not defined (such as on non-supporting browsers, or when the Windows Control Overlay feature is disabled).</p>
<figure id="figure14" class="wp-block-image"><img src="https://lh5.googleusercontent.com/AYZ7D2ZqvPLip8FtF6IzI6XSAEoajjviCG5fo40_ynrksUesFQBjZVEN6dsTOA8F9CCqXbFWb32ZYUN73hEAkMlyzKnX_1Qzjy7kR6jl42TyyJOeg1FWK7A9WeWn-_7SD57-EOdt" alt="" /><figcaption><em>Screenshot of the 1DIV app thumbnail view on macOS with Window Controls Overlay and our CSS updated. The app content that the window controls had been blocking has been repositioned.</em></figcaption></figure><figure id="figure15" class="wp-block-image"><img src="https://lh6.googleusercontent.com/ZxtH5F4v2io8ntHHi8V0YhqgBc_GD5pcq4g52zZy4_bEhbtjC3G7WdyZqQmwc6-D_NIp7Z8dvjsG8qz42DIg7RDhC6HbPHThXEFsknbOgcEfkF7d_cqx45T9vTi6z23pVe0-1nxA" alt="" /><figcaption><em>Screenshot of the 1DIV app thumbnail view on the Windows operating system with Window Controls Overlay and our updated CSS. The app content that the window controls had been blocking has been repositioned.</em></figcaption></figure><p>Now our header adapts to its surroundings, and it doesn’t feel like the window control buttons have been added as an afterthought. The app looks a lot more like a native app.</p>
<h2 id="section7">Changing the window controls background color so it blends in</h2>
<p>Now let’s take a closer look at our second page: the CSS playground editor.</p>
<figure id="figure16" class="wp-block-image size-large"><img width="960" height="486" src="https://i0.wp.com/alistapart.com/wp-content/uploads/2021/12/fig16.png?resize=960%2C486&amp;ssl=1" alt="" class="wp-image-7173230" data-recalc-dims="1" /><figcaption><em>Screenshots of the 1DIV app CSS editor view with Window Controls Overlay in macOS and Windows, respectively. The window controls overlay areas have a solid white background color, which contrasts with the hot pink color of the example CSS design displayed in the editor.</em></figcaption></figure><p>Not great. Our CSS demo area does go all the way to the top, which is what we wanted, but the way the window controls appear as white rectangles on top of it is quite jarring.</p>
<p>We can fix this by changing the app’s theme color. There are a couple of ways to define it:</p>
<ul><li>PWAs can define a theme color in the web app manifest file using the <a href="https://developer.mozilla.org/en-US/docs/Web/Manifest/theme_color"><strong>theme_color</strong></a> manifest member. This color is then used by the OS in different ways. On desktop platforms, it is used to provide a background color to the title bar and window controls.</li>
<li>Websites can use the <a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/meta/name/theme-color"><strong>theme-color</strong> meta tag</a> as well. It’s used by browsers to customize the color of the UI around the web page. For PWAs, this color can override the manifest <strong><code>theme_color</code></strong>.</li>
</ul><p>In our case, we can set the manifest <strong><code>theme_color</code></strong> to white to provide the right default color for our app. The OS will read this color value when the app is installed and use it to make the window controls background color white. This color works great for our main page with the list of demos.</p>
<p>The <strong><code>theme-color</code></strong> meta tag can be changed at runtime, using JavaScript. So we can do that to override the white with the right demo background color when one is opened.</p>
<p>Here is the function we’ll use:</p>
<pre id="snippet3"><code class="language-javascript">function themeWindow(bgColor) {
  document.querySelector("meta[name=theme-color]").setAttribute('content', bgColor);
}</code></pre>
<p>With this in place, we can imagine how using color and CSS transitions can produce a smooth change from the list page to the demo page, and enable the window control buttons to blend in with the rest of the app’s interface.</p>
<figure id="figure17" class="wp-block-image"><img src="https://lh4.googleusercontent.com/YVYktaP8CkIQJFlCtWlwVU4dequS4MutbDJfm-vS8kGx_nedIgzziuHeZICeJ-vsu33VR0rydqwKH0JVIFKjWjlrvbWPYssNvxr7rBsCKKdag7PHMhA_NLV3w0nzBuBzurk1fr1i" alt="" /><figcaption><em>Screenshot of the 1DIV app CSS editor view on the Windows operating system with Window Controls Overlay and updated CSS demonstrating how the window control buttons blend in with the rest of the app’s interface.</em></figcaption></figure><h2 id="section8">Dragging the window</h2>
<p>Now, getting rid of the title bar entirely does have an important accessibility consequence: it’s much more difficult to move the application window around.</p>
<p>The title bar provides a sizable area for users to click and drag, but by using the Window Controls Overlay feature, this area becomes limited to where the control buttons are, and users have to very precisely aim between these buttons to move the window.</p>
<p>Fortunately, this can be fixed using CSS with the <strong><code>app-region</code></strong> property. This property is, for now, only supported in Chromium-based browsers and needs the <strong><code>-webkit-</code></strong> vendor prefix. </p>
<p>To make any element of the app become a dragging target for the window, we can use the following: </p>
<p><strong><code>-webkit-app-region: drag;</code></strong></p>
<p>It is also possible to explicitly make an element non-draggable: </p>
<p><code>-<strong>webkit-app-region: no-drag;</strong> </code></p>
<p>These options can be useful for us. We can make the entire header a dragging target, but make the search field and <strong>NEW</strong> button within it non-draggable so they can still be used as normal.</p>
<p>However, because the editor page doesn’t display the header, users wouldn’t be able to drag the window while editing code. So let’s use a different approach. We’ll create another element before our header, also absolutely positioned, and dedicated to dragging the window.</p>
<pre id="snippet4"><code class="language-markup">&lt;div class="drag"&gt;&lt;/div&gt;
&lt;header&gt;...&lt;/header&gt;</code></pre>
<pre id="snippet5"><code class="language-css">.drag {
  position: absolute;
  top: 0;
  width: 100%;
  height: env(titlebar-area-height, 0);
  -webkit-app-region: drag;
}</code></pre>
<p>With the above code, we’re making the draggable area span the entire viewport width, and using the <strong><code>titlebar-area-height</code></strong> variable to make it as tall as what the title bar would have been. This way, our draggable area is aligned with the window control buttons as shown below.</p>
<p>And, now, to make sure our search field and button remain usable:</p>
<pre id="snippet6"><code class="language-css">header .search,
header .new {
  -webkit-app-region: no-drag;
}</code></pre>
<p>With the above code, users can click and drag where the title bar used to be. It is an area that users expect to be able to use to move windows on desktop, and we’re not breaking this expectation, which is good.</p>
<figure id="figure18" class="wp-block-image"><img src="https://lh5.googleusercontent.com/sU0QjlT2R7SrF91GI--WcdHRy0shD7CfnKpfzvgXGz5VptZY6hyoDX_SYFqxFG85dxMgbLidjb8cwJOcnqzd4OAWeNjIVgSiKpaz68orEZEU7DgKHHLkM3NXU5rkALkpUrEl7Pp_" alt="" /><figcaption><em>An animated view of the 1DIV app being dragged across a Windows desktop with the mouse.</em></figcaption></figure><h2 id="section9">Adapting to window resize</h2>
<p>It may be useful for an app to know both whether the window controls overlay is visible and when its size changes. In our case, if the user made the window very narrow, there wouldn’t be enough space for the search field, logo, and button to fit, so we’d want to push them down a bit.</p>
<p>The Window Controls Overlay feature comes with a JavaScript API we can use to do this: <strong><code>navigator.windowControlsOverlay</code></strong>.</p>
<p>The API provides three interesting things:</p>
<ul><li><strong><code>navigator.windowControlsOverlay.visible</code></strong> lets us know whether the overlay is visible.</li>
<li><strong><code>navigator.windowControlsOverlay.getBoundingClientRect()</code></strong> lets us know the position and size of the title bar area.</li>
<li><strong><code>navigator.windowControlsOverlay.ongeometrychange</code></strong> lets us know when the size or visibility changes.</li>
</ul><p>Let’s use this to be aware of the size of the title bar area and move the header down if it’s too narrow.</p>
<pre id="snippet7"><code class="language-javascript">if (navigator.windowControlsOverlay) {
  navigator.windowControlsOverlay.addEventListener('geometrychange', () =&gt; {
    const { width } = navigator.windowControlsOverlay.getBoundingClientRect();
    document.body.classList.toggle('narrow', width &lt; 250);
  });
}</code></pre>
<p>In the example above, we set the <strong><code>narrow</code></strong> class on the <strong><code>body</code></strong> of the app if the title bar area is narrower than 250px. We could do something similar with a media query, but using the <strong><code>windowControlsOverlay</code></strong> API has two advantages for our use case:</p>
<ul><li>It’s only fired when the feature is supported and used; we don’t want to adapt the design otherwise.</li>
<li>We get the size of the title bar area across operating systems, which is great because the size of the window controls is different on Mac and Windows. Using a media query wouldn’t make it possible for us to know exactly how much space remains.</li>
</ul><pre id="snippet8"><code class="language-css">.narrow header {
  top: env(titlebar-area-height, 0);
  left: 0;
  width: 100%;
}</code></pre>
<p>Using the above CSS code, we can move our header down to stay clear of the window control buttons when the window is too narrow, and move the thumbnails down accordingly.</p>
<figure id="figure19" class="wp-block-image"><img src="https://lh5.googleusercontent.com/e4oVs-No9pSWdYyfqTJ0QKcKrDzlv11bsoTwSVvFBhi1bUo9dP2ub71MlWa90QLEFUc5C9e81mQtg3xwGpB5Kkfvu1dNqdBVhqetz74N_0TSWh7_RfZ5NkDNJEuhv5_ZVvw-vpDG" alt="" /><figcaption><em>A screenshot of the 1DIV app on Windows showing the app’s content adjusted for a much narrower viewport.</em></figcaption></figure><h2 id="section10">Thirty pixels of exciting design opportunities</h2>
<p><br />
Using the Window Controls Overlay feature, we were able to take our simple demo app and turn it into something that feels so much more integrated on desktop devices. Something that reaches out of the usual window constraints and provides a custom experience for its users.</p>
<p>In reality, this feature only gives us about 30 pixels of extra room and comes with challenges on how to deal with the window controls. And yet, this extra room and those challenges can be turned into exciting design opportunities.</p>
<p>More devices of all shapes and forms get invented all the time, and the web keeps on evolving to adapt to them. New features get added to the web platform to allow us, web authors, to integrate more and more deeply with those devices. From watches or foldable devices to desktop computers, we need to evolve our design approach for the web. Building for the web now lets us think outside the rectangular box.</p>
<p>So let’s embrace this. Let’s use the standard technologies already at our disposal, and experiment with new ideas to provide tailored experiences for all devices, all from a single codebase!</p>
<p><br />
If you get a chance to try the Window Controls Overlay feature and have feedback about it, you can <a href="https://github.com/WICG/window-controls-overlay/issues">open issues on the spec’s repository</a>. It’s still early in the development of this feature, and you can help make it even better. Or, you can take a look at the <a href="https://docs.microsoft.com/en-us/microsoft-edge/progressive-web-apps-chromium/how-to/window-controls-overlay">feature’s existing documentation</a>, or this <a href="https://stupefied-edison-a4ee55.netlify.app/">demo app</a> and its <a href="https://github.com/captainbrosset/1DIV">source code</a>. </p>]]></description>
      <link>https://alistapart.com/article/breaking-out-of-the-box/</link>
      <guid>https://alistapart.com/article/breaking-out-of-the-box/</guid>
      <pubDate>Thu, 09 Dec 2021 16:00:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[How to Sell UX Research with Two Simple Questions]]></title>
      <description><![CDATA[<p>Do you find yourself designing screens with only a vague idea of how the things on the screen relate to the things elsewhere in the system? Do you leave stakeholder meetings with unclear directives that often seem to contradict previous conversations? You <em>know</em> a better understanding of user needs would help the team get clear on what you are actually trying to accomplish, but time and budget for research is tight. When it comes to asking for more direct contact with your users, you might feel like poor Oliver Twist, timidly asking, “Please, sir, I want some more.” </p><div class="aside-breaker">Article Continues Below</div>
<p>Here’s the trick. You need to get stakeholders <em>themselves</em> to identify high-risk assumptions and hidden complexity, so that they become just as motivated as you to get answers from users. Basically, you need to make them think it’s their idea. </p>
<p>In this article, I’ll show you how to collaboratively expose misalignment and gaps in the team’s shared understanding by bringing the team together around two simple questions:</p>
<ol><li>What are the objects?</li>
<li>What are the relationships between those objects?</li>
</ol><h2 id="section2">A gauntlet between research and screen design<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/how-to-sell-ux-research#section2">#section2</a></h2>
<p>These two questions align to the first two steps of the ORCA process, which might become your new best friend when it comes to reducing guesswork. Wait, what’s ORCA?! Glad you asked.</p>
<p>ORCA stands for Objects, Relationships, CTAs, and Attributes, and it outlines a process for creating solid object-oriented user experiences. <a href="https://alistapart-production.mystagingwebsite.com/article/object-oriented-ux/">Object-oriented UX</a> is my design philosophy. ORCA is an iterative methodology for synthesizing user research into an elegant structural foundation to support screen and interaction design. <a href="https://alistapart-production.mystagingwebsite.com/article/ooux-a-foundation-for-interaction-design/">OOUX</a> and ORCA have made my work as a UX designer more collaborative, effective, efficient, fun, strategic, and meaningful.</p>
<p>The ORCA process has four iterative rounds and a whopping fifteen steps. In each round we get more clarity on our Os, Rs, Cs, and As.</p>
<figure id="figure1" class="wp-block-image size-large"><img width="1200" height="675" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/10/selling-ux-image1-1.jpg?resize=1024,576" alt="" class="wp-image-7173149" /><figcaption><em>The four rounds and fifteen steps of the ORCA process. In the OOUX world, we love color-coding. Blue is reserved for objects! (Yellow is for core content, pink is for metadata, and green is for calls-to-action. Learn more about the</em> <a href="https://alistapart-production.mystagingwebsite.com/article/object-oriented-ux/"><em>color-coded object map</em></a> <em>and</em> <a href="https://alistapart-production.mystagingwebsite.com/article/ooux-a-foundation-for-interaction-design/"><em>connecting CTAs to objects</em></a><em>.)</em></figcaption></figure><p>I sometimes say that ORCA is a “garbage in, garbage out” process. To ensure that the testable prototype produced in the final round actually tests <em>well</em>, the process needs to be fed by <em>good</em> research. But if you don’t have a ton of research, the beginning of the ORCA process serves another purpose: it helps you sell the <em>need</em> for research.</p>
<figure id="figure2" class="wp-block-image size-large"><img width="1200" height="749" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/10/selling-ux-image2-1.jpg?resize=1024,639" alt="" class="wp-image-7173150" /><figcaption><em>ORCA strengthens the weak spot between research and design by helping distill research into solid information architecture—scaffolding for the screen design and interaction design to hang on.</em></figcaption></figure><p>In other words, the ORCA process serves as a gauntlet between research and design. With good research, you can gracefully ride the killer whale from research into design. But without good research, the process effectively spits you back into research and with a cache of <em>specific</em> open questions.</p>
<h2 id="section3">Getting in the same curiosity-boat<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/how-to-sell-ux-research#section3">#section3</a></h2>
<blockquote class="wp-block-quote">
<p>What gets us into trouble is not what we don’t know. It’s what we know for sure that just ain’t so.</p>
<div><cite>Mark Twain</cite></div></blockquote>
<p>The first two steps of the ORCA process—Object Discovery and Relationship Discovery—shine a spotlight on the dark, dusty corners of your team’s misalignments and any inherent complexity that’s been swept under the rug. It begins to expose what this classic comic so beautifully illustrates:</p>
<figure id="figure3" class="wp-block-image size-full"><img width="674" height="488" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/10/selling-ux-image3-2.jpg" alt="" class="wp-image-7173151" /><figcaption><em>The original “Tree Swing Project Management” cartoon dates back to the 1960s or 1970s and has no artist attribution we could find.</em></figcaption></figure><p>This is one reason why so many UX designers are frustrated in their job and why many projects fail. And this is also why we often can’t sell research: every decision-maker is confident in their own mental picture. </p>
<p>Once we expose hidden fuzzy patches in each picture and the differences between them all, the case for user research makes itself.</p>
<p>But how we do this is important. However much we might want to, we can’t just tell everyone, “YOU ARE WRONG!” Instead, we need to facilitate and guide our team members to self-identify holes in their picture. When stakeholders take ownership of assumptions and gaps in understanding, BAM! Suddenly, UX research is not such a hard sell, and everyone is aboard the same curiosity-boat.</p>
<p>Say your users are doctors. And you have no idea how doctors use the system you are tasked with redesigning.</p>
<p>You might try to sell research by honestly saying: “We need to understand doctors better! What are their pain points? How do they use the current app?” But here’s the problem with that. Those questions are vague, and the answers to them don’t feel acutely actionable.</p>
<p>Instead, you want your stakeholders themselves to ask super-specific questions. This is more like the kind of conversation you need to facilitate. Let’s listen in:</p>
<p><em>“Wait a sec, how often do doctors share patients? Does a patient in this system have primary and secondary doctors?”</em></p>
<p><em>“Can a patient even have more than one primary doctor?”</em></p>
<p><em>“Is it a ‘primary doctor’ or just a ‘primary caregiver’… Can’t that role be a nurse practitioner?”</em></p>
<p><em>“No, caregivers are something else… That’s the patient’s family contacts, right?”</em></p>
<p><em>“So are caregivers in scope for this redesign?”</em></p>
<p><em>“Yeah, because if a caregiver is present at an appointment, the doctor needs to note that. Like, tag the caregiver on the note… Or on the appointment?”</em></p>
<p>Now we are getting somewhere. Do you see how powerful it can be getting stakeholders to debate these questions themselves? The diabolical goal here is to shake their confidence—gently and diplomatically.</p>
<p>When these kinds of questions bubble up collaboratively and come directly from the mouths of your stakeholders and decision-makers, suddenly, designing screens <em>without</em> knowing the answers to these questions seems incredibly risky, even silly.</p>
<p>If we create software without understanding the real-world information environment of our users, we will likely create software that does not <em>align</em> to the real-world information environment of our users. And this will, hands down, result in a more confusing, more complex, and less intuitive software product.</p>
<p>But how do we get to these kinds of meaty questions diplomatically, efficiently, collaboratively, and <em>reliably</em>? </p>
<p>We can do this by starting with those two big questions that align to the first two steps of the ORCA process:</p>
<ol><li>What are the objects?</li>
<li>What are the relationships between those objects?</li>
</ol><p>In practice, getting to these answers is easier said than done. I’m going to show you how these two simple questions can provide the outline for an Object Definition Workshop. During this workshop, these “seed” questions will blossom into dozens of specific questions and shine a spotlight on the need for more user research.</p>
<h2 id="section5">Prep work: Noun foraging<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/how-to-sell-ux-research#section5">#section5</a></h2>
<p>In the next section, I’ll show you how to run an Object Definition Workshop with your stakeholders (and entire cross-functional team, hopefully). But first, you need to do some prep work.</p>
<p>Basically, look for nouns that are particular to the business or industry of your project, and do it across at least a few sources. I call this <em>noun foraging</em>.</p>
<p>Here are just a few great noun foraging sources:</p>
<ul><li>the product’s marketing site</li>
<li>the product’s competitors’ marketing sites (competitive analysis, anyone?)</li>
<li>the existing product (look at labels!)</li>
<li>user interview transcripts</li>
<li>notes from stakeholder interviews or vision docs from stakeholders</li>
</ul><p>Put your detective hat on, my dear Watson. Get resourceful and leverage what you have. If all you have is a marketing website, some screenshots of the existing legacy system, and access to customer service chat logs, then use those.</p>
<p>As you peruse these sources, watch for the nouns that are used over and over again, and start listing them (preferably on blue sticky notes if you’ll be creating an object map later!).</p>
<p>You’ll want to focus on nouns that <em>might</em> represent objects in your system. If you are having trouble determining if a noun might be object-worthy, remember the acronym SIP and test for:</p>
<ol><li>Structure</li>
<li>Instances</li>
<li>Purpose</li>
</ol><p>Think of a library app, for example. Is “book” an object?</p>
<p>Structure: can you think of a few attributes for this potential object? <em>Title, author, publish date…</em> Yep, it has structure. Check!</p>
<p>Instance: what are some examples of this potential “book” object? Can you name a few? <em>The Alchemist,</em> <em>Ready Player One</em>, <em>Everybody Poops</em>… OK, check!</p>
<p>Purpose: why is this object important to the users and business? <em>Well, “book” is what our library client is providing to people and books are why people come to the library</em>… Check, check, check!</p>
<figure id="figure4" class="wp-block-image size-large"><img width="1200" height="794" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/10/selling-ux-image4-1.jpg?resize=1024,678" alt="" class="wp-image-7173152" /><figcaption><em>SIP: Structure, Instances, and Purpose! (Here’s a</em> <a href="https://whimsical.com/is-it-a-object-in-the-ooux-world-PubTHzL4Hs1Kr6Xs6b8y2J"><em>flowchart</em></a> <em>where I elaborate even more on SIP.)</em></figcaption></figure><p>As you are noun foraging, focus on capturing the nouns that have SIP. Avoid capturing <em>components</em> like dropdowns, checkboxes, and calendar pickers—<a href="https://alistapart-production.mystagingwebsite.com/article/a-content-model-is-not-a-design-system/">your UX system is not your design system</a>! Components are just the packaging for objects—they are a means to an end. No one is coming to your digital place to play with your dropdown! They are coming for the VALUABLE THINGS and what they can do with them. Those things, or objects, are what we are trying to identify.</p>
<p>Let’s say we work for a startup disrupting the email experience. This is how I’d start my noun foraging.</p>
<p>First I’d look at my own email client, which happens to be Gmail. I’d then look at Outlook and the new HEY email. I’d look at Yahoo, Hotmail…I’d even look at Slack and Basecamp and other so-called “email replacers.” I’d read some articles, reviews, and forum threads where people are complaining about email. While doing all this, I would look for and write down the nouns.</p>
<p>(Before moving on, feel free to go noun foraging for this hypothetical product, too, and then scroll down to see how much our lists match up. Just don’t get lost in your own emails! Come back to me!)</p>
<p>Drumroll, please…</p>
<p>Here are a few nouns I came up with during my noun foraging:</p>
<ul><li>email message</li>
<li>thread</li>
<li>contact</li>
<li>client</li>
<li>rule/automation</li>
<li>email address that is not a contact?</li>
<li>contact groups</li>
<li>attachment</li>
<li>Google doc file / other integrated file</li>
<li>newsletter? (HEY treats this differently)</li>
<li>saved responses and templates</li>
</ul><figure id="figure5" class="wp-block-image size-large"><img width="1200" height="800" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/10/selling-ux-image5-1.jpg?resize=1024,683" alt="" class="wp-image-7173153" /><figcaption><em>In the OOUX world, we love color-coding. Blue is reserved for objects! (Yellow is for core content, pink is for metadata, and green is for calls-to-action. Learn more about the</em> <a href="https://alistapart-production.mystagingwebsite.com/article/object-oriented-ux/"><em>color coded object map</em></a> <em>and</em> <a href="https://alistapart-production.mystagingwebsite.com/article/ooux-a-foundation-for-interaction-design/"><em>connecting CTAs to objects</em></a><em>.)</em></figcaption></figure><p>Scan your list of nouns and pick out words that you are completely clueless about. In our email example, it might be <em>client</em> or <em>automation</em>. Do as much homework as you can before your session with stakeholders: google what’s googleable. But other terms might be so specific to the product or domain that you need to have a conversation about them.</p>
<p><em>Aside: here are some real nouns foraged during my own past project work that I needed my stakeholders to help me understand:</em></p>
<ul><li><em>Record Locator</em></li>
<li><em>Incentive Home</em></li>
<li><em>Augmented Line Item</em></li>
<li><em>Curriculum-Based Measurement Probe</em></li>
</ul><p>This is really all you need to prepare for the workshop session: a list of nouns that represent potential objects and a short list of nouns that need to be defined further.</p>
<h2 id="section6">Facilitate an Object Definition Workshop<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/how-to-sell-ux-research#section6">#section6</a></h2>
<p>You could actually start your workshop with noun foraging—this activity <em>can</em> be done collaboratively. If you have five people in the room, pick five sources, assign one to every person, and give everyone ten minutes to find the objects within their source. When the time’s up, come together and find the overlap. Affinity mapping is your friend here!</p>
<p>If your team is short on time and might be reluctant to do this kind of grunt work (which is usually the case) do your own noun foraging beforehand, but be prepared to show your work. I love presenting screenshots of documents and screens with all the nouns already highlighted. Bring the artifacts of your process, and start the workshop with a five-minute overview of your noun foraging journey.</p>
<p>HOT TIP: before jumping into the workshop, frame the conversation as a requirements-gathering session to help <em>you</em> better understand the scope and details of the system. You don’t need to let them know that you’re looking for gaps in the team’s understanding so that you can prove the need for more user research—that will be our little secret. Instead, go into the session optimistically, as if your knowledgeable stakeholders and PMs and biz folks already have all the answers. </p>
<p>Then, let the question whack-a-mole commence.</p>
<h3 id="section7">1. What is this thing?<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/how-to-sell-ux-research#section7">#section7</a></h3>
<p>Want to have some <em>real</em> fun? At the beginning of your session, ask stakeholders to privately write definitions for the handful of obscure nouns you might be uncertain about. Then, have everyone show their cards at the same time and see if you get different definitions (you will). This is <em>gold</em> for exposing misalignment and starting great conversations.</p>
<p>As your discussion unfolds, capture any agreed-upon definitions. And when uncertainty emerges, quietly (but visibly) start an “open questions” parking lot. ?</p>
<p>After definitions solidify, here’s a great follow-up:</p>
<h3 id="section8">2. Do our users know what these things are? What do users call this thing?<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/how-to-sell-ux-research#section8">#section8</a></h3>
<p class="c1">Stakeholder 1: They probably call email clients “apps.” But I’m not sure.</p>
<p>Stakeholder 2: Automations are often called “workflows,” I think. Or, maybe users think workflows are something different.</p>
<p>If a more user-friendly term emerges, ask the group if they can agree to use only that term moving forward. This way, the team can better align to the users’ language and mindset.</p>
<p>OK, moving on. </p>
<p>If you have two or more objects that seem to overlap in purpose, ask one of these questions:</p>
<h3 id="section9">3. Are these the same thing? Or are these different? If they are not the same, how are they different?<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/how-to-sell-ux-research#section9">#section9</a></h3>
<p class="c1">You: Is a saved response the same as a template?</p>
<p class="c1">Stakeholder 1: Yes! Definitely.</p>
<p>Stakeholder 2: I don’t think so… A saved response is text with links and variables, but a template is more about the look and feel, like default fonts, colors, and placeholder images. </p>
<p>Continue to build out your growing glossary of objects. And continue to capture areas of uncertainty in your “open questions” parking lot.</p>
<p>If you successfully determine that two similar things are, in fact, different, here’s your next follow-up question:</p>
<h3 id="section10">4. What’s the relationship between these objects?<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/how-to-sell-ux-research#section10">#section10</a></h3>
<p class="c1">You: Are saved responses and templates related in any way?</p>
<p class="c1">Stakeholder 3:  Yeah, a template can be applied to a saved response.</p>
<p>You, always with the follow-ups: When is the template applied to a saved response? Does that happen when the user is constructing the saved response? Or when they apply the saved response to an email? How does that actually work?</p>
<p>Listen. Capture uncertainty. Once the list of “open questions” grows to a critical mass, pause to start assigning questions to groups or individuals. Some questions might be for the dev team (hopefully at least one developer is in the room with you). One question might be specifically for someone who couldn’t make it to the workshop. And many questions will need to be labeled “user.” </p>
<p>Do you see how we are building up to our UXR sales pitch?</p>
<h3 id="section11"><strong>5. Is this object in scope?</strong><a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/how-to-sell-ux-research#section11">#section11</a></h3>
<p>Your next question narrows the team’s focus toward what’s most important to your users. You can simply ask, “Are saved responses in scope for our first release?,” but I’ve got a better, more devious strategy.</p>
<p>By now, you should have a list of clearly defined objects. Ask participants to sort these objects from most to least important, either in small breakout groups or individually. Then, like you did with the definitions, have everyone reveal their sort order at once. Surprisingly—or not so surprisingly—it’s not unusual for the VP to rank something like “saved responses” as #2 while everyone else puts it at the bottom of the list. Try not to look too smug as you inevitably expose more misalignment.</p>
<p>I did this for a startup a few years ago. We posted the three groups’ wildly different sort orders on the whiteboard.</p>
<figure id="figure6" class="wp-block-image size-large"><img width="1200" height="974" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/10/selling-ux-image6-1.jpg?resize=1024,831" alt="" class="wp-image-7173154" /><figcaption><em>Here’s a snippet of the very messy middle from this session: three columns of object cards, showing the same cards prioritized completely differently by three different groups.</em></figcaption></figure><p>The CEO stood back, looked at it, and said, “This is why we haven’t been able to move forward in two years.”</p>
<p>Admittedly, it’s tragic to hear that, but as a professional, it feels pretty awesome to be the one who facilitated a watershed realization.</p>
<p>Once you have a good idea of in-scope, clearly defined things, this is when you move on to doing more relationship mapping.</p>
<h3 id="section12">6. Create a visual representation of the objects’ relationships<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/how-to-sell-ux-research#section12">#section12</a></h3>
<p>We’ve already done a bit of this while trying to determine if two things are different, but this time, ask the team about <em>every</em> potential relationship. For each object, ask how it relates to all the other objects. In what ways are the objects connected? To visualize all the connections, pull out your trusty boxes-and-arrows technique. Here, we are connecting our objects with verbs. I like to keep my verbs to simple “has a” and “has many” statements.</p>
<figure id="figure7" class="wp-block-image size-large"><img width="1200" height="820" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/10/selling-ux-image7-1.jpg?resize=1024,700" alt="" class="wp-image-7173155" /><figcaption><em>A work-in-progress system model of our new email solution.</em></figcaption></figure><p>This system modeling activity brings up all sorts of new questions:</p>
<ul><li>Can a saved response have attachments?</li>
<li>Can a saved response use a template? If so, if an email uses a saved response with a template, can the user override that template?</li>
<li>Do users want to see all the emails they sent that included a particular attachment? For example, “show me all the emails I sent with <strong>ProfessionalImage.jpg</strong> attached. I’ve changed my professional photo and I want to alert everyone to update it.” </li>
</ul><p>Solid answers might emerge directly from the workshop participants. Great! Capture that new shared understanding. But when uncertainty surfaces, continue to add questions to your growing parking lot.</p>
<p>You’ve positioned the explosives all along the floodgates. Now you simply have to light the fuse and BOOM. Watch the buy-in for user research flooooow.</p>
<p>Before your workshop wraps up, have the group reflect on the list of open questions. Make plans for getting answers internally, then focus on the questions that need to be brought before users.</p>
<p>Here’s your final step. Take those questions you’ve compiled for user research and discuss the level of risk associated with NOT answering them. Ask, “if we design without an answer to this question, if we make up our own answer and we are wrong, how bad might that turn out?” </p>
<p>With this methodology, we are cornering our decision-makers into advocating for user research as they themselves label questions as high-risk. Sorry, not sorry. </p>
<p><em>Now</em> is your moment of truth. With everyone in the room, ask for a reasonable budget of time and money to conduct 6–8 user interviews focused <em>specifically</em> on these questions. </p>
<p>HOT TIP: if you are new to UX research, please note that you’ll likely need to rephrase the questions that came up during the workshop before you present them to users. Make sure your questions are open-ended and don’t lead the user into any default answers.</p>
<h2 id="section14">Final words: Hold the screen design!<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/how-to-sell-ux-research#section14">#section14</a></h2>
<p>Seriously, if at all possible, do not ever design screens again without first answering these fundamental questions: what are the objects and how do they relate?</p>
<p>I promise you this: if you can secure a shared understanding between the business, design, and development teams <em>before</em> you start designing screens, you will have less heartache and save more time and money, and (it almost feels like a bonus at this point!) users will be more receptive to what you put out into the world. </p>
<p>I sincerely hope this helps you win time and budget to go talk to your users and gain clarity on what you are designing before you start building screens. If you find success using noun foraging and the Object Definition Workshop, there’s more where that came from in the rest of the ORCA process, which will help prevent even more late-in-the-game scope tugs-of-war and strategy pivots. </p>
<p>All the best of luck! Now go sell research!</p>]]></description>
      <link>https://alistapart-production.mystagingwebsite.com/article/how-to-sell-ux-research/</link>
      <guid>https://alistapart-production.mystagingwebsite.com/article/how-to-sell-ux-research/</guid>
      <pubDate>Thu, 21 Oct 2021 16:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[How to Sell UX Research with Two Simple Questions]]></title>
      <description><![CDATA[<p>Do you find yourself designing screens with only a vague idea of how the things on the screen relate to the things elsewhere in the system? Do you leave stakeholder meetings with unclear directives that often seem to contradict previous conversations? You <em>know</em> a better understanding of user needs would help the team get clear on what you are actually trying to accomplish, but time and budget for research is tight. When it comes to asking for more direct contact with your users, you might feel like poor Oliver Twist, timidly asking, “Please, sir, I want some more.” </p>


<p>Here’s the trick. You need to get stakeholders <em>themselves</em> to identify high-risk assumptions and hidden complexity, so that they become just as motivated as you to get answers from users. Basically, you need to make them think it’s their idea. </p>
<p>In this article, I’ll show you how to collaboratively expose misalignment and gaps in the team’s shared understanding by bringing the team together around two simple questions:</p>
<ol><li>What are the objects?</li>
<li>What are the relationships between those objects?</li>
</ol><h2 id="section2">A gauntlet between research and screen design</h2>
<p>These two questions align to the first two steps of the ORCA process, which might become your new best friend when it comes to reducing guesswork. Wait, what’s ORCA?! Glad you asked.</p>
<p>ORCA stands for Objects, Relationships, CTAs, and Attributes, and it outlines a process for creating solid object-oriented user experiences. <a href="https://alistapart.com/article/object-oriented-ux/">Object-oriented UX</a> is my design philosophy. ORCA is an iterative methodology for synthesizing user research into an elegant structural foundation to support screen and interaction design. <a href="https://alistapart.com/article/ooux-a-foundation-for-interaction-design/">OOUX</a> and ORCA have made my work as a UX designer more collaborative, effective, efficient, fun, strategic, and meaningful.</p>
<p>The ORCA process has four iterative rounds and a whopping fifteen steps. In each round we get more clarity on our Os, Rs, Cs, and As.</p>
<figure id="figure1" class="wp-block-image size-large"><img width="960" height="540" src="https://alistapart.com/wp-content/uploads/2021/10/selling-ux-image1-1.jpg?resize=960%2C540" alt="" class="wp-image-7173149" data-recalc-dims="1" /><figcaption><em>The four rounds and fifteen steps of the ORCA process. In the OOUX world, we love color-coding. Blue is reserved for objects! (Yellow is for core content, pink is for metadata, and green is for calls-to-action. Learn more about the</em> <a href="https://alistapart.com/article/object-oriented-ux/"><em>color-coded object map</em></a> <em>and</em> <a href="https://alistapart.com/article/ooux-a-foundation-for-interaction-design/"><em>connecting CTAs to objects</em></a><em>.)</em></figcaption></figure><p>I sometimes say that ORCA is a “garbage in, garbage out” process. To ensure that the testable prototype produced in the final round actually tests <em>well</em>, the process needs to be fed by <em>good</em> research. But if you don’t have a ton of research, the beginning of the ORCA process serves another purpose: it helps you sell the <em>need</em> for research.</p>
<figure id="figure2" class="wp-block-image size-large"><img width="960" height="599" src="https://alistapart.com/wp-content/uploads/2021/10/selling-ux-image2-1.jpg?resize=960%2C599" alt="" class="wp-image-7173150" data-recalc-dims="1" /><figcaption><em>ORCA strengthens the weak spot between research and design by helping distill research into solid information architecture—scaffolding for the screen design and interaction design to hang on.</em></figcaption></figure><p>In other words, the ORCA process serves as a gauntlet between research and design. With good research, you can gracefully ride the killer whale from research into design. But without good research, the process effectively spits you back into research and with a cache of <em>specific</em> open questions.</p>
<h2 id="section3">Getting in the same curiosity-boat</h2>
<blockquote class="wp-block-quote">
<p>What gets us into trouble is not what we don’t know. It’s what we know for sure that just ain’t so.</p>
<div><cite>Mark Twain</cite></div></blockquote>
<p>The first two steps of the ORCA process—Object Discovery and Relationship Discovery—shine a spotlight on the dark, dusty corners of your team’s misalignments and any inherent complexity that’s been swept under the rug. It begins to expose what this classic comic so beautifully illustrates:</p>
<figure id="figure3" class="wp-block-image size-full"><img width="674" height="488" src="https://alistapart.com/wp-content/uploads/2021/10/selling-ux-image3-2.jpg?resize=674%2C488" alt="" class="wp-image-7173151" data-recalc-dims="1" /><figcaption><em>The original “Tree Swing Project Management” cartoon dates back to the 1960s or 1970s and has no artist attribution we could find.</em></figcaption></figure><p>This is one reason why so many UX designers are frustrated in their job and why many projects fail. And this is also why we often can’t sell research: every decision-maker is confident in their own mental picture. </p>
<p>Once we expose hidden fuzzy patches in each picture and the differences between them all, the case for user research makes itself.</p>
<p>But how we do this is important. However much we might want to, we can’t just tell everyone, “YOU ARE WRONG!” Instead, we need to facilitate and guide our team members to self-identify holes in their picture. When stakeholders take ownership of assumptions and gaps in understanding, BAM! Suddenly, UX research is not such a hard sell, and everyone is aboard the same curiosity-boat.</p>
<p>Say your users are doctors. And you have no idea how doctors use the system you are tasked with redesigning.</p>
<p>You might try to sell research by honestly saying: “We need to understand doctors better! What are their pain points? How do they use the current app?” But here’s the problem with that. Those questions are vague, and the answers to them don’t feel acutely actionable.</p>
<p>Instead, you want your stakeholders themselves to ask super-specific questions. This is more like the kind of conversation you need to facilitate. Let’s listen in:</p>
<p><em>“Wait a sec, how often do doctors share patients? Does a patient in this system have primary and secondary doctors?”</em></p>
<p><em>“Can a patient even have more than one primary doctor?”</em></p>
<p><em>“Is it a ‘primary doctor’ or just a ‘primary caregiver’… Can’t that role be a nurse practitioner?”</em></p>
<p><em>“No, caregivers are something else… That’s the patient’s family contacts, right?”</em></p>
<p><em>“So are caregivers in scope for this redesign?”</em></p>
<p><em>“Yeah, because if a caregiver is present at an appointment, the doctor needs to note that. Like, tag the caregiver on the note… Or on the appointment?”</em></p>
<p>Now we are getting somewhere. Do you see how powerful it can be getting stakeholders to debate these questions themselves? The diabolical goal here is to shake their confidence—gently and diplomatically.</p>
<p>When these kinds of questions bubble up collaboratively and come directly from the mouths of your stakeholders and decision-makers, suddenly, designing screens <em>without</em> knowing the answers to these questions seems incredibly risky, even silly.</p>
<p>If we create software without understanding the real-world information environment of our users, we will likely create software that does not <em>align</em> to the real-world information environment of our users. And this will, hands down, result in a more confusing, more complex, and less intuitive software product.</p>
<h2 id="section4">The two questions</h2>
<p>But how do we get to these kinds of meaty questions diplomatically, efficiently, collaboratively, and <em>reliably</em>? </p>
<p>We can do this by starting with those two big questions that align to the first two steps of the ORCA process:</p>
<ol><li>What are the objects?</li>
<li>What are the relationships between those objects?</li>
</ol><p>In practice, getting to these answers is easier said than done. I’m going to show you how these two simple questions can provide the outline for an Object Definition Workshop. During this workshop, these “seed” questions will blossom into dozens of specific questions and shine a spotlight on the need for more user research.</p>
<h2 id="section5">Prep work: Noun foraging</h2>
<p>In the next section, I’ll show you how to run an Object Definition Workshop with your stakeholders (and entire cross-functional team, hopefully). But first, you need to do some prep work.</p>
<p>Basically, look for nouns that are particular to the business or industry of your project, and do it across at least a few sources. I call this <em>noun foraging</em>.</p>
<p>Here are just a few great noun foraging sources:</p>
<ul><li>the product’s marketing site</li>
<li>the product’s competitors’ marketing sites (competitive analysis, anyone?)</li>
<li>the existing product (look at labels!)</li>
<li>user interview transcripts</li>
<li>notes from stakeholder interviews or vision docs from stakeholders</li>
</ul><p>Put your detective hat on, my dear Watson. Get resourceful and leverage what you have. If all you have is a marketing website, some screenshots of the existing legacy system, and access to customer service chat logs, then use those.</p>
<p>As you peruse these sources, watch for the nouns that are used over and over again, and start listing them (preferably on blue sticky notes if you’ll be creating an object map later!).</p>
<p>You’ll want to focus on nouns that <em>might</em> represent objects in your system. If you are having trouble determining if a noun might be object-worthy, remember the acronym SIP and test for:</p>
<ol><li>Structure</li>
<li>Instances</li>
<li>Purpose</li>
</ol><p>Think of a library app, for example. Is “book” an object?</p>
<p>Structure: can you think of a few attributes for this potential object? <em>Title, author, publish date…</em> Yep, it has structure. Check!</p>
<p>Instance: what are some examples of this potential “book” object? Can you name a few? <em>The Alchemist,</em> <em>Ready Player One</em>, <em>Everybody Poops</em>… OK, check!</p>
<p>Purpose: why is this object important to the users and business? <em>Well, “book” is what our library client is providing to people and books are why people come to the library</em>… Check, check, check!</p>
<figure id="figure4" class="wp-block-image size-large"><img width="960" height="635" src="https://alistapart.com/wp-content/uploads/2021/10/selling-ux-image4-1.jpg?resize=960%2C635" alt="" class="wp-image-7173152" data-recalc-dims="1" /><figcaption><em>SIP: Structure, Instances, and Purpose! (Here’s a</em> <a href="https://whimsical.com/is-it-a-object-in-the-ooux-world-PubTHzL4Hs1Kr6Xs6b8y2J"><em>flowchart</em></a> <em>where I elaborate even more on SIP.)</em></figcaption></figure><p>As you are noun foraging, focus on capturing the nouns that have SIP. Avoid capturing <em>components</em> like dropdowns, checkboxes, and calendar pickers—<a href="https://alistapart.com/article/a-content-model-is-not-a-design-system/">your UX system is not your design system</a>! Components are just the packaging for objects—they are a means to an end. No one is coming to your digital place to play with your dropdown! They are coming for the VALUABLE THINGS and what they can do with them. Those things, or objects, are what we are trying to identify.</p>
<p>Let’s say we work for a startup disrupting the email experience. This is how I’d start my noun foraging.</p>
<p>First I’d look at my own email client, which happens to be Gmail. I’d then look at Outlook and the new HEY email. I’d look at Yahoo, Hotmail…I’d even look at Slack and Basecamp and other so-called “email replacers.” I’d read some articles, reviews, and forum threads where people are complaining about email. While doing all this, I would look for and write down the nouns.</p>
<p>(Before moving on, feel free to go noun foraging for this hypothetical product, too, and then scroll down to see how much our lists match up. Just don’t get lost in your own emails! Come back to me!)</p>
<p>Drumroll, please…</p>
<p>Here are a few nouns I came up with during my noun foraging:</p>
<ul><li>email message</li>
<li>thread</li>
<li>contact</li>
<li>client</li>
<li>rule/automation</li>
<li>email address that is not a contact?</li>
<li>contact groups</li>
<li>attachment</li>
<li>Google doc file / other integrated file</li>
<li>newsletter? (HEY treats this differently)</li>
<li>saved responses and templates</li>
</ul><figure id="figure5" class="wp-block-image size-large"><img width="960" height="640" src="https://alistapart.com/wp-content/uploads/2021/10/selling-ux-image5-1.jpg?resize=960%2C640" alt="" class="wp-image-7173153" data-recalc-dims="1" /><figcaption><em>In the OOUX world, we love color-coding. Blue is reserved for objects! (Yellow is for core content, pink is for metadata, and green is for calls-to-action. Learn more about the</em> <a href="https://alistapart.com/article/object-oriented-ux/"><em>color coded object map</em></a> <em>and</em> <a href="https://alistapart.com/article/ooux-a-foundation-for-interaction-design/"><em>connecting CTAs to objects</em></a><em>.)</em></figcaption></figure><p>Scan your list of nouns and pick out words that you are completely clueless about. In our email example, it might be <em>client</em> or <em>automation</em>. Do as much homework as you can before your session with stakeholders: google what’s googleable. But other terms might be so specific to the product or domain that you need to have a conversation about them.</p>
<p><em>Aside: here are some real nouns foraged during my own past project work that I needed my stakeholders to help me understand:</em></p>
<ul><li><em>Record Locator</em></li>
<li><em>Incentive Home</em></li>
<li><em>Augmented Line Item</em></li>
<li><em>Curriculum-Based Measurement Probe</em></li>
</ul><p>This is really all you need to prepare for the workshop session: a list of nouns that represent potential objects and a short list of nouns that need to be defined further.</p>
<h2 id="section6">Facilitate an Object Definition Workshop</h2>
<p>You could actually start your workshop with noun foraging—this activity <em>can</em> be done collaboratively. If you have five people in the room, pick five sources, assign one to every person, and give everyone ten minutes to find the objects within their source. When the time’s up, come together and find the overlap. Affinity mapping is your friend here!</p>
<p>If your team is short on time and might be reluctant to do this kind of grunt work (which is usually the case) do your own noun foraging beforehand, but be prepared to show your work. I love presenting screenshots of documents and screens with all the nouns already highlighted. Bring the artifacts of your process, and start the workshop with a five-minute overview of your noun foraging journey.</p>
<p>HOT TIP: before jumping into the workshop, frame the conversation as a requirements-gathering session to help <em>you</em> better understand the scope and details of the system. You don’t need to let them know that you’re looking for gaps in the team’s understanding so that you can prove the need for more user research—that will be our little secret. Instead, go into the session optimistically, as if your knowledgeable stakeholders and PMs and biz folks already have all the answers. </p>
<p>Then, let the question whack-a-mole commence.</p>
<h3 id="section7">1. What is this thing?</h3>
<p>Want to have some <em>real</em> fun? At the beginning of your session, ask stakeholders to privately write definitions for the handful of obscure nouns you might be uncertain about. Then, have everyone show their cards at the same time and see if you get different definitions (you will). This is <em>gold</em> for exposing misalignment and starting great conversations.</p>
<p>As your discussion unfolds, capture any agreed-upon definitions. And when uncertainty emerges, quietly (but visibly) start an “open questions” parking lot. ?</p>
<p>After definitions solidify, here’s a great follow-up:</p>
<h3 id="section8">2. Do our users know what these things are? What do users call this thing?</h3>
<p class="c1">Stakeholder 1: They probably call email clients “apps.” But I’m not sure.</p>
<p>Stakeholder 2: Automations are often called “workflows,” I think. Or, maybe users think workflows are something different.</p>
<p>If a more user-friendly term emerges, ask the group if they can agree to use only that term moving forward. This way, the team can better align to the users’ language and mindset.</p>
<p>OK, moving on. </p>
<p>If you have two or more objects that seem to overlap in purpose, ask one of these questions:</p>
<h3 id="section9">3. Are these the same thing? Or are these different? If they are not the same, how are they different?</h3>
<p class="c1">You: Is a saved response the same as a template?</p>
<p class="c1">Stakeholder 1: Yes! Definitely.</p>
<p>Stakeholder 2: I don’t think so… A saved response is text with links and variables, but a template is more about the look and feel, like default fonts, colors, and placeholder images. </p>
<p>Continue to build out your growing glossary of objects. And continue to capture areas of uncertainty in your “open questions” parking lot.</p>
<p>If you successfully determine that two similar things are, in fact, different, here’s your next follow-up question:</p>
<h3 id="section10">4. What’s the relationship between these objects?</h3>
<p class="c1">You: Are saved responses and templates related in any way?</p>
<p class="c1">Stakeholder 3:  Yeah, a template can be applied to a saved response.</p>
<p>You, always with the follow-ups: When is the template applied to a saved response? Does that happen when the user is constructing the saved response? Or when they apply the saved response to an email? How does that actually work?</p>
<p>Listen. Capture uncertainty. Once the list of “open questions” grows to a critical mass, pause to start assigning questions to groups or individuals. Some questions might be for the dev team (hopefully at least one developer is in the room with you). One question might be specifically for someone who couldn’t make it to the workshop. And many questions will need to be labeled “user.” </p>
<p>Do you see how we are building up to our UXR sales pitch?</p>
<h3 id="section11"><strong>5. Is this object in scope?</strong></h3>
<p>Your next question narrows the team’s focus toward what’s most important to your users. You can simply ask, “Are saved responses in scope for our first release?,” but I’ve got a better, more devious strategy.</p>
<p>By now, you should have a list of clearly defined objects. Ask participants to sort these objects from most to least important, either in small breakout groups or individually. Then, like you did with the definitions, have everyone reveal their sort order at once. Surprisingly—or not so surprisingly—it’s not unusual for the VP to rank something like “saved responses” as #2 while everyone else puts it at the bottom of the list. Try not to look too smug as you inevitably expose more misalignment.</p>
<p>I did this for a startup a few years ago. We posted the three groups’ wildly different sort orders on the whiteboard.</p>
<figure id="figure6" class="wp-block-image size-large"><img width="960" height="779" src="https://alistapart.com/wp-content/uploads/2021/10/selling-ux-image6-1.jpg?resize=960%2C779" alt="" class="wp-image-7173154" data-recalc-dims="1" /><figcaption><em>Here’s a snippet of the very messy middle from this session: three columns of object cards, showing the same cards prioritized completely differently by three different groups.</em></figcaption></figure><p>The CEO stood back, looked at it, and said, “This is why we haven’t been able to move forward in two years.”</p>
<p>Admittedly, it’s tragic to hear that, but as a professional, it feels pretty awesome to be the one who facilitated a watershed realization.</p>
<p>Once you have a good idea of in-scope, clearly defined things, this is when you move on to doing more relationship mapping.</p>
<h3 id="section12">6. Create a visual representation of the objects’ relationships</h3>
<p>We’ve already done a bit of this while trying to determine if two things are different, but this time, ask the team about <em>every</em> potential relationship. For each object, ask how it relates to all the other objects. In what ways are the objects connected? To visualize all the connections, pull out your trusty boxes-and-arrows technique. Here, we are connecting our objects with verbs. I like to keep my verbs to simple “has a” and “has many” statements.</p>
<figure id="figure7" class="wp-block-image size-large"><img width="960" height="656" src="https://alistapart.com/wp-content/uploads/2021/10/selling-ux-image7-1.jpg?resize=960%2C656" alt="" class="wp-image-7173155" data-recalc-dims="1" /><figcaption><em>A work-in-progress system model of our new email solution.</em></figcaption></figure><p>This system modeling activity brings up all sorts of new questions:</p>
<ul><li>Can a saved response have attachments?</li>
<li>Can a saved response use a template? If so, if an email uses a saved response with a template, can the user override that template?</li>
<li>Do users want to see all the emails they sent that included a particular attachment? For example, “show me all the emails I sent with <strong>ProfessionalImage.jpg</strong> attached. I’ve changed my professional photo and I want to alert everyone to update it.” </li>
</ul><p>Solid answers might emerge directly from the workshop participants. Great! Capture that new shared understanding. But when uncertainty surfaces, continue to add questions to your growing parking lot.</p>
<h2 id="section13">Light the fuse</h2>
<p>You’ve positioned the explosives all along the floodgates. Now you simply have to light the fuse and BOOM. Watch the buy-in for user research flooooow.</p>
<p>Before your workshop wraps up, have the group reflect on the list of open questions. Make plans for getting answers internally, then focus on the questions that need to be brought before users.</p>
<p>Here’s your final step. Take those questions you’ve compiled for user research and discuss the level of risk associated with NOT answering them. Ask, “if we design without an answer to this question, if we make up our own answer and we are wrong, how bad might that turn out?” </p>
<p>With this methodology, we are cornering our decision-makers into advocating for user research as they themselves label questions as high-risk. Sorry, not sorry. </p>
<p><em>Now</em> is your moment of truth. With everyone in the room, ask for a reasonable budget of time and money to conduct 6–8 user interviews focused <em>specifically</em> on these questions. </p>
<p>HOT TIP: if you are new to UX research, please note that you’ll likely need to rephrase the questions that came up during the workshop before you present them to users. Make sure your questions are open-ended and don’t lead the user into any default answers.</p>
<h2 id="section14">Final words: Hold the screen design!</h2>
<p>Seriously, if at all possible, do not ever design screens again without first answering these fundamental questions: what are the objects and how do they relate?</p>
<p>I promise you this: if you can secure a shared understanding between the business, design, and development teams <em>before</em> you start designing screens, you will have less heartache and save more time and money, and (it almost feels like a bonus at this point!) users will be more receptive to what you put out into the world. </p>
<p>I sincerely hope this helps you win time and budget to go talk to your users and gain clarity on what you are designing before you start building screens. If you find success using noun foraging and the Object Definition Workshop, there’s more where that came from in the rest of the ORCA process, which will help prevent even more late-in-the-game scope tugs-of-war and strategy pivots. </p>
<p>All the best of luck! Now go sell research!</p>]]></description>
      <link>https://alistapart.com/article/how-to-sell-ux-research/</link>
      <guid>https://alistapart.com/article/how-to-sell-ux-research/</guid>
      <pubDate>Thu, 21 Oct 2021 16:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[A Content Model Is Not a Design System]]></title>
      <description><![CDATA[<p>Do you remember when having a great website was enough? Now, people are getting answers from Siri, Google search snippets, and mobile apps, not just our websites. Forward-thinking organizations have adopted an <em>omnichannel content strategy</em>, whose mission is to reach audiences across multiple digital channels and platforms.</p>


<p>But how do you set up a content management system (CMS) to reach your audience now and in the future? I learned the hard way that creating a <a href="https://alistapart.com/article/content-modelling-a-master-skill/"><em>content model</em></a>—a definition of content types, attributes, and relationships that let people and systems understand content—with my more familiar design-system thinking would capsize my customer’s omnichannel content strategy. You can avoid that outcome by creating content models that are semantic and that also connect related content. </p>
<p>I recently had the opportunity to lead the CMS implementation for a Fortune 500 company. The client was excited by the benefits of an omnichannel content strategy, including content reuse, multichannel <a href="https://bluemodus.com/articles/a-content-first-approach-in-a-multi-channel-world">marketing</a>, and <a href="https://alistapart.com/article/conversations-with-robots/">robot delivery</a>—designing content to be intelligible to bots, Google knowledge panels, snippets, and voice user interfaces. </p>
<p>A content model is a critical foundation for an omnichannel content strategy, and for our content to be understood by multiple systems, the model needed <em>semantic</em> types—types named according to their meaning instead of their presentation. Our goal was to let authors create content and reuse it wherever it was relevant. But as the project proceeded, I realized that supporting content reuse at the scale that my customer needed required the whole team to recognize a new pattern.</p>
<p>Despite our best intentions, we kept drawing from what we were more familiar with: <a href="https://alistapart.com/article/learning-from-lego-a-step-forward-in-modular-web-design/">design systems</a>. Unlike web-focused content strategies, an omnichannel content strategy can’t rely on WYSIWYG tools for design and layout. Our tendency to approach the content model with our familiar design-system thinking constantly led us to veer away from one of the primary purposes of a content model: delivering content to audiences on multiple marketing channels.</p>
<h2 id="section2">Two essential principles for an effective content model</h2>
<p>We needed to help our designers, developers, and stakeholders understand that we were doing something very different from their prior web projects, where it was natural for everyone to think about content as visual building blocks fitting into layouts. The previous approach was not only more familiar but also more intuitive—at least at first—because it made the designs feel more tangible. We discovered two principles that helped the team understand how a content model differs from the design systems that we were used to:</p>
<ol><li>Content models must define semantics instead of layout.</li>
<li>And content models should connect content that belongs together.</li>
</ol><h3 id="section3">Semantic content models</h3>
<p>A <em>semantic content model</em> uses type and attribute names that reflect the meaning of the content, not how it will be displayed. For example, in a nonsemantic model, teams might create types like <em>teasers</em>, <em>media blocks</em>, and <em>cards</em>. Although these types might make it easy to lay out content, they don’t help delivery channels understand the content’s meaning, which in turn would have opened the door to the content being presented in each marketing channel. In contrast, a semantic content model uses type names like <em>product</em>, <em>service</em>, and <em>testimonial</em> so that each delivery channel can understand the content and use it as it sees fit. </p>
<p>When you’re creating a semantic content model, a great place to start is to look over the types and properties defined by <a href="https://schema.org/">Schema.org</a>, a community-driven resource for type definitions that are intelligible to platforms like Google search.</p>
<p>A semantic content model has several benefits:</p>
<ul><li>Even if your team doesn’t care about omnichannel content, a semantic content model <strong>decouples content from its presentation</strong> so that teams can evolve the website’s design without needing to refactor its content. In this way, content can withstand disruptive website redesigns. </li>
<li>A semantic content model also provides a competitive edge. By adding<a href="https://developers.google.com/search/docs/guides/intro-structured-data"><strong>structured data</strong></a> based on Schema.org’s types and properties, a website can provide hints to help Google understand the content, display it in search snippets or knowledge panels, and use it to answer voice-interface user questions. Potential visitors could discover your content without ever setting foot in your website.</li>
<li>Beyond those practical benefits, you’ll also need a semantic content model if you want to deliver omnichannel content. To use the same content in multiple marketing channels, <strong>delivery channels need to be able to understand it</strong>. For example, if your content model were to provide a list of questions and answers, it could easily be rendered on a frequently asked questions (FAQ) page, but it could also be used in a <a href="https://alistapart.com/article/usability-testing-for-voice-content/">voice interface</a> or by a bot that answers <a href="https://alistapart.com/article/the-faq-as-advice-column/">common questions</a>.</li>
</ul><p>For example, using a semantic content model for articles, events, people, and locations lets <em>A List Apart</em> provide cleanly structured data for search engines so that users can read the content on the website, in Google knowledge panels, and even with hypothetical voice interfaces in the future.</p>
<figure id="figure1" class="wp-block-image size-large"><img width="960" height="756" src="https://alistapart.com/wp-content/uploads/2021/09/image2.png?w=960&amp;resize=960%2C756" alt="Image showing an event in a CMS passing data to a Google knowledge panel, a website, and a voice interface" class="wp-image-7173120" data-recalc-dims="1" /></figure><h3 id="section4">Content models that connect</h3>
<p>After struggling to describe what makes a good content model, I’ve come to realize that the best models are those that are semantic and that also connect related content components (such as a FAQ item’s question and answer pair), instead of slicing up related content across disparate content components. A good content model connects content that should remain together so that multiple delivery channels can use it without needing to first put those pieces back together.</p>
<p>Think about writing an article or essay. An article’s meaning and usefulness depends upon its parts being kept together. Would one of the headings or paragraphs be meaningful on their own without the context of the full article? On our project, our familiar design-system thinking often led us to want to create content models that would slice content into disparate chunks to fit the web-centric layout. This had a similar impact to an article that were to have been separated from its headline. Because we were slicing content into standalone pieces based on layout, content that belonged together became difficult to manage and nearly impossible for multiple delivery channels to understand.</p>
<p>To illustrate, let’s look at how connecting related content applies in a real-world scenario. The design team for our customer presented a complex layout for a software product page that included multiple tabs and sections. Our instincts were to follow suit with the content model. Shouldn’t we make it as easy and as flexible as possible to add any number of tabs in the future?</p>
<p>Because our design-system instincts were so familiar, it felt like we had needed a content type called “tab section” so that multiple tab sections could be added to a page. Each tab section would display various types of content. One tab might provide the software’s overview or its specifications. Another tab might provide a list of resources. </p>
<p>Our inclination to break down the content model into “tab section” pieces would have led to an unnecessarily complex model and a cumbersome editing experience, and it would have also created content that couldn’t have been understood by additional delivery channels. For example, how would another system have been able to tell which “tab section” referred to a product’s specifications or its resource list—would that other system have to have resorted to counting tab sections and content blocks? This would have prevented the tabs from ever being reordered, and it would have required adding logic in every other delivery channel to interpret the design system’s layout. Furthermore, if the customer were to have no longer wanted to display this content in a tab layout, it would have been tedious to migrate to a new content model to reflect the new page redesign.</p>
<figure id="figure2" class="wp-block-image size-large"><img width="723" height="345" src="https://alistapart.com/wp-content/uploads/2021/09/image3.png?w=723&amp;resize=723%2C345" alt="Illustration showing a data tree flowing into a list of cards (data), flowing into a navigation menu on a website" class="wp-image-7173121" data-recalc-dims="1" /><figcaption>A content model based on design components is unnecessarily complex, and it’s unintelligible to systems.</figcaption></figure><p>We had a breakthrough when we discovered that our customer had a specific purpose in mind for each tab: it would reveal specific information such as the software product’s overview, specifications, related resources, and pricing. Once implementation began, our inclination to focus on what’s visual and familiar had obscured the intent of the designs. With a little digging, it didn’t take long to realize that the concept of tabs wasn’t relevant to the content model. The meaning of the content that they were planning to display in the tabs was what mattered.</p>
<p>In fact, the customer could have decided to display this content in a different way—without tabs—somewhere else. This realization prompted us to define content types for the software product based on the meaningful attributes that the customer had wanted to render on the web. There were obvious semantic attributes like <em>name</em> and <em>description</em> as well as rich attributes like <em>screenshots</em>, <em>software requirements</em>, and <em>feature lists</em>. The software’s product information stayed together because it wasn’t sliced across separate components like “tab sections” that were derived from the content’s presentation. Any delivery channel—including future ones—could understand and present this content.</p>
<figure id="figure3" class="wp-block-image size-large"><img width="695" height="359" src="https://alistapart.com/wp-content/uploads/2021/09/image1.png?w=695&amp;resize=695%2C359" alt="Illustration showing a data tree flowing into a formatted list, flowing into a navigation menu on a website" class="wp-image-7173119" data-recalc-dims="1" /><figcaption><em>A good content model connects content that belongs together so it can be easily managed and reused.</em></figcaption></figure><h2 id="section5">Conclusion</h2>
<p>In this omnichannel marketing project, we discovered that the best way to keep our content model on track was to ensure that it was <em>semantic</em> (with type and attribute names that reflected the meaning of the content) and that it <em>kept content together that belonged together</em> (instead of fragmenting it). These two concepts curtailed our temptation to shape the content model based on the design. So if you’re working on a content model to support an omnichannel content strategy—or even if you just want to make sure that Google and other interfaces understand your content—remember:</p>
<ul><li>A design system isn’t a content model. Team members may be tempted to conflate them and to make your content model mirror your design system, so you should protect the semantic value and contextual structure of the content strategy during the entire implementation process. This will let every delivery channel consume the content without needing a magic decoder ring.</li>
<li>If your team is struggling to make this transition, you can still reap some of the benefits by using Schema.org–based structured data in your website. Even if additional delivery channels aren’t on the immediate horizon, the benefit to search engine optimization is a compelling reason on its own.</li>
<li>Additionally, remind the team that decoupling the content model from the design will let them update the designs more easily because they won’t be held back by the cost of content migrations. They’ll be able to create new designs without the obstacle of compatibility between the design and the content, and ​they’ll be ready for the next big thing. </li>
</ul><p>By rigorously advocating for these principles, you’ll help your team treat content the way that it deserves—as the most critical asset in your user experience and the best way to connect with your audience.</p>]]></description>
      <link>https://alistapart.com/article/a-content-model-is-not-a-design-system/</link>
      <guid>https://alistapart.com/article/a-content-model-is-not-a-design-system/</guid>
      <pubDate>Thu, 23 Sep 2021 16:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[A Content Model Is Not a Design System]]></title>
      <description><![CDATA[<p>Do you remember when having a great website was enough? Now, people are getting answers from Siri, Google search snippets, and mobile apps, not just our websites. Forward-thinking organizations have adopted an <em>omnichannel content strategy</em>, whose mission is to reach audiences across multiple digital channels and platforms.</p><div class="aside-breaker">Article Continues Below</div>
<p>But how do you set up a content management system (CMS) to reach your audience now and in the future? I learned the hard way that creating a <a href="https://alistapart-production.mystagingwebsite.com/article/content-modelling-a-master-skill/"><em>content model</em></a>—a definition of content types, attributes, and relationships that let people and systems understand content—with my more familiar design-system thinking would capsize my customer’s omnichannel content strategy. You can avoid that outcome by creating content models that are semantic and that also connect related content. </p>
<p>I recently had the opportunity to lead the CMS implementation for a Fortune 500 company. The client was excited by the benefits of an omnichannel content strategy, including content reuse, multichannel <a href="https://bluemodus.com/articles/a-content-first-approach-in-a-multi-channel-world">marketing</a>, and <a href="https://alistapart-production.mystagingwebsite.com/article/conversations-with-robots/">robot delivery</a>—designing content to be intelligible to bots, Google knowledge panels, snippets, and voice user interfaces. </p>
<p>A content model is a critical foundation for an omnichannel content strategy, and for our content to be understood by multiple systems, the model needed <em>semantic</em> types—types named according to their meaning instead of their presentation. Our goal was to let authors create content and reuse it wherever it was relevant. But as the project proceeded, I realized that supporting content reuse at the scale that my customer needed required the whole team to recognize a new pattern.</p>
<p>Despite our best intentions, we kept drawing from what we were more familiar with: <a href="https://alistapart-production.mystagingwebsite.com/article/learning-from-lego-a-step-forward-in-modular-web-design/">design systems</a>. Unlike web-focused content strategies, an omnichannel content strategy can’t rely on WYSIWYG tools for design and layout. Our tendency to approach the content model with our familiar design-system thinking constantly led us to veer away from one of the primary purposes of a content model: delivering content to audiences on multiple marketing channels.</p>
<h2>Two essential principles for an effective content model<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/a-content-model-is-not-a-design-system#section2">#section2</a></h2>
<p>We needed to help our designers, developers, and stakeholders understand that we were doing something very different from their prior web projects, where it was natural for everyone to think about content as visual building blocks fitting into layouts. The previous approach was not only more familiar but also more intuitive—at least at first—because it made the designs feel more tangible. We discovered two principles that helped the team understand how a content model differs from the design systems that we were used to:</p>
<ol><li>Content models must define semantics instead of layout.</li>
<li>And content models should connect content that belongs together.</li>
</ol><h3>Semantic content models<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/a-content-model-is-not-a-design-system#section3">#section3</a></h3>
<p>A <em>semantic content model</em> uses type and attribute names that reflect the meaning of the content, not how it will be displayed. For example, in a nonsemantic model, teams might create types like <em>teasers</em>, <em>media blocks</em>, and <em>cards</em>. Although these types might make it easy to lay out content, they don’t help delivery channels understand the content’s meaning, which in turn would have opened the door to the content being presented in each marketing channel. In contrast, a semantic content model uses type names like <em>product</em>, <em>service</em>, and <em>testimonial</em> so that each delivery channel can understand the content and use it as it sees fit. </p>
<p>When you’re creating a semantic content model, a great place to start is to look over the types and properties defined by <a href="https://schema.org/">Schema.org</a>, a community-driven resource for type definitions that are intelligible to platforms like Google search.</p>
<p>A semantic content model has several benefits:</p>
<ul><li>Even if your team doesn’t care about omnichannel content, a semantic content model <strong>decouples content from its presentation</strong> so that teams can evolve the website’s design without needing to refactor its content. In this way, content can withstand disruptive website redesigns. </li>
<li>A semantic content model also provides a competitive edge. By adding<a href="https://developers.google.com/search/docs/guides/intro-structured-data"><strong>structured data</strong></a> based on Schema.org’s types and properties, a website can provide hints to help Google understand the content, display it in search snippets or knowledge panels, and use it to answer voice-interface user questions. Potential visitors could discover your content without ever setting foot in your website.</li>
<li>Beyond those practical benefits, you’ll also need a semantic content model if you want to deliver omnichannel content. To use the same content in multiple marketing channels, <strong>delivery channels need to be able to understand it</strong>. For example, if your content model were to provide a list of questions and answers, it could easily be rendered on a frequently asked questions (FAQ) page, but it could also be used in a <a href="https://alistapart-production.mystagingwebsite.com/article/usability-testing-for-voice-content/">voice interface</a> or by a bot that answers <a href="https://alistapart-production.mystagingwebsite.com/article/the-faq-as-advice-column/">common questions</a>.</li>
</ul><p>For example, using a semantic content model for articles, events, people, and locations lets <em>A List Apart</em> provide cleanly structured data for search engines so that users can read the content on the website, in Google knowledge panels, and even with hypothetical voice interfaces in the future.</p>
<figure class="wp-block-image size-large"><img width="1999" height="1575" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/09/image2.png?w=960" alt="Image showing an event in a CMS passing data to a Google knowledge panel, a website, and a voice interface" class="wp-image-7173120" /></figure><h3 id="section4">Content models that connect<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/a-content-model-is-not-a-design-system#section4">#section4</a></h3>
<p>After struggling to describe what makes a good content model, I’ve come to realize that the best models are those that are semantic and that also connect related content components (such as a FAQ item’s question and answer pair), instead of slicing up related content across disparate content components. A good content model connects content that should remain together so that multiple delivery channels can use it without needing to first put those pieces back together.</p>
<p>Think about writing an article or essay. An article’s meaning and usefulness depends upon its parts being kept together. Would one of the headings or paragraphs be meaningful on their own without the context of the full article? On our project, our familiar design-system thinking often led us to want to create content models that would slice content into disparate chunks to fit the web-centric layout. This had a similar impact to an article that were to have been separated from its headline. Because we were slicing content into standalone pieces based on layout, content that belonged together became difficult to manage and nearly impossible for multiple delivery channels to understand.</p>
<p>To illustrate, let’s look at how connecting related content applies in a real-world scenario. The design team for our customer presented a complex layout for a software product page that included multiple tabs and sections. Our instincts were to follow suit with the content model. Shouldn’t we make it as easy and as flexible as possible to add any number of tabs in the future?</p>
<p>Because our design-system instincts were so familiar, it felt like we had needed a content type called “tab section” so that multiple tab sections could be added to a page. Each tab section would display various types of content. One tab might provide the software’s overview or its specifications. Another tab might provide a list of resources. </p>
<p>Our inclination to break down the content model into “tab section” pieces would have led to an unnecessarily complex model and a cumbersome editing experience, and it would have also created content that couldn’t have been understood by additional delivery channels. For example, how would another system have been able to tell which “tab section” referred to a product’s specifications or its resource list—would that other system have to have resorted to counting tab sections and content blocks? This would have prevented the tabs from ever being reordered, and it would have required adding logic in every other delivery channel to interpret the design system’s layout. Furthermore, if the customer were to have no longer wanted to display this content in a tab layout, it would have been tedious to migrate to a new content model to reflect the new page redesign.</p>
<figure class="wp-block-image size-large"><img width="723" height="345" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/09/image3.png?w=723" alt="Illustration showing a data tree flowing into a list of cards (data), flowing into a navigation menu on a website" class="wp-image-7173121" /><figcaption>A content model based on design components is unnecessarily complex, and it’s unintelligible to systems.</figcaption></figure><p>We had a breakthrough when we discovered that our customer had a specific purpose in mind for each tab: it would reveal specific information such as the software product’s overview, specifications, related resources, and pricing. Once implementation began, our inclination to focus on what’s visual and familiar had obscured the intent of the designs. With a little digging, it didn’t take long to realize that the concept of tabs wasn’t relevant to the content model. The meaning of the content that they were planning to display in the tabs was what mattered.</p>
<p>In fact, the customer could have decided to display this content in a different way—without tabs—somewhere else. This realization prompted us to define content types for the software product based on the meaningful attributes that the customer had wanted to render on the web. There were obvious semantic attributes like <em>name</em> and <em>description</em> as well as rich attributes like <em>screenshots</em>, <em>software requirements</em>, and <em>feature lists</em>. The software’s product information stayed together because it wasn’t sliced across separate components like “tab sections” that were derived from the content’s presentation. Any delivery channel—including future ones—could understand and present this content.</p>
<figure class="wp-block-image size-large"><img width="695" height="359" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/09/image1.png?w=695" alt="Illustration showing a data tree flowing into a formatted list, flowing into a navigation menu on a website" class="wp-image-7173119" /><figcaption><em>A good content model connects content that belongs together so it can be easily managed and reused.</em></figcaption></figure>
<p>In this omnichannel marketing project, we discovered that the best way to keep our content model on track was to ensure that it was <em>semantic</em> (with type and attribute names that reflected the meaning of the content) and that it <em>kept content together that belonged together</em> (instead of fragmenting it). These two concepts curtailed our temptation to shape the content model based on the design. So if you’re working on a content model to support an omnichannel content strategy—or even if you just want to make sure that Google and other interfaces understand your content—remember:</p>
<ul><li>A design system isn’t a content model. Team members may be tempted to conflate them and to make your content model mirror your design system, so you should protect the semantic value and contextual structure of the content strategy during the entire implementation process. This will let every delivery channel consume the content without needing a magic decoder ring.</li>
<li>If your team is struggling to make this transition, you can still reap some of the benefits by using Schema.org–based structured data in your website. Even if additional delivery channels aren’t on the immediate horizon, the benefit to search engine optimization is a compelling reason on its own.</li>
<li>Additionally, remind the team that decoupling the content model from the design will let them update the designs more easily because they won’t be held back by the cost of content migrations. They’ll be able to create new designs without the obstacle of compatibility between the design and the content, and ​they’ll be ready for the next big thing. </li>
</ul><p>By rigorously advocating for these principles, you’ll help your team treat content the way that it deserves—as the most critical asset in your user experience and the best way to connect with your audience.</p>]]></description>
      <link>https://alistapart-production.mystagingwebsite.com/article/a-content-model-is-not-a-design-system/</link>
      <guid>https://alistapart-production.mystagingwebsite.com/article/a-content-model-is-not-a-design-system/</guid>
      <pubDate>Thu, 23 Sep 2021 16:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Design for Safety, An Excerpt]]></title>
      <description><![CDATA[<p>Antiracist economist Kim Crayton says that “intention without strategy is chaos.” We’ve discussed how our biases, assumptions, and inattention toward marginalized and vulnerable groups lead to dangerous and unethical tech—but what, <em>specifically</em>, do we need to do to fix it? The intention to make our tech safer is not enough; we need a strategy.</p><div class="aside-breaker">Article Continues Below</div>
<p>This chapter will equip you with that plan of action. It covers how to integrate safety principles into your design work in order to create tech that’s safe, how to convince your stakeholders that this work is necessary, and how to respond to the critique that what we <em>actually</em> need is more diversity. (Spoiler: we do, but diversity alone is not the antidote to fixing unethical, unsafe tech.)</p>
<p>When you are designing for safety, your goals are to:</p>
<ul><li>identify ways your product can be used for abuse,</li>
<li>design ways to prevent the abuse, and</li>
<li>provide support for vulnerable users to reclaim power and control.</li>
</ul><p>The Process for Inclusive Safety is a tool to help you reach those goals (<strong>Fig 5.1</strong>). It’s a methodology I created in 2018 to capture the various techniques I was using when designing products with safety in mind. Whether you are creating an entirely new product or adding to an existing feature, the Process can help you make your product safe and inclusive. The Process includes five general areas of action:</p>
<ul><li>Conducting research</li>
<li>Creating archetypes</li>
<li>Brainstorming problems</li>
<li>Designing solutions</li>
<li>Testing for safety</li>
</ul><figure class="wp-block-image size-full"><img width="627" height="189" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/08/dfs-fig-5-1.jpg" alt="" class="wp-image-7173096" /><figcaption><strong>Fig 5.1</strong>: Each aspect of the Process for Inclusive Safety can be incorporated into your design process where it makes the most sense for you. The times given are estimates to help you incorporate the stages into your design plan.</figcaption></figure><p>The Process is meant to be flexible—it won’t make sense for teams to implement every step in some situations. Use the parts that are relevant to your unique work and context; this is meant to be something you can insert into your existing design practice.</p>
<p>And once you use it, if you have an idea for making it better or simply want to provide context of how it helped your team, please get in touch with me. It’s a living document that I hope will continue to be a useful and realistic tool that technologists can use in their day-to-day work.</p>
<p>If you’re working on a product specifically for a vulnerable group or survivors of some form of trauma, such as an app for survivors of domestic violence, sexual assault, or drug addiction, be sure to read Chapter 7, which covers that situation explicitly and should be handled a bit differently. The guidelines here are for prioritizing safety when designing a more general product that will have a wide user base (which, we already know from statistics, will include certain groups that should be protected from harm). Chapter 7 is focused on products that are <em>specifically for</em> vulnerable groups and people who have experienced trauma.</p>
<h3>Step 1: Conduct research<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/design-for-safety-excerpt#section3">#section3</a></h3>
<p>Design research should include a broad analysis of how your tech might be weaponized for abuse as well as specific insights into the experiences of survivors and perpetrators of that type of abuse. At this stage, you and your team will investigate issues of interpersonal harm and abuse, and explore any other safety, security, or inclusivity issues that might be a concern for your product or service, like data security, racist algorithms, and harassment.</p>
<h4>Broad research<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/design-for-safety-excerpt#section4">#section4</a></h4>
<p>Your project should begin with broad, general research into similar products and issues around safety and ethical concerns that have already been reported. For example, a team building a smart home device would do well to understand the multitude of ways that existing smart home devices have been used as tools of abuse. If your product will involve AI, seek to understand the potentials for racism and other issues that have been reported in existing AI products. Nearly all types of technology have some kind of potential or actual harm that’s been reported on in the news or written about by academics. <a href="https://scholar.google.com">Google Scholar</a> is a useful tool for finding these studies.</p>
<h4>Specific research: Survivors<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/design-for-safety-excerpt#section5">#section5</a></h4>
<p>When possible and appropriate, include direct research (surveys and interviews) with people who are experts in the forms of harm you have uncovered. Ideally, you’ll want to interview advocates working in the space of your research first so that you have a more solid understanding of the topic and are better equipped to not retraumatize survivors. If you’ve uncovered possible domestic violence issues, for example, the experts you’ll want to speak with are survivors themselves, as well as workers at domestic violence hotlines, shelters, other related nonprofits, and lawyers.</p>
<p>Especially when interviewing survivors of any kind of trauma, it is important to pay people for their knowledge and lived experiences. Don’t ask survivors to share their trauma for free, as this is exploitative. While some survivors may not want to be paid, you should always make the offer in the initial ask. An alternative to payment is to donate to an organization working against the type of violence that the interviewee experienced. We’ll talk more about how to appropriately interview survivors in Chapter 6.</p>
<h4>Specific research: Abusers<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/design-for-safety-excerpt#section6">#section6</a></h4>
<p>It’s unlikely that teams aiming to design for safety will be able to interview self-proclaimed abusers or people who have broken laws around things like hacking. Don’t make this a goal; rather, try to get at this angle in your general research. Aim to understand how abusers or bad actors weaponize technology to use against others, how they cover their tracks, and how they explain or rationalize the abuse.</p>
<h3>Step 2: Create archetypes<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/design-for-safety-excerpt#section7">#section7</a></h3>
<p>Once you’ve finished conducting your research, use your insights to create abuser and survivor archetypes. Archetypes are not personas, as they’re not based on real people that you interviewed and surveyed. Instead, they’re based on your research into likely safety issues, much like when we design for accessibility: we don’t need to have found a group of blind or low-vision users in our interview pool to create a design that’s inclusive of them. Instead, we base those designs on existing research into what this group needs. Personas typically represent real users and include many details, while archetypes are broader and can be more generalized.</p>
<p>The abuser archetype is someone who will look at the product as a tool to perform harm (<strong>Fig 5.2</strong>). They may be trying to harm someone they don’t know through surveillance or anonymous harassment, or they may be trying to control, monitor, abuse, or torment someone they know personally.</p>
<figure class="wp-block-image size-large"><img width="1510" height="1130" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/08/5.2-abuser-archetype-Harry-Oleson.jpg?resize=1024,766" alt="" class="wp-image-7173097" /><figcaption><strong>Fig 5.2:</strong> Harry Oleson, an abuser archetype for a fitness product, is looking for ways to stalk his ex-girlfriend through the fitness apps she uses.</figcaption></figure><p>The survivor archetype is someone who is being abused with the product. There are various situations to consider in terms of the archetype’s understanding of the abuse and how to put an end to it: Do they need proof of abuse they already suspect is happening, or are they unaware they’ve been targeted in the first place and need to be alerted (<strong>Fig 5.3</strong>)?</p>
<figure class="wp-block-image size-large"><img width="1510" height="1130" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/08/5.3-survivor-archetype-Lisa-Zwaan.jpg?resize=1024,766" alt="" class="wp-image-7173098" /><figcaption><strong>Fig 5.3</strong>: The survivor archetype Lisa Zwaan suspects her husband is weaponizing their home’s IoT devices against her, but in the face of his insistence that she simply doesn’t understand how to use the products, she’s unsure. She needs some kind of proof of the abuse.</figcaption></figure><p>You may want to make multiple survivor archetypes to capture a range of different experiences. They may know that the abuse is happening but not be able to stop it, like when an abuser locks them out of IoT devices; or they know it’s happening but don’t know how, such as when a stalker keeps figuring out their location (<strong>Fig 5.4</strong>). Include as many of these scenarios as you need to in your survivor archetype. You’ll use these later on when you design solutions to help your survivor archetypes achieve their goals of preventing and ending abuse.</p>
<figure class="wp-block-image size-large"><img width="1510" height="1130" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/08/5.4-survivor-archetype-Eric-Mitchell.jpg?resize=1024,766" alt="" class="wp-image-7173099" /><figcaption><strong>Fig 5.4</strong>: The survivor archetype Eric Mitchell knows he’s being stalked by his ex-boyfriend Rob but can’t figure out how Rob is learning his location information.</figcaption></figure><p>It may be useful for you to create persona-like artifacts for your archetypes, such as the three examples shown. Instead of focusing on the demographic information we often see in personas, focus on their goals. The goals of the abuser will be to carry out the specific abuse you’ve identified, while the goals of the survivor will be to prevent abuse, understand that abuse is happening, make ongoing abuse stop, or regain control over the technology that’s being used for abuse. Later, you’ll brainstorm how to prevent the abuser’s goals and assist the survivor’s goals.</p>
<p>And while the “abuser/survivor” model fits most cases, it doesn’t fit all, so modify it as you need to. For example, if you uncovered an issue with security, such as the ability for someone to hack into a home camera system and talk to children, the malicious hacker would get the abuser archetype and the child’s parents would get survivor archetype.</p>
<h3>Step 3: Brainstorm problems<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/design-for-safety-excerpt#section8">#section8</a></h3>
<p>After creating archetypes, brainstorm novel abuse cases and safety issues. “Novel” means things not found in your research; you’re trying to identify completely <em>new</em> safety issues that are unique to your product or service. The goal with this step is to exhaust every effort of identifying harms your product could cause. You aren’t worrying about how to prevent the harm yet—that comes in the next step.</p>
<p>How could your product be used for any kind of abuse, outside of what you’ve already identified in your research? I recommend setting aside at least a few hours with your team for this process.</p>
<p>If you’re looking for somewhere to start, try doing a Black Mirror brainstorm. This exercise is based on the show <em>Black Mirror</em>, which features stories about the dark possibilities of technology. Try to figure out how your product would be used in an episode of the show—the most wild, awful, out-of-control ways it could be used for harm. When I’ve led Black Mirror brainstorms, participants usually end up having a good deal of fun (which I think is great—it’s okay to have fun when designing for safety!). I recommend time-boxing a Black Mirror brainstorm to half an hour, and then dialing it back and using the rest of the time thinking of more realistic forms of harm.</p>
<p>After you’ve identified as many opportunities for abuse as possible, you may still not feel confident that you’ve uncovered every potential form of harm. A healthy amount of anxiety is normal when you’re doing this kind of work. It’s common for teams designing for safety to worry, “Have we really identified every possible harm? What if we’ve missed something?” If you’ve spent at least four hours coming up with ways your product could be used for harm and have run out of ideas, go to the next step.</p>
<p>It’s impossible to guarantee you’ve thought of everything; instead of aiming for 100 percent assurance, recognize that you’ve taken this time and have done the best you can, and commit to continuing to prioritize safety in the future. Once your product is released, your users may identify new issues that you missed; aim to receive that feedback graciously and course-correct quickly.</p>
<h3>Step 4: Design solutions<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/design-for-safety-excerpt#section9">#section9</a></h3>
<p>At this point, you should have a list of ways your product can be used for harm as well as survivor and abuser archetypes describing opposing user goals. The next step is to identify ways to design against the identified abuser’s goals and to support the survivor’s goals. This step is a good one to insert alongside existing parts of your design process where you’re proposing solutions for the various problems your research uncovered.</p>
<p>Some questions to ask yourself to help prevent harm and support your archetypes include:</p>
<ul><li>Can you design your product in such a way that the identified harm cannot happen in the first place? If not, what roadblocks can you put up to prevent the harm from happening?</li>
<li>How can you make the victim aware that abuse is happening through your product?</li>
<li>How can you help the victim understand what they need to do to make the problem stop?</li>
<li>Can you identify any types of user activity that would indicate some form of harm or abuse? Could your product help the user access support?</li>
</ul><p>In some products, it’s possible to proactively recognize that harm is happening. For example, a pregnancy app might be modified to allow the user to report that they were the victim of an assault, which could trigger an offer to receive resources for local and national organizations. This sort of proactiveness is not always possible, but it’s worth taking a half hour to discuss if any type of user activity would indicate some form of harm or abuse, and how your product could assist the user in receiving help in a safe manner.</p>
<p>That said, use caution: you don’t want to do anything that could put a user in harm’s way if their devices are being monitored. If you do offer some kind of proactive help, always make it voluntary, and think through other safety issues, such as the need to keep the user in-app in case an abuser is checking their search history. We’ll walk through a good example of this in the next chapter.</p>
<h3>Step 5: Test for safety<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/design-for-safety-excerpt#section10">#section10</a></h3>
<p>The final step is to test your prototypes from the point of view of your archetypes: the person who wants to weaponize the product for harm and the victim of the harm who needs to regain control over the technology. Just like any other kind of product testing, at this point you’ll aim to rigorously test out your safety solutions so that you can identify gaps and correct them, validate that your designs will help keep your users safe, and feel more confident releasing your product into the world.</p>
<p>Ideally, safety testing happens along with usability testing. If you’re at a company that doesn’t do usability testing, you might be able to use safety testing to cleverly perform both; a user who goes through your design attempting to weaponize the product against someone else can also be encouraged to point out interactions or other elements of the design that don’t make sense to them.</p>
<p>You’ll want to conduct safety testing on either your final prototype or the actual product if it’s already been released. There’s nothing wrong with testing an existing product that wasn’t designed with safety goals in mind from the onset—“retrofitting” it for safety is a good thing to do.</p>
<p>Remember that testing for safety involves testing from the perspective of both an abuser and a survivor, though it may not make sense for you to do both. Alternatively, if you made multiple survivor archetypes to capture multiple scenarios, you’ll want to test from the perspective of each one.</p>
<p>As with other sorts of usability testing, you as the designer are most likely too close to the product and its design by this point to be a valuable tester; you know the product too well. Instead of doing it yourself, set up testing as you would with other usability testing: find someone who is not familiar with the product and its design, set the scene, give them a task, encourage them to think out loud, and observe how they attempt to complete it.</p>
<h4>Abuser testing<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/design-for-safety-excerpt#section11">#section11</a></h4>
<p>The goal of this testing is to understand how easy it is for someone to weaponize your product for harm. Unlike with usability testing, you <em>want</em> to make it impossible, or at least difficult, for them to achieve their goal. Reference the goals in the abuser archetype you created earlier, and use your product in an attempt to achieve them.</p>
<p>For example, for a fitness app with GPS-enabled location features, we can imagine that the abuser archetype would have the goal of figuring out where his ex-girlfriend now lives. With this goal in mind, you’d try everything possible to figure out the location of another user who has their privacy settings enabled. You might try to see her running routes, view any available information on her profile, view anything available about her location (which she has set to private), and investigate the profiles of any other users somehow connected with her account, such as her followers.</p>
<p>If by the end of this you’ve managed to uncover some of her location data, despite her having set her profile to private, you know now that your product enables stalking. Your next step is to go back to step 4 and figure out how to prevent this from happening. You may need to repeat the process of designing solutions and testing them more than once.</p>
<h4>Survivor testing<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/design-for-safety-excerpt#section12">#section12</a></h4>
<p>Survivor testing involves identifying how to give information and power to the survivor. It might not always make sense based on the product or context. Thwarting the attempt of an abuser archetype to stalk someone also satisfies the goal of the survivor archetype to not be stalked, so separate testing wouldn’t be needed from the survivor’s perspective.</p>
<p>However, there are cases where it makes sense. For example, for a smart thermostat, a survivor archetype’s goals would be to understand who or what is making the temperature change when they aren’t doing it themselves. You could test this by looking for the thermostat’s history log and checking for usernames, actions, and times; if you couldn’t find that information, you would have more work to do in step 4.</p>
<p>Another goal might be regaining control of the thermostat once the survivor realizes the abuser is remotely changing its settings. Your test would involve attempting to figure out how to do this: are there instructions that explain how to remove another user and change the password, and are they easy to find? This might again reveal that more work is needed to make it clear to the user how they can regain control of the device or account.</p>
<h4 id="section13">Stress testing<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/design-for-safety-excerpt#section13">#section13</a></h4>
<p>To make your product more inclusive and compassionate, consider adding stress testing. This concept comes from <em><a href="https://abookapart.com/products/design-for-real-life">Design for Real Life</a></em> by Eric Meyer and Sara Wachter-Boettcher. The authors pointed out that personas typically center people who are having a good day—but real users are often anxious, stressed out, having a bad day, or even experiencing tragedy. These are called “stress cases,” and testing your products for users in stress-case situations can help you identify places where your design lacks compassion. <em>Design for Real Life</em> has more details about what it looks like to incorporate stress cases into your design as well as many other great tactics for compassionate design.</p>]]></description>
      <link>https://alistapart-production.mystagingwebsite.com/article/design-for-safety-excerpt/</link>
      <guid>https://alistapart-production.mystagingwebsite.com/article/design-for-safety-excerpt/</guid>
      <pubDate>Thu, 26 Aug 2021 17:01:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Design for Safety, An Excerpt]]></title>
      <description><![CDATA[<p>Antiracist economist Kim Crayton says that “intention without strategy is chaos.” We’ve discussed how our biases, assumptions, and inattention toward marginalized and vulnerable groups lead to dangerous and unethical tech—but what, <em>specifically</em>, do we need to do to fix it? The intention to make our tech safer is not enough; we need a strategy.</p>


<p>This chapter will equip you with that plan of action. It covers how to integrate safety principles into your design work in order to create tech that’s safe, how to convince your stakeholders that this work is necessary, and how to respond to the critique that what we <em>actually</em> need is more diversity. (Spoiler: we do, but diversity alone is not the antidote to fixing unethical, unsafe tech.)</p>
<h2 id="section2"><strong>The process for inclusive safety</strong></h2>
<p>When you are designing for safety, your goals are to:</p>
<ul><li>identify ways your product can be used for abuse,</li>
<li>design ways to prevent the abuse, and</li>
<li>provide support for vulnerable users to reclaim power and control.</li>
</ul><p>The Process for Inclusive Safety is a tool to help you reach those goals (<strong>Fig 5.1</strong>). It’s a methodology I created in 2018 to capture the various techniques I was using when designing products with safety in mind. Whether you are creating an entirely new product or adding to an existing feature, the Process can help you make your product safe and inclusive. The Process includes five general areas of action:</p>
<ul><li>Conducting research</li>
<li>Creating archetypes</li>
<li>Brainstorming problems</li>
<li>Designing solutions</li>
<li>Testing for safety</li>
</ul><figure id="figure1" class="wp-block-image size-full"><img width="627" height="189" src="https://alistapart.com/wp-content/uploads/2021/08/dfs-fig-5-1.jpg?resize=627%2C189" alt="" class="wp-image-7173096" data-recalc-dims="1" /><figcaption><strong>Fig 5.1</strong>: Each aspect of the Process for Inclusive Safety can be incorporated into your design process where it makes the most sense for you. The times given are estimates to help you incorporate the stages into your design plan.</figcaption></figure><p>The Process is meant to be flexible—it won’t make sense for teams to implement every step in some situations. Use the parts that are relevant to your unique work and context; this is meant to be something you can insert into your existing design practice.</p>
<p>And once you use it, if you have an idea for making it better or simply want to provide context of how it helped your team, please get in touch with me. It’s a living document that I hope will continue to be a useful and realistic tool that technologists can use in their day-to-day work.</p>
<p>If you’re working on a product specifically for a vulnerable group or survivors of some form of trauma, such as an app for survivors of domestic violence, sexual assault, or drug addiction, be sure to read Chapter 7, which covers that situation explicitly and should be handled a bit differently. The guidelines here are for prioritizing safety when designing a more general product that will have a wide user base (which, we already know from statistics, will include certain groups that should be protected from harm). Chapter 7 is focused on products that are <em>specifically for</em> vulnerable groups and people who have experienced trauma.</p>
<h3 id="section3">Step 1: Conduct research</h3>
<p>Design research should include a broad analysis of how your tech might be weaponized for abuse as well as specific insights into the experiences of survivors and perpetrators of that type of abuse. At this stage, you and your team will investigate issues of interpersonal harm and abuse, and explore any other safety, security, or inclusivity issues that might be a concern for your product or service, like data security, racist algorithms, and harassment.</p>
<h4 id="section4">Broad research</h4>
<p>Your project should begin with broad, general research into similar products and issues around safety and ethical concerns that have already been reported. For example, a team building a smart home device would do well to understand the multitude of ways that existing smart home devices have been used as tools of abuse. If your product will involve AI, seek to understand the potentials for racism and other issues that have been reported in existing AI products. Nearly all types of technology have some kind of potential or actual harm that’s been reported on in the news or written about by academics. <a href="https://scholar.google.com">Google Scholar</a> is a useful tool for finding these studies.</p>
<h4 id="section5">Specific research: Survivors</h4>
<p>When possible and appropriate, include direct research (surveys and interviews) with people who are experts in the forms of harm you have uncovered. Ideally, you’ll want to interview advocates working in the space of your research first so that you have a more solid understanding of the topic and are better equipped to not retraumatize survivors. If you’ve uncovered possible domestic violence issues, for example, the experts you’ll want to speak with are survivors themselves, as well as workers at domestic violence hotlines, shelters, other related nonprofits, and lawyers.</p>
<p>Especially when interviewing survivors of any kind of trauma, it is important to pay people for their knowledge and lived experiences. Don’t ask survivors to share their trauma for free, as this is exploitative. While some survivors may not want to be paid, you should always make the offer in the initial ask. An alternative to payment is to donate to an organization working against the type of violence that the interviewee experienced. We’ll talk more about how to appropriately interview survivors in Chapter 6.</p>
<h4 id="section6">Specific research: Abusers</h4>
<p>It’s unlikely that teams aiming to design for safety will be able to interview self-proclaimed abusers or people who have broken laws around things like hacking. Don’t make this a goal; rather, try to get at this angle in your general research. Aim to understand how abusers or bad actors weaponize technology to use against others, how they cover their tracks, and how they explain or rationalize the abuse.</p>
<h3 id="section7">Step 2: Create archetypes</h3>
<p>Once you’ve finished conducting your research, use your insights to create abuser and survivor archetypes. Archetypes are not personas, as they’re not based on real people that you interviewed and surveyed. Instead, they’re based on your research into likely safety issues, much like when we design for accessibility: we don’t need to have found a group of blind or low-vision users in our interview pool to create a design that’s inclusive of them. Instead, we base those designs on existing research into what this group needs. Personas typically represent real users and include many details, while archetypes are broader and can be more generalized.</p>
<p>The abuser archetype is someone who will look at the product as a tool to perform harm (<strong>Fig 5.2</strong>). They may be trying to harm someone they don’t know through surveillance or anonymous harassment, or they may be trying to control, monitor, abuse, or torment someone they know personally.</p>
<figure id="figure2" class="wp-block-image size-large"><img width="960" height="718" src="https://alistapart.com/wp-content/uploads/2021/08/5.2-abuser-archetype-Harry-Oleson.jpg?resize=960%2C718" alt="" class="wp-image-7173097" data-recalc-dims="1" /><figcaption><strong>Fig 5.2:</strong> Harry Oleson, an abuser archetype for a fitness product, is looking for ways to stalk his ex-girlfriend through the fitness apps she uses.</figcaption></figure><p>The survivor archetype is someone who is being abused with the product. There are various situations to consider in terms of the archetype’s understanding of the abuse and how to put an end to it: Do they need proof of abuse they already suspect is happening, or are they unaware they’ve been targeted in the first place and need to be alerted (<strong>Fig 5.3</strong>)?</p>
<figure id="figure3" class="wp-block-image size-large"><img width="960" height="718" src="https://alistapart.com/wp-content/uploads/2021/08/5.3-survivor-archetype-Lisa-Zwaan.jpg?resize=960%2C718" alt="" class="wp-image-7173098" data-recalc-dims="1" /><figcaption><strong>Fig 5.3</strong>: The survivor archetype Lisa Zwaan suspects her husband is weaponizing their home’s IoT devices against her, but in the face of his insistence that she simply doesn’t understand how to use the products, she’s unsure. She needs some kind of proof of the abuse.</figcaption></figure><p>You may want to make multiple survivor archetypes to capture a range of different experiences. They may know that the abuse is happening but not be able to stop it, like when an abuser locks them out of IoT devices; or they know it’s happening but don’t know how, such as when a stalker keeps figuring out their location (<strong>Fig 5.4</strong>). Include as many of these scenarios as you need to in your survivor archetype. You’ll use these later on when you design solutions to help your survivor archetypes achieve their goals of preventing and ending abuse.</p>
<figure id="figure4" class="wp-block-image size-large"><img width="960" height="718" src="https://alistapart.com/wp-content/uploads/2021/08/5.4-survivor-archetype-Eric-Mitchell.jpg?resize=960%2C718" alt="" class="wp-image-7173099" data-recalc-dims="1" /><figcaption><strong>Fig 5.4</strong>: The survivor archetype Eric Mitchell knows he’s being stalked by his ex-boyfriend Rob but can’t figure out how Rob is learning his location information.</figcaption></figure><p>It may be useful for you to create persona-like artifacts for your archetypes, such as the three examples shown. Instead of focusing on the demographic information we often see in personas, focus on their goals. The goals of the abuser will be to carry out the specific abuse you’ve identified, while the goals of the survivor will be to prevent abuse, understand that abuse is happening, make ongoing abuse stop, or regain control over the technology that’s being used for abuse. Later, you’ll brainstorm how to prevent the abuser’s goals and assist the survivor’s goals.</p>
<p>And while the “abuser/survivor” model fits most cases, it doesn’t fit all, so modify it as you need to. For example, if you uncovered an issue with security, such as the ability for someone to hack into a home camera system and talk to children, the malicious hacker would get the abuser archetype and the child’s parents would get survivor archetype.</p>
<h3 id="section8">Step 3: Brainstorm problems</h3>
<p>After creating archetypes, brainstorm novel abuse cases and safety issues. “Novel” means things not found in your research; you’re trying to identify completely <em>new</em> safety issues that are unique to your product or service. The goal with this step is to exhaust every effort of identifying harms your product could cause. You aren’t worrying about how to prevent the harm yet—that comes in the next step.</p>
<p>How could your product be used for any kind of abuse, outside of what you’ve already identified in your research? I recommend setting aside at least a few hours with your team for this process.</p>
<p>If you’re looking for somewhere to start, try doing a Black Mirror brainstorm. This exercise is based on the show <em>Black Mirror</em>, which features stories about the dark possibilities of technology. Try to figure out how your product would be used in an episode of the show—the most wild, awful, out-of-control ways it could be used for harm. When I’ve led Black Mirror brainstorms, participants usually end up having a good deal of fun (which I think is great—it’s okay to have fun when designing for safety!). I recommend time-boxing a Black Mirror brainstorm to half an hour, and then dialing it back and using the rest of the time thinking of more realistic forms of harm.</p>
<p>After you’ve identified as many opportunities for abuse as possible, you may still not feel confident that you’ve uncovered every potential form of harm. A healthy amount of anxiety is normal when you’re doing this kind of work. It’s common for teams designing for safety to worry, “Have we really identified every possible harm? What if we’ve missed something?” If you’ve spent at least four hours coming up with ways your product could be used for harm and have run out of ideas, go to the next step.</p>
<p>It’s impossible to guarantee you’ve thought of everything; instead of aiming for 100 percent assurance, recognize that you’ve taken this time and have done the best you can, and commit to continuing to prioritize safety in the future. Once your product is released, your users may identify new issues that you missed; aim to receive that feedback graciously and course-correct quickly.</p>
<h3 id="section9">Step 4: Design solutions</h3>
<p>At this point, you should have a list of ways your product can be used for harm as well as survivor and abuser archetypes describing opposing user goals. The next step is to identify ways to design against the identified abuser’s goals and to support the survivor’s goals. This step is a good one to insert alongside existing parts of your design process where you’re proposing solutions for the various problems your research uncovered.</p>
<p>Some questions to ask yourself to help prevent harm and support your archetypes include:</p>
<ul><li>Can you design your product in such a way that the identified harm cannot happen in the first place? If not, what roadblocks can you put up to prevent the harm from happening?</li>
<li>How can you make the victim aware that abuse is happening through your product?</li>
<li>How can you help the victim understand what they need to do to make the problem stop?</li>
<li>Can you identify any types of user activity that would indicate some form of harm or abuse? Could your product help the user access support?</li>
</ul><p>In some products, it’s possible to proactively recognize that harm is happening. For example, a pregnancy app might be modified to allow the user to report that they were the victim of an assault, which could trigger an offer to receive resources for local and national organizations. This sort of proactiveness is not always possible, but it’s worth taking a half hour to discuss if any type of user activity would indicate some form of harm or abuse, and how your product could assist the user in receiving help in a safe manner.</p>
<p>That said, use caution: you don’t want to do anything that could put a user in harm’s way if their devices are being monitored. If you do offer some kind of proactive help, always make it voluntary, and think through other safety issues, such as the need to keep the user in-app in case an abuser is checking their search history. We’ll walk through a good example of this in the next chapter.</p>
<h3 id="section10">Step 5: Test for safety</h3>
<p>The final step is to test your prototypes from the point of view of your archetypes: the person who wants to weaponize the product for harm and the victim of the harm who needs to regain control over the technology. Just like any other kind of product testing, at this point you’ll aim to rigorously test out your safety solutions so that you can identify gaps and correct them, validate that your designs will help keep your users safe, and feel more confident releasing your product into the world.</p>
<p>Ideally, safety testing happens along with usability testing. If you’re at a company that doesn’t do usability testing, you might be able to use safety testing to cleverly perform both; a user who goes through your design attempting to weaponize the product against someone else can also be encouraged to point out interactions or other elements of the design that don’t make sense to them.</p>
<p>You’ll want to conduct safety testing on either your final prototype or the actual product if it’s already been released. There’s nothing wrong with testing an existing product that wasn’t designed with safety goals in mind from the onset—“retrofitting” it for safety is a good thing to do.</p>
<p>Remember that testing for safety involves testing from the perspective of both an abuser and a survivor, though it may not make sense for you to do both. Alternatively, if you made multiple survivor archetypes to capture multiple scenarios, you’ll want to test from the perspective of each one.</p>
<p>As with other sorts of usability testing, you as the designer are most likely too close to the product and its design by this point to be a valuable tester; you know the product too well. Instead of doing it yourself, set up testing as you would with other usability testing: find someone who is not familiar with the product and its design, set the scene, give them a task, encourage them to think out loud, and observe how they attempt to complete it.</p>
<h4 id="section11">Abuser testing</h4>
<p>The goal of this testing is to understand how easy it is for someone to weaponize your product for harm. Unlike with usability testing, you <em>want</em> to make it impossible, or at least difficult, for them to achieve their goal. Reference the goals in the abuser archetype you created earlier, and use your product in an attempt to achieve them.</p>
<p>For example, for a fitness app with GPS-enabled location features, we can imagine that the abuser archetype would have the goal of figuring out where his ex-girlfriend now lives. With this goal in mind, you’d try everything possible to figure out the location of another user who has their privacy settings enabled. You might try to see her running routes, view any available information on her profile, view anything available about her location (which she has set to private), and investigate the profiles of any other users somehow connected with her account, such as her followers.</p>
<p>If by the end of this you’ve managed to uncover some of her location data, despite her having set her profile to private, you know now that your product enables stalking. Your next step is to go back to step 4 and figure out how to prevent this from happening. You may need to repeat the process of designing solutions and testing them more than once.</p>
<h4 id="section12">Survivor testing</h4>
<p>Survivor testing involves identifying how to give information and power to the survivor. It might not always make sense based on the product or context. Thwarting the attempt of an abuser archetype to stalk someone also satisfies the goal of the survivor archetype to not be stalked, so separate testing wouldn’t be needed from the survivor’s perspective.</p>
<p>However, there are cases where it makes sense. For example, for a smart thermostat, a survivor archetype’s goals would be to understand who or what is making the temperature change when they aren’t doing it themselves. You could test this by looking for the thermostat’s history log and checking for usernames, actions, and times; if you couldn’t find that information, you would have more work to do in step 4.</p>
<p>Another goal might be regaining control of the thermostat once the survivor realizes the abuser is remotely changing its settings. Your test would involve attempting to figure out how to do this: are there instructions that explain how to remove another user and change the password, and are they easy to find? This might again reveal that more work is needed to make it clear to the user how they can regain control of the device or account.</p>
<h4 id="section13">Stress testing</h4>
<p>To make your product more inclusive and compassionate, consider adding stress testing. This concept comes from <em><a href="https://abookapart.com/products/design-for-real-life">Design for Real Life</a></em> by Eric Meyer and Sara Wachter-Boettcher. The authors pointed out that personas typically center people who are having a good day—but real users are often anxious, stressed out, having a bad day, or even experiencing tragedy. These are called “stress cases,” and testing your products for users in stress-case situations can help you identify places where your design lacks compassion. <em>Design for Real Life</em> has more details about what it looks like to incorporate stress cases into your design as well as many other great tactics for compassionate design.</p>]]></description>
      <link>https://alistapart.com/article/design-for-safety-excerpt/</link>
      <guid>https://alistapart.com/article/design-for-safety-excerpt/</guid>
      <pubDate>Thu, 26 Aug 2021 17:01:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Sustainable Web Design, An Excerpt]]></title>
      <description><![CDATA[<p>In the 1950s, many in the elite running community had begun to believe it wasn’t possible to run a mile in less than four minutes. Runners had been attempting it since the late 19th century and were beginning to draw the conclusion that the human body simply wasn’t built for the task. </p>


<p>But on May 6, 1956, Roger Bannister took everyone by surprise. It was a cold, wet day in Oxford, England—conditions no one expected to lend themselves to record-setting—and yet Bannister did just that, running a mile in 3:59.4 and becoming the first person in the record books to run a mile in under four minutes. </p>
<p>This shift in the benchmark had profound effects; the world now knew that the four-minute mile was possible. Bannister’s record lasted only forty-six days, when it was snatched away by Australian runner John Landy. Then a year later, three runners all beat the four-minute barrier together in the same race. Since then, over 1,400 runners have officially <a href="https://en.wikipedia.org/wiki/Four-minute_mile">run a mile in under four minutes</a>; the current record is 3:43.13, held by Moroccan athlete Hicham El Guerrouj.</p>
<p>We achieve far more when we believe that something is possible, and we will believe it’s possible only when we see someone else has already done it—and as with human running speed, so it is with what we believe are the hard limits for how a website needs to perform.</p>
<h2 id="section2">Establishing standards for a sustainable web</h2>
<p>In most major industries, the key metrics of environmental performance are fairly well established, such as miles per gallon for cars or energy per square meter for homes. The tools and methods for calculating those metrics are standardized as well, which keeps everyone on the same page when doing environmental assessments. In the world of websites and apps, however, we aren’t held to any particular environmental standards, and only recently have gained the tools and methods we need to even make an environmental assessment.</p>
<p>The primary goal in sustainable web design is to reduce <em>carbon emissions</em>. However, it’s almost impossible to actually measure the amount of CO<sub>2</sub> produced by a web product. We can’t measure the fumes coming out of the exhaust pipes on our laptops. The emissions of our websites are far away, out of sight and out of mind, coming out of power stations burning coal and gas. We have no way to trace the electrons from a website or app back to the power station where the electricity is being generated and actually know the exact amount of greenhouse gas produced. So what do we do? </p>
<p>If we can’t measure the actual carbon emissions, then we need to find what we <em>can</em> measure. The primary factors that could be used as indicators of carbon emissions are:</p>
<ol><li>Data transfer </li>
<li>Carbon intensity of electricity</li>
</ol><p>Let’s take a look at how we can use these metrics to quantify the energy consumption, and in turn the carbon footprint, of the websites and web apps we create.</p>
<h3 id="section3">Data transfer</h3>
<p>Most researchers use kilowatt-hours per gigabyte (kWh/GB) as a metric of energy efficiency when measuring the amount of data transferred over the internet when a website or application is used. This provides a great reference point for energy consumption and carbon emissions. As a rule of thumb, the more data transferred, the more energy used in the data center, telecoms networks, and end user devices.</p>
<p>For web pages, data transfer for a single visit can be most easily estimated by measuring the <em>page weight,</em> meaning the transfer size of the page in kilobytes the first time someone visits the page. It’s fairly easy to measure using the developer tools in any modern web browser. Often your web hosting account will include statistics for the total data transfer of any web application (<strong>Fig 2.1</strong>).</p>
<figure id="figure1" class="wp-block-image size-full"><img width="846" height="356" src="https://alistapart.com/wp-content/uploads/2021/08/2-1.png?resize=846%2C356" alt="" class="wp-image-7173077" data-recalc-dims="1" /><figcaption><strong>Fig 2.1:</strong> The Kinsta hosting dashboard displays data transfer alongside traffic volumes. If you divide data transfer by visits, you get the average data per visit, which can be used as a metric of efficiency.</figcaption></figure><p>The nice thing about page weight as a metric is that it allows us to compare the efficiency of web pages on a level playing field without confusing the issue with constantly changing traffic volumes. </p>
<p>Reducing page weight requires a large scope. By early 2020, the median page weight was 1.97 MB for setups the HTTP Archive classifies as “desktop” and 1.77 MB for “mobile,” with desktop increasing 36 percent since January 2016 and mobile page weights nearly <a href="https://httparchive.org/reports/state-of-the-web#bytesTotal">doubling in the same period</a> (<strong>Fig 2.2</strong>). Roughly half of this data transfer is image files, making images the single biggest source of carbon emissions on the average website. </p>
<p>History clearly shows us that our web pages <em>can</em> be smaller, if only we set our minds to it. While most technologies become ever more energy efficient, including the underlying technology of the web such as data centers and transmission networks, websites themselves are a technology that becomes less efficient as time goes on.</p>
<figure id="figure2" class="wp-block-image size-full"><img width="806" height="358" src="https://alistapart.com/wp-content/uploads/2021/08/2-2.png?resize=806%2C358" alt="" class="wp-image-7173078" data-recalc-dims="1" /><figcaption><strong>Fig 2.2:</strong> The historical page weight data from HTTP Archive can teach us a lot about what is possible in the future.</figcaption></figure><p>You might be familiar with the concept of performance budgeting as a way of focusing a project team on creating faster user experiences. For example, we might specify that the website must load in a maximum of one second on a broadband connection and three seconds on a 3G connection. Much like speed limits while driving, performance budgets are upper limits rather than vague suggestions, so the goal should always be to come in under budget.</p>
<p>Designing for fast performance does often lead to reduced data transfer and emissions, but it isn’t always the case. Web performance is often more about the subjective perception of load times than it is about the true efficiency of the underlying system, whereas page weight and transfer size are more objective measures and more reliable benchmarks for sustainable web design. </p>
<p>We can set a page weight budget in reference to a benchmark of industry averages, using data from sources like HTTP Archive. We can also benchmark page weight against competitors or the old version of the website we’re replacing. For example, we might set a maximum page weight budget as equal to our most efficient competitor, or we could set the benchmark lower to guarantee we are best in class. </p>
<p>If we want to take it to the next level, then we could also start looking at the transfer size of our web pages for repeat visitors. Although page weight for the first time someone visits is the easiest thing to measure, and easy to compare on a like-for-like basis, we can learn even more if we start looking at transfer size in other scenarios too. For example, visitors who load the same page multiple times will likely have a high percentage of the files cached in their browser, meaning they don’t need to transfer all of the files on subsequent visits. Likewise, a visitor who navigates to new pages on the same website will likely not need to load the full page each time, as some global assets from areas like the header and footer may already be cached in their browser. Measuring transfer size at this next level of detail can help us learn even more about how we can optimize efficiency for users who regularly visit our pages, and enable us to set page weight budgets for additional scenarios beyond the first visit.</p>
<p>Page weight budgets are easy to track throughout a design and development process. Although they don’t actually tell us carbon emission and energy consumption analytics directly, they give us a clear indication of efficiency relative to other websites. And as transfer size is an effective analog for energy consumption, we can actually use it to estimate energy consumption too.</p>
<p>In summary, reduced data transfer translates to energy efficiency, a key factor to reducing carbon emissions of web products. The more efficient our products, the less electricity they use, and the less fossil fuels need to be burned to produce the electricity to power them. But as we’ll see next, since all web products demand <em>some</em> power, it’s important to consider the source of that electricity, too.</p>
<h3 id="section4">Carbon intensity of electricity</h3>
<p>Regardless of energy efficiency, the level of pollution caused by digital products depends on the <em>carbon intensity</em> of the energy being used to power them. Carbon intensity is a term used to define the grams of CO<sub>2</sub> produced for every kilowatt-hour of electricity (gCO<sub>2</sub>/kWh). This varies widely, with renewable energy sources and nuclear having <a href="https://www.carbonbrief.org/solar-wind-nuclear-amazingly-low-carbon-footprints">an extremely low carbon intensity</a> of less than 10 gCO<sub>2</sub>/kWh (even when factoring in their construction); whereas fossil fuels have <a href="https://www.volker-quaschning.de/datserv/CO2-spez/index_e.php">very high carbon intensity</a> of approximately 200–400 gCO<sub>2</sub>/kWh. </p>
<p>Most electricity comes from national or state grids, where energy from a variety of different sources is mixed together with varying levels of carbon intensity. The distributed nature of the internet means that a single user of a website or app might be using energy from multiple different grids simultaneously; a website user in Paris uses electricity from the French national grid to power their home internet and devices, but the website’s data center could be in Dallas, USA, pulling electricity from the Texas grid, while the telecoms networks use energy from everywhere between Dallas and Paris.</p>
<p>We don’t have control over the full energy supply of web services, but we do have some control over where we host our projects. With a data center using a significant proportion of the energy of any website, locating the data center in an area with low carbon energy will tangibly reduce its carbon emissions. Danish startup Tomorrow reports and <a href="https://www.electricitymap.org/map">maps this user-contributed data</a>, and a glance at their map shows how, for example, choosing a data center in France will have significantly lower carbon emissions than a data center in the Netherlands (<strong>Fig 2.3</strong>).</p>
<figure id="figure3" class="wp-block-image size-full"><img width="830" height="380" src="https://alistapart.com/wp-content/uploads/2021/08/2-3.png?resize=830%2C380" alt="" class="wp-image-7173079" data-recalc-dims="1" /><figcaption><strong>Fig 2.3:</strong> Tomorrow’s electricityMap shows live data for the carbon intensity of electricity by country.</figcaption></figure><p>That said, we don’t want to locate our servers too far away from our users; it takes energy to transmit data through the telecom’s networks, and the further the data travels, the more energy is consumed. Just like food miles, we can think of the distance from the data center to the website’s core user base as “megabyte miles”—and we want it to be as small as possible.</p>
<p>Using the distance itself as a benchmark, we can use website analytics to identify the country, state, or even city where our core user group is located and measure the distance from that location to the data center used by our hosting company. This will be a somewhat fuzzy metric as we don’t know the precise center of mass of our users or the exact location of a data center, but we can at least get a rough idea. </p>
<p>For example, if a website is hosted in London but the primary user base is on the West Coast of the USA, then we could look up the distance from London to San Francisco, which is 5,300 miles. That’s a long way! We can see that hosting it somewhere in North America, ideally on the West Coast, would significantly reduce the distance and thus the energy used to transmit the data. In addition, locating our servers closer to our visitors helps reduce latency and delivers better user experience, so it’s a win-win.</p>
<h3 id="section5"><strong>Converting it back to carbon emissions</strong></h3>
<p>If we combine carbon intensity with a calculation for energy consumption, we can calculate the carbon emissions of our websites and apps. A tool my team created does this by measuring the data transfer over the wire when loading a web page, calculating the amount of electricity associated, and then converting that into a figure for CO<sub>2</sub> (<strong>Fig 2.4</strong>). It also factors in whether or not the web hosting is powered by renewable energy.</p>
<p>If you want to take it to the next level and tailor the data more accurately to the unique aspects of your project, the <a href="https://docs.google.com/spreadsheets/d/1gQeUwNFHp7ck4AS7r-d_EwfriM-UFoQ6ApBek9n-hqo/edit#gid=1896136078">Energy and Emissions Worksheet</a> accompanying this book shows you how.</p>
<figure id="figure4" class="wp-block-image size-full"><img width="576" height="624" src="https://alistapart.com/wp-content/uploads/2021/08/2-4.png?resize=576%2C624" alt="" class="wp-image-7173080" data-recalc-dims="1" /><figcaption><strong>Fig 2.4:</strong> The <a href="https://www.websitecarbon.com">Website Carbon Calculator</a> shows how the Riverford Organic website embodies their commitment to sustainability, being both low carbon and hosted in a data center using renewable energy.</figcaption></figure><p>With the ability to calculate carbon emissions for our projects, we could actually take a page weight budget one step further and set carbon budgets as well. CO<sub>2</sub> is not a metric commonly used in web projects; we’re more familiar with kilobytes and megabytes, and can fairly easily look at design options and files to assess how big they are. Translating that into carbon adds a layer of abstraction that isn’t as intuitive—but carbon budgets do focus our minds on the primary thing we’re trying to reduce, and support the core objective of sustainable web design: reducing carbon emissions.</p>
<h3 id="section6">Browser Energy</h3>
<p>Data transfer might be the simplest and most complete analog for energy consumption in our digital projects, but by giving us one number to represent the energy used in the data center, the telecoms networks, and the end user’s devices, it can’t offer us insights into the efficiency in any specific part of the system.</p>
<p>One part of the system we can look at in more detail is the energy used by end users’ devices. As front-end web technologies become more advanced, the computational load is increasingly moving from the data center to users’ devices, whether they be phones, tablets, laptops, desktops, or even smart TVs. Modern web browsers allow us to implement more complex styling and animation on the fly using CSS and JavaScript. Furthermore, JavaScript libraries such as Angular and React allow us to create applications where the “thinking” work is done partly or entirely in the browser. </p>
<p>All of these advances are exciting and open up new possibilities for what the web can do to serve society and create positive experiences. However, more computation in the user’s web browser means more energy used by their devices. This has implications not just environmentally, but also for user experience and inclusivity. Applications that put a heavy processing load on the user’s device can inadvertently exclude users with older, slower devices and cause batteries on phones and laptops to drain faster. Furthermore, if we build web applications that require the user to have up-to-date, powerful devices, people throw away old devices much more frequently. This isn’t just bad for the environment, but it puts a disproportionate financial burden on the poorest in society.</p>
<p>In part because the tools are limited, and partly because there are so many different models of devices, it’s difficult to measure website energy consumption on end users’ devices. One tool we do currently have is the Energy Impact monitor inside the developer console of the Safari browser (<strong>Fig 2.5</strong>).</p>
<figure id="figure5" class="wp-block-image size-full"><img width="782" height="494" src="https://alistapart.com/wp-content/uploads/2021/08/2-5.png?resize=782%2C494" alt="" class="wp-image-7173081" data-recalc-dims="1" /><figcaption><strong>Fig 2.5:</strong> The Energy Impact meter in Safari (on the right) shows how a website consumes CPU energy.</figcaption></figure><p>You know when you load a website and your computer’s cooling fans start spinning so frantically you think it might actually take off? That’s essentially what this tool is measuring. </p>
<p>It shows us the percentage of CPU used and the duration of CPU usage when loading the web page, and uses these figures to generate an energy impact rating. It doesn’t give us precise data for the amount of electricity used in kilowatts, but the information it does provide can be used to benchmark how efficiently your websites use energy and set targets for improvement.</p>]]></description>
      <link>https://alistapart.com/article/sustainable-web-design-excerpt/</link>
      <guid>https://alistapart.com/article/sustainable-web-design-excerpt/</guid>
      <pubDate>Thu, 05 Aug 2021 16:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Sustainable Web Design, An Excerpt]]></title>
      <description><![CDATA[<p>In the 1950s, many in the elite running community had begun to believe it wasn’t possible to run a mile in less than four minutes. Runners had been attempting it since the late 19th century and were beginning to draw the conclusion that the human body simply wasn’t built for the task. </p><div class="aside-breaker">Article Continues Below</div>
<p>But on May 6, 1956, Roger Bannister took everyone by surprise. It was a cold, wet day in Oxford, England—conditions no one expected to lend themselves to record-setting—and yet Bannister did just that, running a mile in 3:59.4 and becoming the first person in the record books to run a mile in under four minutes. </p>
<p>This shift in the benchmark had profound effects; the world now knew that the four-minute mile was possible. Bannister’s record lasted only forty-six days, when it was snatched away by Australian runner John Landy. Then a year later, three runners all beat the four-minute barrier together in the same race. Since then, over 1,400 runners have officially <a href="https://en.wikipedia.org/wiki/Four-minute_mile">run a mile in under four minutes</a>; the current record is 3:43.13, held by Moroccan athlete Hicham El Guerrouj.</p>
<p>We achieve far more when we believe that something is possible, and we will believe it’s possible only when we see someone else has already done it—and as with human running speed, so it is with what we believe are the hard limits for how a website needs to perform.</p>
<p>In most major industries, the key metrics of environmental performance are fairly well established, such as miles per gallon for cars or energy per square meter for homes. The tools and methods for calculating those metrics are standardized as well, which keeps everyone on the same page when doing environmental assessments. In the world of websites and apps, however, we aren’t held to any particular environmental standards, and only recently have gained the tools and methods we need to even make an environmental assessment.</p>
<p>The primary goal in sustainable web design is to reduce <em>carbon emissions</em>. However, it’s almost impossible to actually measure the amount of CO<sub>2</sub> produced by a web product. We can’t measure the fumes coming out of the exhaust pipes on our laptops. The emissions of our websites are far away, out of sight and out of mind, coming out of power stations burning coal and gas. We have no way to trace the electrons from a website or app back to the power station where the electricity is being generated and actually know the exact amount of greenhouse gas produced. So what do we do? </p>
<p>If we can’t measure the actual carbon emissions, then we need to find what we <em>can</em> measure. The primary factors that could be used as indicators of carbon emissions are:</p>
<ol><li>Data transfer </li>
<li>Carbon intensity of electricity</li>
</ol><p>Let’s take a look at how we can use these metrics to quantify the energy consumption, and in turn the carbon footprint, of the websites and web apps we create.</p>
<h3>Data transfer<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/sustainable-web-design-excerpt#section3">#section3</a></h3>
<p>Most researchers use kilowatt-hours per gigabyte (kWh/GB) as a metric of energy efficiency when measuring the amount of data transferred over the internet when a website or application is used. This provides a great reference point for energy consumption and carbon emissions. As a rule of thumb, the more data transferred, the more energy used in the data center, telecoms networks, and end user devices.</p>
<p>For web pages, data transfer for a single visit can be most easily estimated by measuring the <em>page weight,</em> meaning the transfer size of the page in kilobytes the first time someone visits the page. It’s fairly easy to measure using the developer tools in any modern web browser. Often your web hosting account will include statistics for the total data transfer of any web application (<strong>Fig 2.1</strong>).</p>
<figure class="wp-block-image size-full"><img width="846" height="356" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/08/2-1.png" alt="" class="wp-image-7173077" /><figcaption><strong>Fig 2.1:</strong> The Kinsta hosting dashboard displays data transfer alongside traffic volumes. If you divide data transfer by visits, you get the average data per visit, which can be used as a metric of efficiency.</figcaption></figure><p>The nice thing about page weight as a metric is that it allows us to compare the efficiency of web pages on a level playing field without confusing the issue with constantly changing traffic volumes. </p>
<p>Reducing page weight requires a large scope. By early 2020, the median page weight was 1.97 MB for setups the HTTP Archive classifies as “desktop” and 1.77 MB for “mobile,” with desktop increasing 36 percent since January 2016 and mobile page weights nearly <a href="https://httparchive.org/reports/state-of-the-web#bytesTotal">doubling in the same period</a> (<strong>Fig 2.2</strong>). Roughly half of this data transfer is image files, making images the single biggest source of carbon emissions on the average website. </p>
<p>History clearly shows us that our web pages <em>can</em> be smaller, if only we set our minds to it. While most technologies become ever more energy efficient, including the underlying technology of the web such as data centers and transmission networks, websites themselves are a technology that becomes less efficient as time goes on.</p>
<figure class="wp-block-image size-full"><img width="806" height="358" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/08/2-2.png" alt="" class="wp-image-7173078" /><figcaption><strong>Fig 2.2:</strong> The historical page weight data from HTTP Archive can teach us a lot about what is possible in the future.</figcaption></figure><p>You might be familiar with the concept of performance budgeting as a way of focusing a project team on creating faster user experiences. For example, we might specify that the website must load in a maximum of one second on a broadband connection and three seconds on a 3G connection. Much like speed limits while driving, performance budgets are upper limits rather than vague suggestions, so the goal should always be to come in under budget.</p>
<p>Designing for fast performance does often lead to reduced data transfer and emissions, but it isn’t always the case. Web performance is often more about the subjective perception of load times than it is about the true efficiency of the underlying system, whereas page weight and transfer size are more objective measures and more reliable benchmarks for sustainable web design. </p>
<p>We can set a page weight budget in reference to a benchmark of industry averages, using data from sources like HTTP Archive. We can also benchmark page weight against competitors or the old version of the website we’re replacing. For example, we might set a maximum page weight budget as equal to our most efficient competitor, or we could set the benchmark lower to guarantee we are best in class. </p>
<p>If we want to take it to the next level, then we could also start looking at the transfer size of our web pages for repeat visitors. Although page weight for the first time someone visits is the easiest thing to measure, and easy to compare on a like-for-like basis, we can learn even more if we start looking at transfer size in other scenarios too. For example, visitors who load the same page multiple times will likely have a high percentage of the files cached in their browser, meaning they don’t need to transfer all of the files on subsequent visits. Likewise, a visitor who navigates to new pages on the same website will likely not need to load the full page each time, as some global assets from areas like the header and footer may already be cached in their browser. Measuring transfer size at this next level of detail can help us learn even more about how we can optimize efficiency for users who regularly visit our pages, and enable us to set page weight budgets for additional scenarios beyond the first visit.</p>
<p>Page weight budgets are easy to track throughout a design and development process. Although they don’t actually tell us carbon emission and energy consumption analytics directly, they give us a clear indication of efficiency relative to other websites. And as transfer size is an effective analog for energy consumption, we can actually use it to estimate energy consumption too.</p>
<p>In summary, reduced data transfer translates to energy efficiency, a key factor to reducing carbon emissions of web products. The more efficient our products, the less electricity they use, and the less fossil fuels need to be burned to produce the electricity to power them. But as we’ll see next, since all web products demand <em>some</em> power, it’s important to consider the source of that electricity, too.</p>
<h3>Carbon intensity of electricity<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/sustainable-web-design-excerpt#section4">#section4</a></h3>
<p>Regardless of energy efficiency, the level of pollution caused by digital products depends on the <em>carbon intensity</em> of the energy being used to power them. Carbon intensity is a term used to define the grams of CO<sub>2</sub> produced for every kilowatt-hour of electricity (gCO<sub>2</sub>/kWh). This varies widely, with renewable energy sources and nuclear having <a href="https://www.carbonbrief.org/solar-wind-nuclear-amazingly-low-carbon-footprints">an extremely low carbon intensity</a> of less than 10 gCO<sub>2</sub>/kWh (even when factoring in their construction); whereas fossil fuels have <a href="https://www.volker-quaschning.de/datserv/CO2-spez/index_e.php">very high carbon intensity</a> of approximately 200–400 gCO<sub>2</sub>/kWh. </p>
<p>Most electricity comes from national or state grids, where energy from a variety of different sources is mixed together with varying levels of carbon intensity. The distributed nature of the internet means that a single user of a website or app might be using energy from multiple different grids simultaneously; a website user in Paris uses electricity from the French national grid to power their home internet and devices, but the website’s data center could be in Dallas, USA, pulling electricity from the Texas grid, while the telecoms networks use energy from everywhere between Dallas and Paris.</p>
<p>We don’t have control over the full energy supply of web services, but we do have some control over where we host our projects. With a data center using a significant proportion of the energy of any website, locating the data center in an area with low carbon energy will tangibly reduce its carbon emissions. Danish startup Tomorrow reports and <a href="https://www.electricitymap.org/map">maps this user-contributed data</a>, and a glance at their map shows how, for example, choosing a data center in France will have significantly lower carbon emissions than a data center in the Netherlands (<strong>Fig 2.3</strong>).</p>
<figure class="wp-block-image size-full"><img width="830" height="380" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/08/2-3.png" alt="" class="wp-image-7173079" /><figcaption><strong>Fig 2.3:</strong> Tomorrow’s electricityMap shows live data for the carbon intensity of electricity by country.</figcaption></figure><p>That said, we don’t want to locate our servers too far away from our users; it takes energy to transmit data through the telecom’s networks, and the further the data travels, the more energy is consumed. Just like food miles, we can think of the distance from the data center to the website’s core user base as “megabyte miles”—and we want it to be as small as possible.</p>
<p>Using the distance itself as a benchmark, we can use website analytics to identify the country, state, or even city where our core user group is located and measure the distance from that location to the data center used by our hosting company. This will be a somewhat fuzzy metric as we don’t know the precise center of mass of our users or the exact location of a data center, but we can at least get a rough idea. </p>
<p>For example, if a website is hosted in London but the primary user base is on the West Coast of the USA, then we could look up the distance from London to San Francisco, which is 5,300 miles. That’s a long way! We can see that hosting it somewhere in North America, ideally on the West Coast, would significantly reduce the distance and thus the energy used to transmit the data. In addition, locating our servers closer to our visitors helps reduce latency and delivers better user experience, so it’s a win-win.</p>
<h3><strong>Converting it back to carbon emissions</strong><a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/sustainable-web-design-excerpt#section5">#section5</a></h3>
<p>If we combine carbon intensity with a calculation for energy consumption, we can calculate the carbon emissions of our websites and apps. A tool my team created does this by measuring the data transfer over the wire when loading a web page, calculating the amount of electricity associated, and then converting that into a figure for CO<sub>2</sub> (<strong>Fig 2.4</strong>). It also factors in whether or not the web hosting is powered by renewable energy.</p>
<p>If you want to take it to the next level and tailor the data more accurately to the unique aspects of your project, the <a href="https://docs.google.com/spreadsheets/d/1gQeUwNFHp7ck4AS7r-d_EwfriM-UFoQ6ApBek9n-hqo/edit#gid=1896136078">Energy and Emissions Worksheet</a> accompanying this book shows you how.</p>
<figure class="wp-block-image size-full"><img width="576" height="624" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/08/2-4.png" alt="" class="wp-image-7173080" /><figcaption><strong>Fig 2.4:</strong> The <a href="https://www.websitecarbon.com">Website Carbon Calculator</a> shows how the Riverford Organic website embodies their commitment to sustainability, being both low carbon and hosted in a data center using renewable energy.</figcaption></figure><p>With the ability to calculate carbon emissions for our projects, we could actually take a page weight budget one step further and set carbon budgets as well. CO<sub>2</sub> is not a metric commonly used in web projects; we’re more familiar with kilobytes and megabytes, and can fairly easily look at design options and files to assess how big they are. Translating that into carbon adds a layer of abstraction that isn’t as intuitive—but carbon budgets do focus our minds on the primary thing we’re trying to reduce, and support the core objective of sustainable web design: reducing carbon emissions.</p>
<h3>Browser Energy<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/sustainable-web-design-excerpt#section6">#section6</a></h3>
<p>Data transfer might be the simplest and most complete analog for energy consumption in our digital projects, but by giving us one number to represent the energy used in the data center, the telecoms networks, and the end user’s devices, it can’t offer us insights into the efficiency in any specific part of the system.</p>
<p>One part of the system we can look at in more detail is the energy used by end users’ devices. As front-end web technologies become more advanced, the computational load is increasingly moving from the data center to users’ devices, whether they be phones, tablets, laptops, desktops, or even smart TVs. Modern web browsers allow us to implement more complex styling and animation on the fly using CSS and JavaScript. Furthermore, JavaScript libraries such as Angular and React allow us to create applications where the “thinking” work is done partly or entirely in the browser. </p>
<p>All of these advances are exciting and open up new possibilities for what the web can do to serve society and create positive experiences. However, more computation in the user’s web browser means more energy used by their devices. This has implications not just environmentally, but also for user experience and inclusivity. Applications that put a heavy processing load on the user’s device can inadvertently exclude users with older, slower devices and cause batteries on phones and laptops to drain faster. Furthermore, if we build web applications that require the user to have up-to-date, powerful devices, people throw away old devices much more frequently. This isn’t just bad for the environment, but it puts a disproportionate financial burden on the poorest in society.</p>
<p>In part because the tools are limited, and partly because there are so many different models of devices, it’s difficult to measure website energy consumption on end users’ devices. One tool we do currently have is the Energy Impact monitor inside the developer console of the Safari browser (<strong>Fig 2.5</strong>).</p>
<figure class="wp-block-image size-full"><img width="782" height="494" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/08/2-5.png" alt="" class="wp-image-7173081" /><figcaption><strong>Fig 2.5:</strong> The Energy Impact meter in Safari (on the right) shows how a website consumes CPU energy.</figcaption></figure><p>You know when you load a website and your computer’s cooling fans start spinning so frantically you think it might actually take off? That’s essentially what this tool is measuring. </p>
<p>It shows us the percentage of CPU used and the duration of CPU usage when loading the web page, and uses these figures to generate an energy impact rating. It doesn’t give us precise data for the amount of electricity used in kilowatts, but the information it does provide can be used to benchmark how efficiently your websites use energy and set targets for improvement.</p>]]></description>
      <link>https://alistapart-production.mystagingwebsite.com/article/sustainable-web-design-excerpt/</link>
      <guid>https://alistapart-production.mystagingwebsite.com/article/sustainable-web-design-excerpt/</guid>
      <pubDate>Thu, 05 Aug 2021 16:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Voice Content and Usability]]></title>
      <description><![CDATA[<p id="E1205">We’ve been having conversations for thousands of years. Whether to convey information, conduct transactions, or simply to check in on one another, people have yammered away, chattering and gesticulating, through spoken conversation for countless generations. Only in the last few millennia have we begun to commit our conversations to writing, and only in the last few decades have we begun to outsource them to the computer, a machine that shows much more affinity for written correspondence than for the slangy vagaries of spoken language.</p><div class="aside-breaker">Article Continues Below</div>
<p id="E1222">Computers have trouble because between spoken and written language, speech is more primordial. To have successful conversations with us, machines must grapple with the messiness of human speech: the disfluencies and pauses, the gestures and body language, and the variations in word choice and spoken dialect that can stymie even the most carefully crafted human-computer interaction. In the human-to-human scenario, spoken language also has the privilege of face-to-face contact, where we can readily interpret nonverbal social cues.</p>
<p id="E1233">In contrast, written language immediately concretizes as we commit it to record and retains usages long after they become obsolete in spoken communication (the salutation “To whom it may concern,” for example), generating its own fossil record of outdated terms and phrases. Because it tends to be more consistent, polished, and formal, written text is fundamentally much easier for machines to parse and understand.</p>
<p id="E1257">Spoken language has no such luxury. Besides the nonverbal cues that decorate conversations with emphasis and emotional context, there are also verbal cues and vocal behaviors that modulate conversation in nuanced ways: <em>how</em> something is said, not <em>what</em>. Whether rapid-fire, low-pitched, or high-decibel, whether sarcastic, stilted, or sighing, our spoken language conveys much more than the written word could ever muster. So when it comes to voice interfaces—the machines we conduct spoken conversations with—we face exciting challenges as designers and content strategists.</p>
<p id="E1289">We interact with voice interfaces for a variety of reasons, but according to Michael McTear, Zoraida Callejas, and David Griol in <em>The Conversational Interface</em>, those motivations by and large mirror the reasons we initiate conversations with other people, too (<a href="http://bkaprt.com/vcu36/01-01" target="_blank" rel="noreferrer noopener">http://bkaprt.com/vcu36/01-01</a>). Generally, we start up a conversation because:</p>
<ul><li>we need something done (such as a transaction),</li>
<li>we want to know something (information of some sort), or</li>
<li>we are social beings and want someone to talk to (conversation for conversation’s sake).</li>
</ul><p id="E1330">These three categories—which I call <em>transactional</em>, <em>informational</em>, and <em>prosocial</em>—also characterize essentially every <em>voice interaction</em>: a single conversation from beginning to end that realizes some outcome for the user, starting with the voice interface’s first greeting and ending with the user exiting the interface. Note here that a <em>conversation</em> in our human sense—a chat between people that leads to some result and lasts an arbitrary length of time—could encompass multiple transactional, informational, and prosocial voice interactions in succession. In other words, a voice interaction is a conversation, but a conversation is not necessarily a single voice interaction.</p>
<p id="E1346">Purely <em>prosocial</em> conversations are more gimmicky than captivating in most voice interfaces, because machines don’t yet have the capacity to <em>really</em> want to know how we’re doing and to do the sort of glad-handing humans crave. There’s also ongoing debate as to whether users actually prefer the sort of organic human conversation that begins with a prosocial voice interaction and shifts seamlessly into other types. In fact, in <em>Voice User Interface Design</em>, Michael Cohen, James Giangola, and Jennifer Balogh recommend sticking to users’ expectations by mimicking how they interact with other voice interfaces rather than trying too hard to be human—potentially alienating them in the process (<a href="http://bkaprt.com/vcu36/01-01" target="_blank" rel="noreferrer noopener">http://bkaprt.com/vcu36/01-01</a>).</p>
<p id="E1385">That leaves two genres of conversations we can have with one another that a voice interface can easily have with us, too: a <em>transactional</em> voice interaction realizing some outcome (“buy iced tea”) and an <em>informational</em> voice interaction teaching us something new (“discuss a musical”).</p>
<h2>Transactional voice interactions<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/voice-content-and-usability#section3">#section3</a></h2>
<p id="E1405">Unless you’re tapping buttons on a food delivery app, you’re generally having a conversation—and therefore a voice interaction—when you order a Hawaiian pizza with extra pineapple. Even when we walk up to the counter and place an order, the conversation quickly pivots from an initial smattering of neighborly small talk to the real mission at hand: ordering a pizza (generously topped with pineapple, as it should be).</p>
<blockquote class="wp-block-quote">
<p>Alison: Hey, how’s it going?</p>
<p>Burhan: Hi, welcome to Crust Deluxe! It’s cold out there. How can I help you?</p>
<p>Alison: Can I get a Hawaiian pizza with extra pineapple?</p>
<p>Burhan: Sure, what size?</p>
<p>Alison: Large.</p>
<p>Burhan: Anything else?</p>
<p>Alison: No thanks, that’s it.</p>
<p>Burhan: Something to drink?</p>
<p>Alison: I’ll have a bottle of Coke.</p>
<p>Burhan: You got it. That’ll be $13.55 and about fifteen minutes.</p>
</blockquote>
<p id="E1460">Each progressive disclosure in this <em>transactional</em> conversation reveals more and more of the desired outcome of the transaction: a service rendered or a product delivered. Transactional conversations have certain key traits: they’re direct, to the point, and economical. They quickly dispense with pleasantries.</p>
<h2>Informational voice interactions<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/voice-content-and-usability#section4">#section4</a></h2>
<p id="E1474">Meanwhile, some conversations are primarily about obtaining information. Though Alison might visit Crust Deluxe with the sole purpose of placing an order, she might not actually want to walk out with a pizza at all. She might be just as interested in whether they serve halal or kosher dishes, gluten-free options, or something else. Here, though we again have a prosocial mini-conversation at the beginning to establish politeness, we’re after much more.</p>
<blockquote class="wp-block-quote">
<p>Alison: Hey, how’s it going?</p>
<p>Burhan: Hi, welcome to Crust Deluxe! It’s cold out there. How can I help you?</p>
<p>Alison: Can I ask a few questions?</p>
<p>Burhan: Of course! Go right ahead.</p>
<p>Alison: Do you have any halal options on the menu?</p>
<p>Burhan: Absolutely! We can make any pie halal by request. We also have lots of vegetarian, ovo-lacto, and vegan options. Are you thinking about any other dietary restrictions?</p>
<p>Alison: What about gluten-free pizzas?</p>
<p>Burhan: We can definitely do a gluten-free crust for you, no problem, for both our deep-dish and thin-crust pizzas. Anything else I can answer for you?</p>
<p>Alison: That’s it for now. Good to know. Thanks!</p>
<p>Burhan: Anytime, come back soon!</p>
</blockquote>
<p id="E1546">This is a very different dialogue. Here, the goal is to get a certain set of facts. <em>I</em><em>nf</em><em>ormational</em> conversations are investigative quests for the truth—research expeditions to gather data, news, or facts. Voice interactions that are informational might be more long-winded than transactional conversations by necessity. Responses tend to be lengthier, more informative, and carefully communicated so the customer understands the key takeaways.</p>
<p id="E1564">At their core, <em>voice interfaces</em> employ speech to support users in reaching their goals. But simply because an interface has a voice component doesn’t mean that every user interaction with it is mediated through voice. Because multimodal voice interfaces can lean on visual components like screens as crutches, we’re most concerned in this book with <em>pure voice interfaces</em>, which depend entirely on spoken conversation, lack any visual component whatsoever, and are therefore much more nuanced and challenging to tackle.</p>
<p id="E1588">Though voice interfaces have long been integral to the imagined future of humanity in science fiction, only recently have those lofty visions become fully realized in genuine voice interfaces.</p>
<h3>Interactive voice response (IVR) systems<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/voice-content-and-usability#section6">#section6</a></h3>
<p id="E1595">Though written conversational interfaces have been fixtures of computing for many decades, voice interfaces first emerged in the early 1990s with text-to-speech (TTS) dictation programs that recited written text aloud, as well as speech-enabled in-car systems that gave directions to a user-provided address. With the advent of <em>interactive voice response</em> (IVR) systems, intended as an alternative to overburdened customer service representatives, we became acquainted with the first true voice interfaces that engaged in authentic conversation.</p>
<p id="E1620">IVR systems allowed organizations to reduce their reliance on call centers but soon became notorious for their clunkiness. Commonplace in the corporate world, these systems were primarily designed as metaphorical switchboards to guide customers to a real phone agent (“Say <em>R</em><em>eservations</em> to book a flight or check an itinerary”); chances are you will enter a conversation with one when you call an airline or hotel conglomerate. Despite their functional issues and users’ frustration with their inability to speak to an actual human right away, IVR systems proliferated in the early 1990s across a variety of industries (<a href="http://bkaprt.com/vcu36/01-02" target="_blank" rel="noreferrer noopener">http://bkaprt.com/vcu36/01-02</a>, PDF).</p>
<p id="E1655">While IVR systems are great for highly repetitive, monotonous conversations that generally don’t veer from a single format, they have a reputation for less scintillating conversation than we’re used to in real life (or even in science fiction).</p>
<h3>Screen readers<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/voice-content-and-usability#section7">#section7</a></h3>
<p id="E1668">Parallel to the evolution of IVR systems was the invention of the <em>screen reader</em>, a tool that transcribes visual content into synthesized speech. For Blind or visually impaired website users, it’s the predominant method of interacting with text, multimedia, or form elements. Screen readers represent perhaps the closest equivalent we have today to an out-of-the-box implementation of content delivered through voice.</p>
<p id="E1689">Among the first screen readers known by that moniker was the Screen Reader for the BBC Micro and NEEC Portable developed by the Research Centre for the Education of the Visually Handicapped (RCEVH) at the University of Birmingham in 1986 (<a href="http://bkaprt.com/vcu36/01-03" target="_blank" rel="noreferrer noopener">http://bkaprt.com/vcu36/01-03</a>). That same year, Jim Thatcher created the first IBM Screen Reader for text-based computers, later recreated for computers with graphical user interfaces (GUIs) (<a href="http://bkaprt.com/vcu36/01-04" target="_blank" rel="noreferrer noopener">http://bkaprt.com/vcu36/01-04</a>).</p>
<p id="E1702">With the rapid growth of the web in the 1990s, the demand for accessible tools for websites exploded. Thanks to the introduction of semantic HTML and especially ARIA roles beginning in 2008, screen readers started facilitating speedy interactions with web pages that ostensibly allow disabled users to traverse the page as an aural and temporal space rather than a visual and physical one. In other words, screen readers for the web “provide mechanisms that translate visual design constructs—proximity, proportion, etc.—into useful information,” writes Aaron Gustafson in <em>A List Apart</em>. “At least they do when documents are authored thoughtfully” (<a rel="noreferrer noopener" href="http://bkaprt.com/vcu36/01-05" target="_blank">http://bkaprt.com/vcu36/01-05</a>).</p>
<p id="E1735">Though deeply instructive for voice interface designers, there’s one significant problem with screen readers: they’re difficult to use and unremittingly verbose. The visual structures of websites and web navigation don’t translate well to screen readers, sometimes resulting in unwieldy pronouncements that name every manipulable HTML element and announce every formatting change. For many screen reader users, working with web-based interfaces exacts a cognitive toll.</p>
<p id="E1744">In <em>Wired</em>, accessibility advocate and voice engineer Chris Maury considers why the screen reader experience is ill-suited to users relying on voice:</p>
<blockquote class="wp-block-quote">
<p>From the beginning, I hated the way that Screen Readers work. Why are they designed the way they are? It makes no sense to present information visually and then, and only then, translate that into audio. All of the time and energy that goes into creating the perfect user experience for an app is wasted, or even worse, adversely impacting the experience for blind users. (<a rel="noreferrer noopener" href="http://bkaprt.com/vcu36/01-06" target="_blank">http://bkaprt.com/vcu36/01-06</a>)</p>
</blockquote>
<p id="E1759">In many cases, well-designed voice interfaces can speed users to their destination better than long-winded screen reader monologues. After all, visual interface users have the benefit of darting around the viewport freely to find information, ignoring areas irrelevant to them. Blind users, meanwhile, are obligated to listen to every utterance synthesized into speech and therefore prize brevity and efficiency. Disabled users who have long had no choice but to employ clunky screen readers may find that voice interfaces, particularly more modern voice assistants, offer a more streamlined experience.</p>
<h3>Voice assistants<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/voice-content-and-usability#section8">#section8</a></h3>
<p id="E1777">When we think of <em>voice assistants</em> (the subset of voice interfaces now commonplace in living rooms, smart homes, and offices), many of us immediately picture HAL from <em>2001: A Space Odyssey</em> or hear Majel Barrett’s voice as the omniscient computer in <em>Star Trek</em>. Voice assistants are akin to personal concierges that can answer questions, schedule appointments, conduct searches, and perform other common day-to-day tasks. And they’re rapidly gaining more attention from accessibility advocates for their assistive potential.</p>
<p id="E1805">Before the earliest IVR systems found success in the enterprise, Apple published a demonstration video in 1987 depicting the Knowledge Navigator, a voice assistant that could transcribe spoken words and recognize human speech to a great degree of accuracy. Then, in 2001, Tim Berners-Lee and others formulated their vision for a Semantic Web “agent” that would perform typical errands like “checking calendars, making appointments, and finding locations” (<a href="http://bkaprt.com/vcu36/01-07" target="_blank" rel="noreferrer noopener">http://bkaprt.com/vcu36/01-07</a>, behind paywall). It wasn’t until 2011 that Apple’s Siri finally entered the picture, making voice assistants a tangible reality for consumers.</p>
<p id="E1822">Thanks to the plethora of voice assistants available today, there is considerable variation in how programmable and customizable certain voice assistants are over others (<strong>Fig 1.1</strong>). At one extreme, everything except vendor-provided features is locked down; for example, at the time of their release, the core functionality of Apple’s Siri and Microsoft’s Cortana couldn’t be extended beyond their existing capabilities. Even today, it isn’t possible to program Siri to perform arbitrary functions, because there’s no means by which developers can interact with Siri at a low level, apart from predefined categories of tasks like sending messages, hailing rideshares, making restaurant reservations, and certain others.</p>
<p id="E1854">At the opposite end of the spectrum, voice assistants like Amazon Alexa and Google Home offer a core foundation on which developers can build custom voice interfaces. For this reason, programmable voice assistants that lend themselves to customization and extensibility are becoming increasingly popular for developers who feel stifled by the limitations of Siri and Cortana. Amazon offers the Alexa Skills Kit, a developer framework for building custom voice interfaces for Amazon Alexa, while Google Home offers the ability to program arbitrary Google Assistant skills. Today, users can choose from among thousands of custom-built skills within both the Amazon Alexa and Google Assistant ecosystems.</p>
<figure class="wp-block-image size-large"><img width="2160" height="1161" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/07/1.1-Voice-assistant-programmability.png?resize=1024,550" alt="" class="wp-image-7173070" /><figcaption><strong>Fig 1.1</strong>: Voice assistants like Amazon Alexa and Google Home tend to be more programmable, and thus more flexible, than their counterpart Apple Siri.</figcaption></figure><p id="E1890">As corporations like Amazon, Apple, Microsoft, and Google continue to stake their territory, they’re also selling and open-sourcing an unprecedented array of tools and frameworks for designers and developers that aim to make building voice interfaces as easy as possible, even without code.</p>
<p id="E1906">Often by necessity, voice assistants like Amazon Alexa tend to be <em>monochannel</em>—they’re tightly coupled to a device and can’t be accessed on a computer or smartphone instead. By contrast, many development platforms like Google’s Dialogflow have introduced <em>omnichannel</em> capabilities so users can build a single conversational interface that then manifests as a voice interface, textual chatbot, and IVR system upon deployment. I don’t prescribe any specific implementation approaches in this design-focused book, but in Chapter 4 we’ll get into some of the implications these variables might have on the way you build out your design artifacts.</p>
<p id="E1954">Simply put, <em>voice content</em> is content delivered through voice. To preserve what makes human conversation so compelling in the first place, voice content needs to be free-flowing and organic, contextless and concise—everything written content isn’t.</p>
<p id="E1966">Our world is replete with voice content in various forms: screen readers reciting website content, voice assistants rattling off a weather forecast, and automated phone hotline responses governed by IVR systems. In this book, we’re most concerned with content delivered auditorily—not as an option, but as a necessity.</p>
<p id="E1973">For many of us, our first foray into informational voice interfaces will be to deliver content to users. There’s only one problem: any content we already have isn’t in any way ready for this new habitat. So how do we make the content trapped on our websites more conversational? And how do we write new copy that lends itself to voice interactions?</p>
<p id="E1980">Lately, we’ve begun slicing and dicing our content in unprecedented ways. Websites are, in many respects, colossal vaults of what I call <em>macrocontent</em>: lengthy prose that can extend for infinitely scrollable miles in a browser window, like microfilm viewers of newspaper archives. Back in 2002, well before the present-day ubiquity of voice assistants, technologist Anil Dash defined <em>microcontent</em> as permalinked pieces of content that stay legible regardless of environment, such as email or text messages:</p>
<blockquote class="wp-block-quote">
<p>A day’s weather forcast [<em>sic</em>], the arrival and departure times for an airplane flight, an abstract from a long publication, or a single instant message can all be examples of microcontent. (<a rel="noreferrer noopener" href="http://bkaprt.com/vcu36/01-08" target="_blank">http://bkaprt.com/vcu36/01-08</a>)</p>
</blockquote>
<p id="E2017">I’d update Dash’s definition of microcontent to include all examples of bite-sized content that go well beyond written communiqués. After all, today we encounter microcontent in interfaces where a small snippet of copy is displayed alone, unmoored from the browser, like a textbot confirmation of a restaurant reservation. Microcontent offers the best opportunity to gauge how your content can be stretched to the very edges of its capabilities, informing delivery channels both established and novel.</p>
<p id="E2050">As microcontent, voice content is unique because it’s an example of how content is experienced in <em>time</em> rather than in <em>space</em>. We can glance at a digital sign underground for an instant and know when the next train is arriving, but voice interfaces hold our attention captive for periods of time that we can’t easily escape or skip, something screen reader users are all too familiar with.</p>
<p id="E2064">Because microcontent is fundamentally made up of isolated blobs with no relation to the channels where they’ll eventually end up, we need to ensure that our microcontent truly performs well as voice content—and that means focusing on the two most important traits of robust voice content: <em>voice content legibility</em> and <em>voice content discoverability</em>.</p>
<p id="E1174">Fundamentally, the legibility and discoverability of our voice content both have to do with how voice content manifests in perceived time and space.</p>]]></description>
      <link>https://alistapart-production.mystagingwebsite.com/article/voice-content-and-usability/</link>
      <guid>https://alistapart-production.mystagingwebsite.com/article/voice-content-and-usability/</guid>
      <pubDate>Thu, 29 Jul 2021 15:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Voice Content and Usability]]></title>
      <description><![CDATA[<p id="E1205">We’ve been having conversations for thousands of years. Whether to convey information, conduct transactions, or simply to check in on one another, people have yammered away, chattering and gesticulating, through spoken conversation for countless generations. Only in the last few millennia have we begun to commit our conversations to writing, and only in the last few decades have we begun to outsource them to the computer, a machine that shows much more affinity for written correspondence than for the slangy vagaries of spoken language.</p>


<p id="E1222">Computers have trouble because between spoken and written language, speech is more primordial. To have successful conversations with us, machines must grapple with the messiness of human speech: the disfluencies and pauses, the gestures and body language, and the variations in word choice and spoken dialect that can stymie even the most carefully crafted human-computer interaction. In the human-to-human scenario, spoken language also has the privilege of face-to-face contact, where we can readily interpret nonverbal social cues.</p>
<p id="E1233">In contrast, written language immediately concretizes as we commit it to record and retains usages long after they become obsolete in spoken communication (the salutation “To whom it may concern,” for example), generating its own fossil record of outdated terms and phrases. Because it tends to be more consistent, polished, and formal, written text is fundamentally much easier for machines to parse and understand.</p>
<p id="E1257">Spoken language has no such luxury. Besides the nonverbal cues that decorate conversations with emphasis and emotional context, there are also verbal cues and vocal behaviors that modulate conversation in nuanced ways: <em>how</em> something is said, not <em>what</em>. Whether rapid-fire, low-pitched, or high-decibel, whether sarcastic, stilted, or sighing, our spoken language conveys much more than the written word could ever muster. So when it comes to voice interfaces—the machines we conduct spoken conversations with—we face exciting challenges as designers and content strategists.</p>
<h2 id="section2">Voice Interactions</h2>
<p id="E1289">We interact with voice interfaces for a variety of reasons, but according to Michael McTear, Zoraida Callejas, and David Griol in <em>The Conversational Interface</em>, those motivations by and large mirror the reasons we initiate conversations with other people, too (<a href="http://bkaprt.com/vcu36/01-01" target="_blank" rel="noreferrer noopener">http://bkaprt.com/vcu36/01-01</a>). Generally, we start up a conversation because:</p>
<ul><li>we need something done (such as a transaction),</li>
<li>we want to know something (information of some sort), or</li>
<li>we are social beings and want someone to talk to (conversation for conversation’s sake).</li>
</ul><p id="E1330">These three categories—which I call <em>transactional</em>, <em>informational</em>, and <em>prosocial</em>—also characterize essentially every <em>voice interaction</em>: a single conversation from beginning to end that realizes some outcome for the user, starting with the voice interface’s first greeting and ending with the user exiting the interface. Note here that a <em>conversation</em> in our human sense—a chat between people that leads to some result and lasts an arbitrary length of time—could encompass multiple transactional, informational, and prosocial voice interactions in succession. In other words, a voice interaction is a conversation, but a conversation is not necessarily a single voice interaction.</p>
<p id="E1346">Purely <em>prosocial</em> conversations are more gimmicky than captivating in most voice interfaces, because machines don’t yet have the capacity to <em>really</em> want to know how we’re doing and to do the sort of glad-handing humans crave. There’s also ongoing debate as to whether users actually prefer the sort of organic human conversation that begins with a prosocial voice interaction and shifts seamlessly into other types. In fact, in <em>Voice User Interface Design</em>, Michael Cohen, James Giangola, and Jennifer Balogh recommend sticking to users’ expectations by mimicking how they interact with other voice interfaces rather than trying too hard to be human—potentially alienating them in the process (<a href="http://bkaprt.com/vcu36/01-01" target="_blank" rel="noreferrer noopener">http://bkaprt.com/vcu36/01-01</a>).</p>
<p id="E1385">That leaves two genres of conversations we can have with one another that a voice interface can easily have with us, too: a <em>transactional</em> voice interaction realizing some outcome (“buy iced tea”) and an <em>informational</em> voice interaction teaching us something new (“discuss a musical”).</p>
<h2 id="section3">Transactional voice interactions</h2>
<p id="E1405">Unless you’re tapping buttons on a food delivery app, you’re generally having a conversation—and therefore a voice interaction—when you order a Hawaiian pizza with extra pineapple. Even when we walk up to the counter and place an order, the conversation quickly pivots from an initial smattering of neighborly small talk to the real mission at hand: ordering a pizza (generously topped with pineapple, as it should be).</p>
<blockquote class="wp-block-quote">
<p>Alison: Hey, how’s it going?</p>
<p>Burhan: Hi, welcome to Crust Deluxe! It’s cold out there. How can I help you?</p>
<p>Alison: Can I get a Hawaiian pizza with extra pineapple?</p>
<p>Burhan: Sure, what size?</p>
<p>Alison: Large.</p>
<p>Burhan: Anything else?</p>
<p>Alison: No thanks, that’s it.</p>
<p>Burhan: Something to drink?</p>
<p>Alison: I’ll have a bottle of Coke.</p>
<p>Burhan: You got it. That’ll be $13.55 and about fifteen minutes.</p>
</blockquote>
<p id="E1460">Each progressive disclosure in this <em>transactional</em> conversation reveals more and more of the desired outcome of the transaction: a service rendered or a product delivered. Transactional conversations have certain key traits: they’re direct, to the point, and economical. They quickly dispense with pleasantries.</p>
<h2 id="section4">Informational voice interactions</h2>
<p id="E1474">Meanwhile, some conversations are primarily about obtaining information. Though Alison might visit Crust Deluxe with the sole purpose of placing an order, she might not actually want to walk out with a pizza at all. She might be just as interested in whether they serve halal or kosher dishes, gluten-free options, or something else. Here, though we again have a prosocial mini-conversation at the beginning to establish politeness, we’re after much more.</p>
<blockquote class="wp-block-quote">
<p>Alison: Hey, how’s it going?</p>
<p>Burhan: Hi, welcome to Crust Deluxe! It’s cold out there. How can I help you?</p>
<p>Alison: Can I ask a few questions?</p>
<p>Burhan: Of course! Go right ahead.</p>
<p>Alison: Do you have any halal options on the menu?</p>
<p>Burhan: Absolutely! We can make any pie halal by request. We also have lots of vegetarian, ovo-lacto, and vegan options. Are you thinking about any other dietary restrictions?</p>
<p>Alison: What about gluten-free pizzas?</p>
<p>Burhan: We can definitely do a gluten-free crust for you, no problem, for both our deep-dish and thin-crust pizzas. Anything else I can answer for you?</p>
<p>Alison: That’s it for now. Good to know. Thanks!</p>
<p>Burhan: Anytime, come back soon!</p>
</blockquote>
<p id="E1546">This is a very different dialogue. Here, the goal is to get a certain set of facts. <em>I</em><em>nf</em><em>ormational</em> conversations are investigative quests for the truth—research expeditions to gather data, news, or facts. Voice interactions that are informational might be more long-winded than transactional conversations by necessity. Responses tend to be lengthier, more informative, and carefully communicated so the customer understands the key takeaways.</p>
<h2 id="section5">Voice Interfaces</h2>
<p id="E1564">At their core, <em>voice interfaces</em> employ speech to support users in reaching their goals. But simply because an interface has a voice component doesn’t mean that every user interaction with it is mediated through voice. Because multimodal voice interfaces can lean on visual components like screens as crutches, we’re most concerned in this book with <em>pure voice interfaces</em>, which depend entirely on spoken conversation, lack any visual component whatsoever, and are therefore much more nuanced and challenging to tackle.</p>
<p id="E1588">Though voice interfaces have long been integral to the imagined future of humanity in science fiction, only recently have those lofty visions become fully realized in genuine voice interfaces.</p>
<h3 id="section6">Interactive voice response (IVR) systems</h3>
<p id="E1595">Though written conversational interfaces have been fixtures of computing for many decades, voice interfaces first emerged in the early 1990s with text-to-speech (TTS) dictation programs that recited written text aloud, as well as speech-enabled in-car systems that gave directions to a user-provided address. With the advent of <em>interactive voice response</em> (IVR) systems, intended as an alternative to overburdened customer service representatives, we became acquainted with the first true voice interfaces that engaged in authentic conversation.</p>
<p id="E1620">IVR systems allowed organizations to reduce their reliance on call centers but soon became notorious for their clunkiness. Commonplace in the corporate world, these systems were primarily designed as metaphorical switchboards to guide customers to a real phone agent (“Say <em>R</em><em>eservations</em> to book a flight or check an itinerary”); chances are you will enter a conversation with one when you call an airline or hotel conglomerate. Despite their functional issues and users’ frustration with their inability to speak to an actual human right away, IVR systems proliferated in the early 1990s across a variety of industries (<a href="http://bkaprt.com/vcu36/01-02" target="_blank" rel="noreferrer noopener">http://bkaprt.com/vcu36/01-02</a>, PDF).</p>
<p id="E1655">While IVR systems are great for highly repetitive, monotonous conversations that generally don’t veer from a single format, they have a reputation for less scintillating conversation than we’re used to in real life (or even in science fiction).</p>
<h3 id="section7">Screen readers</h3>
<p id="E1668">Parallel to the evolution of IVR systems was the invention of the <em>screen reader</em>, a tool that transcribes visual content into synthesized speech. For Blind or visually impaired website users, it’s the predominant method of interacting with text, multimedia, or form elements. Screen readers represent perhaps the closest equivalent we have today to an out-of-the-box implementation of content delivered through voice.</p>
<p id="E1689">Among the first screen readers known by that moniker was the Screen Reader for the BBC Micro and NEEC Portable developed by the Research Centre for the Education of the Visually Handicapped (RCEVH) at the University of Birmingham in 1986 (<a href="http://bkaprt.com/vcu36/01-03" target="_blank" rel="noreferrer noopener">http://bkaprt.com/vcu36/01-03</a>). That same year, Jim Thatcher created the first IBM Screen Reader for text-based computers, later recreated for computers with graphical user interfaces (GUIs) (<a href="http://bkaprt.com/vcu36/01-04" target="_blank" rel="noreferrer noopener">http://bkaprt.com/vcu36/01-04</a>).</p>
<p id="E1702">With the rapid growth of the web in the 1990s, the demand for accessible tools for websites exploded. Thanks to the introduction of semantic HTML and especially ARIA roles beginning in 2008, screen readers started facilitating speedy interactions with web pages that ostensibly allow disabled users to traverse the page as an aural and temporal space rather than a visual and physical one. In other words, screen readers for the web “provide mechanisms that translate visual design constructs—proximity, proportion, etc.—into useful information,” writes Aaron Gustafson in <em>A List Apart</em>. “At least they do when documents are authored thoughtfully” (<a rel="noreferrer noopener" href="http://bkaprt.com/vcu36/01-05" target="_blank">http://bkaprt.com/vcu36/01-05</a>).</p>
<p id="E1735">Though deeply instructive for voice interface designers, there’s one significant problem with screen readers: they’re difficult to use and unremittingly verbose. The visual structures of websites and web navigation don’t translate well to screen readers, sometimes resulting in unwieldy pronouncements that name every manipulable HTML element and announce every formatting change. For many screen reader users, working with web-based interfaces exacts a cognitive toll.</p>
<p id="E1744">In <em>Wired</em>, accessibility advocate and voice engineer Chris Maury considers why the screen reader experience is ill-suited to users relying on voice:</p>
<blockquote class="wp-block-quote">
<p>From the beginning, I hated the way that Screen Readers work. Why are they designed the way they are? It makes no sense to present information visually and then, and only then, translate that into audio. All of the time and energy that goes into creating the perfect user experience for an app is wasted, or even worse, adversely impacting the experience for blind users. (<a rel="noreferrer noopener" href="http://bkaprt.com/vcu36/01-06" target="_blank">http://bkaprt.com/vcu36/01-06</a>)</p>
</blockquote>
<p id="E1759">In many cases, well-designed voice interfaces can speed users to their destination better than long-winded screen reader monologues. After all, visual interface users have the benefit of darting around the viewport freely to find information, ignoring areas irrelevant to them. Blind users, meanwhile, are obligated to listen to every utterance synthesized into speech and therefore prize brevity and efficiency. Disabled users who have long had no choice but to employ clunky screen readers may find that voice interfaces, particularly more modern voice assistants, offer a more streamlined experience.</p>
<h3 id="section8">Voice assistants</h3>
<p id="E1777">When we think of <em>voice assistants</em> (the subset of voice interfaces now commonplace in living rooms, smart homes, and offices), many of us immediately picture HAL from <em>2001: A Space Odyssey</em> or hear Majel Barrett’s voice as the omniscient computer in <em>Star Trek</em>. Voice assistants are akin to personal concierges that can answer questions, schedule appointments, conduct searches, and perform other common day-to-day tasks. And they’re rapidly gaining more attention from accessibility advocates for their assistive potential.</p>
<p id="E1805">Before the earliest IVR systems found success in the enterprise, Apple published a demonstration video in 1987 depicting the Knowledge Navigator, a voice assistant that could transcribe spoken words and recognize human speech to a great degree of accuracy. Then, in 2001, Tim Berners-Lee and others formulated their vision for a Semantic Web “agent” that would perform typical errands like “checking calendars, making appointments, and finding locations” (<a href="http://bkaprt.com/vcu36/01-07" target="_blank" rel="noreferrer noopener">http://bkaprt.com/vcu36/01-07</a>, behind paywall). It wasn’t until 2011 that Apple’s Siri finally entered the picture, making voice assistants a tangible reality for consumers.</p>
<p id="E1822">Thanks to the plethora of voice assistants available today, there is considerable variation in how programmable and customizable certain voice assistants are over others (<strong>Fig 1.1</strong>). At one extreme, everything except vendor-provided features is locked down; for example, at the time of their release, the core functionality of Apple’s Siri and Microsoft’s Cortana couldn’t be extended beyond their existing capabilities. Even today, it isn’t possible to program Siri to perform arbitrary functions, because there’s no means by which developers can interact with Siri at a low level, apart from predefined categories of tasks like sending messages, hailing rideshares, making restaurant reservations, and certain others.</p>
<p id="E1854">At the opposite end of the spectrum, voice assistants like Amazon Alexa and Google Home offer a core foundation on which developers can build custom voice interfaces. For this reason, programmable voice assistants that lend themselves to customization and extensibility are becoming increasingly popular for developers who feel stifled by the limitations of Siri and Cortana. Amazon offers the Alexa Skills Kit, a developer framework for building custom voice interfaces for Amazon Alexa, while Google Home offers the ability to program arbitrary Google Assistant skills. Today, users can choose from among thousands of custom-built skills within both the Amazon Alexa and Google Assistant ecosystems.</p>
<figure id="figure1" class="wp-block-image size-large"><img width="960" height="516" src="https://alistapart.com/wp-content/uploads/2021/07/1.1-Voice-assistant-programmability.png?resize=960%2C516" alt="" class="wp-image-7173070" data-recalc-dims="1" /><figcaption><strong>Fig 1.1</strong>: Voice assistants like Amazon Alexa and Google Home tend to be more programmable, and thus more flexible, than their counterpart Apple Siri.</figcaption></figure><p id="E1890">As corporations like Amazon, Apple, Microsoft, and Google continue to stake their territory, they’re also selling and open-sourcing an unprecedented array of tools and frameworks for designers and developers that aim to make building voice interfaces as easy as possible, even without code.</p>
<p id="E1906">Often by necessity, voice assistants like Amazon Alexa tend to be <em>monochannel</em>—they’re tightly coupled to a device and can’t be accessed on a computer or smartphone instead. By contrast, many development platforms like Google’s Dialogflow have introduced <em>omnichannel</em> capabilities so users can build a single conversational interface that then manifests as a voice interface, textual chatbot, and IVR system upon deployment. I don’t prescribe any specific implementation approaches in this design-focused book, but in Chapter 4 we’ll get into some of the implications these variables might have on the way you build out your design artifacts.</p>
<h2 id="section9">Voice Content</h2>
<p id="E1954">Simply put, <em>voice content</em> is content delivered through voice. To preserve what makes human conversation so compelling in the first place, voice content needs to be free-flowing and organic, contextless and concise—everything written content isn’t.</p>
<p id="E1966">Our world is replete with voice content in various forms: screen readers reciting website content, voice assistants rattling off a weather forecast, and automated phone hotline responses governed by IVR systems. In this book, we’re most concerned with content delivered auditorily—not as an option, but as a necessity.</p>
<p id="E1973">For many of us, our first foray into informational voice interfaces will be to deliver content to users. There’s only one problem: any content we already have isn’t in any way ready for this new habitat. So how do we make the content trapped on our websites more conversational? And how do we write new copy that lends itself to voice interactions?</p>
<p id="E1980">Lately, we’ve begun slicing and dicing our content in unprecedented ways. Websites are, in many respects, colossal vaults of what I call <em>macrocontent</em>: lengthy prose that can extend for infinitely scrollable miles in a browser window, like microfilm viewers of newspaper archives. Back in 2002, well before the present-day ubiquity of voice assistants, technologist Anil Dash defined <em>microcontent</em> as permalinked pieces of content that stay legible regardless of environment, such as email or text messages:</p>
<blockquote class="wp-block-quote">
<p>A day’s weather forcast [<em>sic</em>], the arrival and departure times for an airplane flight, an abstract from a long publication, or a single instant message can all be examples of microcontent. (<a rel="noreferrer noopener" href="http://bkaprt.com/vcu36/01-08" target="_blank">http://bkaprt.com/vcu36/01-08</a>)</p>
</blockquote>
<p id="E2017">I’d update Dash’s definition of microcontent to include all examples of bite-sized content that go well beyond written communiqués. After all, today we encounter microcontent in interfaces where a small snippet of copy is displayed alone, unmoored from the browser, like a textbot confirmation of a restaurant reservation. Microcontent offers the best opportunity to gauge how your content can be stretched to the very edges of its capabilities, informing delivery channels both established and novel.</p>
<p id="E2050">As microcontent, voice content is unique because it’s an example of how content is experienced in <em>time</em> rather than in <em>space</em>. We can glance at a digital sign underground for an instant and know when the next train is arriving, but voice interfaces hold our attention captive for periods of time that we can’t easily escape or skip, something screen reader users are all too familiar with.</p>
<p id="E2064">Because microcontent is fundamentally made up of isolated blobs with no relation to the channels where they’ll eventually end up, we need to ensure that our microcontent truly performs well as voice content—and that means focusing on the two most important traits of robust voice content: <em>voice content legibility</em> and <em>voice content discoverability</em>.</p>
<p id="E1174">Fundamentally, the legibility and discoverability of our voice content both have to do with how voice content manifests in perceived time and space.</p>]]></description>
      <link>https://alistapart.com/article/voice-content-and-usability/</link>
      <guid>https://alistapart.com/article/voice-content-and-usability/</guid>
      <pubDate>Thu, 29 Jul 2021 15:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Designing for the Unexpected]]></title>
      <description><![CDATA[<p>I’m not sure when I first heard this quote, but it’s something that has stayed with me over the years. How do you create services for situations you can’t imagine? Or design products that work on devices yet to be invented?</p><div class="aside-breaker">Article Continues Below</div>
<h2>Flash, Photoshop, and responsive design<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/designing-for-the-unexpected#section2">#section2</a></h2>
<p>When I first started designing websites, my go-to software was Photoshop. I created a 960px canvas and set about creating a layout that I would later drop content in. The development phase was about attaining pixel-perfect accuracy using fixed widths, fixed heights, and absolute positioning.</p>
<p>Ethan Marcotte’s talk at An Event Apart and subsequent article “<a href="https://alistapart-production.mystagingwebsite.com/article/responsive-web-design/">Responsive Web Design</a>” in <em>A List Apart</em> in 2010 changed all this. I was sold on responsive design as soon as I heard about it, but I was also terrified. The pixel-perfect designs full of magic numbers that I had previously prided myself on producing were no longer good enough.</p>
<p>The fear wasn’t helped by my first experience with responsive design. My first project was to take an existing fixed-width website and make it responsive. What I learned the hard way was that you can’t just add responsiveness at the end of a project. To create fluid layouts, you need to plan throughout the design phase.</p>
<h3>A new way to design<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/designing-for-the-unexpected#section3">#section3</a></h3>
<p>Designing responsive or fluid sites has always been about removing limitations, producing content that can be viewed on any device. It relies on the use of percentage-based layouts, which I initially achieved with native CSS and utility classes:</p>
<pre class="language-css">.column-span-6 {
  width: 49%;
  float: left;
  margin-right: 0.5%;
  margin-left: 0.5%;
}
.column-span-4 {
  width: 32%;
  float: left;
  margin-right: 0.5%;
  margin-left: 0.5%;
}
.column-span-3 {
  width: 24%;
  float: left;
  margin-right: 0.5%;
  margin-left: 0.5%;
}</pre>
<p>Then with Sass so I could take advantage of @includes to re-use repeated blocks of code and move back to more semantic markup:</p>
<pre class="language-css">.logo {
  @include colSpan(6);
}
.search {
  @include colSpan(3);
}
.social-share {
  @include colSpan(3);
}</pre>
<h3>Media queries<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/designing-for-the-unexpected#section4">#section4</a></h3>
<p>The second ingredient for responsive design is media queries. Without them, content would shrink to fit the available space regardless of whether that content remained readable (The exact opposite problem occurred with the introduction of a mobile-first approach).</p>
<figure class="wp-block-image size-large"><img width="652" height="435" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/07/image5.png?w=652" alt="Wireframes showing three boxes at a large size, and three very narrow boxes at a mobile size" class="wp-image-7173046" /><figcaption>Components becoming too small at mobile breakpoints</figcaption></figure><p>Media queries prevented this by allowing us to add breakpoints where the design could adapt. Like most people, I started out with three breakpoints: one for desktop, one for tablets, and one for mobile. Over the years, I added more and more for phablets, wide screens, and so on. </p>
<p>For years, I happily worked this way and improved both my design and front-end skills in the process. The only problem I encountered was making changes to content, since with our Sass grid system in place, there was no way for the site owners to add content without amending the markup—something a small business owner might struggle with. This is because each row in the grid was defined using a <strong><code>div</code></strong> as a container. Adding content meant creating new row markup, which requires a level of HTML knowledge.</p>
<p>Row markup was a staple of early responsive design, present in all the widely used frameworks like Bootstrap and Skeleton.</p>
<pre class="language-markup">&lt;section class="row"&gt;
  &lt;div class="column-span-4"&gt;1 of 7&lt;/div&gt;
  &lt;div class="column-span-4"&gt;2 of 7&lt;/div&gt;
  &lt;div class="column-span-4"&gt;3 of 7&lt;/div&gt;
&lt;/section&gt;
&lt;section class="row"&gt;
  &lt;div class="column-span-4"&gt;4 of 7&lt;/div&gt;
  &lt;div class="column-span-4"&gt;5 of 7&lt;/div&gt;
  &lt;div class="column-span-4"&gt;6 of 7&lt;/div&gt;
&lt;/section&gt;
&lt;section class="row"&gt;
  &lt;div class="column-span-4"&gt;7 of 7&lt;/div&gt;
&lt;/section&gt;</pre>
<figure class="wp-block-image size-large"><img width="451" height="435" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/07/image10.png?w=451" alt="Wireframe showing three rows of boxes" class="wp-image-7173051" /><figcaption>Components placed in the rows of a Sass grid</figcaption></figure><p>Another problem arose as I moved from a design agency building websites for small- to medium-sized businesses, to larger in-house teams where I worked across a suite of related sites. In those roles I started to work much more with reusable components. </p>
<p>Our reliance on media queries resulted in components that were tied to common viewport sizes. If the goal of component libraries is reuse, then this is a real problem because you can only use these components if the devices you’re designing for correspond to the viewport sizes used in the pattern library—in the process not really hitting that “devices that don’t yet exist”goal.</p>
<p>Then there’s the problem of space. Media queries allow components to adapt based on the viewport size, but what if I put a component into a sidebar, like in the figure below?</p>
<figure class="wp-block-image size-large"><img width="1144" height="435" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/07/image8.png?w=960" alt="Wireframes showing different configurations of boxes at three different sizes" class="wp-image-7173049" /><figcaption>Components responding to the viewport width with media queries</figcaption></figure><h3>Container queries: our savior or a false dawn?<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/designing-for-the-unexpected#section5">#section5</a></h3>
<p>Container queries have long been touted as an improvement upon media queries, but at the time of writing are unsupported in most browsers. There are JavaScript workarounds, but they can create dependency and compatibility issues. The basic theory underlying container queries is that elements should change based on the size of their parent container and not the viewport width, as seen in the following illustrations.</p>
<figure class="wp-block-image size-large"><img width="951" height="435" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/07/image11.png?w=951" alt="Wireframes showing different configurations of boxes at different sizes" class="wp-image-7173052" /><figcaption>Components responding to their parent container with container queries</figcaption></figure><p>One of the biggest arguments in favor of container queries is that they help us create components or design patterns that are truly reusable because they can be picked up and placed anywhere in a layout. This is an important step in moving toward a form of component-based design that works at any size on any device.</p>
<p>In other words, responsive components to replace responsive layouts.</p>
<p>Container queries will help us move from designing pages that respond to the browser or device size to designing components that can be placed in a sidebar or in the main content, and respond accordingly.</p>
<p>My concern is that we are still using layout to determine when a design needs to adapt. This approach will always be restrictive, as we will still need pre-defined breakpoints. For this reason, my main question with container queries is, How would we decide when to change the CSS used by a component? </p>
<p>A component library removed from context and real content is probably not the best place for that decision. </p>
<p>As the diagrams below illustrate, we can use container queries to create designs for specific container widths, but what if I want to change the design based on the image size or ratio?</p>
<figure class="wp-block-image size-large"><img width="905" height="423" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/07/image4.png?w=905" alt="Wireframes showing different layouts at 600px and 400px" class="wp-image-7173045" /><figcaption>Cards responding to their parent container with container queries</figcaption></figure><figure class="wp-block-image size-large"><img width="1094" height="423" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/07/image7.png?w=960" alt="Wireframes showing different configurations of content at the same size" class="wp-image-7173048" /><figcaption>Cards responding based on their own content</figcaption></figure><p>In this example, the dimensions of the container are not what should dictate the design; rather, the image is.</p>
<p>It’s hard to say for sure whether container queries will be a success story until we have solid cross-browser support for them. Responsive component libraries would definitely evolve how we design and would improve the possibilities for reuse and design at scale. But maybe we will always need to adjust these components to suit our content.</p>
<h3>CSS is changing<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/designing-for-the-unexpected#section6">#section6</a></h3>
<p>Whilst the container query debate rumbles on, there have been numerous advances in CSS that change the way we think about design. The days of fixed-width elements measured in pixels and floated <strong><code>div</code></strong> elements used to cobble layouts together are long gone, consigned to history along with table layouts. Flexbox and CSS Grid have revolutionized layouts for the web. We can now create elements that wrap onto new rows when they run out of space, not when the device changes.</p>
<pre class="language-css">.wrapper {
  display: grid;
  grid-template-columns: repeat(auto-fit, 450px);
  gap: 10px;
}</pre>
<p>The <strong><code>repeat()</code></strong> function paired with <strong><code>auto-fit</code></strong> or <strong><code>auto-fill</code></strong> allows us to specify how much space each column should use while leaving it up to the browser to decide when to spill the columns onto a new line. Similar things can be achieved with Flexbox, as elements can wrap over multiple rows and “flex” to fill available space. </p>
<pre class="language-css">.wrapper {
  display: flex;
  flex-wrap: wrap;
  justify-content: space-between;
}
.child {
  flex-basis: 32%;
  margin-bottom: 20px;
}</pre>
<p>The biggest benefit of all this is you don’t need to wrap elements in container rows. Without rows, content isn’t tied to page markup in quite the same way, allowing for removals or additions of content without additional development.</p>
<figure class="wp-block-image size-large"><img width="451" height="435" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/07/image13.png?w=451" alt="A wireframe showing seven boxes in a larger container" class="wp-image-7173054" /><figcaption>A traditional Grid layout without the usual row containers</figcaption></figure><p>This is a big step forward when it comes to creating designs that allow for evolving content, but the real game changer for flexible designs is CSS Subgrid. </p>
<p>Remember the days of crafting perfectly aligned interfaces, only for the customer to add an unbelievably long header almost as soon as they’re given CMS access, like the illustration below?</p>
<figure id="figure8" class="wp-block-image size-large"><img width="932" height="233" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/07/image1.png?w=932" alt="" class="wp-image-7173042" /><figcaption><em>Cards unable to respond to a sibling’s content changes</em></figcaption></figure><p>Subgrid allows elements to respond to adjustments in their own content and in the content of sibling elements, helping us create designs more resilient to change.</p>
<figure id="figure9" class="wp-block-image size-large"><img width="932" height="490" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/07/image9.png?w=932" alt="Wireframes showing several boxes with the contents aligned across boxes" class="wp-image-7173050" /><figcaption>Cards responding to content in sibling cards</figcaption></figure><pre class="language-css">.wrapper {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(150px, 1fr));
     grid-template-rows: auto 1fr auto;
  gap: 10px;
}
.sub-grid {
  display: grid;
  grid-row: span 3;
  grid-template-rows: subgrid; /* sets rows to parent grid */
}</pre>
<p>CSS Grid allows us to separate layout and content, thereby enabling flexible designs. Meanwhile, Subgrid allows us to create designs that can adapt in order to suit morphing content. Subgrid at the time of writing is only supported in Firefox but the above code can be implemented behind an @supports feature query. </p>
<h3>Intrinsic layouts <a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/designing-for-the-unexpected#section7">#section7</a></h3>
<p>I’d be remiss not to mention <a href="https://aneventapart.com/news/post/designing-intrinsic-layouts-aea-video"><em>intrinsic layouts</em></a>, the term created by Jen Simmons to describe a mixture of new and old CSS features used to create layouts that respond to available space. </p>
<p>Responsive layouts have flexible columns using percentages. Intrinsic layouts, on the other hand, use the <strong>fr</strong> unit to create flexible columns that won’t ever shrink so much that they render the content illegible.</p>
<p><strong><em><code>fr</code></em></strong> <em>units is a way to say I want you to distribute the extra space in this way, but…don’t ever make it smaller than the content that’s inside of it.</em></p>
<p><em>—Jen Simmons, “Designing Intrinsic Layouts”</em></p>
<p>Intrinsic layouts can also utilize a mixture of fixed and flexible units, allowing the content to dictate the space it takes up.</p>
<figure id="figure10" class="wp-block-image size-large"><img width="1999" height="737" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/07/image12.png?w=960" alt="A slide from a presentation showing two boxes with max content and one with auto" class="wp-image-7173053" /><figcaption>Slide from “Designing Intrinsic Layouts” by Jen Simmons</figcaption></figure><p>What makes intrinsic design stand out is that it not only creates designs that can withstand future devices but also helps scale design without losing flexibility. Components and patterns can be lifted and reused without the prerequisite of having the same breakpoints or the same amount of content as in the previous implementation. </p>
<p>We can now create designs that adapt to the space they have, the content within them, and the content around them. With an intrinsic approach, we can construct responsive components without depending on container queries.</p>
<h3>Another 2010 moment?<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/designing-for-the-unexpected#section8">#section8</a></h3>
<p>This intrinsic approach should in my view be every bit as groundbreaking as responsive web design was ten years ago. For me, it’s another “everything changed” moment. </p>
<p>But it doesn’t seem to be moving quite as fast; I haven’t yet had that same career-changing moment I had with responsive design, despite <a href="https://aneventapart.com/news/post/everything-you-know-about-web-design-just-changed-by-jen-simmons">the widely shared and brilliant talk</a> that brought it to my attention. </p>
<p>One reason for that could be that I now work in a large organization, which is quite different from the design agency role I had in 2010. In my agency days, every new project was a clean slate, a chance to try something new. Nowadays, projects use existing tools and frameworks and are often improvements to existing websites with an existing codebase. </p>
<p>Another could be that I feel more prepared for change now. In 2010 I was new to design in general; the shift was frightening and required a lot of learning. Also, an intrinsic approach isn’t exactly all-new; it’s about using existing skills and existing CSS knowledge in a different way. </p>
<h3>You can’t framework your way out of a content problem<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/designing-for-the-unexpected#section9">#section9</a></h3>
<p>Another reason for the slightly slower adoption of intrinsic design could be the lack of quick-fix framework solutions available to kick-start the change. </p>
<p>Responsive grid systems were all over the place ten years ago. With a framework like Bootstrap or Skeleton, you had a responsive design template at your fingertips.</p>
<p>Intrinsic design and frameworks do not go hand in hand quite so well because the benefit of having a selection of units is a hindrance when it comes to creating layout templates. The beauty of intrinsic design is combining different units and experimenting with techniques to get the best for your content.</p>
<p>And then there are design tools. We probably all, at some point in our careers, used Photoshop templates for desktop, tablet, and mobile devices to drop designs in and show how the site would look at all three stages.</p>
<p>How do you do that now, with each component responding to content and layouts flexing as and when they need to? This type of design must happen in the browser, which personally I’m a big fan of. </p>
<p>The debate about “whether designers should code” is another that has rumbled on for years. When designing a digital product, we should, at the very least, design for a best- and worst-case scenario when it comes to content. To do this in a graphics-based software package is far from ideal. In code, we can add longer sentences, more radio buttons, and extra tabs, and watch in real time as the design adapts. Does it still work? Is the design too reliant on the current content?</p>
<p>Personally, I look forward to the day intrinsic design is the standard for design, when a design component can be truly flexible and adapt to both its space and content with no reliance on device or container dimensions.</p>
<p>Content is not constant. After all, to design for the unknown or unexpected we need to account for content changes like our earlier Subgrid card example that allowed the cards to respond to adjustments to their own content and the content of sibling elements.</p>
<p>Thankfully, there’s more to CSS than layout, and plenty of properties and values can help us put content first. Subgrid and pseudo-elements like <strong><code>::first-line</code></strong> and <strong><code>::first-letter</code></strong> help to separate design from markup so we can create designs that allow for changes.</p>
<p>Instead of old markup hacks like this—</p>
<pre class="language-markup">&lt;p&gt;
  &lt;span class="first-line"&gt;First line of text with different styling&lt;/span&gt;...
&lt;/p&gt;</pre>
<p>—we can target content based on where it appears.</p>
<pre class="language-css">.element::first-line {
  font-size: 1.4em;
}
.element::first-letter {
  color: red;
}</pre>
<p>Much bigger additions to CSS include l<a href="https://www.w3.org/TR/css-logical-1/">ogical properties, which</a> change the way we construct designs using logical dimensions (start and end) instead of physical ones (left and right), something CSS Grid also does with functions like <a href="https://developer.mozilla.org/en-US/docs/Web/CSS/min()"><strong><code>min()</code></strong></a>, <a href="https://developer.mozilla.org/en-US/docs/Web/CSS/max()"><code><strong>max()</strong></code></a><strong><code>,</code></strong> and <a href="https://developer.mozilla.org/en-US/docs/Web/CSS/clamp()"><strong><code>clamp()</code></strong></a>.</p>
<p>This flexibility allows for directional changes according to content, a common requirement when we need to present content in multiple languages. In the past, this was often achieved with Sass mixins but was often limited to switching from left-to-right to right-to-left orientation.</p>
<p>In the Sass version, directional variables need to be set.</p>
<pre class="language-css">$direction: rtl;
$opposite-direction: ltr;
$start-direction: right;
$end-direction: left;</pre>
<p>These variables can be used as values—</p>
<pre class="language-css">body {
  direction: $direction;
  text-align: $start-direction;
}</pre>
<p>—or as properties.</p>
<pre class="language-css">margin-#{$end-direction}: 10px;
padding-#{$start-direction}: 10px;</pre>
<p>However, now we have native logical properties, removing the reliance on both Sass (or a similar tool) and pre-planning that necessitated using variables throughout a codebase. These properties also start to break apart the tight coupling between a design and strict physical dimensions, creating more flexibility for changes in language and in direction.</p>
<pre class="language-css">margin-block-end: 10px;
padding-block-start: 10px;</pre>
<p>There are also native start and end values for properties like <strong><code>text-align</code></strong>, which means we can replace <strong><code>text-align: right</code></strong> with <strong><code>text-align: start</code></strong>.</p>
<p>Like the earlier examples, these properties help to build out designs that aren’t constrained to one language; the design will reflect the content’s needs.</p>
<figure id="figure11" class="wp-block-image size-large"><img width="1631" height="448" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/07/image14.png?w=960" alt="Wireframe showing different text alignment options" class="wp-image-7173055" /></figure><h3>Fixed and fluid <a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/designing-for-the-unexpected#section11">#section11</a></h3>
<p>We briefly covered the power of combining fixed widths with fluid widths with intrinsic layouts. The <strong><code>min()</code></strong> and <strong><code>max()</code></strong> functions are a similar concept, allowing you to specify a fixed value with a flexible alternative. </p>
<p>For <strong><code>min()</code></strong> this means setting a fluid minimum value and a maximum fixed value.</p>
<pre class="language-css">.element {
  width: min(50%, 300px);
}</pre>
<figure id="figure12" class="wp-block-image size-large"><img width="1251" height="277" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/07/image6.png?w=960" alt="Wireframe showing a 300px box inside of an 800px box, and a 200px box inside of a 400px box" class="wp-image-7173047" /></figure><p>The element in the figure above will be 50% of its container as long as the element’s width doesn’t exceed 300px.</p>
<p>For <strong><code>max()</code></strong> we can set a flexible max value and a minimum fixed value.</p>
<pre class="language-css">.element {
  width: max(50%, 300px);
}</pre>
<figure id="figure13" class="wp-block-image size-large"><img width="1251" height="277" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/07/image3.png?w=960" alt="Wireframe showing a 400px box inside of an 800px box, and a 300px box inside of a 400px box" class="wp-image-7173044" /></figure><p>Now the element will be 50% of its container as long as the element’s width is at least 300px. This means we can set limits but allow content to react to the available space. </p>
<p>The <strong><code>clamp()</code></strong> function builds on this by allowing us to set a preferred value with a third parameter. Now we can allow the element to shrink or grow if it needs to without getting to a point where it becomes unusable.</p>
<pre class="language-css">.element {
  width: clamp(300px, 50%, 600px);
}</pre>
<figure id="figure14" class="wp-block-image size-large"><img width="1999" height="222" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/07/image2.png?w=960" alt="Wireframe showing an 800px box inside of a 1400px box, a 400px box inside of an 800px box, and a 300px box inside of a 400px box" class="wp-image-7173043" /></figure><p>This time, the element’s width will be 50% (the preferred value) of its container but never less than 300px and never more than 600px.</p>
<p>With these techniques, we have a content-first approach to responsive design. We can separate content from markup, meaning the changes users make will not affect the design. We can start to future-proof designs by planning for unexpected changes in language or direction. And we can increase flexibility by setting desired dimensions alongside flexible alternatives, allowing for more or less content to be displayed correctly.</p>
<p>Thanks to what we’ve discussed so far, we can cover device flexibility by changing our approach, designing around content and space instead of catering to devices. But what about that last bit of Jeffrey Zeldman’s quote, “…situations you haven’t imagined”?</p>
<p>It’s a very different thing to design for someone seated at a desktop computer as opposed to someone using a mobile phone and moving through a crowded street in glaring sunshine. Situations and environments are hard to plan for or predict because they change as people react to their own unique challenges and tasks.</p>
<p>This is why choice is so important. One size never fits all, so we need to design for multiple scenarios to create equal experiences for all our users.</p>
<p>Thankfully, there is a lot we can do to provide choice.</p>
<h3>Responsible design <a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/designing-for-the-unexpected#section13">#section13</a></h3>
<blockquote class="wp-block-quote">
<p>“There are parts of the world where mobile data is prohibitively expensive, and where there is little or no broadband infrastructure.”</p>
<p>“<a href="https://www.smashingmagazine.com/2019/07/web-on-50mb-budget/">I Used the Web for a Day on a 50 MB Budget</a>”</p>
<p>Chris Ashton</p>
</blockquote>
<p>One of the biggest assumptions we make is that people interacting with our designs have a good wifi connection and a wide screen monitor. But in the real world, our users may be commuters traveling on trains or other forms of transport using smaller mobile devices that can experience drops in connectivity. There is nothing more frustrating than a web page that won’t load, but there are ways we can help users use less data or deal with sporadic connectivity.</p>
<p>The <a href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/srcset"><strong><code>srcset</code></strong></a> attribute allows the browser to decide which image to serve. This means we can create smaller ‘cropped’ images to display on mobile devices in turn using less bandwidth and less data.</p>
<pre class="language-markup">&lt;img 
  src="image-file.jpg"
  srcset="large.jpg 1024w,
             medium.jpg 640w,
             small.jpg 320w"
     alt="Image alt text" /&gt;</pre>
<p>The <a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Link_types/preload"><strong><code>preload</code></strong></a> attribute can also help us to think about how and when media is downloaded. It can be used to tell a browser about any critical assets that need to be downloaded with high priority, improving perceived performance and the user experience. </p>
<pre class="language-markup">&lt;link rel="stylesheet" href="style.css"&gt; &lt;!--Standard stylesheet markup--&gt;
&lt;link rel="preload" href="style.css" as="style"&gt; &lt;!--Preload stylesheet markup--&gt;</pre>
<p>There’s also native <a href="https://developer.mozilla.org/en-US/docs/Web/Performance/Lazy_loading">lazy loading</a>, which indicates assets that should only be downloaded when they are needed.</p>
<pre class="language-markup">&lt;img src="image.png" loading="lazy" alt="…"&gt;</pre>
<p>With <strong><code>srcset</code></strong>, <strong><code>preload</code></strong>, and lazy loading, we can start to tailor a user’s experience based on the situation they find themselves in. What none of this does, however, is allow the user themselves to decide what they want downloaded, as the decision is usually the browser’s to make. </p>
<p>So how can we put users in control?</p>
<h3>The return of media queries <a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/designing-for-the-unexpected#section14">#section14</a></h3>
<p>Media queries have always been about much more than device sizes. They allow content to adapt to different situations, with screen size being just one of them.</p>
<p>We’ve long been able to check for media types like print and speech and features such as hover, resolution, and color. These checks allow us to provide options that suit more than one scenario; it’s less about one-size-fits-all and more about serving adaptable content. </p>
<p>As of this writing, the <a href="https://www.w3.org/TR/mediaqueries-5/"><em>Media Queries Level 5</em> spec</a> is still under development. It introduces some really exciting queries that in the future will help us design for multiple other unexpected situations.</p>
<p>For example, there’s a light-level feature that allows you to modify styles if a user is in sunlight or darkness. Paired with <a href="https://developer.mozilla.org/en-US/docs/Web/CSS/--*">custom properties</a>, these features allow us to quickly create designs or themes for specific environments.</p>
<pre class="language-css">@media (light-level: normal) {
  --background-color: #fff;
  --text-color: #0b0c0c;  
}
@media (light-level: dim) {
  --background-color: #efd226;
  --text-color: #0b0c0c;
}</pre>
<p>Another key feature of the <em>Level 5</em> spec is personalization. Instead of creating designs that are the same for everyone, users can choose what works for them. This is achieved by using features like <strong><code>prefers-reduced-data</code></strong>, <strong><code>prefers-color-scheme</code></strong>, and <strong><code>prefers-reduced-motion</code></strong>, the latter two of which already enjoy broad browser support. These features tap into preferences set via the operating system or browser so people don’t have to spend time making each site they visit more usable. </p>
<p>Media queries like this go beyond choices made by a browser to grant more control to the user.</p>
<h2 id="section15">Expect the unexpected<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/designing-for-the-unexpected#section15">#section15</a></h2>
<p>In the end, the one thing we should always expect is for things to change. Devices in particular change faster than we can keep up, with foldable screens already on the market.</p>
<p>We can’t design the same way we have for this ever-changing landscape, but we can design for content. By putting content first and allowing that content to adapt to whatever space surrounds it, we can create more robust, flexible designs that increase the longevity of our products. </p>
<p>A lot of the CSS discussed here is about moving away from layouts and putting content at the heart of design. From responsive components to fixed and fluid units, there is so much more we can do to take a more intrinsic approach. Even better, we can test these techniques during the design phase by designing in-browser and watching how our designs adapt in real-time.</p>
<p>When it comes to unexpected situations, we need to make sure our products are usable when people need them, whenever and wherever that might be. We can move closer to achieving this by involving users in our design decisions, by creating choice via browsers, and by giving control to our users with user-preference-based media queries. </p>
<p>Good design for the unexpected should allow for change, provide choice, and give control to those we serve: our users themselves.</p>]]></description>
      <link>https://alistapart-production.mystagingwebsite.com/article/designing-for-the-unexpected/</link>
      <guid>https://alistapart-production.mystagingwebsite.com/article/designing-for-the-unexpected/</guid>
      <pubDate>Thu, 15 Jul 2021 15:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Designing for the Unexpected]]></title>
      <description><![CDATA[<p>I’m not sure when I first heard this quote, but it’s something that has stayed with me over the years. How do you create services for situations you can’t imagine? Or design products that work on devices yet to be invented?</p>


<h2 id="section2">Flash, Photoshop, and responsive design</h2>
<p>When I first started designing websites, my go-to software was Photoshop. I created a 960px canvas and set about creating a layout that I would later drop content in. The development phase was about attaining pixel-perfect accuracy using fixed widths, fixed heights, and absolute positioning.</p>
<p>Ethan Marcotte’s talk at An Event Apart and subsequent article “<a href="https://alistapart.com/article/responsive-web-design/">Responsive Web Design</a>” in <em>A List Apart</em> in 2010 changed all this. I was sold on responsive design as soon as I heard about it, but I was also terrified. The pixel-perfect designs full of magic numbers that I had previously prided myself on producing were no longer good enough.</p>
<p>The fear wasn’t helped by my first experience with responsive design. My first project was to take an existing fixed-width website and make it responsive. What I learned the hard way was that you can’t just add responsiveness at the end of a project. To create fluid layouts, you need to plan throughout the design phase.</p>
<h3 id="section3">A new way to design</h3>
<p>Designing responsive or fluid sites has always been about removing limitations, producing content that can be viewed on any device. It relies on the use of percentage-based layouts, which I initially achieved with native CSS and utility classes:</p>
<pre id="snippet1"><code class="language-css">.column-span-6 {
  width: 49%;
  float: left;
  margin-right: 0.5%;
  margin-left: 0.5%;
}
.column-span-4 {
  width: 32%;
  float: left;
  margin-right: 0.5%;
  margin-left: 0.5%;
}
.column-span-3 {
  width: 24%;
  float: left;
  margin-right: 0.5%;
  margin-left: 0.5%;
}</code></pre>
<p>Then with Sass so I could take advantage of @includes to re-use repeated blocks of code and move back to more semantic markup:</p>
<pre id="snippet2"><code class="language-css">.logo {
  @include colSpan(6);
}
.search {
  @include colSpan(3);
}
.social-share {
  @include colSpan(3);
}</code></pre>
<h3 id="section4">Media queries</h3>
<p>The second ingredient for responsive design is media queries. Without them, content would shrink to fit the available space regardless of whether that content remained readable (The exact opposite problem occurred with the introduction of a mobile-first approach).</p>
<figure id="figure1" class="wp-block-image size-large"><img width="652" height="435" src="https://alistapart.com/wp-content/uploads/2021/07/image5.png?w=652&amp;resize=652%2C435" alt="Wireframes showing three boxes at a large size, and three very narrow boxes at a mobile size" class="wp-image-7173046" data-recalc-dims="1" /><figcaption>Components becoming too small at mobile breakpoints</figcaption></figure><p>Media queries prevented this by allowing us to add breakpoints where the design could adapt. Like most people, I started out with three breakpoints: one for desktop, one for tablets, and one for mobile. Over the years, I added more and more for phablets, wide screens, and so on. </p>
<p>For years, I happily worked this way and improved both my design and front-end skills in the process. The only problem I encountered was making changes to content, since with our Sass grid system in place, there was no way for the site owners to add content without amending the markup—something a small business owner might struggle with. This is because each row in the grid was defined using a <strong><code>div</code></strong> as a container. Adding content meant creating new row markup, which requires a level of HTML knowledge.</p>
<p>Row markup was a staple of early responsive design, present in all the widely used frameworks like Bootstrap and Skeleton.</p>
<pre id="snippet3"><code class="language-markup">&lt;section class="row"&gt;
  &lt;div class="column-span-4"&gt;1 of 7&lt;/div&gt;
  &lt;div class="column-span-4"&gt;2 of 7&lt;/div&gt;
  &lt;div class="column-span-4"&gt;3 of 7&lt;/div&gt;
&lt;/section&gt;
&lt;section class="row"&gt;
  &lt;div class="column-span-4"&gt;4 of 7&lt;/div&gt;
  &lt;div class="column-span-4"&gt;5 of 7&lt;/div&gt;
  &lt;div class="column-span-4"&gt;6 of 7&lt;/div&gt;
&lt;/section&gt;
&lt;section class="row"&gt;
  &lt;div class="column-span-4"&gt;7 of 7&lt;/div&gt;
&lt;/section&gt;</code></pre>
<figure id="figure2" class="wp-block-image size-large"><img width="451" height="435" src="https://alistapart.com/wp-content/uploads/2021/07/image10.png?w=451&amp;resize=451%2C435" alt="Wireframe showing three rows of boxes" class="wp-image-7173051" data-recalc-dims="1" /><figcaption>Components placed in the rows of a Sass grid</figcaption></figure><p>Another problem arose as I moved from a design agency building websites for small- to medium-sized businesses, to larger in-house teams where I worked across a suite of related sites. In those roles I started to work much more with reusable components. </p>
<p>Our reliance on media queries resulted in components that were tied to common viewport sizes. If the goal of component libraries is reuse, then this is a real problem because you can only use these components if the devices you’re designing for correspond to the viewport sizes used in the pattern library—in the process not really hitting that “devices that don’t yet exist”goal.</p>
<p>Then there’s the problem of space. Media queries allow components to adapt based on the viewport size, but what if I put a component into a sidebar, like in the figure below?</p>
<figure id="figure3" class="wp-block-image size-large"><img width="960" height="365" src="https://alistapart.com/wp-content/uploads/2021/07/image8.png?w=960&amp;resize=960%2C365" alt="Wireframes showing different configurations of boxes at three different sizes" class="wp-image-7173049" data-recalc-dims="1" /><figcaption>Components responding to the viewport width with media queries</figcaption></figure><h3 id="section5">Container queries: our savior or a false dawn?</h3>
<p>Container queries have long been touted as an improvement upon media queries, but at the time of writing are unsupported in most browsers. There are JavaScript workarounds, but they can create dependency and compatibility issues. The basic theory underlying container queries is that elements should change based on the size of their parent container and not the viewport width, as seen in the following illustrations.</p>
<figure id="figure4" class="wp-block-image size-large"><img width="951" height="435" src="https://alistapart.com/wp-content/uploads/2021/07/image11.png?w=951&amp;resize=951%2C435" alt="Wireframes showing different configurations of boxes at different sizes" class="wp-image-7173052" data-recalc-dims="1" /><figcaption>Components responding to their parent container with container queries</figcaption></figure><p>One of the biggest arguments in favor of container queries is that they help us create components or design patterns that are truly reusable because they can be picked up and placed anywhere in a layout. This is an important step in moving toward a form of component-based design that works at any size on any device.</p>
<p>In other words, responsive components to replace responsive layouts.</p>
<p>Container queries will help us move from designing pages that respond to the browser or device size to designing components that can be placed in a sidebar or in the main content, and respond accordingly.</p>
<p>My concern is that we are still using layout to determine when a design needs to adapt. This approach will always be restrictive, as we will still need pre-defined breakpoints. For this reason, my main question with container queries is, How would we decide when to change the CSS used by a component? </p>
<p>A component library removed from context and real content is probably not the best place for that decision. </p>
<p>As the diagrams below illustrate, we can use container queries to create designs for specific container widths, but what if I want to change the design based on the image size or ratio?</p>
<figure id="figure5" class="wp-block-image size-large"><img width="905" height="423" src="https://alistapart.com/wp-content/uploads/2021/07/image4.png?w=905&amp;resize=905%2C423" alt="Wireframes showing different layouts at 600px and 400px" class="wp-image-7173045" data-recalc-dims="1" /><figcaption>Cards responding to their parent container with container queries</figcaption></figure><figure id="figure6" class="wp-block-image size-large"><img width="960" height="371" src="https://alistapart.com/wp-content/uploads/2021/07/image7.png?w=960&amp;resize=960%2C371" alt="Wireframes showing different configurations of content at the same size" class="wp-image-7173048" data-recalc-dims="1" /><figcaption>Cards responding based on their own content</figcaption></figure><p>In this example, the dimensions of the container are not what should dictate the design; rather, the image is.</p>
<p>It’s hard to say for sure whether container queries will be a success story until we have solid cross-browser support for them. Responsive component libraries would definitely evolve how we design and would improve the possibilities for reuse and design at scale. But maybe we will always need to adjust these components to suit our content.</p>
<h3 id="section6">CSS is changing</h3>
<p>Whilst the container query debate rumbles on, there have been numerous advances in CSS that change the way we think about design. The days of fixed-width elements measured in pixels and floated <strong><code>div</code></strong> elements used to cobble layouts together are long gone, consigned to history along with table layouts. Flexbox and CSS Grid have revolutionized layouts for the web. We can now create elements that wrap onto new rows when they run out of space, not when the device changes.</p>
<pre id="snippet4"><code class="language-css">.wrapper {
  display: grid;
  grid-template-columns: repeat(auto-fit, 450px);
  gap: 10px;
}</code></pre>
<p>The <strong><code>repeat()</code></strong> function paired with <strong><code>auto-fit</code></strong> or <strong><code>auto-fill</code></strong> allows us to specify how much space each column should use while leaving it up to the browser to decide when to spill the columns onto a new line. Similar things can be achieved with Flexbox, as elements can wrap over multiple rows and “flex” to fill available space. </p>
<pre id="snippet5"><code class="language-css">.wrapper {
  display: flex;
  flex-wrap: wrap;
  justify-content: space-between;
}
.child {
  flex-basis: 32%;
  margin-bottom: 20px;
}</code></pre>
<p>The biggest benefit of all this is you don’t need to wrap elements in container rows. Without rows, content isn’t tied to page markup in quite the same way, allowing for removals or additions of content without additional development.</p>
<figure id="figure7" class="wp-block-image size-large"><img width="451" height="435" src="https://alistapart.com/wp-content/uploads/2021/07/image13.png?w=451&amp;resize=451%2C435" alt="A wireframe showing seven boxes in a larger container" class="wp-image-7173054" data-recalc-dims="1" /><figcaption>A traditional Grid layout without the usual row containers</figcaption></figure><p>This is a big step forward when it comes to creating designs that allow for evolving content, but the real game changer for flexible designs is CSS Subgrid. </p>
<p>Remember the days of crafting perfectly aligned interfaces, only for the customer to add an unbelievably long header almost as soon as they’re given CMS access, like the illustration below?</p>
<figure id="figure8" class="wp-block-image size-large"><img width="932" height="233" src="https://alistapart.com/wp-content/uploads/2021/07/image1.png?w=932&amp;resize=932%2C233" alt="" class="wp-image-7173042" data-recalc-dims="1" /><figcaption><em>Cards unable to respond to a sibling’s content changes</em></figcaption></figure><p>Subgrid allows elements to respond to adjustments in their own content and in the content of sibling elements, helping us create designs more resilient to change.</p>
<figure id="figure9" class="wp-block-image size-large"><img width="932" height="490" src="https://alistapart.com/wp-content/uploads/2021/07/image9.png?w=932&amp;resize=932%2C490" alt="Wireframes showing several boxes with the contents aligned across boxes" class="wp-image-7173050" data-recalc-dims="1" /><figcaption>Cards responding to content in sibling cards</figcaption></figure><pre id="snippet6"><code class="language-css">.wrapper {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(150px, 1fr));
     grid-template-rows: auto 1fr auto;
  gap: 10px;
}
.sub-grid {
  display: grid;
  grid-row: span 3;
  grid-template-rows: subgrid; /* sets rows to parent grid */
}</code></pre>
<p>CSS Grid allows us to separate layout and content, thereby enabling flexible designs. Meanwhile, Subgrid allows us to create designs that can adapt in order to suit morphing content. Subgrid at the time of writing is only supported in Firefox but the above code can be implemented behind an @supports feature query. </p>
<h3 id="section7">Intrinsic layouts </h3>
<p>I’d be remiss not to mention <a href="https://aneventapart.com/news/post/designing-intrinsic-layouts-aea-video"><em>intrinsic layouts</em></a>, the term created by Jen Simmons to describe a mixture of new and old CSS features used to create layouts that respond to available space. </p>
<p>Responsive layouts have flexible columns using percentages. Intrinsic layouts, on the other hand, use the <strong>fr</strong> unit to create flexible columns that won’t ever shrink so much that they render the content illegible.</p>
<p><strong><em><code>fr</code></em></strong> <em>units is a way to say I want you to distribute the extra space in this way, but…don’t ever make it smaller than the content that’s inside of it.</em></p>
<p><em>—Jen Simmons, “Designing Intrinsic Layouts”</em></p>
<p>Intrinsic layouts can also utilize a mixture of fixed and flexible units, allowing the content to dictate the space it takes up.</p>
<figure id="figure10" class="wp-block-image size-large"><img width="960" height="354" src="https://alistapart.com/wp-content/uploads/2021/07/image12.png?w=960&amp;resize=960%2C354" alt="A slide from a presentation showing two boxes with max content and one with auto" class="wp-image-7173053" data-recalc-dims="1" /><figcaption>Slide from “Designing Intrinsic Layouts” by Jen Simmons</figcaption></figure><p>What makes intrinsic design stand out is that it not only creates designs that can withstand future devices but also helps scale design without losing flexibility. Components and patterns can be lifted and reused without the prerequisite of having the same breakpoints or the same amount of content as in the previous implementation. </p>
<p>We can now create designs that adapt to the space they have, the content within them, and the content around them. With an intrinsic approach, we can construct responsive components without depending on container queries.</p>
<h3 id="section8">Another 2010 moment?</h3>
<p>This intrinsic approach should in my view be every bit as groundbreaking as responsive web design was ten years ago. For me, it’s another “everything changed” moment. </p>
<p>But it doesn’t seem to be moving quite as fast; I haven’t yet had that same career-changing moment I had with responsive design, despite <a href="https://aneventapart.com/news/post/everything-you-know-about-web-design-just-changed-by-jen-simmons">the widely shared and brilliant talk</a> that brought it to my attention. </p>
<p>One reason for that could be that I now work in a large organization, which is quite different from the design agency role I had in 2010. In my agency days, every new project was a clean slate, a chance to try something new. Nowadays, projects use existing tools and frameworks and are often improvements to existing websites with an existing codebase. </p>
<p>Another could be that I feel more prepared for change now. In 2010 I was new to design in general; the shift was frightening and required a lot of learning. Also, an intrinsic approach isn’t exactly all-new; it’s about using existing skills and existing CSS knowledge in a different way. </p>
<h3 id="section9">You can’t framework your way out of a content problem</h3>
<p>Another reason for the slightly slower adoption of intrinsic design could be the lack of quick-fix framework solutions available to kick-start the change. </p>
<p>Responsive grid systems were all over the place ten years ago. With a framework like Bootstrap or Skeleton, you had a responsive design template at your fingertips.</p>
<p>Intrinsic design and frameworks do not go hand in hand quite so well because the benefit of having a selection of units is a hindrance when it comes to creating layout templates. The beauty of intrinsic design is combining different units and experimenting with techniques to get the best for your content.</p>
<p>And then there are design tools. We probably all, at some point in our careers, used Photoshop templates for desktop, tablet, and mobile devices to drop designs in and show how the site would look at all three stages.</p>
<p>How do you do that now, with each component responding to content and layouts flexing as and when they need to? This type of design must happen in the browser, which personally I’m a big fan of. </p>
<p>The debate about “whether designers should code” is another that has rumbled on for years. When designing a digital product, we should, at the very least, design for a best- and worst-case scenario when it comes to content. To do this in a graphics-based software package is far from ideal. In code, we can add longer sentences, more radio buttons, and extra tabs, and watch in real time as the design adapts. Does it still work? Is the design too reliant on the current content?</p>
<p>Personally, I look forward to the day intrinsic design is the standard for design, when a design component can be truly flexible and adapt to both its space and content with no reliance on device or container dimensions.</p>
<h2 id="section10">Content first </h2>
<p>Content is not constant. After all, to design for the unknown or unexpected we need to account for content changes like our earlier Subgrid card example that allowed the cards to respond to adjustments to their own content and the content of sibling elements.</p>
<p>Thankfully, there’s more to CSS than layout, and plenty of properties and values can help us put content first. Subgrid and pseudo-elements like <strong><code>::first-line</code></strong> and <strong><code>::first-letter</code></strong> help to separate design from markup so we can create designs that allow for changes.</p>
<p>Instead of old markup hacks like this—</p>
<pre id="snippet7"><code class="language-markup">&lt;p&gt;
  &lt;span class="first-line"&gt;First line of text with different styling&lt;/span&gt;...
&lt;/p&gt;</code></pre>
<p>—we can target content based on where it appears.</p>
<pre id="snippet8"><code class="language-css">.element::first-line {
  font-size: 1.4em;
}
.element::first-letter {
  color: red;
}</code></pre>
<p>Much bigger additions to CSS include l<a href="https://www.w3.org/TR/css-logical-1/">ogical properties, which</a> change the way we construct designs using logical dimensions (start and end) instead of physical ones (left and right), something CSS Grid also does with functions like <a href="https://developer.mozilla.org/en-US/docs/Web/CSS/min()"><strong><code>min()</code></strong></a>, <a href="https://developer.mozilla.org/en-US/docs/Web/CSS/max()"><code><strong>max()</strong></code></a><strong><code>,</code></strong> and <a href="https://developer.mozilla.org/en-US/docs/Web/CSS/clamp()"><strong><code>clamp()</code></strong></a>.</p>
<p>This flexibility allows for directional changes according to content, a common requirement when we need to present content in multiple languages. In the past, this was often achieved with Sass mixins but was often limited to switching from left-to-right to right-to-left orientation.</p>
<p>In the Sass version, directional variables need to be set.</p>
<pre id="snippet9"><code class="language-css">$direction: rtl;
$opposite-direction: ltr;
$start-direction: right;
$end-direction: left;</code></pre>
<p>These variables can be used as values—</p>
<pre id="snippet10"><code class="language-css">body {
  direction: $direction;
  text-align: $start-direction;
}</code></pre>
<p>—or as properties.</p>
<pre id="snippet11"><code class="language-css">margin-#{$end-direction}: 10px;
padding-#{$start-direction}: 10px;</code></pre>
<p>However, now we have native logical properties, removing the reliance on both Sass (or a similar tool) and pre-planning that necessitated using variables throughout a codebase. These properties also start to break apart the tight coupling between a design and strict physical dimensions, creating more flexibility for changes in language and in direction.</p>
<pre id="snippet12"><code class="language-css">margin-block-end: 10px;
padding-block-start: 10px;</code></pre>
<p>There are also native start and end values for properties like <strong><code>text-align</code></strong>, which means we can replace <strong><code>text-align: right</code></strong> with <strong><code>text-align: start</code></strong>.</p>
<p>Like the earlier examples, these properties help to build out designs that aren’t constrained to one language; the design will reflect the content’s needs.</p>
<figure id="figure11" class="wp-block-image size-large"><img width="960" height="264" src="https://alistapart.com/wp-content/uploads/2021/07/image14.png?w=960&amp;resize=960%2C264" alt="Wireframe showing different text alignment options" class="wp-image-7173055" data-recalc-dims="1" /></figure><h3 id="section11">Fixed and fluid </h3>
<p>We briefly covered the power of combining fixed widths with fluid widths with intrinsic layouts. The <strong><code>min()</code></strong> and <strong><code>max()</code></strong> functions are a similar concept, allowing you to specify a fixed value with a flexible alternative. </p>
<p>For <strong><code>min()</code></strong> this means setting a fluid minimum value and a maximum fixed value.</p>
<pre id="snippet13"><code class="language-css">.element {
  width: min(50%, 300px);
}</code></pre>
<figure id="figure12" class="wp-block-image size-large"><img width="960" height="213" src="https://alistapart.com/wp-content/uploads/2021/07/image6.png?w=960&amp;resize=960%2C213" alt="Wireframe showing a 300px box inside of an 800px box, and a 200px box inside of a 400px box" class="wp-image-7173047" data-recalc-dims="1" /></figure><p>The element in the figure above will be 50% of its container as long as the element’s width doesn’t exceed 300px.</p>
<p>For <strong><code>max()</code></strong> we can set a flexible max value and a minimum fixed value.</p>
<pre id="snippet14"><code class="language-css">.element {
  width: max(50%, 300px);
}</code></pre>
<figure id="figure13" class="wp-block-image size-large"><img width="960" height="213" src="https://alistapart.com/wp-content/uploads/2021/07/image3.png?w=960&amp;resize=960%2C213" alt="Wireframe showing a 400px box inside of an 800px box, and a 300px box inside of a 400px box" class="wp-image-7173044" data-recalc-dims="1" /></figure><p>Now the element will be 50% of its container as long as the element’s width is at least 300px. This means we can set limits but allow content to react to the available space. </p>
<p>The <strong><code>clamp()</code></strong> function builds on this by allowing us to set a preferred value with a third parameter. Now we can allow the element to shrink or grow if it needs to without getting to a point where it becomes unusable.</p>
<pre id="snippet15"><code class="language-css">.element {
  width: clamp(300px, 50%, 600px);
}</code></pre>
<figure id="figure14" class="wp-block-image size-large"><img width="960" height="107" src="https://alistapart.com/wp-content/uploads/2021/07/image2.png?w=960&amp;resize=960%2C107" alt="Wireframe showing an 800px box inside of a 1400px box, a 400px box inside of an 800px box, and a 300px box inside of a 400px box" class="wp-image-7173043" data-recalc-dims="1" /></figure><p>This time, the element’s width will be 50% (the preferred value) of its container but never less than 300px and never more than 600px.</p>
<p>With these techniques, we have a content-first approach to responsive design. We can separate content from markup, meaning the changes users make will not affect the design. We can start to future-proof designs by planning for unexpected changes in language or direction. And we can increase flexibility by setting desired dimensions alongside flexible alternatives, allowing for more or less content to be displayed correctly.</p>
<h2 id="section12">Situation first</h2>
<p>Thanks to what we’ve discussed so far, we can cover device flexibility by changing our approach, designing around content and space instead of catering to devices. But what about that last bit of Jeffrey Zeldman’s quote, “…situations you haven’t imagined”?</p>
<p>It’s a very different thing to design for someone seated at a desktop computer as opposed to someone using a mobile phone and moving through a crowded street in glaring sunshine. Situations and environments are hard to plan for or predict because they change as people react to their own unique challenges and tasks.</p>
<p>This is why choice is so important. One size never fits all, so we need to design for multiple scenarios to create equal experiences for all our users.</p>
<p>Thankfully, there is a lot we can do to provide choice.</p>
<h3 id="section13">Responsible design </h3>
<blockquote class="wp-block-quote">
<p>“There are parts of the world where mobile data is prohibitively expensive, and where there is little or no broadband infrastructure.”</p>
<p>“<a href="https://www.smashingmagazine.com/2019/07/web-on-50mb-budget/">I Used the Web for a Day on a 50 MB Budget</a>”</p>
<p>Chris Ashton</p>
</blockquote>
<p>One of the biggest assumptions we make is that people interacting with our designs have a good wifi connection and a wide screen monitor. But in the real world, our users may be commuters traveling on trains or other forms of transport using smaller mobile devices that can experience drops in connectivity. There is nothing more frustrating than a web page that won’t load, but there are ways we can help users use less data or deal with sporadic connectivity.</p>
<p>The <a href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/srcset"><strong><code>srcset</code></strong></a> attribute allows the browser to decide which image to serve. This means we can create smaller ‘cropped’ images to display on mobile devices in turn using less bandwidth and less data.</p>
<pre id="snippet16"><code class="language-markup">&lt;img 
  src="image-file.jpg"
  srcset="large.jpg 1024w,
             medium.jpg 640w,
             small.jpg 320w"
     alt="Image alt text" /&gt;</code></pre>
<p>The <a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Link_types/preload"><strong><code>preload</code></strong></a> attribute can also help us to think about how and when media is downloaded. It can be used to tell a browser about any critical assets that need to be downloaded with high priority, improving perceived performance and the user experience. </p>
<pre id="snippet17"><code class="language-markup">&lt;link rel="stylesheet" href="style.css"&gt; &lt;!--Standard stylesheet markup--&gt;
&lt;link rel="preload" href="style.css" as="style"&gt; &lt;!--Preload stylesheet markup--&gt;</code></pre>
<p>There’s also native <a href="https://developer.mozilla.org/en-US/docs/Web/Performance/Lazy_loading">lazy loading</a>, which indicates assets that should only be downloaded when they are needed.</p>
<pre id="snippet18"><code class="language-markup">&lt;img src="image.png" loading="lazy" alt="…"&gt;</code></pre>
<p>With <strong><code>srcset</code></strong>, <strong><code>preload</code></strong>, and lazy loading, we can start to tailor a user’s experience based on the situation they find themselves in. What none of this does, however, is allow the user themselves to decide what they want downloaded, as the decision is usually the browser’s to make. </p>
<p>So how can we put users in control?</p>
<h3 id="section14">The return of media queries </h3>
<p>Media queries have always been about much more than device sizes. They allow content to adapt to different situations, with screen size being just one of them.</p>
<p>We’ve long been able to check for media types like print and speech and features such as hover, resolution, and color. These checks allow us to provide options that suit more than one scenario; it’s less about one-size-fits-all and more about serving adaptable content. </p>
<p>As of this writing, the <a href="https://www.w3.org/TR/mediaqueries-5/"><em>Media Queries Level 5</em> spec</a> is still under development. It introduces some really exciting queries that in the future will help us design for multiple other unexpected situations.</p>
<p>For example, there’s a light-level feature that allows you to modify styles if a user is in sunlight or darkness. Paired with <a href="https://developer.mozilla.org/en-US/docs/Web/CSS/--*">custom properties</a>, these features allow us to quickly create designs or themes for specific environments.</p>
<pre id="snippet19"><code class="language-css">@media (light-level: normal) {
  --background-color: #fff;
  --text-color: #0b0c0c;  
}
@media (light-level: dim) {
  --background-color: #efd226;
  --text-color: #0b0c0c;
}</code></pre>
<p>Another key feature of the <em>Level 5</em> spec is personalization. Instead of creating designs that are the same for everyone, users can choose what works for them. This is achieved by using features like <strong><code>prefers-reduced-data</code></strong>, <strong><code>prefers-color-scheme</code></strong>, and <strong><code>prefers-reduced-motion</code></strong>, the latter two of which already enjoy broad browser support. These features tap into preferences set via the operating system or browser so people don’t have to spend time making each site they visit more usable. </p>
<p>Media queries like this go beyond choices made by a browser to grant more control to the user.</p>
<h2 id="section15">Expect the unexpected</h2>
<p>In the end, the one thing we should always expect is for things to change. Devices in particular change faster than we can keep up, with foldable screens already on the market.</p>
<p>We can’t design the same way we have for this ever-changing landscape, but we can design for content. By putting content first and allowing that content to adapt to whatever space surrounds it, we can create more robust, flexible designs that increase the longevity of our products. </p>
<p>A lot of the CSS discussed here is about moving away from layouts and putting content at the heart of design. From responsive components to fixed and fluid units, there is so much more we can do to take a more intrinsic approach. Even better, we can test these techniques during the design phase by designing in-browser and watching how our designs adapt in real-time.</p>
<p>When it comes to unexpected situations, we need to make sure our products are usable when people need them, whenever and wherever that might be. We can move closer to achieving this by involving users in our design decisions, by creating choice via browsers, and by giving control to our users with user-preference-based media queries. </p>
<p>Good design for the unexpected should allow for change, provide choice, and give control to those we serve: our users themselves.</p>]]></description>
      <link>https://alistapart.com/article/designing-for-the-unexpected/</link>
      <guid>https://alistapart.com/article/designing-for-the-unexpected/</guid>
      <pubDate>Thu, 15 Jul 2021 15:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Asynchronous Design Critique: Giving Feedback,  Part 2]]></title>
      <description><![CDATA[<p>“Any comment?” is probably one of the worst ways to ask for feedback. It’s vague and open ended, and it doesn’t provide any indication of what we’re looking for. Getting good feedback starts earlier than we might expect: it starts with the request. </p>


<p>It might seem counterintuitive to start the process of receiving feedback with a <strong>question</strong>, but that makes sense if we realize that getting feedback can be thought of as a form of design research. In the same way that we wouldn’t do any research without the right questions to get the insights that we need, the best way to ask for feedback is also to craft sharp questions.</p>
<p>Design critique is not a one-shot process. Sure, any good feedback workflow continues until the project is finished, but this is particularly true for design because design work continues <strong>iteration</strong> after iteration, from a high level to the finest details. Each level needs its own set of questions.</p>
<p>And finally, as with any good research, we need to <strong>review</strong> what we got back, get to the core of its insights, and take action. <em>Question</em>, <em>iteration</em>, and <em>review</em>. Let’s look at each of those.</p>
<h2 id="section2">The question</h2>
<p>Being open to feedback is essential, but we need to be precise about what we’re looking for. Just saying “Any comment?”, “What do you think?”, or “I’d love to get your opinion” at the end of a presentation—whether it’s in person, over video, or through a written post—is likely to get a number of varied opinions or, even worse, get everyone to follow the direction of the first person who speaks up. And then… we get frustrated because vague questions like those can turn a high-level flows review into people instead commenting on the borders of buttons. Which might be a hearty topic, so it might be hard at that point to redirect the team to the subject that you had wanted to focus on.</p>
<p>But how do we get into this situation? It’s a mix of factors. One is that we don’t usually consider <em>asking</em> as a part of the feedback process. Another is how natural it is to just leave the question implied, expecting the others to be on the same page. Another is that in nonprofessional discussions, there’s often no need to be that precise. In short, we tend to underestimate the importance of the questions, so we don’t work on improving them.</p>
<p><strong>The act of asking good questions guides and focuses the critique</strong>. It’s also a form of consent: it makes it clear that you’re open to comments and what kind of comments you’d like to get. It puts people in the right mental state, especially in situations when they weren’t expecting to give feedback.</p>
<p>There isn’t a single best way to ask for feedback. It just needs to be <strong>specific</strong>, and specificity can take many shapes. A model for design critique that I’ve found particularly useful in my coaching is the one of <strong>stage versus depth</strong>.</p>
<figure id="figure1" class="wp-block-image size-large"><img width="960" height="425" src="https://alistapart.com/wp-content/uploads/2021/06/fig1.png?resize=960%2C425" alt="A chart showing Depth on one axis and Stage on another axis, with Depth decreasing as Stage increases" class="wp-image-7173027" data-recalc-dims="1" /></figure><p>“<strong>Stage</strong>” refers to each of the steps of the process—in our case, the design process. In progressing from user research to the final design, the kind of feedback evolves. But within a single step, one might still review whether some assumptions are correct and whether there’s been a proper translation of the amassed feedback into updated designs as the project has evolved. A starting point for potential questions could derive from the <a href="http://www.jjg.net/elements/pdf/elements_ch02.pdf">layers of user experience</a>. What do you want to know: Project objectives? User needs? Functionality? Content? Interaction design? Information architecture? UI design? Navigation design? Visual design? Branding?</p>
<p>Here’re a few example questions that are precise and to the point that refer to different layers:</p>
<ul><li>Functionality: Is automating account creation desirable?</li>
<li>Interaction design: Take a look through the updated flow and let me know whether you see any steps or error states that I might’ve missed.</li>
<li>Information architecture: We have two competing bits of information on this page. Is the structure effective in communicating them both?</li>
<li>UI design: What are your thoughts on the error counter at the top of the page that makes sure that you see the next error, even if the error is out of the viewport? </li>
<li>Navigation design: From research, we identified these second-level navigation items, but once you’re on the page, the list feels too long and hard to navigate. Are there any suggestions to address this?</li>
<li>Visual design: Are the sticky notifications in the bottom-right corner visible enough?</li>
</ul><p>The other axis of specificity is about how <strong>deep</strong> you’d like to go on what’s being presented. For example, we might have introduced a new end-to-end flow, but there was a specific view that you found particularly challenging and you’d like a detailed review of that. This can be especially useful from one iteration to the next where it’s important to <strong>highlight the parts that have changed</strong>.</p>
<p>There are other things that we can consider when we want to achieve more specific—and more effective—questions.</p>
<p>A simple trick is to remove <strong>generic qualifiers</strong> from your questions like “good,” “well,” “nice,” “bad,” “okay,” and “cool.” For example, asking, “When the block opens and the buttons appear, is this interaction good?” might look specific, but you can spot the “good” qualifier, and convert it to an even better question: “When the block opens and the buttons appear, is it clear what the next action is?”</p>
<p>Sometimes <strong>we actually do want broad feedback</strong>. That’s rare, but it can happen. In that sense, you might still make it explicit that you’re looking for a wide range of opinions, whether at a high level or with details. Or maybe just say, “At first glance, what do you think?” so that it’s clear that what you’re asking is open ended but focused on someone’s impression after their first five seconds of looking at it.</p>
<p>Sometimes the <strong>project is particularly expansive</strong>, and some areas may have already been explored in detail. In these situations, it might be useful to explicitly say that some parts are already locked in and aren’t open to feedback. It’s not something that I’d recommend in general, but I’ve found it useful to avoid falling again into rabbit holes of the sort that might lead to further refinement but aren’t what’s most important right now.</p>
<p>Asking specific questions can completely change the quality of the feedback that you receive. People with less refined critique skills will now be able to offer more actionable feedback, and even expert designers will welcome the clarity and efficiency that comes from focusing only on what’s needed. It can save a lot of time and frustration.</p>
<h2 id="section3">The iteration</h2>
<p>Design iterations are probably the most visible part of the design work, and they provide a natural checkpoint for feedback. Yet a lot of design tools with inline commenting tend to show changes as a single fluid stream in the same file, and those types of design tools make conversations disappear once they’re resolved, update shared UI components automatically, and compel designs to always show the latest version—unless these would-be helpful features were to be manually turned off. The implied goal that these design tools seem to have is to arrive at just one final copy with all discussions closed, probably because they inherited patterns from how written documents are collaboratively edited. That’s probably not the best way to approach design critiques, but even if I don’t want to be too prescriptive here: that could work for some teams.</p>
<p>The asynchronous design-critique approach that I find most effective is to create explicit checkpoints for discussion. I’m going to use the term <strong>iteration post</strong> for this. It refers to a <em>write-up or presentation</em> of the design iteration followed by a <em>discussion thread</em> of some kind. Any platform that can accommodate this structure can use this. By the way, when I refer to a “write-up or presentation,” I’m including video recordings or other media too: as long as it’s asynchronous, it works.</p>
<p>Using iteration posts has many advantages:</p>
<ul><li>It creates a <strong>rhythm</strong> in the design work so that the designer can review feedback from each iteration and prepare for the next.</li>
<li>It makes <strong>decisions visible</strong> for future review, and conversations are likewise always available.</li>
<li>It creates a <strong>record</strong> of how the design changed over time.</li>
<li>Depending on the tool, it might also make it easier to collect feedback and <strong>act</strong> on it.</li>
</ul><p>These posts of course don’t mean that no other feedback approach should be used, just that iteration posts could be the primary rhythm for a remote design team to use. And other feedback approaches (such as live critique, pair designing, or inline comments) can build from there.</p>
<p>I don’t think there’s a standard format for iteration posts. But there are a few high-level elements that make sense to include as a baseline:</p>
<ol><li>The goal</li>
<li>The design</li>
<li>The list of changes</li>
<li>The questions</li>
</ol><p>Each project is likely to have a <strong>goal</strong>, and hopefully it’s something that’s already been summarized in a single sentence somewhere else, such as the client brief, the product manager’s outline, or the project owner’s request. So this is something that I’d repeat in every iteration post—literally copy and pasting it. The idea is to provide context and to repeat what’s essential to make each iteration post <strong>complete</strong> so that there’s no need to find information spread across multiple posts. If I want to know about the latest design, the latest iteration post will have all that I need.</p>
<p>This copy-and-paste part introduces another relevant concept: <em>alignment comes from repetition</em>. So having posts that repeat information is actually very effective toward making sure that everyone is on the same page.</p>
<p>The <strong>design</strong> is then the actual series of information-architecture outlines, diagrams, flows, maps, wireframes, screens, visuals, and any other kind of design work that’s been done. In short, it’s any design artifact. For the final stages of work, I prefer the term <em>blueprint</em> to emphasize that I’ll be showing full flows instead of individual screens to make it easier to understand the bigger picture. </p>
<p>It can also be useful to label the artifacts with clear <em>titles</em> because that can make it easier to refer to them. Write the post in a way that helps people understand the work. It’s not too different from organizing a good live presentation. </p>
<p>For an efficient discussion, you should also include a bullet list of the <strong>changes</strong> from the previous iteration to let people focus on what’s new, which can be especially useful for larger pieces of work where keeping track, iteration after iteration, could become a challenge.</p>
<p>And finally, as noted earlier, it’s essential that you include a list of the <strong>questions</strong> to drive the design critique in the direction you want. Doing this as a numbered list can also help make it easier to refer to each question by its number.</p>
<p>Not all iterations are the same. <strong>Earlier iterations don’t need to be as tightly focused</strong>—they can be more exploratory and experimental, maybe even breaking some of the design-language guidelines to see what’s possible. Then later, the iterations start settling on a solution and refining it until the design process reaches its end and the feature ships.</p>
<p>I want to highlight that even if these iteration posts are written and conceived as checkpoints, <strong>by no means do they need to be exhaustive</strong>. A post might be a draft—just a concept to get a conversation going—or it could be a cumulative list of each feature that was added over the course of each iteration until the full picture is done.</p>
<p>Over time, I also started using <strong>specific labels for incremental iterations: i1, i2, i3</strong>, and so on. This might look like a minor labelling tip, but it can help in multiple ways:</p>
<ul><li>Unique—It’s a clear unique marker. Within each project, one can easily say, “This was discussed in i4,” and everyone knows where they can go to review things.</li>
<li>Unassuming—It works like versions (such as v1, v2, and v3) but in contrast, versions create the impression of something that’s big, exhaustive, and complete. Iterations must be able to be exploratory, incomplete, partial.</li>
<li>Future proof—It resolves the “final” naming problem that you can run into with versions. No more files named “final final complete no-really-its-done.” Within each project, the largest number always represents the latest iteration.</li>
</ul><p>To mark when a design is complete enough to be worked on, even if there might be some bits still in need of attention and in turn more iterations needed, the wording <strong>release candidate</strong> (RC) could be used to describe it: “with i8, we reached RC” or “i12 is an RC.”</p>
<h2 id="section4">The review</h2>
<p>What usually happens during a design critique is an open <em>discussion</em>, with a back and forth between people that can be very productive. This approach is particularly effective during live, synchronous feedback. But when we work asynchronously, it’s more effective to use a different approach: <strong>we can shift to a user-research mindset</strong>. Written feedback from teammates, stakeholders, or others can be treated as if it were the result of user interviews and surveys, and we can analyze it accordingly.</p>
<p>This shift has some major benefits that make asynchronous feedback particularly effective, especially around these friction points:</p>
<ol><li>It removes the <em>pressure to reply</em> to everyone.</li>
<li>It reduces the frustration from <em>swoop-by comments</em>.</li>
<li>It lessens our <em>personal stake</em>.</li>
</ol><p>The first friction point is feeling a <strong>pressure to reply</strong> to every single comment. Sometimes we write the iteration post, and we get replies from our team. It’s just a few of them, it’s easy, and it doesn’t feel like a problem. But other times, some solutions might require more in-depth discussions, and the amount of replies can quickly increase, which can create a tension between trying to be a good team player by replying to everyone and doing the next design iteration. This might be especially true if the person who’s replying is a stakeholder or someone directly involved in the project who we feel that we need to listen to. We need to accept that this pressure is absolutely normal, and it’s human nature to try to accommodate people who we care about. Sometimes replying to all comments can be effective, but if we treat a design critique more like user research, we realize that we don’t have to reply to every comment, and in asynchronous spaces, there are alternatives:</p>
<ul><li>One is to <strong>let the next iteration speak for itself</strong>. When the design evolves and we post a follow-up iteration, that’s the reply. You might tag all the people who were involved in the previous discussion, but even that’s a choice, not a requirement. </li>
<li>Another is to <strong>briefly reply</strong> to acknowledge each comment, such as “Understood. Thank you,” “Good points—I’ll review,” or “Thanks. I’ll include these in the next iteration.” In some cases, this could also be just a single top-level comment along the lines of “Thanks for all the feedback everyone—the next iteration is coming soon!”</li>
<li>Another is to provide a <strong>quick summary</strong> of the comments before moving on. Depending on your workflow, this can be particularly useful as it can provide a simplified checklist that you can then use for the next iteration.</li>
</ul><p>The second friction point is the <strong>swoop-by comment</strong>, which is the kind of feedback that comes from someone outside the project or team who might not be aware of the context, restrictions, decisions, or requirements—or of the previous iterations’ discussions. On their side, there’s something that one can hope that they might learn: they could start to acknowledge that they’re doing this and they could be more conscious in outlining where they’re coming from. Swoop-by comments often trigger the simple thought “We’ve already discussed this…”, and it can be frustrating to have to repeat the same reply over and over.</p>
<p>Let’s begin by acknowledging again that there’s no need to reply to every comment. If, however, replying to a previously litigated point might be useful, a <strong>short reply with a link</strong> to the previous discussion for extra details is usually enough. Remember, <em>alignment comes from repetition</em>, so it’s okay to repeat things sometimes!</p>
<p>Swoop-by commenting can still be useful for two reasons: they might point out something that still isn’t clear, and they also have the potential to stand in for the point of view of a user who’s seeing the design for the first time. Sure, you’ll still be frustrated, but that might at least help in dealing with it.</p>
<p>The third friction point is the <strong>personal stake</strong> we could have with the design, which could make us feel defensive if the <em>review</em> were to feel more like a <em>discussion</em>. Treating feedback as user research helps us create a healthy distance between the people giving us feedback and our ego (because yes, even if we don’t want to admit it, it’s there). And ultimately, treating everything in aggregated form allows us to better prioritize our work.</p>
<p>Always remember that while you need to listen to stakeholders, project owners, and specific advice, you don’t have to accept every piece of feedback. You have to analyze it and make a decision that you can justify, but sometimes “no” is the right answer. </p>
<p>As the designer leading the project, you’re in charge of that decision. Ultimately, everyone has their specialty, and as the designer, you’re the one who has the most knowledge and the most context to make the right decision. And <strong>by listening to the feedback that you’ve received, you’re making sure that it’s also the best and most balanced decision</strong>.</p>
<p><em>Thanks to Brie Anne Demkiw and Mike Shelton for reviewing the first draft of this article.</em></p>]]></description>
      <link>https://alistapart.com/article/asynchronous-design-critique-giving-feedback-part2/</link>
      <guid>https://alistapart.com/article/asynchronous-design-critique-giving-feedback-part2/</guid>
      <pubDate>Thu, 01 Jul 2021 16:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Asynchronous Design Critique: Getting Feedback]]></title>
      <description><![CDATA[<p>“Any comment?” is probably one of the worst ways to ask for feedback. It’s vague and open ended, and it doesn’t provide any indication of what we’re looking for. Getting good feedback starts earlier than we might expect: it starts with the request. </p><div class="aside-breaker">Article Continues Below</div>
<p>It might seem counterintuitive to start the process of receiving feedback with a <strong>question</strong>, but that makes sense if we realize that getting feedback can be thought of as a form of design research. In the same way that we wouldn’t do any research without the right questions to get the insights that we need, the best way to ask for feedback is also to craft sharp questions.</p>
<p>Design critique is not a one-shot process. Sure, any good feedback workflow continues until the project is finished, but this is particularly true for design because design work continues <strong>iteration</strong> after iteration, from a high level to the finest details. Each level needs its own set of questions.</p>
<p>And finally, as with any good research, we need to <strong>review</strong> what we got back, get to the core of its insights, and take action. <em>Question</em>, <em>iteration</em>, and <em>review</em>. Let’s look at each of those.</p>
<p>Being open to feedback is essential, but we need to be precise about what we’re looking for. Just saying “Any comment?”, “What do you think?”, or “I’d love to get your opinion” at the end of a presentation—whether it’s in person, over video, or through a written post—is likely to get a number of varied opinions or, even worse, get everyone to follow the direction of the first person who speaks up. And then… we get frustrated because vague questions like those can turn a high-level flows review into people instead commenting on the borders of buttons. Which might be a hearty topic, so it might be hard at that point to redirect the team to the subject that you had wanted to focus on.</p>
<p>But how do we get into this situation? It’s a mix of factors. One is that we don’t usually consider <em>asking</em> as a part of the feedback process. Another is how natural it is to just leave the question implied, expecting the others to be on the same page. Another is that in nonprofessional discussions, there’s often no need to be that precise. In short, we tend to underestimate the importance of the questions, so we don’t work on improving them.</p>
<p><strong>The act of asking good questions guides and focuses the critique</strong>. It’s also a form of consent: it makes it clear that you’re open to comments and what kind of comments you’d like to get. It puts people in the right mental state, especially in situations when they weren’t expecting to give feedback.</p>
<p>There isn’t a single best way to ask for feedback. It just needs to be <strong>specific</strong>, and specificity can take many shapes. A model for design critique that I’ve found particularly useful in my coaching is the one of <strong>stage versus depth</strong>.</p>
<figure class="wp-block-image size-large"><img width="1400" height="620" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/06/fig1.png?resize=1024,453" alt="A chart showing Depth on one axis and Stage on another axis, with Depth decreasing as Stage increases" class="wp-image-7173027" /></figure><p>“<strong>Stage</strong>” refers to each of the steps of the process—in our case, the design process. In progressing from user research to the final design, the kind of feedback evolves. But within a single step, one might still review whether some assumptions are correct and whether there’s been a proper translation of the amassed feedback into updated designs as the project has evolved. A starting point for potential questions could derive from the <a href="http://www.jjg.net/elements/pdf/elements_ch02.pdf">layers of user experience</a>. What do you want to know: Project objectives? User needs? Functionality? Content? Interaction design? Information architecture? UI design? Navigation design? Visual design? Branding?</p>
<p>Here’re a few example questions that are precise and to the point that refer to different layers:</p>
<ul><li>Functionality: Is automating account creation desirable?</li>
<li>Interaction design: Take a look through the updated flow and let me know whether you see any steps or error states that I might’ve missed.</li>
<li>Information architecture: We have two competing bits of information on this page. Is the structure effective in communicating them both?</li>
<li>UI design: What are your thoughts on the error counter at the top of the page that makes sure that you see the next error, even if the error is out of the viewport? </li>
<li>Navigation design: From research, we identified these second-level navigation items, but once you’re on the page, the list feels too long and hard to navigate. Are there any suggestions to address this?</li>
<li>Visual design: Are the sticky notifications in the bottom-right corner visible enough?</li>
</ul><p>The other axis of specificity is about how <strong>deep</strong> you’d like to go on what’s being presented. For example, we might have introduced a new end-to-end flow, but there was a specific view that you found particularly challenging and you’d like a detailed review of that. This can be especially useful from one iteration to the next where it’s important to <strong>highlight the parts that have changed</strong>.</p>
<p>There are other things that we can consider when we want to achieve more specific—and more effective—questions.</p>
<p>A simple trick is to remove <strong>generic qualifiers</strong> from your questions like “good,” “well,” “nice,” “bad,” “okay,” and “cool.” For example, asking, “When the block opens and the buttons appear, is this interaction good?” might look specific, but you can spot the “good” qualifier, and convert it to an even better question: “When the block opens and the buttons appear, is it clear what the next action is?”</p>
<p>Sometimes <strong>we actually do want broad feedback</strong>. That’s rare, but it can happen. In that sense, you might still make it explicit that you’re looking for a wide range of opinions, whether at a high level or with details. Or maybe just say, “At first glance, what do you think?” so that it’s clear that what you’re asking is open ended but focused on someone’s impression after their first five seconds of looking at it.</p>
<p>Sometimes the <strong>project is particularly expansive</strong>, and some areas may have already been explored in detail. In these situations, it might be useful to explicitly say that some parts are already locked in and aren’t open to feedback. It’s not something that I’d recommend in general, but I’ve found it useful to avoid falling again into rabbit holes of the sort that might lead to further refinement but aren’t what’s most important right now.</p>
<p>Asking specific questions can completely change the quality of the feedback that you receive. People with less refined critique skills will now be able to offer more actionable feedback, and even expert designers will welcome the clarity and efficiency that comes from focusing only on what’s needed. It can save a lot of time and frustration.</p>
<p>Design iterations are probably the most visible part of the design work, and they provide a natural checkpoint for feedback. Yet a lot of design tools with inline commenting tend to show changes as a single fluid stream in the same file, and those types of design tools make conversations disappear once they’re resolved, update shared UI components automatically, and compel designs to always show the latest version—unless these would-be helpful features were to be manually turned off. The implied goal that these design tools seem to have is to arrive at just one final copy with all discussions closed, probably because they inherited patterns from how written documents are collaboratively edited. That’s probably not the best way to approach design critiques, but even if I don’t want to be too prescriptive here: that could work for some teams.</p>
<p>The asynchronous design-critique approach that I find most effective is to create explicit checkpoints for discussion. I’m going to use the term <strong>iteration post</strong> for this. It refers to a <em>write-up or presentation</em> of the design iteration followed by a <em>discussion thread</em> of some kind. Any platform that can accommodate this structure can use this. By the way, when I refer to a “write-up or presentation,” I’m including video recordings or other media too: as long as it’s asynchronous, it works.</p>
<p>Using iteration posts has many advantages:</p>
<ul><li>It creates a <strong>rhythm</strong> in the design work so that the designer can review feedback from each iteration and prepare for the next.</li>
<li>It makes <strong>decisions visible</strong> for future review, and conversations are likewise always available.</li>
<li>It creates a <strong>record</strong> of how the design changed over time.</li>
<li>Depending on the tool, it might also make it easier to collect feedback and <strong>act</strong> on it.</li>
</ul><p>These posts of course don’t mean that no other feedback approach should be used, just that iteration posts could be the primary rhythm for a remote design team to use. And other feedback approaches (such as live critique, pair designing, or inline comments) can build from there.</p>
<p>I don’t think there’s a standard format for iteration posts. But there are a few high-level elements that make sense to include as a baseline:</p>
<ol><li>The goal</li>
<li>The design</li>
<li>The list of changes</li>
<li>The questions</li>
</ol><p>Each project is likely to have a <strong>goal</strong>, and hopefully it’s something that’s already been summarized in a single sentence somewhere else, such as the client brief, the product manager’s outline, or the project owner’s request. So this is something that I’d repeat in every iteration post—literally copy and pasting it. The idea is to provide context and to repeat what’s essential to make each iteration post <strong>complete</strong> so that there’s no need to find information spread across multiple posts. If I want to know about the latest design, the latest iteration post will have all that I need.</p>
<p>This copy-and-paste part introduces another relevant concept: <em>alignment comes from repetition</em>. So having posts that repeat information is actually very effective toward making sure that everyone is on the same page.</p>
<p>The <strong>design</strong> is then the actual series of information-architecture outlines, diagrams, flows, maps, wireframes, screens, visuals, and any other kind of design work that’s been done. In short, it’s any design artifact. For the final stages of work, I prefer the term <em>blueprint</em> to emphasize that I’ll be showing full flows instead of individual screens to make it easier to understand the bigger picture. </p>
<p>It can also be useful to label the artifacts with clear <em>titles</em> because that can make it easier to refer to them. Write the post in a way that helps people understand the work. It’s not too different from organizing a good live presentation. </p>
<p>For an efficient discussion, you should also include a bullet list of the <strong>changes</strong> from the previous iteration to let people focus on what’s new, which can be especially useful for larger pieces of work where keeping track, iteration after iteration, could become a challenge.</p>
<p>And finally, as noted earlier, it’s essential that you include a list of the <strong>questions</strong> to drive the design critique in the direction you want. Doing this as a numbered list can also help make it easier to refer to each question by its number.</p>
<p>Not all iterations are the same. <strong>Earlier iterations don’t need to be as tightly focused</strong>—they can be more exploratory and experimental, maybe even breaking some of the design-language guidelines to see what’s possible. Then later, the iterations start settling on a solution and refining it until the design process reaches its end and the feature ships.</p>
<p>I want to highlight that even if these iteration posts are written and conceived as checkpoints, <strong>by no means do they need to be exhaustive</strong>. A post might be a draft—just a concept to get a conversation going—or it could be a cumulative list of each feature that was added over the course of each iteration until the full picture is done.</p>
<p>Over time, I also started using <strong>specific labels for incremental iterations: i1, i2, i3</strong>, and so on. This might look like a minor labelling tip, but it can help in multiple ways:</p>
<ul><li>Unique—It’s a clear unique marker. Within each project, one can easily say, “This was discussed in i4,” and everyone knows where they can go to review things.</li>
<li>Unassuming—It works like versions (such as v1, v2, and v3) but in contrast, versions create the impression of something that’s big, exhaustive, and complete. Iterations must be able to be exploratory, incomplete, partial.</li>
<li>Future proof—It resolves the “final” naming problem that you can run into with versions. No more files named “final final complete no-really-its-done.” Within each project, the largest number always represents the latest iteration.</li>
</ul><p>To mark when a design is complete enough to be worked on, even if there might be some bits still in need of attention and in turn more iterations needed, the wording <strong>release candidate</strong> (RC) could be used to describe it: “with i8, we reached RC” or “i12 is an RC.”</p>
<p>What usually happens during a design critique is an open <em>discussion</em>, with a back and forth between people that can be very productive. This approach is particularly effective during live, synchronous feedback. But when we work asynchronously, it’s more effective to use a different approach: <strong>we can shift to a user-research mindset</strong>. Written feedback from teammates, stakeholders, or others can be treated as if it were the result of user interviews and surveys, and we can analyze it accordingly.</p>
<p>This shift has some major benefits that make asynchronous feedback particularly effective, especially around these friction points:</p>
<ol><li>It removes the <em>pressure to reply</em> to everyone.</li>
<li>It reduces the frustration from <em>swoop-by comments</em>.</li>
<li>It lessens our <em>personal stake</em>.</li>
</ol><p>The first friction point is feeling a <strong>pressure to reply</strong> to every single comment. Sometimes we write the iteration post, and we get replies from our team. It’s just a few of them, it’s easy, and it doesn’t feel like a problem. But other times, some solutions might require more in-depth discussions, and the amount of replies can quickly increase, which can create a tension between trying to be a good team player by replying to everyone and doing the next design iteration. This might be especially true if the person who’s replying is a stakeholder or someone directly involved in the project who we feel that we need to listen to. We need to accept that this pressure is absolutely normal, and it’s human nature to try to accommodate people who we care about. Sometimes replying to all comments can be effective, but if we treat a design critique more like user research, we realize that we don’t have to reply to every comment, and in asynchronous spaces, there are alternatives:</p>
<ul><li>One is to <strong>let the next iteration speak for itself</strong>. When the design evolves and we post a follow-up iteration, that’s the reply. You might tag all the people who were involved in the previous discussion, but even that’s a choice, not a requirement. </li>
<li>Another is to <strong>briefly reply</strong> to acknowledge each comment, such as “Understood. Thank you,” “Good points—I’ll review,” or “Thanks. I’ll include these in the next iteration.” In some cases, this could also be just a single top-level comment along the lines of “Thanks for all the feedback everyone—the next iteration is coming soon!”</li>
<li>Another is to provide a <strong>quick summary</strong> of the comments before moving on. Depending on your workflow, this can be particularly useful as it can provide a simplified checklist that you can then use for the next iteration.</li>
</ul><p>The second friction point is the <strong>swoop-by comment</strong>, which is the kind of feedback that comes from someone outside the project or team who might not be aware of the context, restrictions, decisions, or requirements—or of the previous iterations’ discussions. On their side, there’s something that one can hope that they might learn: they could start to acknowledge that they’re doing this and they could be more conscious in outlining where they’re coming from. Swoop-by comments often trigger the simple thought “We’ve already discussed this…”, and it can be frustrating to have to repeat the same reply over and over.</p>
<p>Let’s begin by acknowledging again that there’s no need to reply to every comment. If, however, replying to a previously litigated point might be useful, a <strong>short reply with a link</strong> to the previous discussion for extra details is usually enough. Remember, <em>alignment comes from repetition</em>, so it’s okay to repeat things sometimes!</p>
<p>Swoop-by commenting can still be useful for two reasons: they might point out something that still isn’t clear, and they also have the potential to stand in for the point of view of a user who’s seeing the design for the first time. Sure, you’ll still be frustrated, but that might at least help in dealing with it.</p>
<p>The third friction point is the <strong>personal stake</strong> we could have with the design, which could make us feel defensive if the <em>review</em> were to feel more like a <em>discussion</em>. Treating feedback as user research helps us create a healthy distance between the people giving us feedback and our ego (because yes, even if we don’t want to admit it, it’s there). And ultimately, treating everything in aggregated form allows us to better prioritize our work.</p>
<p>Always remember that while you need to listen to stakeholders, project owners, and specific advice, you don’t have to accept every piece of feedback. You have to analyze it and make a decision that you can justify, but sometimes “no” is the right answer. </p>
<p>As the designer leading the project, you’re in charge of that decision. Ultimately, everyone has their specialty, and as the designer, you’re the one who has the most knowledge and the most context to make the right decision. And <strong>by listening to the feedback that you’ve received, you’re making sure that it’s also the best and most balanced decision</strong>.</p>
<p><em>Thanks to Brie Anne Demkiw and Mike Shelton for reviewing the first draft of this article.</em></p>]]></description>
      <link>https://alistapart-production.mystagingwebsite.com/article/asynchronous-design-critique-giving-feedback-part2/</link>
      <guid>https://alistapart-production.mystagingwebsite.com/article/asynchronous-design-critique-giving-feedback-part2/</guid>
      <pubDate>Thu, 01 Jul 2021 16:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Asynchronous Design Critique: Giving Feedback]]></title>
      <description><![CDATA[<p>Feedback, in whichever form it takes, and whatever it may be called, is one of the most effective soft skills that we have at our disposal to collaboratively get our designs to a better place while growing our own skills and perspectives.</p>


<p>Feedback is also one of the most underestimated tools, and often by assuming that we’re already good at it, we settle, forgetting that it’s a skill that can be trained, grown, and improved. Poor feedback can create confusion in projects, bring down morale, and affect trust and team collaboration over the long term. Quality feedback can be a transformative force. </p>
<p>Practicing our skills is surely a good way to improve, but the learning gets even faster when it’s paired with a good foundation that channels and focuses the practice. What are some foundational aspects of giving good feedback? And how can feedback be adjusted for remote and distributed work environments? </p>
<p>On the web, we can identify a long tradition of asynchronous feedback: from the early days of open source, code was shared and discussed on mailing lists. Today, developers engage on pull requests, designers comment in their favorite design tools, project managers and scrum masters exchange ideas on tickets, and so on.</p>
<p><em>Design critique</em> is often the name used for a type of feedback that’s provided to make our work better, collaboratively. So it shares a lot of the principles with feedback in general, but it also has some differences.</p>
<h2 id="section2">The content</h2>
<p>The foundation of every good critique is the feedback’s content, so that’s where we need to start. There are many models that you can use to shape your content. The one that I personally like best—because it’s clear and actionable—is this one from <a href="https://larahogan.me/blog/feedback-equation/">Lara Hogan</a>.</p>
<figure id="figure1" class="wp-block-image size-large"><img width="960" height="274" src="https://alistapart.com/wp-content/uploads/2021/06/async-critique-feedback-equation.png?resize=960%2C274" alt="An equation: Observation plus impact plus question equals actionable feedback." class="wp-image-7173014" data-recalc-dims="1" /></figure><p>While this equation is generally used to give feedback to people, it also fits really well in a design critique because it ultimately answers some of the core questions that we work on: What? Where? Why? How? Imagine that you’re giving some feedback about some design work that spans multiple screens, like an onboarding flow: there are some pages shown, a flow blueprint, and an outline of the decisions made. You spot something that could be improved. If you keep the three elements of the equation in mind, you’ll have a mental model that can help you be more precise and effective.</p>
<p>Here is a comment that could be given as a part of some feedback, and it might look reasonable at a first glance: it seems to superficially fulfill the elements in the equation. But does it?</p>
<blockquote class="wp-block-quote">
<p>Not sure about the buttons’ styles and hierarchy—it feels off. Can you change them?</p>
</blockquote>
<p><strong>Observation</strong> for design feedback doesn’t just mean pointing out which part of the interface your feedback refers to, but it also refers to offering a perspective that’s as specific as possible. Are you providing the user’s perspective? Your expert perspective? A business perspective? The project manager’s perspective? A first-time user’s perspective?</p>
<blockquote class="wp-block-quote">
<p>When I see these two buttons, I expect one to go forward and one to go back.</p>
</blockquote>
<p><strong>Impact</strong> is about the <em>why</em>. Just pointing out a UI element might sometimes be enough if the issue may be obvious, but more often than not, you should add an explanation of what you’re pointing out.</p>
<blockquote class="wp-block-quote">
<p>When I see these two buttons, I expect one to go forward and one to go back. But this is the only screen where this happens, as before we just used a single button and an “×” to close. This seems to be breaking the consistency in the flow.</p>
</blockquote>
<p>The <strong>question</strong> approach is meant to provide open guidance by eliciting the critical thinking in the designer receiving the feedback. Notably, in Lara’s equation she provides a second approach: <strong>request</strong>, which instead provides guidance toward a specific solution. While that’s a viable option for feedback in general, for design critiques, in my experience, defaulting to the <em>question</em> approach usually reaches the best solutions because designers are generally more comfortable in being given an open space to explore.</p>
<p>The difference between the two can be exemplified with, for the <em>question</em> approach:</p>
<blockquote class="wp-block-quote">
<p>When I see these two buttons, I expect one to go forward and one to go back. But this is the only screen where this happens, as before we just used a single button and an “×” to close. This seems to be breaking the consistency in the flow. Would it make sense to unify them?</p>
</blockquote>
<p>Or, for the <em>request</em> approach:</p>
<blockquote class="wp-block-quote">
<p>When I see these two buttons, I expect one to go forward and one to go back. But this is the only screen where this happens, as before we just used a single button and an “×” to close. This seems to be breaking the consistency in the flow. Let’s make sure that all screens have the same pair of forward and back buttons.</p>
</blockquote>
<p>At this point in some situations, it might be useful to integrate with an extra <em>why</em>: why you consider the given suggestion to be better.</p>
<blockquote class="wp-block-quote">
<p>When I see these two buttons, I expect one to go forward and one to go back. But this is the only screen where this happens, as before we just used a single button and an “×” to close. This seems to be breaking the consistency in the flow. Let’s make sure that all screens have the same two forward and back buttons so that users don’t get confused.</p>
</blockquote>
<p>Choosing the <em>question</em> approach or the <em>request</em> approach can also at times be a matter of personal preference. A while ago, I was putting a lot of effort into improving my feedback: I did rounds of anonymous feedback, and I reviewed feedback with other people. After a few rounds of this work and a year later, I got a positive response: my feedback came across as effective and grounded. Until I changed teams. To my shock, my next round of feedback from one specific person wasn’t that great. The reason is that I had previously tried not to be prescriptive in my advice—because the people who I was previously working with preferred the open-ended <em>question</em> format over the <em>request</em> style of suggestions. But now in this other team, there was one person who instead preferred specific guidance. So I adapted my feedback for them to include requests.</p>
<p>One comment that I heard come up a few times is that this kind of feedback is quite long, and it doesn’t seem very efficient. No… but also yes. Let’s explore both sides.</p>
<p>No, this style of feedback is actually <strong>efficient</strong> because the length here is a byproduct of clarity, and spending time giving this kind of feedback can provide exactly enough information for a good fix. Also if we zoom out, it can reduce future back-and-forth conversations and misunderstandings, improving the overall efficiency and effectiveness of collaboration beyond the single comment. Imagine that in the example above the feedback were instead just, “Let’s make sure that all screens have the same two forward and back buttons.” The designer receiving this feedback wouldn’t have much to go by, so they might just apply the change. In later iterations, the interface might change or they might introduce new features—and maybe that change might not make sense anymore. Without the <em>why</em>, the designer might imagine that the change is about consistency… but what if it wasn’t? So there could now be an underlying concern that changing the buttons would be perceived as a regression.</p>
<p>Yes, this style of feedback is <strong>not always efficient</strong> because the points in some comments don’t always need to be exhaustive, sometimes because certain changes may be obvious (“The font used doesn’t follow our guidelines”) and sometimes because the team may have a lot of internal knowledge such that some of the <em>whys</em> may be implied.</p>
<p>So the equation above isn’t meant to suggest a strict template for feedback but a mnemonic to reflect and improve the practice. Even after years of active work on my critiques, I still from time to time go back to this formula and reflect on whether what I just wrote is effective.</p>
<h2 id="section3">The tone</h2>
<p>Well-grounded content is the foundation of feedback, but that’s not really enough. The soft skills of the person who’s providing the critique can multiply the likelihood that the feedback will be well received and understood. Tone alone can make the difference between content that’s rejected or welcomed, and it’s been demonstrated that <a href="https://pubmed.ncbi.nlm.nih.gov/23802125/">only positive feedback creates sustained change</a> in people.</p>
<p>Since our goal is to be understood and to have a positive working environment, tone is essential to work on. Over the years, I’ve tried to summarize the required soft skills in a formula that mirrors the one for content: the <strong>receptivity equation</strong>.</p>
<figure id="figure2" class="wp-block-image size-large"><img width="960" height="274" src="https://alistapart.com/wp-content/uploads/2021/06/async-critique-receptivity-equation.png?resize=960%2C274" alt="Another equation: Timing plus attitude plus form equals respectful feedback." class="wp-image-7173015" data-recalc-dims="1" /></figure><p>Respectful feedback comes across as grounded, solid, and constructive. It’s the kind of feedback that, whether it’s positive or negative, is perceived as useful and fair.</p>
<p><strong>Timing</strong> refers to when the feedback happens. To-the-point feedback doesn’t have much hope of being well received if it’s given at the wrong time. Questioning the entire high-level information architecture of a new feature when it’s about to ship might still be relevant if that questioning highlights a major blocker that nobody saw, but it’s way more likely that those concerns will have to wait for a later rework. So in general, attune your feedback to the stage of the project. Early iteration? Late iteration? Polishing work in progress? These all have different needs. The right timing will make it more likely that your feedback will be well received.</p>
<p><strong>Attitude</strong> is the equivalent of intent, and in the context of person-to-person feedback, it can be referred to as <a href="https://www.radicalcandor.com/radical-candor-not-brutal-honesty/">radical candor</a>. That means checking before we write to see whether what we have in mind will truly help the person and make the project better overall. This might be a hard reflection at times because maybe we don’t want to admit that we don’t really appreciate that person. Hopefully that’s not the case, but that can happen, and that’s okay. Acknowledging and owning that can help you make up for that: how would I write if I really cared about them? How can I avoid being passive aggressive? How can I be more constructive?</p>
<p><strong>Form</strong> is relevant especially in a diverse and cross-cultural work environments because having great content, perfect timing, and the right attitude might not come across if the way that we write creates misunderstandings. There might be many reasons for this: sometimes certain words might trigger specific reactions; sometimes nonnative speakers might not understand all the nuances of some sentences; sometimes our brains might just be different and we might perceive the world differently—neurodiversity must be taken into consideration. Whatever the reason, it’s important to review not just what we write but how.</p>
<p>A few years back, I was asking for some feedback on how I give feedback. I received some good advice but also a comment that surprised me. They pointed out that when I wrote “Oh, […],” I made them feel stupid. That wasn’t my intent! I felt really bad, and I just realized that I provided feedback to them for months, and every time I might have made them feel stupid. I was horrified… but also thankful. I made a quick fix: I added “oh” in my list of replaced words (your choice between: macOS’s text replacement, aText, TextExpander, or others) so that when I typed “oh,” it was instantly deleted. </p>
<p>Something to highlight because it’s quite frequent—especially in teams that have a strong group spirit—is that people tend to beat around the bush. It’s important to remember here that <strong>a positive attitude doesn’t mean going light on the feedback</strong>—it just means that even when you provide hard, difficult, or challenging feedback, you do so in a way that’s respectful and constructive. The nicest thing that you can do for someone is to help them grow.</p>
<p>We have a great advantage in giving feedback in written form: it can be <strong>reviewed by another person</strong> who isn’t directly involved, which can help to reduce or remove any bias that might be there. I found that the best, most insightful moments for me have happened when I’ve shared a comment and I’ve asked someone who I highly trusted, “How does this sound?,” “How can I do it better,” and even “How would you have written it?”—and I’ve learned a lot by seeing the two versions side by side.</p>
<h2 id="section4">The format</h2>
<p>Asynchronous feedback also has a major inherent advantage: we can take more time to refine what we’ve written to make sure that it fulfills two main goals: the <em>clarity</em> of communication and the <em>actionability</em> of the suggestions.</p>
<figure id="figure3" class="wp-block-image size-large"><img width="960" height="274" src="https://alistapart.com/wp-content/uploads/2021/06/async-critique-format.png?resize=960%2C274" alt="Clarity plus Actionability" class="wp-image-7173016" data-recalc-dims="1" /></figure><p>Let’s imagine that someone shared a design iteration for a project. You are reviewing it and leaving a comment. There are many ways to do this, and of course context matters, but let’s try to think about some elements that may be useful to consider.</p>
<p>In terms of <em>clarity</em>, start by grounding the critique that you’re about to give by providing <strong>context</strong>. Specifically, this means describing where you’re coming from: do you have a deep knowledge of the project, or is this the first time that you’re seeing it? Are you coming from a high-level perspective, or are you figuring out the details? Are there regressions? Which user’s perspective are you taking when providing your feedback? Is the design iteration at a point where it would be okay to ship this, or are there major things that need to be addressed first?</p>
<p>Providing context is helpful even if you’re sharing feedback within a team that already has some information on the project. And context is absolutely essential when giving cross-team feedback. If I were to review a design that might be indirectly related to my work, and if I had no knowledge about how the project arrived at that point, I would say so, highlighting my take as external.</p>
<p>We often focus on the negatives, trying to outline all the things that could be done better. That’s of course important, but it’s just as important—if not more—to focus on the <strong>positives</strong>, especially if you saw progress from the previous iteration. This might seem superfluous, but it’s important to keep in mind that design is a discipline where there are hundreds of possible solutions for every problem. So pointing out that the design solution that was chosen is good and explaining why it’s good has two major benefits: it confirms that the approach taken was solid, and it helps to ground your negative feedback. In the longer term, sharing positive feedback can help prevent regressions on things that are going well because those things will have been highlighted as important. As a bonus, positive feedback can also help reduce impostor syndrome.</p>
<p>There’s one powerful approach that combines both <em>context</em> and <em>a focus on the positives</em>: <strong>frame how the design is better than the status quo</strong> (compared to a previous iteration, competitors, or benchmarks) and why, and then on that foundation, you can add what could be improved. This is powerful because there’s a big difference between a critique that’s for a design that’s already in good shape and a critique that’s for a design that isn’t quite there yet.</p>
<p>Another way that you can improve your feedback is to <strong>depersonalize the feedback</strong>: the comments should always be about the work, never about the person who made it. It’s “This button isn’t well aligned” versus “You haven’t aligned this button well.” This is very easy to change in your writing by reviewing it just before sending.</p>
<p>In terms of <em>actionability</em>, one of the best approaches to help the designer who’s reading through your feedback is to <strong>split</strong> it into bullet points or paragraphs, which are easier to review and analyze one by one. For longer pieces of feedback, you might also consider splitting it into sections or even across multiple comments. Of course, adding screenshots or signifying markers of the specific part of the interface you’re referring to can also be especially useful.</p>
<p>One approach that I’ve personally used effectively in some contexts is to enhance the bullet points with four markers using emojis. So a red square ? means that it’s something that I consider blocking; a yellow diamond ? is something that I can be convinced otherwise, but it seems to me that it should be changed; and a green circle ? is a detailed, positive confirmation. I also use a blue spiral ? for either something that I’m not sure about, an exploration, an open alternative, or just a note. But I’d use this approach only on teams where I’ve already established a good level of trust because if it happens that I have to deliver a lot of red squares, the impact could be quite demoralizing, and I’d reframe how I’d communicate that a bit.</p>
<p>Let’s see how this would work by reusing the example that we used earlier as the first bullet point in this list:</p>
<ul><li>? Navigation—When I see these two buttons, I expect one to go forward and one to go back. But this is the only screen where this happens, as before we just used a single button and an “×” to close. This seems to be breaking the consistency in the flow. Let’s make sure that all screens have the same two forward and back buttons so that users don’t get confused.</li>
<li>? Overall—I think the page is solid, and this is good enough to be our release candidate for a version 1.0.</li>
<li>? Metrics—Good improvement in the buttons on the metrics area; the improved contrast and new focus style make them more accessible.</li>
<li> ?  Button Style—Using the green accent in this context creates the impression that it’s a positive action because green is usually perceived as a confirmation color. Do we need to explore a different color?</li>
<li>?Tiles—Given the number of items on the page, and the overall page hierarchy, it seems to me that the tiles shouldn’t be using the Subtitle 1 style but the Subtitle 2 style. This will keep the visual hierarchy more consistent.</li>
<li>? Background—Using a light texture works well, but I wonder whether it adds too much noise in this kind of page. What is the thinking in using that?</li>
</ul><p>What about giving feedback directly in <strong>Figma</strong> or another design tool that allows in-place feedback? In general, I find these difficult to use because they hide discussions and they’re harder to track, but in the right context, they can be very effective. Just make sure that each of the comments is separate so that it’s easier to match each discussion to a single task, similar to the idea of splitting mentioned above.</p>
<p>One final note: <strong>say the obvious</strong>. Sometimes we might feel that something is obviously good or obviously wrong, and so we don’t say it. Or sometimes we might have a doubt that we don’t express because the question might sound stupid. Say it—that’s okay. You might have to reword it a little bit to make the reader feel more comfortable, but don’t hold it back. Good feedback is transparent, even when it may be obvious.</p>
<p>There’s another advantage of asynchronous feedback: <strong>written feedback automatically tracks decisions</strong>. Especially in large projects, “Why did we do this?” could be a question that pops up from time to time, and there’s nothing better than open, transparent discussions that can be reviewed at any time. For this reason, I recommend using software that saves these discussions, without hiding them once they are resolved. </p>
<p>Content, tone, and format. Each one of these subjects provides a useful model, but working to improve eight areas—<em>observation, impact, question, timing, attitude, form, clarity, and actionability</em>—is a lot of work to put in all at once. One effective approach is to take them one by one: first identify the area that you lack the most (either from your perspective or from feedback from others) and start there. Then the second, then the third, and so on. At first you’ll have to put in extra time for every piece of feedback that you give, but after a while, it’ll become second nature, and your impact on the work will multiply.</p>
<p><em>Thanks to Brie Anne Demkiw and Mike Shelton for reviewing the first draft of this article.</em></p>]]></description>
      <link>https://alistapart.com/article/async-design-critique-giving-feedback/</link>
      <guid>https://alistapart.com/article/async-design-critique-giving-feedback/</guid>
      <pubDate>Thu, 17 Jun 2021 16:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Asynchronous Design Critique: Giving Feedback]]></title>
      <description><![CDATA[<p>Feedback, in whichever form it takes, and whatever it may be called, is one of the most effective soft skills that we have at our disposal to collaboratively get our designs to a better place while growing our own skills and perspectives.</p><div class="aside-breaker">Article Continues Below</div>
<p>Feedback is also one of the most underestimated tools, and often by assuming that we’re already good at it, we settle, forgetting that it’s a skill that can be trained, grown, and improved. Poor feedback can create confusion in projects, bring down morale, and affect trust and team collaboration over the long term. Quality feedback can be a transformative force. </p>
<p>Practicing our skills is surely a good way to improve, but the learning gets even faster when it’s paired with a good foundation that channels and focuses the practice. What are some foundational aspects of giving good feedback? And how can feedback be adjusted for remote and distributed work environments? </p>
<p>On the web, we can identify a long tradition of asynchronous feedback: from the early days of open source, code was shared and discussed on mailing lists. Today, developers engage on pull requests, designers comment in their favorite design tools, project managers and scrum masters exchange ideas on tickets, and so on.</p>
<p><em>Design critique</em> is often the name used for a type of feedback that’s provided to make our work better, collaboratively. So it shares a lot of the principles with feedback in general, but it also has some differences.</p>
<p>The foundation of every good critique is the feedback’s content, so that’s where we need to start. There are many models that you can use to shape your content. The one that I personally like best—because it’s clear and actionable—is this one from <a href="https://larahogan.me/blog/feedback-equation/">Lara Hogan</a>.</p>
<figure class="wp-block-image size-large"><img width="1400" height="400" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/06/async-critique-feedback-equation.png?resize=1024,293" alt="An equation: Observation plus impact plus question equals actionable feedback." class="wp-image-7173014" /></figure><p>While this equation is generally used to give feedback to people, it also fits really well in a design critique because it ultimately answers some of the core questions that we work on: What? Where? Why? How? Imagine that you’re giving some feedback about some design work that spans multiple screens, like an onboarding flow: there are some pages shown, a flow blueprint, and an outline of the decisions made. You spot something that could be improved. If you keep the three elements of the equation in mind, you’ll have a mental model that can help you be more precise and effective.</p>
<p>Here is a comment that could be given as a part of some feedback, and it might look reasonable at a first glance: it seems to superficially fulfill the elements in the equation. But does it?</p>
<blockquote class="wp-block-quote">
<p>Not sure about the buttons’ styles and hierarchy—it feels off. Can you change them?</p>
</blockquote>
<p><strong>Observation</strong> for design feedback doesn’t just mean pointing out which part of the interface your feedback refers to, but it also refers to offering a perspective that’s as specific as possible. Are you providing the user’s perspective? Your expert perspective? A business perspective? The project manager’s perspective? A first-time user’s perspective?</p>
<blockquote class="wp-block-quote">
<p>When I see these two buttons, I expect one to go forward and one to go back.</p>
</blockquote>
<p><strong>Impact</strong> is about the <em>why</em>. Just pointing out a UI element might sometimes be enough if the issue may be obvious, but more often than not, you should add an explanation of what you’re pointing out.</p>
<blockquote class="wp-block-quote">
<p>When I see these two buttons, I expect one to go forward and one to go back. But this is the only screen where this happens, as before we just used a single button and an “×” to close. This seems to be breaking the consistency in the flow.</p>
</blockquote>
<p>The <strong>question</strong> approach is meant to provide open guidance by eliciting the critical thinking in the designer receiving the feedback. Notably, in Lara’s equation she provides a second approach: <strong>request</strong>, which instead provides guidance toward a specific solution. While that’s a viable option for feedback in general, for design critiques, in my experience, defaulting to the <em>question</em> approach usually reaches the best solutions because designers are generally more comfortable in being given an open space to explore.</p>
<p>The difference between the two can be exemplified with, for the <em>question</em> approach:</p>
<blockquote class="wp-block-quote">
<p>When I see these two buttons, I expect one to go forward and one to go back. But this is the only screen where this happens, as before we just used a single button and an “×” to close. This seems to be breaking the consistency in the flow. Would it make sense to unify them?</p>
</blockquote>
<p>Or, for the <em>request</em> approach:</p>
<blockquote class="wp-block-quote">
<p>When I see these two buttons, I expect one to go forward and one to go back. But this is the only screen where this happens, as before we just used a single button and an “×” to close. This seems to be breaking the consistency in the flow. Let’s make sure that all screens have the same pair of forward and back buttons.</p>
</blockquote>
<p>At this point in some situations, it might be useful to integrate with an extra <em>why</em>: why you consider the given suggestion to be better.</p>
<blockquote class="wp-block-quote">
<p>When I see these two buttons, I expect one to go forward and one to go back. But this is the only screen where this happens, as before we just used a single button and an “×” to close. This seems to be breaking the consistency in the flow. Let’s make sure that all screens have the same two forward and back buttons so that users don’t get confused.</p>
</blockquote>
<p>Choosing the <em>question</em> approach or the <em>request</em> approach can also at times be a matter of personal preference. A while ago, I was putting a lot of effort into improving my feedback: I did rounds of anonymous feedback, and I reviewed feedback with other people. After a few rounds of this work and a year later, I got a positive response: my feedback came across as effective and grounded. Until I changed teams. To my shock, my next round of feedback from one specific person wasn’t that great. The reason is that I had previously tried not to be prescriptive in my advice—because the people who I was previously working with preferred the open-ended <em>question</em> format over the <em>request</em> style of suggestions. But now in this other team, there was one person who instead preferred specific guidance. So I adapted my feedback for them to include requests.</p>
<p>One comment that I heard come up a few times is that this kind of feedback is quite long, and it doesn’t seem very efficient. No… but also yes. Let’s explore both sides.</p>
<p>No, this style of feedback is actually <strong>efficient</strong> because the length here is a byproduct of clarity, and spending time giving this kind of feedback can provide exactly enough information for a good fix. Also if we zoom out, it can reduce future back-and-forth conversations and misunderstandings, improving the overall efficiency and effectiveness of collaboration beyond the single comment. Imagine that in the example above the feedback were instead just, “Let’s make sure that all screens have the same two forward and back buttons.” The designer receiving this feedback wouldn’t have much to go by, so they might just apply the change. In later iterations, the interface might change or they might introduce new features—and maybe that change might not make sense anymore. Without the <em>why</em>, the designer might imagine that the change is about consistency… but what if it wasn’t? So there could now be an underlying concern that changing the buttons would be perceived as a regression.</p>
<p>Yes, this style of feedback is <strong>not always efficient</strong> because the points in some comments don’t always need to be exhaustive, sometimes because certain changes may be obvious (“The font used doesn’t follow our guidelines”) and sometimes because the team may have a lot of internal knowledge such that some of the <em>whys</em> may be implied.</p>
<p>So the equation above isn’t meant to suggest a strict template for feedback but a mnemonic to reflect and improve the practice. Even after years of active work on my critiques, I still from time to time go back to this formula and reflect on whether what I just wrote is effective.</p>
<p>Well-grounded content is the foundation of feedback, but that’s not really enough. The soft skills of the person who’s providing the critique can multiply the likelihood that the feedback will be well received and understood. Tone alone can make the difference between content that’s rejected or welcomed, and it’s been demonstrated that <a href="https://pubmed.ncbi.nlm.nih.gov/23802125/">only positive feedback creates sustained change</a> in people.</p>
<p>Since our goal is to be understood and to have a positive working environment, tone is essential to work on. Over the years, I’ve tried to summarize the required soft skills in a formula that mirrors the one for content: the <strong>receptivity equation</strong>.</p>
<figure class="wp-block-image size-large"><img width="1400" height="400" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/06/async-critique-receptivity-equation.png?resize=1024,293" alt="Another equation: Timing plus attitude plus form equals respectful feedback." class="wp-image-7173015" /></figure><p>Respectful feedback comes across as grounded, solid, and constructive. It’s the kind of feedback that, whether it’s positive or negative, is perceived as useful and fair.</p>
<p><strong>Timing</strong> refers to when the feedback happens. To-the-point feedback doesn’t have much hope of being well received if it’s given at the wrong time. Questioning the entire high-level information architecture of a new feature when it’s about to ship might still be relevant if that questioning highlights a major blocker that nobody saw, but it’s way more likely that those concerns will have to wait for a later rework. So in general, attune your feedback to the stage of the project. Early iteration? Late iteration? Polishing work in progress? These all have different needs. The right timing will make it more likely that your feedback will be well received.</p>
<p><strong>Attitude</strong> is the equivalent of intent, and in the context of person-to-person feedback, it can be referred to as <a href="https://www.radicalcandor.com/radical-candor-not-brutal-honesty/">radical candor</a>. That means checking before we write to see whether what we have in mind will truly help the person and make the project better overall. This might be a hard reflection at times because maybe we don’t want to admit that we don’t really appreciate that person. Hopefully that’s not the case, but that can happen, and that’s okay. Acknowledging and owning that can help you make up for that: how would I write if I really cared about them? How can I avoid being passive aggressive? How can I be more constructive?</p>
<p><strong>Form</strong> is relevant especially in a diverse and cross-cultural work environments because having great content, perfect timing, and the right attitude might not come across if the way that we write creates misunderstandings. There might be many reasons for this: sometimes certain words might trigger specific reactions; sometimes nonnative speakers might not understand all the nuances of some sentences; sometimes our brains might just be different and we might perceive the world differently—neurodiversity must be taken into consideration. Whatever the reason, it’s important to review not just what we write but how.</p>
<p>A few years back, I was asking for some feedback on how I give feedback. I received some good advice but also a comment that surprised me. They pointed out that when I wrote “Oh, […],” I made them feel stupid. That wasn’t my intent! I felt really bad, and I just realized that I provided feedback to them for months, and every time I might have made them feel stupid. I was horrified… but also thankful. I made a quick fix: I added “oh” in my list of replaced words (your choice between: macOS’s text replacement, aText, TextExpander, or others) so that when I typed “oh,” it was instantly deleted. </p>
<p>Something to highlight because it’s quite frequent—especially in teams that have a strong group spirit—is that people tend to beat around the bush. It’s important to remember here that <strong>a positive attitude doesn’t mean going light on the feedback</strong>—it just means that even when you provide hard, difficult, or challenging feedback, you do so in a way that’s respectful and constructive. The nicest thing that you can do for someone is to help them grow.</p>
<p>We have a great advantage in giving feedback in written form: it can be <strong>reviewed by another person</strong> who isn’t directly involved, which can help to reduce or remove any bias that might be there. I found that the best, most insightful moments for me have happened when I’ve shared a comment and I’ve asked someone who I highly trusted, “How does this sound?,” “How can I do it better,” and even “How would you have written it?”—and I’ve learned a lot by seeing the two versions side by side.</p>
<p>Asynchronous feedback also has a major inherent advantage: we can take more time to refine what we’ve written to make sure that it fulfills two main goals: the <em>clarity</em> of communication and the <em>actionability</em> of the suggestions.</p>
<figure class="wp-block-image size-large"><img width="1400" height="400" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/06/async-critique-format.png?resize=1024,293" alt="Clarity plus Actionability" class="wp-image-7173016" /></figure><p>Let’s imagine that someone shared a design iteration for a project. You are reviewing it and leaving a comment. There are many ways to do this, and of course context matters, but let’s try to think about some elements that may be useful to consider.</p>
<p>In terms of <em>clarity</em>, start by grounding the critique that you’re about to give by providing <strong>context</strong>. Specifically, this means describing where you’re coming from: do you have a deep knowledge of the project, or is this the first time that you’re seeing it? Are you coming from a high-level perspective, or are you figuring out the details? Are there regressions? Which user’s perspective are you taking when providing your feedback? Is the design iteration at a point where it would be okay to ship this, or are there major things that need to be addressed first?</p>
<p>Providing context is helpful even if you’re sharing feedback within a team that already has some information on the project. And context is absolutely essential when giving cross-team feedback. If I were to review a design that might be indirectly related to my work, and if I had no knowledge about how the project arrived at that point, I would say so, highlighting my take as external.</p>
<p>We often focus on the negatives, trying to outline all the things that could be done better. That’s of course important, but it’s just as important—if not more—to focus on the <strong>positives</strong>, especially if you saw progress from the previous iteration. This might seem superfluous, but it’s important to keep in mind that design is a discipline where there are hundreds of possible solutions for every problem. So pointing out that the design solution that was chosen is good and explaining why it’s good has two major benefits: it confirms that the approach taken was solid, and it helps to ground your negative feedback. In the longer term, sharing positive feedback can help prevent regressions on things that are going well because those things will have been highlighted as important. As a bonus, positive feedback can also help reduce impostor syndrome.</p>
<p>There’s one powerful approach that combines both <em>context</em> and <em>a focus on the positives</em>: <strong>frame how the design is better than the status quo</strong> (compared to a previous iteration, competitors, or benchmarks) and why, and then on that foundation, you can add what could be improved. This is powerful because there’s a big difference between a critique that’s for a design that’s already in good shape and a critique that’s for a design that isn’t quite there yet.</p>
<p>Another way that you can improve your feedback is to <strong>depersonalize the feedback</strong>: the comments should always be about the work, never about the person who made it. It’s “This button isn’t well aligned” versus “You haven’t aligned this button well.” This is very easy to change in your writing by reviewing it just before sending.</p>
<p>In terms of <em>actionability</em>, one of the best approaches to help the designer who’s reading through your feedback is to <strong>split</strong> it into bullet points or paragraphs, which are easier to review and analyze one by one. For longer pieces of feedback, you might also consider splitting it into sections or even across multiple comments. Of course, adding screenshots or signifying markers of the specific part of the interface you’re referring to can also be especially useful.</p>
<p>One approach that I’ve personally used effectively in some contexts is to enhance the bullet points with four markers using emojis. So a red square ? means that it’s something that I consider blocking; a yellow diamond ? is something that I can be convinced otherwise, but it seems to me that it should be changed; and a green circle ? is a detailed, positive confirmation. I also use a blue spiral ? for either something that I’m not sure about, an exploration, an open alternative, or just a note. But I’d use this approach only on teams where I’ve already established a good level of trust because if it happens that I have to deliver a lot of red squares, the impact could be quite demoralizing, and I’d reframe how I’d communicate that a bit.</p>
<p>Let’s see how this would work by reusing the example that we used earlier as the first bullet point in this list:</p>
<ul><li>? Navigation—When I see these two buttons, I expect one to go forward and one to go back. But this is the only screen where this happens, as before we just used a single button and an “×” to close. This seems to be breaking the consistency in the flow. Let’s make sure that all screens have the same two forward and back buttons so that users don’t get confused.</li>
<li>? Overall—I think the page is solid, and this is good enough to be our release candidate for a version 1.0.</li>
<li>? Metrics—Good improvement in the buttons on the metrics area; the improved contrast and new focus style make them more accessible.</li>
<li> ?  Button Style—Using the green accent in this context creates the impression that it’s a positive action because green is usually perceived as a confirmation color. Do we need to explore a different color?</li>
<li>?Tiles—Given the number of items on the page, and the overall page hierarchy, it seems to me that the tiles shouldn’t be using the Subtitle 1 style but the Subtitle 2 style. This will keep the visual hierarchy more consistent.</li>
<li>? Background—Using a light texture works well, but I wonder whether it adds too much noise in this kind of page. What is the thinking in using that?</li>
</ul><p>What about giving feedback directly in <strong>Figma</strong> or another design tool that allows in-place feedback? In general, I find these difficult to use because they hide discussions and they’re harder to track, but in the right context, they can be very effective. Just make sure that each of the comments is separate so that it’s easier to match each discussion to a single task, similar to the idea of splitting mentioned above.</p>
<p>One final note: <strong>say the obvious</strong>. Sometimes we might feel that something is obviously good or obviously wrong, and so we don’t say it. Or sometimes we might have a doubt that we don’t express because the question might sound stupid. Say it—that’s okay. You might have to reword it a little bit to make the reader feel more comfortable, but don’t hold it back. Good feedback is transparent, even when it may be obvious.</p>
<p>There’s another advantage of asynchronous feedback: <strong>written feedback automatically tracks decisions</strong>. Especially in large projects, “Why did we do this?” could be a question that pops up from time to time, and there’s nothing better than open, transparent discussions that can be reviewed at any time. For this reason, I recommend using software that saves these discussions, without hiding them once they are resolved. </p>
<p>Content, tone, and format. Each one of these subjects provides a useful model, but working to improve eight areas—<em>observation, impact, question, timing, attitude, form, clarity, and actionability</em>—is a lot of work to put in all at once. One effective approach is to take them one by one: first identify the area that you lack the most (either from your perspective or from feedback from others) and start there. Then the second, then the third, and so on. At first you’ll have to put in extra time for every piece of feedback that you give, but after a while, it’ll become second nature, and your impact on the work will multiply.</p>
<p><em>Thanks to Brie Anne Demkiw and Mike Shelton for reviewing the first draft of this article.</em></p>]]></description>
      <link>https://alistapart-production.mystagingwebsite.com/article/async-design-critique-giving-feedback/</link>
      <guid>https://alistapart-production.mystagingwebsite.com/article/async-design-critique-giving-feedback/</guid>
      <pubDate>Thu, 17 Jun 2021 16:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[That’s Not My Burnout]]></title>
      <description><![CDATA[<p>Are you like me, reading about people fading away as they burn out, and feeling unable to relate? Do you feel like your feelings are invisible to the world because you’re experiencing burnout differently? When burnout starts to push down on us, our core comes through more. Beautiful, peaceful souls get quieter and fade into that distant and distracted burnout we’ve all read about. But some of us, those with fires always burning on the edges of our core, get hotter. In my heart I am fire. When I face burnout I double down, triple down, burning hotter and hotter to try to best the challenge. I don’t fade—I am engulfed in a <em>zealous burnout</em>. </p><div class="aside-breaker">Article Continues Below</div>
<h2>So what on earth is a zealous burnout?<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/thats-not-my-burnout#section2">#section2</a></h2>
<p>Imagine a woman determined to do it all. She has two amazing children whom she, along with her husband who is also working remotely, is homeschooling during a pandemic. She has a demanding client load at work—all of whom she loves. She gets up early to get some movement in (or often catch up on work), does dinner prep as the kids are eating breakfast, and gets to work while positioning herself near “fourth grade” to listen in as she juggles clients, tasks, and budgets. Sound like a lot? Even with a supportive team both at home and at work, it is. </p>
<p>Sounds like this woman has too much on her plate and needs self-care. But no, she doesn’t have time for that. In fact, she starts to feel like she’s dropping balls. Not accomplishing enough. There’s not enough of her to be here and there; she is trying to divide her mind in two all the time, all day, every day. She starts to doubt herself. And as those feelings creep in more and more, her internal narrative becomes more and more critical.</p>
<p>Suddenly she KNOWS what she needs to do! She should DO MORE. </p>
<p>This is a hard and dangerous cycle. Know why? Because once she doesn’t finish that new goal, that narrative will get worse. Suddenly she’s failing. She isn’t doing enough. SHE is <em>not enough</em>. She might fail, she might fail her family…so she’ll find more she should do. She doesn’t sleep as much, move as much, all in the efforts to do more. Caught in this cycle of trying to prove herself to herself, never reaching any goal. Never feeling “enough.” </p>
<p>So, yeah, that’s what zealous burnout looks like for me. It doesn’t happen overnight in some grand gesture but instead slowly builds over weeks and months. My burning out process looks like speeding up, not a person losing focus. I speed up and up and up…and then I just stop.</p>
<h2>I am the one who could<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/thats-not-my-burnout#section3">#section3</a></h2>
<p>It’s funny the things that shape us. Through the lens of childhood, I viewed the fears, struggles, and sacrifices of someone who had to make it all work without having enough. I was lucky that my mother was so resourceful and my father supportive; I never went without and even got an extra here or there. </p>
<p>Growing up, I did not feel shame when my mother paid with food stamps; in fact, I’d have likely taken on any debate on the topic, verbally eviscerating anyone who dared to criticize the disabled woman trying to make sure all our needs were met with so little. As a child, I watched the way the fear of not making those ends meet impacted people I love. As the non-disabled person in my home, I would take on many of the physical tasks because I was “the one who could” make our lives a little easier. I learned early to associate fears or uncertainty with putting more of myself into it—I am the one who can. I learned early that when something frightens me, I can double down and work harder to make it better. I can own the challenge. When people have seen this in me as an adult, I’ve been told I seem fearless, but make no mistake, I’m not. If I seem fearless, it’s because this behavior was forged from other people’s fears. </p>
<p>And here I am, more than 30 years later still feeling the urge to mindlessly push myself forward when faced with overwhelming tasks ahead of me, assuming that I am the one who can and therefore should. I find myself driven to prove that I can make things happen if I work longer hours, take on more responsibility, and do <em>more</em>. </p>
<p>I do not see people who struggle financially as failures, because I have seen how strong that tide can be—it pulls you along the way. I truly get that I have been privileged to be able to avoid many of the challenges that were present in my youth. That said, I am still “the one who can” who feels she should, so if I were faced with not having enough to make ends meet for my own family, I would see myself as having failed. Though I am supported and educated, most of this is due to good fortune. I will, however, allow myself the arrogance of saying I have been careful with my choices to have encouraged that luck. My identity stems from the idea that I am “the one who can” so therefore feel obligated to do the most. I can choose to stop, and with some quite literal cold water splashed in my face, I’ve made the choice to before. But that choosing to stop is not my go-to; I move forward, driven by a fear that is so a part of me that I barely notice it’s there until I’m feeling utterly worn away.</p>
<p>So why all the history? You see, burnout is a fickle thing. I have heard and read a lot about burnout over the years. Burnout is real. Especially now, with COVID, many of us are balancing more than we ever have before—all at once! It’s hard, and the procrastinating, the avoidance, the shutting down impacts so many amazing professionals. There are important articles that relate to what I imagine must be the majority of people out there, but not me. That’s not what my burnout looks like.</p>
<h2>The dangerous invisibility of zealous burnout<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/thats-not-my-burnout#section4">#section4</a></h2>
<p>A lot of work environments see the extra hours, extra effort, and overall focused commitment as an asset (and sometimes that’s all it is). They see someone trying to rise to challenges, not someone stuck in their fear. Many well-meaning organizations have safeguards in place to protect their teams from burnout. But in cases like this, those alarms are not always tripped, and then when the inevitable stop comes, some members of the organization feel surprised and disappointed. And sometimes maybe even betrayed. </p>
<p>Parents—more so mothers, statistically speaking—are praised as being so on top of it all when they can work, be involved in the after-school activities, practice self-care in the form of diet and exercise, and still meet friends for coffee or wine. During COVID many of us have binged countless streaming episodes showing how it’s so hard for the female protagonist, but she is strong and funny and can do it. It’s a “very special episode” when she breaks down, cries in the bathroom, woefully admits she needs help, and just stops for a bit. Truth is, countless people are hiding their tears or are doom-scrolling to escape. We know that the media is a lie to amuse us, but often the perception that it’s what we should strive for has penetrated much of society.</p>
<p>I love men. And though I don’t love every man (heads up, I don’t love every woman or nonbinary person either), I think there is a beautiful spectrum of individuals who represent that particular binary gender. </p>
<p>That said, women are still more often at risk of burnout than their male counterparts, especially in these COVID stressed times. Mothers in the workplace feel the pressure to do all the “mom” things while giving 110%. Mothers not in the workplace feel they need to do more to “justify” their lack of traditional employment. Women who are not mothers often feel the need to do even more because they don’t have that extra pressure at home. It’s vicious and systemic and so a part of our culture that we’re often not even aware of the enormity of the pressures we put on ourselves and each other. </p>
<p>And there are prices beyond happiness too. <a href="https://www.health.harvard.edu/heart-health/job-strain-and-heart-disease-risk-in-women">Harvard Health Publishing released a study</a> a decade ago that “uncovered strong links between women’s job stress and cardiovascular disease.” <a href="https://www.cdc.gov/heartdisease/women.htm">The CDC noted,</a> “Heart disease is the leading cause of death for women in the United States, killing 299,578 women in 2017—or about 1 in every 5 female deaths.” </p>
<p>This relationship between work stress and health, from what I have read, is more dangerous for women than it is for their non-female counterparts.</p>
<h2>But what if your burnout isn’t like that either?<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/thats-not-my-burnout#section6">#section6</a></h2>
<p>That might not be you either. After all, each of us is so different and how we respond to stressors is too. It’s part of what makes us human. <strong>Don’t stress what burnout looks like</strong>, <strong>just learn to recognize it in yourself.</strong> Here are a few questions I sometimes ask friends if I am concerned about them.</p>
<p class="c1"><em>Are you happy?</em> This simple question should be the first thing you ask yourself. Chances are, even if you’re burning out doing all the things you love, as you approach burnout you’ll just stop taking as much joy from it all.</p>
<p class="c1"><em>Do you feel empowered to say no?</em> I have observed in myself and others that when someone is burning out, they no longer feel they can say no to things. Even those who don’t “speed up” feel pressure to say yes to not disappoint the people around them.</p>
<p class="c1"><em>What are three things you’ve done for yourself?</em> Another observance is that we all tend to stop doing things for ourselves. Anything from skipping showers and eating poorly to avoiding talking to friends. These can be red flags. </p>
<p class="c1"><em>Are you making excuses?</em> Many of us try to disregard feelings of burnout. Over and over I have heard, “It’s just crunch time,” “As soon as I do this one thing, it will all be better,” and “Well I should be able to handle this, so I’ll figure it out.” And it <em>might</em> really be crunch time, a single goal, and/or a skill set you need to learn. That happens—life happens. BUT if this doesn’t stop, be honest with yourself. If you’ve worked more 50-hour weeks since January than not, maybe it’s not crunch time—maybe it’s a bad situation that you’re burning out from.</p>
<p class="c1"><em>Do you have a plan to stop feeling this way?</em> If something is truly temporary and you do need to just push through, then it has an exit route with a<br />defined end.</p>
<p>Take the time to listen to yourself as you would a friend. Be honest, allow yourself to be uncomfortable, and break the thought cycles that prevent you from healing. </p>
<p>What I just described is a different path to burnout, but it’s still burnout. There are well-established approaches to working through burnout:</p>
<ul><li>Get enough sleep.</li>
<li>Eat healthy.</li>
<li>Work out.</li>
<li>Get outside.</li>
<li>Take a break.</li>
<li>Overall, practice self-care.</li>
</ul><p>Those are hard for me because they feel like more tasks. If I’m in the burnout cycle, doing any of the above <em>for me</em> feels like a waste. The narrative is that if I’m already failing, why would I take care of myself when I’m dropping all those other balls? People need me, right? </p>
<p>If you’re deep in the cycle, your inner voice might be pretty awful by now. If you need to, tell yourself you need to take care of the person your people depend on. If your roles are pushing you toward burnout, use them to help make healing easier by justifying the time spent working on you. </p>
<p>To help remind myself of the airline attendant message about putting the mask on yourself first, I have come up with a few things that I do when I start feeling myself going into a zealous burnout.</p>
<h3>Cook an elaborate meal for someone! <a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/thats-not-my-burnout#section8">#section8</a></h3>
<p>OK, I am a “food-focused” individual so cooking for someone is always my go-to. There are countless tales in my home of someone walking into the kitchen and turning right around and walking out when they noticed I was “chopping angrily.” But it’s more than that, and you should give it a try. Seriously. It’s the perfect go-to if you don’t feel worthy of taking time for yourself—do it for someone else. Most of us work in a digital world, so cooking can fill all of your senses and force you to be in the moment with all the ways you perceive the world. It can break you out of your head and help you gain a better perspective. In my house, I’ve been known to pick a place on the map and cook food that comes from wherever that is (thank you, Pinterest). I love cooking Indian food, as the smells are warm, the bread needs just enough kneading to keep my hands busy, and the process takes real attention for me because it’s not what I was brought up making. And in the end, we all win!</p>
<h3>Vent like a foul-mouthed fool<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/thats-not-my-burnout#section9">#section9</a></h3>
<p><em>Be careful with this one! </em></p>
<p>I have been making an effort to practice more gratitude over the past few years, and I recognize the true benefits of that. That said, sometimes you just gotta let it all out—even the ugly. Hell, I’m a big fan of not sugarcoating our lives, and that sometimes means that to get past the big pile of poop, you’re gonna wanna complain about it a bit. </p>
<p>When that is what’s needed, turn to a trusted friend and allow yourself some pure verbal diarrhea, saying all the things that are bothering you. You need to trust this friend not to judge, to see your pain, and, most importantly, to tell you to remove your cranium from your own rectal cavity. Seriously, it’s about getting a reality check here! One of the things I admire the most about my husband (though often after the fact) is his ability to break things down to their simplest. “We’re spending our lives together, of course you’re going to disappoint me from time to time, so get over it” has been his way of speaking his dedication, love, and acceptance of me—and I could not be more grateful. It also, of course, has meant that I needed to remove my head from that rectal cavity. So, again, usually those moments are appreciated in hindsight.</p>
<h3>Pick up a book! <a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/thats-not-my-burnout#section10">#section10</a></h3>
<p>There are many books out there that aren’t so much self-help as they are people just like you sharing their stories and how they’ve come to find greater balance. Maybe you’ll find something that speaks to you. Titles that have stood out to me include:</p>
<ul><li><em>Thrive</em> by Arianna Huffington</li>
<li><em>Tools of Titans</em> by Tim Ferriss</li>
<li><em>Girl, Stop Apologizing</em> by Rachel Hollis</li>
<li><em>Dare to Lead</em> by Brené Brown</li>
</ul><p>Or, another tactic I love to employ is to read or listen to a book that has NOTHING to do with my work-life balance. I’ve read the following books and found they helped balance me out because my mind was pondering their interesting topics instead of running in circles:</p>
<ul><li><em>The Drunken Botanist</em> by Amy Stewart</li>
<li><em>Superlife</em> by Darin Olien</li>
<li><em>A Brief History of Everyone Who Ever Lived</em> by Adam Rutherford</li>
<li><em>Gaia’s Garden</em> by Toby Hemenway </li>
</ul><p>If you’re not into reading, pick up a topic on YouTube or choose a podcast to subscribe to. I’ve watched countless permaculture and gardening topics in addition to how to raise chickens and ducks. For the record, I do not have a particularly large food garden, nor do I own livestock of any kind…yet. I just find the topic interesting, and it has nothing to do with any aspect of my life that <em>needs</em> anything from me.</p>
<h3>Forgive yourself<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/thats-not-my-burnout#section11">#section11</a></h3>
<p>You are never going to be perfect—hell, it would be boring if you were. It’s OK to be broken and flawed. It’s human to be tired and sad and worried. It’s OK to not do it all. It’s scary to be imperfect, but you cannot be brave if nothing were scary.</p>
<p>This last one is the most important: <strong>allow yourself permission to NOT do it all.</strong> You never promised to be everything to everyone at all times. We are more powerful than the fears that drive us. </p>
<p>This is hard. It is hard for me. It’s what’s driven me to write this—that it’s OK to stop. It’s OK that your unhealthy habit that might even benefit those around you needs to end. You can still be successful in life.</p>
<p>I recently read that we are all writing our eulogy in how we live. Knowing that your professional accomplishments won’t be mentioned in that speech, what will yours say? What do you want it to say? </p>
<p>Look, I get that none of these ideas will “fix it,” and that’s not their purpose. None of us are in control of our surroundings, only how we respond to them. These suggestions are to help stop the spiral effect so that you are empowered to address the underlying issues and choose your response. They are things that work for me most of the time. Maybe they’ll work for you.</p>
<h2>Does this sound familiar? <a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/thats-not-my-burnout#section12">#section12</a></h2>
<p>If this sounds familiar, it’s not just you. Don’t let your negative self-talk tell you that you “even burn out wrong.” It’s not wrong. Even if rooted in fear like my own drivers, I believe that this need to do more comes from a place of love, determination, motivation, and other wonderful attributes that make you the amazing person you are. We’re going to be OK, ya know. The lives that unfold before us might never look like that story in our head—that idea of “perfect” or “done” we’re looking for, but that’s OK. Really, when we stop and look around, usually the only eyes that judge us are in the mirror. </p>
<p>Do you remember that Winnie the Pooh sketch that had Pooh eat so much at Rabbit’s house that his buttocks couldn’t fit through the door? Well, I already associate a lot with Rabbit, so it came as no surprise when he abruptly declared that this was unacceptable. But do you recall what happened next? He put a shelf across poor Pooh’s ankles and decorations on his back, and made the best of the big butt in his kitchen. </p>
<p>At the end of the day we are resourceful and know that we are able to push ourselves if we need to—even when we are tired to our core or have a big butt of fluff ‘n’ stuff in our room. None of us has to be afraid, as we can manage any obstacle put in front of us. And maybe that means we will need to redefine success to allow space for being uncomfortably human, but that doesn’t really sound so bad either. </p>
<p>So, wherever you are right now, please breathe. Do what you need to do to get out of your head. Forgive and take care.</p>]]></description>
      <link>https://alistapart-production.mystagingwebsite.com/article/thats-not-my-burnout/</link>
      <guid>https://alistapart-production.mystagingwebsite.com/article/thats-not-my-burnout/</guid>
      <pubDate>Thu, 20 May 2021 16:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[That’s Not My Burnout]]></title>
      <description><![CDATA[<p>Are you like me, reading about people fading away as they burn out, and feeling unable to relate? Do you feel like your feelings are invisible to the world because you’re experiencing burnout differently? When burnout starts to push down on us, our core comes through more. Beautiful, peaceful souls get quieter and fade into that distant and distracted burnout we’ve all read about. But some of us, those with fires always burning on the edges of our core, get hotter. In my heart I am fire. When I face burnout I double down, triple down, burning hotter and hotter to try to best the challenge. I don’t fade—I am engulfed in a <em>zealous burnout</em>. </p>


<h2 id="section2">So what on earth is a zealous burnout?</h2>
<p>Imagine a woman determined to do it all. She has two amazing children whom she, along with her husband who is also working remotely, is homeschooling during a pandemic. She has a demanding client load at work—all of whom she loves. She gets up early to get some movement in (or often catch up on work), does dinner prep as the kids are eating breakfast, and gets to work while positioning herself near “fourth grade” to listen in as she juggles clients, tasks, and budgets. Sound like a lot? Even with a supportive team both at home and at work, it is. </p>
<p>Sounds like this woman has too much on her plate and needs self-care. But no, she doesn’t have time for that. In fact, she starts to feel like she’s dropping balls. Not accomplishing enough. There’s not enough of her to be here and there; she is trying to divide her mind in two all the time, all day, every day. She starts to doubt herself. And as those feelings creep in more and more, her internal narrative becomes more and more critical.</p>
<p>Suddenly she KNOWS what she needs to do! She should DO MORE. </p>
<p>This is a hard and dangerous cycle. Know why? Because once she doesn’t finish that new goal, that narrative will get worse. Suddenly she’s failing. She isn’t doing enough. SHE is <em>not enough</em>. She might fail, she might fail her family…so she’ll find more she should do. She doesn’t sleep as much, move as much, all in the efforts to do more. Caught in this cycle of trying to prove herself to herself, never reaching any goal. Never feeling “enough.” </p>
<p>So, yeah, that’s what zealous burnout looks like for me. It doesn’t happen overnight in some grand gesture but instead slowly builds over weeks and months. My burning out process looks like speeding up, not a person losing focus. I speed up and up and up…and then I just stop.</p>
<h2 id="section3">I am the one who could</h2>
<p>It’s funny the things that shape us. Through the lens of childhood, I viewed the fears, struggles, and sacrifices of someone who had to make it all work without having enough. I was lucky that my mother was so resourceful and my father supportive; I never went without and even got an extra here or there. </p>
<p>Growing up, I did not feel shame when my mother paid with food stamps; in fact, I’d have likely taken on any debate on the topic, verbally eviscerating anyone who dared to criticize the disabled woman trying to make sure all our needs were met with so little. As a child, I watched the way the fear of not making those ends meet impacted people I love. As the non-disabled person in my home, I would take on many of the physical tasks because I was “the one who could” make our lives a little easier. I learned early to associate fears or uncertainty with putting more of myself into it—I am the one who can. I learned early that when something frightens me, I can double down and work harder to make it better. I can own the challenge. When people have seen this in me as an adult, I’ve been told I seem fearless, but make no mistake, I’m not. If I seem fearless, it’s because this behavior was forged from other people’s fears. </p>
<p>And here I am, more than 30 years later still feeling the urge to mindlessly push myself forward when faced with overwhelming tasks ahead of me, assuming that I am the one who can and therefore should. I find myself driven to prove that I can make things happen if I work longer hours, take on more responsibility, and do <em>more</em>. </p>
<p>I do not see people who struggle financially as failures, because I have seen how strong that tide can be—it pulls you along the way. I truly get that I have been privileged to be able to avoid many of the challenges that were present in my youth. That said, I am still “the one who can” who feels she should, so if I were faced with not having enough to make ends meet for my own family, I would see myself as having failed. Though I am supported and educated, most of this is due to good fortune. I will, however, allow myself the arrogance of saying I have been careful with my choices to have encouraged that luck. My identity stems from the idea that I am “the one who can” so therefore feel obligated to do the most. I can choose to stop, and with some quite literal cold water splashed in my face, I’ve made the choice to before. But that choosing to stop is not my go-to; I move forward, driven by a fear that is so a part of me that I barely notice it’s there until I’m feeling utterly worn away.</p>
<p>So why all the history? You see, burnout is a fickle thing. I have heard and read a lot about burnout over the years. Burnout is real. Especially now, with COVID, many of us are balancing more than we ever have before—all at once! It’s hard, and the procrastinating, the avoidance, the shutting down impacts so many amazing professionals. There are important articles that relate to what I imagine must be the majority of people out there, but not me. That’s not what my burnout looks like.</p>
<h2 id="section4">The dangerous invisibility of zealous burnout</h2>
<p>A lot of work environments see the extra hours, extra effort, and overall focused commitment as an asset (and sometimes that’s all it is). They see someone trying to rise to challenges, not someone stuck in their fear. Many well-meaning organizations have safeguards in place to protect their teams from burnout. But in cases like this, those alarms are not always tripped, and then when the inevitable stop comes, some members of the organization feel surprised and disappointed. And sometimes maybe even betrayed. </p>
<p>Parents—more so mothers, statistically speaking—are praised as being so on top of it all when they can work, be involved in the after-school activities, practice self-care in the form of diet and exercise, and still meet friends for coffee or wine. During COVID many of us have binged countless streaming episodes showing how it’s so hard for the female protagonist, but she is strong and funny and can do it. It’s a “very special episode” when she breaks down, cries in the bathroom, woefully admits she needs help, and just stops for a bit. Truth is, countless people are hiding their tears or are doom-scrolling to escape. We know that the media is a lie to amuse us, but often the perception that it’s what we should strive for has penetrated much of society.</p>
<h2 id="section5">Women and burnout</h2>
<p>I love men. And though I don’t love every man (heads up, I don’t love every woman or nonbinary person either), I think there is a beautiful spectrum of individuals who represent that particular binary gender. </p>
<p>That said, women are still more often at risk of burnout than their male counterparts, especially in these COVID stressed times. Mothers in the workplace feel the pressure to do all the “mom” things while giving 110%. Mothers not in the workplace feel they need to do more to “justify” their lack of traditional employment. Women who are not mothers often feel the need to do even more because they don’t have that extra pressure at home. It’s vicious and systemic and so a part of our culture that we’re often not even aware of the enormity of the pressures we put on ourselves and each other. </p>
<p>And there are prices beyond happiness too. <a href="https://www.health.harvard.edu/heart-health/job-strain-and-heart-disease-risk-in-women">Harvard Health Publishing released a study</a> a decade ago that “uncovered strong links between women’s job stress and cardiovascular disease.” <a href="https://www.cdc.gov/heartdisease/women.htm">The CDC noted,</a> “Heart disease is the leading cause of death for women in the United States, killing 299,578 women in 2017—or about 1 in every 5 female deaths.” </p>
<p>This relationship between work stress and health, from what I have read, is more dangerous for women than it is for their non-female counterparts.</p>
<h2 id="section6">But what if your burnout isn’t like that either?</h2>
<p>That might not be you either. After all, each of us is so different and how we respond to stressors is too. It’s part of what makes us human. <strong>Don’t stress what burnout looks like</strong>, <strong>just learn to recognize it in yourself.</strong> Here are a few questions I sometimes ask friends if I am concerned about them.</p>
<p class="c1"><em>Are you happy?</em> This simple question should be the first thing you ask yourself. Chances are, even if you’re burning out doing all the things you love, as you approach burnout you’ll just stop taking as much joy from it all.</p>
<p class="c1"><em>Do you feel empowered to say no?</em> I have observed in myself and others that when someone is burning out, they no longer feel they can say no to things. Even those who don’t “speed up” feel pressure to say yes to not disappoint the people around them.</p>
<p class="c1"><em>What are three things you’ve done for yourself?</em> Another observance is that we all tend to stop doing things for ourselves. Anything from skipping showers and eating poorly to avoiding talking to friends. These can be red flags. </p>
<p class="c1"><em>Are you making excuses?</em> Many of us try to disregard feelings of burnout. Over and over I have heard, “It’s just crunch time,” “As soon as I do this one thing, it will all be better,” and “Well I should be able to handle this, so I’ll figure it out.” And it <em>might</em> really be crunch time, a single goal, and/or a skill set you need to learn. That happens—life happens. BUT if this doesn’t stop, be honest with yourself. If you’ve worked more 50-hour weeks since January than not, maybe it’s not crunch time—maybe it’s a bad situation that you’re burning out from.</p>
<p class="c1"><em>Do you have a plan to stop feeling this way?</em> If something is truly temporary and you do need to just push through, then it has an exit route with a<br />
defined end.</p>
<p>Take the time to listen to yourself as you would a friend. Be honest, allow yourself to be uncomfortable, and break the thought cycles that prevent you from healing. </p>
<h2 id="section7">So now what?</h2>
<p>What I just described is a different path to burnout, but it’s still burnout. There are well-established approaches to working through burnout:</p>
<ul><li>Get enough sleep.</li>
<li>Eat healthy.</li>
<li>Work out.</li>
<li>Get outside.</li>
<li>Take a break.</li>
<li>Overall, practice self-care.</li>
</ul><p>Those are hard for me because they feel like more tasks. If I’m in the burnout cycle, doing any of the above <em>for me</em> feels like a waste. The narrative is that if I’m already failing, why would I take care of myself when I’m dropping all those other balls? People need me, right? </p>
<p>If you’re deep in the cycle, your inner voice might be pretty awful by now. If you need to, tell yourself you need to take care of the person your people depend on. If your roles are pushing you toward burnout, use them to help make healing easier by justifying the time spent working on you. </p>
<p>To help remind myself of the airline attendant message about putting the mask on yourself first, I have come up with a few things that I do when I start feeling myself going into a zealous burnout.</p>
<h3 id="section8">Cook an elaborate meal for someone! </h3>
<p>OK, I am a “food-focused” individual so cooking for someone is always my go-to. There are countless tales in my home of someone walking into the kitchen and turning right around and walking out when they noticed I was “chopping angrily.” But it’s more than that, and you should give it a try. Seriously. It’s the perfect go-to if you don’t feel worthy of taking time for yourself—do it for someone else. Most of us work in a digital world, so cooking can fill all of your senses and force you to be in the moment with all the ways you perceive the world. It can break you out of your head and help you gain a better perspective. In my house, I’ve been known to pick a place on the map and cook food that comes from wherever that is (thank you, Pinterest). I love cooking Indian food, as the smells are warm, the bread needs just enough kneading to keep my hands busy, and the process takes real attention for me because it’s not what I was brought up making. And in the end, we all win!</p>
<h3 id="section9">Vent like a foul-mouthed fool</h3>
<p><em>Be careful with this one! </em></p>
<p>I have been making an effort to practice more gratitude over the past few years, and I recognize the true benefits of that. That said, sometimes you just gotta let it all out—even the ugly. Hell, I’m a big fan of not sugarcoating our lives, and that sometimes means that to get past the big pile of poop, you’re gonna wanna complain about it a bit. </p>
<p>When that is what’s needed, turn to a trusted friend and allow yourself some pure verbal diarrhea, saying all the things that are bothering you. You need to trust this friend not to judge, to see your pain, and, most importantly, to tell you to remove your cranium from your own rectal cavity. Seriously, it’s about getting a reality check here! One of the things I admire the most about my husband (though often after the fact) is his ability to break things down to their simplest. “We’re spending our lives together, of course you’re going to disappoint me from time to time, so get over it” has been his way of speaking his dedication, love, and acceptance of me—and I could not be more grateful. It also, of course, has meant that I needed to remove my head from that rectal cavity. So, again, usually those moments are appreciated in hindsight.</p>
<h3 id="section10">Pick up a book! </h3>
<p>There are many books out there that aren’t so much self-help as they are people just like you sharing their stories and how they’ve come to find greater balance. Maybe you’ll find something that speaks to you. Titles that have stood out to me include:</p>
<ul><li><em>Thrive</em> by Arianna Huffington</li>
<li><em>Tools of Titans</em> by Tim Ferriss</li>
<li><em>Girl, Stop Apologizing</em> by Rachel Hollis</li>
<li><em>Dare to Lead</em> by Brené Brown</li>
</ul><p>Or, another tactic I love to employ is to read or listen to a book that has NOTHING to do with my work-life balance. I’ve read the following books and found they helped balance me out because my mind was pondering their interesting topics instead of running in circles:</p>
<ul><li><em>The Drunken Botanist</em> by Amy Stewart</li>
<li><em>Superlife</em> by Darin Olien</li>
<li><em>A Brief History of Everyone Who Ever Lived</em> by Adam Rutherford</li>
<li><em>Gaia’s Garden</em> by Toby Hemenway </li>
</ul><p>If you’re not into reading, pick up a topic on YouTube or choose a podcast to subscribe to. I’ve watched countless permaculture and gardening topics in addition to how to raise chickens and ducks. For the record, I do not have a particularly large food garden, nor do I own livestock of any kind…yet. I just find the topic interesting, and it has nothing to do with any aspect of my life that <em>needs</em> anything from me.</p>
<h3 id="section11">Forgive yourself</h3>
<p>You are never going to be perfect—hell, it would be boring if you were. It’s OK to be broken and flawed. It’s human to be tired and sad and worried. It’s OK to not do it all. It’s scary to be imperfect, but you cannot be brave if nothing were scary.</p>
<p>This last one is the most important: <strong>allow yourself permission to NOT do it all.</strong> You never promised to be everything to everyone at all times. We are more powerful than the fears that drive us. </p>
<p>This is hard. It is hard for me. It’s what’s driven me to write this—that it’s OK to stop. It’s OK that your unhealthy habit that might even benefit those around you needs to end. You can still be successful in life.</p>
<p>I recently read that we are all writing our eulogy in how we live. Knowing that your professional accomplishments won’t be mentioned in that speech, what will yours say? What do you want it to say? </p>
<p>Look, I get that none of these ideas will “fix it,” and that’s not their purpose. None of us are in control of our surroundings, only how we respond to them. These suggestions are to help stop the spiral effect so that you are empowered to address the underlying issues and choose your response. They are things that work for me most of the time. Maybe they’ll work for you.</p>
<h2 id="section12">Does this sound familiar? </h2>
<p>If this sounds familiar, it’s not just you. Don’t let your negative self-talk tell you that you “even burn out wrong.” It’s not wrong. Even if rooted in fear like my own drivers, I believe that this need to do more comes from a place of love, determination, motivation, and other wonderful attributes that make you the amazing person you are. We’re going to be OK, ya know. The lives that unfold before us might never look like that story in our head—that idea of “perfect” or “done” we’re looking for, but that’s OK. Really, when we stop and look around, usually the only eyes that judge us are in the mirror. </p>
<p>Do you remember that Winnie the Pooh sketch that had Pooh eat so much at Rabbit’s house that his buttocks couldn’t fit through the door? Well, I already associate a lot with Rabbit, so it came as no surprise when he abruptly declared that this was unacceptable. But do you recall what happened next? He put a shelf across poor Pooh’s ankles and decorations on his back, and made the best of the big butt in his kitchen. </p>
<p>At the end of the day we are resourceful and know that we are able to push ourselves if we need to—even when we are tired to our core or have a big butt of fluff ‘n’ stuff in our room. None of us has to be afraid, as we can manage any obstacle put in front of us. And maybe that means we will need to redefine success to allow space for being uncomfortably human, but that doesn’t really sound so bad either. </p>
<p>So, wherever you are right now, please breathe. Do what you need to do to get out of your head. Forgive and take care.</p>]]></description>
      <link>https://alistapart.com/article/thats-not-my-burnout/</link>
      <guid>https://alistapart.com/article/thats-not-my-burnout/</guid>
      <pubDate>Thu, 20 May 2021 16:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Beware the Cut ‘n’ Paste Persona]]></title>
      <description><![CDATA[<p><a href="https://thispersondoesnotexist.com/">This Person Does Not Exist</a> is a website that generates human faces with a machine learning algorithm. It takes real portraits and recombines them into fake human faces. We recently scrolled past a LinkedIn post stating that this website could be useful “if you are developing a persona and looking for a photo.” </p><div class="aside-breaker">Article Continues Below</div>
<p>We agree: the computer-generated faces could be a great match for personas—but not for the reason you might think. Ironically, the website highlights the core issue of this very common design method: <em>the person(a) does not exist</em>. Like the pictures, personas are artificially made. Information is taken out of natural context and recombined into an isolated snapshot that’s detached from reality. </p>
<p>But strangely enough, designers use personas to inspire their design for the real world. </p>
<h2>Personas: A step back<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/beware-the-cut-n-paste-persona#section2">#section2</a></h2>
<p>Most designers have created, used, or come across personas at least once in their career. In their article “<a href="https://www.interaction-design.org/literature/article/personas-why-and-how-you-should-use-them">Personas – A Simple Introduction</a>,” the Interaction Design Foundation defines personas as “fictional characters, which you create based upon your research in order to represent the different user types that might use your service, product, site, or brand.” In their most complete expression, personas typically consist of a name, profile picture, quotes, demographics, goals, needs, behavior in relation to a certain service/product, emotions, and motivations (for example, see Creative Companion’s <a href="https://creativecompanion.wordpress.com/2011/05/05/the-persona-core-poster/">Persona Core Poster</a>). The purpose of personas, as <a href="https://medium.designit.com/mindset-over-matter-a-new-design-trick-for-your-toolbox-part-one-91bc5f82360f">stated by</a> design agency Designit, is “to make the research relatable, [and] easy to communicate, digest, reference, and apply to product and service development.”</p>
<h2>The decontextualization of personas<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/beware-the-cut-n-paste-persona#section3">#section3</a></h2>
<p>Personas are popular because they make “dry” research data more relatable, more human. However, this method constrains the researcher’s data analysis in such a way that the investigated users are removed from their unique contexts. As a result, personas don’t portray key factors that make you understand their decision-making process or allow you to relate to users’ thoughts and behavior; they lack <em>stories</em>. You understand <em>what</em> the persona did, but you don’t have the background to understand <em>why</em>. You end up with representations of users that are actually <em>less</em> human.</p>
<p>This “decontextualization” we see in personas happens in four ways, which we’ll explain below. </p>
<h3>Personas assume people are static <a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/beware-the-cut-n-paste-persona#section4">#section4</a></h3>
<p>Although many companies still try to box in their employees and customers with outdated personality tests (referring to you, Myers-Briggs), here’s a painfully obvious truth: people are not a fixed set of features. You act, think, and feel differently according to the situations you experience. You appear different to different people; you might act friendly to some, rough to others. And you change your mind all the time about decisions you’ve taken. </p>
<p><a href="https://en.wikipedia.org/wiki/Person%E2%80%93situation_debate#Current_directions">Modern psychologists agree</a> that while people generally behave according to certain patterns, it’s actually a combination of background and environment that determines how people act and take decisions. The context—the environment, the influence of other people, your mood, the entire history that led up to a situation—determines the kind of person you are in each specific moment. </p>
<p>In their attempt to simplify reality, personas do not take this variability into account; they present a user as a fixed set of features. Like personality tests, personas snatch people away from real life. Even worse, people are reduced to a label and categorized as “that kind of person” with no means to exercise their innate flexibility. This practice reinforces stereotypes, lowers diversity, and doesn’t reflect reality. </p>
<h3>Personas focus on individuals, not the environment<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/beware-the-cut-n-paste-persona#section5">#section5</a></h3>
<p>In the real world, you’re designing for a context, not for an individual. Each person lives in a family, a community, an ecosystem, where there are environmental, political, and social factors you need to consider. A design is never meant for a single user. Rather, you design for one or more particular contexts in which many people might use that product. Personas, however, show the user <em>alone</em> rather than describe how the user relates to the environment. </p>
<p>Would you always make the same decision over and over again? Maybe you’re a committed vegan but still decide to buy some meat when your relatives are coming over. As they depend on different situations and variables, your decisions—and behavior, opinions, and statements—are not absolute but highly contextual. The persona that “represents” you wouldn’t take into account this dependency, because it doesn’t specify the premises of your decisions. It doesn’t provide a justification of why you act the way you do. Personas enact the well-known bias called <a href="https://en.wikipedia.org/wiki/Fundamental_attribution_error"><em>fundamental attribution error</em></a>: explaining others’ behavior too much by their personality and too little by the situation.</p>
<p>As mentioned by the Interaction Design Foundation, personas are usually placed in a scenario that’s a “specific context with a problem they want to or have to solve”—does that mean context actually <em>is</em> considered? Unfortunately, what often happens is that you take a fictional character and based on that fiction determine how this character might deal with a certain situation. This is made worse by the fact that you haven’t even fully investigated and understood the <em>current</em> context of the people your persona seeks to represent; so how could you possibly understand how they would act in <em>new</em> situations? </p>
<h3>Personas are meaningless averages<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/beware-the-cut-n-paste-persona#section6">#section6</a></h3>
<p>As mentioned in Shlomo Goltz’s <a href="https://www.smashingmagazine.com/2014/08/a-closer-look-at-personas-part-1/">introductory article</a> on <em>Smashing Magazine</em>, “a persona is depicted as a specific person but is not a real individual; rather, it is synthesized from observations of many people.” A well-known critique to this aspect of personas is that <em>the average person does not exist</em>, as per the <a href="https://www.goodreads.com/book/show/24186666-the-end-of-average">famous example</a> of the USA Air Force designing planes based on the average of 140 of their pilots’ physical dimensions and not a single pilot actually fitting within that average seat. </p>
<p>The same limitation applies to mental aspects of people. Have you ever heard a famous person say, “They took what I said out of context! They used my words, but I didn’t mean it like that.” The celebrity’s statement was reported literally, but the reporter failed to explain the context around the statement and didn’t describe the non-verbal expressions. As a result, the intended meaning was lost. You do the same when you create personas: you collect somebody’s statement (or goal, or need, or emotion), of which the meaning can only be understood if you provide its own specific context, yet report it as an isolated finding. </p>
<p>But personas go a step further, extracting a decontextualized finding and joining it with <em>another</em> decontextualized finding from somebody else. The resulting set of findings often does not make sense: it’s unclear, or even contrasting, because it lacks the underlying reasons on why and how that finding has arisen. It lacks <em>meaning</em>. And the persona doesn’t give you the full background of the person(s) to uncover this meaning: you would need to dive into the raw data for each single persona item to find it. What, then, is the usefulness of the persona?</p>
<figure class="wp-block-image size-large"><img width="1999" height="1999" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/05/cut-n-paste-persona-fig3.jpg?resize=1024,1024" alt="Composite image of a man composed of many different photos" class="wp-image-7172942" /></figure><h3>The relatability of personas is deceiving<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/beware-the-cut-n-paste-persona#section7">#section7</a></h3>
<p>To a certain extent, designers realize that a persona is a lifeless average. To overcome this, designers invent and add “relatable” details to personas to make them resemble real individuals. Nothing captures the absurdity of this better than a sentence by the Interaction Design Foundation: “Add a few fictional personal details to make the persona a realistic character.” In other words, you add non-realism in an attempt to create more realism. You deliberately obscure the fact that “John Doe” is an abstract representation of research findings; but wouldn’t it be much more responsible to <em>emphasize</em> that John is only an abstraction? If something is artificial, let’s present it as such.</p>
<p>It’s the finishing touch of a persona’s decontextualization: after having assumed that people’s personalities are fixed, dismissed the importance of their environment, and hidden meaning by joining isolated, non-generalizable findings, designers <em>invent</em> new context to create (their own) meaning. In doing so, as with everything they create, they introduce a host of biases. As phrased by Designit, as designers we can “contextualize [the persona] based on our reality and experience. We create connections that are familiar to <em>us</em>.” This practice reinforces stereotypes, doesn’t reflect real-world diversity, and gets further away from people’s actual reality with every detail added. </p>
<p>To do good design research, we should report the reality “as-is” and make it relatable for our audience, so everyone can use their own empathy and develop their own interpretation and emotional response.</p>
<h2>Dynamic Selves: The alternative to personas<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/beware-the-cut-n-paste-persona#section8">#section8</a></h2>
<p>If we shouldn’t use personas, what should we do instead? </p>
<p>Designit has proposed using <a href="https://medium.designit.com/mindset-over-matter-a-new-design-trick-for-your-toolbox-part-two-f56bd248319a"><em>Mindsets</em></a> instead of personas. Each Mindset is a “spectrum of attitudes and emotional responses that different people have within the same context or life experience.” It challenges designers to not get fixated on a single user’s way of being. Unfortunately, while being a step in the right direction, this proposal doesn’t take into account that people are part of an environment that determines their personality, their behavior, and, yes, their mindset. Therefore, Mindsets are also not absolute but change in regard to the situation. The question remains, what determines a certain Mindset?</p>
<p>Another alternative comes from Margaret P., author of the article “<a href="https://medium.com/microsoft-design/kill-your-personas-1c332d4908cc">Kill Your Personas</a>,” who has argued for replacing personas with <em>persona spectrums</em> that consist of a <em>range</em> of user abilities. For example, a visual impairment could be permanent (blindness), temporary (recovery from eye surgery), or situational (screen glare). Persona spectrums are highly useful for more inclusive and <em>context-based</em> design, as they’re based on the understanding that the context is the pattern, not the personality. Their limitation, however, is that they have a very <em>functional</em> take on users that misses the relatability of a real person taken from within a spectrum. </p>
<p>In developing an alternative to personas, we aim to transform the standard design process to be context-based. Contexts are generalizable and have patterns that we can identify, just like we tried to do previously with people. So how do we identify these patterns? How do we ensure truly context-based design? </p>
<h2>Understand real individuals in multiple contexts<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/beware-the-cut-n-paste-persona#section9">#section9</a></h2>
<p>Nothing is more relatable and inspiring than reality. Therefore, we have to understand real individuals in their multi-faceted contexts, and use this understanding to fuel our design. We refer to this approach as <em>Dynamic Selves</em>.</p>
<p>Let’s take a look at what the approach looks like, based on an example of how one of us applied it in a recent project that researched habits of Italians around energy consumption. We drafted a design research plan aimed at investigating people’s attitudes toward energy consumption and sustainable behavior, with a focus on smart thermostats. </p>
<h4>1. Choose the right sample<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/beware-the-cut-n-paste-persona#section10">#section10</a></h4>
<p>When we argue against personas, we’re often challenged with <a href="https://ux.stackexchange.com/questions/8647/why-not-use-a-real-person-as-a-persona">quotes</a> such as “Where are you going to find a single person that encapsulates all the information from one of these advanced personas[?]” The answer is simple: <em>you don’t have to</em>. You don’t need to have information about many people for your insights to be deep and meaningful. </p>
<p>In qualitative research, validity does not derive from quantity but from accurate sampling. You select the people that best represent the “population” you’re designing for. If this sample is chosen well, and you have understood the sampled people in sufficient depth, you’re able to infer how the rest of the population thinks and behaves. There’s no need to study seven Susans and five Yuriys; one of each will do. </p>
<p>Similarly, you don’t need to understand Susan in fifteen different contexts. Once you’ve seen her in a couple of diverse situations, you’ve understood the scheme of Susan’s response to different contexts. Not Susan as an atomic being but Susan in relation to the surrounding environment: how she might act, feel, and think in different situations. </p>
<p>Given that each person is representative of a part of the total population you’re researching, it becomes clear why each should be represented as an individual, as each already is an abstraction of a larger group of individuals in similar contexts. You don’t want abstractions of abstractions! These selected people need to be understood and shown in their full expression, remaining in their microcosmos—and if you want to identify patterns you can focus on identifying patterns in contexts.</p>
<p>Yet the question remains: how do you select a representative sample? First of all, you have to consider what’s the target audience of the product or service you are designing: it might be useful to look at the company’s goals and strategy, the current customer base, and/or a possible future target audience. </p>
<p>In our example project, we were designing an application for those who own a smart thermostat. In the future, everyone could have a smart thermostat in their house. Right now, though, only early adopters own one. To build a significant sample, we needed to understand the reason why these early adopters became such. We therefore recruited by asking people why they had a smart thermostat and how they got it. There were those who had <em>chosen</em> to buy it, those who had been <em>influenced</em> by others to buy it, and those who had <em>found</em> it in their house. So we selected representatives of these three situations, from different age groups and geographical locations, with an equal balance of tech savvy and non-tech savvy participants. </p>
<h4>2. Conduct your research<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/beware-the-cut-n-paste-persona#section11">#section11</a></h4>
<p>After having chosen and recruited your sample, conduct your research using ethnographic methodologies. This will make your qualitative data rich with anecdotes and examples. In our example project, given COVID-19 restrictions, we converted an in-house ethnographic research effort into remote family interviews, conducted from home and accompanied by diary studies.</p>
<p>To gain an in-depth understanding of attitudes and decision-making trade-offs, the research focus was not limited to the interviewee alone but deliberately included the whole family. Each interviewee would tell a story that would then become much more lively and precise with the corrections or additional details coming from wives, husbands, children, or sometimes even pets. We also focused on the relationships with other meaningful people (such as colleagues or distant family) and all the behaviors that resulted from those relationships. This wide research focus allowed us to shape a vivid mental image of dynamic situations with multiple actors. </p>
<p>It’s essential that the scope of the research remains broad enough to be able to include all possible actors. Therefore, it normally works best to define broad research areas with macro questions. Interviews are best set up in a semi-structured way, where follow-up questions will dive into topics mentioned spontaneously by the interviewee. This open-minded “plan to be surprised” will yield the most insightful findings. When we asked one of our participants how his family regulated the house temperature, he replied, “My wife has not installed the thermostat’s app—she uses WhatsApp instead. If she wants to turn on the heater and she is not home, she will text me. <em>I am her thermostat.”</em></p>
<h4>3. Analysis: Create the Dynamic Selves<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/beware-the-cut-n-paste-persona#section12">#section12</a></h4>
<p>During the research analysis, you start representing each individual with <em>multiple</em> Dynamic Selves, each “Self” representing one of the contexts you have investigated. The core of each Dynamic Self is a quote, which comes supported by a photo and a few relevant demographics that illustrate the wider context. The research findings themselves will show which demographics are relevant to show. In our case, as our research focused on families and their lifestyle to understand their needs for thermal regulation, the important demographics were family type, number and nature of houses owned, economic status, and technological maturity. (We also included the individual’s name and age, but they’re optional—we included them to ease the stakeholders’ transition from personas and be able to connect multiple actions and contexts to the same person).</p>
<figure class="wp-block-image size-large"><img width="1999" height="1081" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/05/cut-n-paste-persona-fig1.png?resize=1024,554" alt="Three cards, each showing a different lifestyle photo, a quote that correlates to that dynamic self's attitude about technology, and some basic demographic info" class="wp-image-7172943" /></figure><p>To capture exact quotes, interviews need to be video-recorded and notes need to be taken <em>verbatim</em> as much as possible. This is essential to the truthfulness of the several Selves of each participant. In the case of real-life ethnographic research, photos of the context and anonymized actors are essential to build realistic Selves. Ideally, these photos should come directly from field research, but an evocative and representative image will work, too, as long as it’s realistic and depicts meaningful actions that you associate with your participants. For example, one of our interviewees told us about his mountain home where he used to spend every weekend with his family. Therefore, we portrayed him hiking with his little daughter. </p>
<p>At the end of the research analysis, we displayed all of the Selves’ “cards” on a single canvas, categorized by activities. Each card displayed a situation, represented by a quote and a unique photo. All participants had multiple cards about themselves.</p>
<figure class="wp-block-image size-large"><img width="1999" height="853" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/05/cut-n-paste-persona-fig2.png?resize=1024,437" alt="A collection of many cards representing many dynamic self personas" class="wp-image-7172944" /></figure><h4>4. Identify design opportunities<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/beware-the-cut-n-paste-persona#section13">#section13</a></h4>
<p>Once you have collected all main quotes from the interview transcripts and diaries, and laid them all down as Self cards, you will see patterns emerge. These patterns will highlight the <em>opportunity areas</em> for new product creation, new functionalities, and new services—for new design. </p>
<p>In our example project, there was a particularly interesting insight around the concept of humidity. We realized that people don’t know what humidity is and why it is important to monitor it for health: an environment that’s too dry or too wet can cause respiratory problems or worsen existing ones. This highlighted a big opportunity for our client to educate users on this concept and become a health advisor.</p>
<h3>Benefits of Dynamic Selves<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/beware-the-cut-n-paste-persona#section14">#section14</a></h3>
<p>When you use the Dynamic Selves approach in your research, you start to notice unique social relations, peculiar situations real people face and the actions that follow, and that people are surrounded by changing environments. In our thermostat project, we have come to know one of the participants, Davide, as a boyfriend, dog-lover, and tech enthusiast. </p>
<p>Davide is an individual we might have once reduced to a persona called “tech enthusiast.” But we can have tech enthusiasts who have families or are single, who are rich or poor. Their motivations and priorities when deciding to purchase a new thermostat can be opposite according to these different frames. </p>
<p>Once you have understood Davide in multiple situations, and for each situation have understood in sufficient depth the underlying reasons for his behavior, you’re able to generalize how he would act in another situation. You can use your understanding of him to infer what he would think and do in the contexts (or scenarios) that you design for.</p>
<figure class="wp-block-image size-large"><img width="1999" height="1125" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/05/cut-n-paste-persona-fig4.png?resize=1024,576" alt="A comparison. On one side, three people are fused into one to create a persona; in the second, the three people exist as separate dynamic selves." class="wp-image-7172945" /></figure><p>The Dynamic Selves approach aims to dismiss the conflicted dual purpose of personas—to summarize and empathize at the same time—by separating your research summary from the people you’re seeking to empathize with. This is important because our empathy for people is <a href="https://www.epicpeople.org/commodified-empathy/">affected by scale</a>: the bigger the group, the harder it is to feel empathy for others. We feel the strongest empathy for individuals we can personally relate to.  </p>
<p>If you take a <em>real</em> person as inspiration for your design, you no longer need to create an artificial character. No more inventing details to make the character more “realistic,” no more unnecessary additional bias. It’s simply how this person is in real life. In fact, in our experience, personas quickly become nothing more than a name in our <a href="https://alistapart-production.mystagingwebsite.com/article/priority-guides-a-content-first-alternative-to-wireframes/">priority guides</a> and prototype screens, as we all know that these characters don’t really exist. </p>
<p>Another powerful benefit of the Dynamic Selves approach is that it raises the stakes of your work: if you mess up your design, someone real, a person you and the team know and have met, is going to feel the consequences. It might stop you from taking shortcuts and will remind you to conduct <a href="https://alistapart-production.mystagingwebsite.com/article/daily-ethical-design/">daily</a> checks on your designs.</p>
<p>And finally, real people in their specific contexts are a better basis for anecdotal storytelling and therefore are more effective in persuasion. Documentation of real research is essential in achieving this result. It adds weight and urgency behind your design arguments: “When I met Alessandra, the conditions of her workplace struck me. Noise, bad ergonomics, lack of light, you name it. If we go for this functionality, I’m afraid we’re going to add complexity to her life.”</p>
<p>Designit mentioned in their article on Mindsets that “design thinking tools offer a shortcut to deal with reality’s complexities, but this process of simplification can sometimes flatten out people’s lives into a few general characteristics.” Unfortunately, personas have been culprits in a crime of oversimplification. They are unsuited to represent the complex nature of our users’ decision-making processes and don’t account for the fact that humans are immersed in contexts. </p>
<p>Design needs simplification but not generalization. You have to look at the research elements that stand out: the sentences that captured your attention, the images that struck you, the sounds that linger. Portray those, use them to describe the person in their multiple contexts. Both insights and people come with a context; they cannot be cut from that context because it would remove meaning. </p>
<p>It’s high time for design to move away from fiction, and embrace reality—in its messy, surprising, and unquantifiable beauty—as our guide and inspiration.</p>]]></description>
      <link>https://alistapart-production.mystagingwebsite.com/article/beware-the-cut-n-paste-persona/</link>
      <guid>https://alistapart-production.mystagingwebsite.com/article/beware-the-cut-n-paste-persona/</guid>
      <pubDate>Thu, 06 May 2021 16:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Beware the Cut ‘n’ Paste Persona]]></title>
      <description><![CDATA[<p><a href="https://thispersondoesnotexist.com/">This Person Does Not Exist</a> is a website that generates human faces with a machine learning algorithm. It takes real portraits and recombines them into fake human faces. We recently scrolled past a LinkedIn post stating that this website could be useful “if you are developing a persona and looking for a photo.” </p>


<p>We agree: the computer-generated faces could be a great match for personas—but not for the reason you might think. Ironically, the website highlights the core issue of this very common design method: <em>the person(a) does not exist</em>. Like the pictures, personas are artificially made. Information is taken out of natural context and recombined into an isolated snapshot that’s detached from reality. </p>
<p>But strangely enough, designers use personas to inspire their design for the real world. </p>
<h2 id="section2">Personas: A step back</h2>
<p>Most designers have created, used, or come across personas at least once in their career. In their article “<a href="https://www.interaction-design.org/literature/article/personas-why-and-how-you-should-use-them">Personas – A Simple Introduction</a>,” the Interaction Design Foundation defines personas as “fictional characters, which you create based upon your research in order to represent the different user types that might use your service, product, site, or brand.” In their most complete expression, personas typically consist of a name, profile picture, quotes, demographics, goals, needs, behavior in relation to a certain service/product, emotions, and motivations (for example, see Creative Companion’s <a href="https://creativecompanion.wordpress.com/2011/05/05/the-persona-core-poster/">Persona Core Poster</a>). The purpose of personas, as <a href="https://medium.designit.com/mindset-over-matter-a-new-design-trick-for-your-toolbox-part-one-91bc5f82360f">stated by</a> design agency Designit, is “to make the research relatable, [and] easy to communicate, digest, reference, and apply to product and service development.”</p>
<h2 id="section3">The decontextualization of personas</h2>
<p>Personas are popular because they make “dry” research data more relatable, more human. However, this method constrains the researcher’s data analysis in such a way that the investigated users are removed from their unique contexts. As a result, personas don’t portray key factors that make you understand their decision-making process or allow you to relate to users’ thoughts and behavior; they lack <em>stories</em>. You understand <em>what</em> the persona did, but you don’t have the background to understand <em>why</em>. You end up with representations of users that are actually <em>less</em> human.</p>
<p>This “decontextualization” we see in personas happens in four ways, which we’ll explain below. </p>
<h3 id="section4">Personas assume people are static </h3>
<p>Although many companies still try to box in their employees and customers with outdated personality tests (referring to you, Myers-Briggs), here’s a painfully obvious truth: people are not a fixed set of features. You act, think, and feel differently according to the situations you experience. You appear different to different people; you might act friendly to some, rough to others. And you change your mind all the time about decisions you’ve taken. </p>
<p><a href="https://en.wikipedia.org/wiki/Person%E2%80%93situation_debate#Current_directions">Modern psychologists agree</a> that while people generally behave according to certain patterns, it’s actually a combination of background and environment that determines how people act and take decisions. The context—the environment, the influence of other people, your mood, the entire history that led up to a situation—determines the kind of person you are in each specific moment. </p>
<p>In their attempt to simplify reality, personas do not take this variability into account; they present a user as a fixed set of features. Like personality tests, personas snatch people away from real life. Even worse, people are reduced to a label and categorized as “that kind of person” with no means to exercise their innate flexibility. This practice reinforces stereotypes, lowers diversity, and doesn’t reflect reality. </p>
<h3 id="section5">Personas focus on individuals, not the environment</h3>
<p>In the real world, you’re designing for a context, not for an individual. Each person lives in a family, a community, an ecosystem, where there are environmental, political, and social factors you need to consider. A design is never meant for a single user. Rather, you design for one or more particular contexts in which many people might use that product. Personas, however, show the user <em>alone</em> rather than describe how the user relates to the environment. </p>
<p>Would you always make the same decision over and over again? Maybe you’re a committed vegan but still decide to buy some meat when your relatives are coming over. As they depend on different situations and variables, your decisions—and behavior, opinions, and statements—are not absolute but highly contextual. The persona that “represents” you wouldn’t take into account this dependency, because it doesn’t specify the premises of your decisions. It doesn’t provide a justification of why you act the way you do. Personas enact the well-known bias called <a href="https://en.wikipedia.org/wiki/Fundamental_attribution_error"><em>fundamental attribution error</em></a>: explaining others’ behavior too much by their personality and too little by the situation.</p>
<p>As mentioned by the Interaction Design Foundation, personas are usually placed in a scenario that’s a “specific context with a problem they want to or have to solve”—does that mean context actually <em>is</em> considered? Unfortunately, what often happens is that you take a fictional character and based on that fiction determine how this character might deal with a certain situation. This is made worse by the fact that you haven’t even fully investigated and understood the <em>current</em> context of the people your persona seeks to represent; so how could you possibly understand how they would act in <em>new</em> situations? </p>
<h3 id="section6">Personas are meaningless averages</h3>
<p>As mentioned in Shlomo Goltz’s <a href="https://www.smashingmagazine.com/2014/08/a-closer-look-at-personas-part-1/">introductory article</a> on <em>Smashing Magazine</em>, “a persona is depicted as a specific person but is not a real individual; rather, it is synthesized from observations of many people.” A well-known critique to this aspect of personas is that <em>the average person does not exist</em>, as per the <a href="https://www.goodreads.com/book/show/24186666-the-end-of-average">famous example</a> of the USA Air Force designing planes based on the average of 140 of their pilots’ physical dimensions and not a single pilot actually fitting within that average seat. </p>
<p>The same limitation applies to mental aspects of people. Have you ever heard a famous person say, “They took what I said out of context! They used my words, but I didn’t mean it like that.” The celebrity’s statement was reported literally, but the reporter failed to explain the context around the statement and didn’t describe the non-verbal expressions. As a result, the intended meaning was lost. You do the same when you create personas: you collect somebody’s statement (or goal, or need, or emotion), of which the meaning can only be understood if you provide its own specific context, yet report it as an isolated finding. </p>
<p>But personas go a step further, extracting a decontextualized finding and joining it with <em>another</em> decontextualized finding from somebody else. The resulting set of findings often does not make sense: it’s unclear, or even contrasting, because it lacks the underlying reasons on why and how that finding has arisen. It lacks <em>meaning</em>. And the persona doesn’t give you the full background of the person(s) to uncover this meaning: you would need to dive into the raw data for each single persona item to find it. What, then, is the usefulness of the persona?</p>
<figure id="figure1" class="wp-block-image size-large"><img width="960" height="960" src="https://alistapart.com/wp-content/uploads/2021/05/cut-n-paste-persona-fig3.jpg?resize=960%2C960" alt="Composite image of a man composed of many different photos" class="wp-image-7172942" data-recalc-dims="1" /></figure><h3 id="section7">The relatability of personas is deceiving</h3>
<p>To a certain extent, designers realize that a persona is a lifeless average. To overcome this, designers invent and add “relatable” details to personas to make them resemble real individuals. Nothing captures the absurdity of this better than a sentence by the Interaction Design Foundation: “Add a few fictional personal details to make the persona a realistic character.” In other words, you add non-realism in an attempt to create more realism. You deliberately obscure the fact that “John Doe” is an abstract representation of research findings; but wouldn’t it be much more responsible to <em>emphasize</em> that John is only an abstraction? If something is artificial, let’s present it as such.</p>
<p>It’s the finishing touch of a persona’s decontextualization: after having assumed that people’s personalities are fixed, dismissed the importance of their environment, and hidden meaning by joining isolated, non-generalizable findings, designers <em>invent</em> new context to create (their own) meaning. In doing so, as with everything they create, they introduce a host of biases. As phrased by Designit, as designers we can “contextualize [the persona] based on our reality and experience. We create connections that are familiar to <em>us</em>.” This practice reinforces stereotypes, doesn’t reflect real-world diversity, and gets further away from people’s actual reality with every detail added. </p>
<p>To do good design research, we should report the reality “as-is” and make it relatable for our audience, so everyone can use their own empathy and develop their own interpretation and emotional response.</p>
<h2 id="section8">Dynamic Selves: The alternative to personas</h2>
<p>If we shouldn’t use personas, what should we do instead? </p>
<p>Designit has proposed using <a href="https://medium.designit.com/mindset-over-matter-a-new-design-trick-for-your-toolbox-part-two-f56bd248319a"><em>Mindsets</em></a> instead of personas. Each Mindset is a “spectrum of attitudes and emotional responses that different people have within the same context or life experience.” It challenges designers to not get fixated on a single user’s way of being. Unfortunately, while being a step in the right direction, this proposal doesn’t take into account that people are part of an environment that determines their personality, their behavior, and, yes, their mindset. Therefore, Mindsets are also not absolute but change in regard to the situation. The question remains, what determines a certain Mindset?</p>
<p>Another alternative comes from Margaret P., author of the article “<a href="https://medium.com/microsoft-design/kill-your-personas-1c332d4908cc">Kill Your Personas</a>,” who has argued for replacing personas with <em>persona spectrums</em> that consist of a <em>range</em> of user abilities. For example, a visual impairment could be permanent (blindness), temporary (recovery from eye surgery), or situational (screen glare). Persona spectrums are highly useful for more inclusive and <em>context-based</em> design, as they’re based on the understanding that the context is the pattern, not the personality. Their limitation, however, is that they have a very <em>functional</em> take on users that misses the relatability of a real person taken from within a spectrum. </p>
<p>In developing an alternative to personas, we aim to transform the standard design process to be context-based. Contexts are generalizable and have patterns that we can identify, just like we tried to do previously with people. So how do we identify these patterns? How do we ensure truly context-based design? </p>
<h2 id="section9">Understand real individuals in multiple contexts</h2>
<p>Nothing is more relatable and inspiring than reality. Therefore, we have to understand real individuals in their multi-faceted contexts, and use this understanding to fuel our design. We refer to this approach as <em>Dynamic Selves</em>.</p>
<p>Let’s take a look at what the approach looks like, based on an example of how one of us applied it in a recent project that researched habits of Italians around energy consumption. We drafted a design research plan aimed at investigating people’s attitudes toward energy consumption and sustainable behavior, with a focus on smart thermostats. </p>
<h4 id="section10">1. Choose the right sample</h4>
<p>When we argue against personas, we’re often challenged with <a href="https://ux.stackexchange.com/questions/8647/why-not-use-a-real-person-as-a-persona">quotes</a> such as “Where are you going to find a single person that encapsulates all the information from one of these advanced personas[?]” The answer is simple: <em>you don’t have to</em>. You don’t need to have information about many people for your insights to be deep and meaningful. </p>
<p>In qualitative research, validity does not derive from quantity but from accurate sampling. You select the people that best represent the “population” you’re designing for. If this sample is chosen well, and you have understood the sampled people in sufficient depth, you’re able to infer how the rest of the population thinks and behaves. There’s no need to study seven Susans and five Yuriys; one of each will do. </p>
<p>Similarly, you don’t need to understand Susan in fifteen different contexts. Once you’ve seen her in a couple of diverse situations, you’ve understood the scheme of Susan’s response to different contexts. Not Susan as an atomic being but Susan in relation to the surrounding environment: how she might act, feel, and think in different situations. </p>
<p>Given that each person is representative of a part of the total population you’re researching, it becomes clear why each should be represented as an individual, as each already is an abstraction of a larger group of individuals in similar contexts. You don’t want abstractions of abstractions! These selected people need to be understood and shown in their full expression, remaining in their microcosmos—and if you want to identify patterns you can focus on identifying patterns in contexts.</p>
<p>Yet the question remains: how do you select a representative sample? First of all, you have to consider what’s the target audience of the product or service you are designing: it might be useful to look at the company’s goals and strategy, the current customer base, and/or a possible future target audience. </p>
<p>In our example project, we were designing an application for those who own a smart thermostat. In the future, everyone could have a smart thermostat in their house. Right now, though, only early adopters own one. To build a significant sample, we needed to understand the reason why these early adopters became such. We therefore recruited by asking people why they had a smart thermostat and how they got it. There were those who had <em>chosen</em> to buy it, those who had been <em>influenced</em> by others to buy it, and those who had <em>found</em> it in their house. So we selected representatives of these three situations, from different age groups and geographical locations, with an equal balance of tech savvy and non-tech savvy participants. </p>
<h4 id="section11">2. Conduct your research</h4>
<p>After having chosen and recruited your sample, conduct your research using ethnographic methodologies. This will make your qualitative data rich with anecdotes and examples. In our example project, given COVID-19 restrictions, we converted an in-house ethnographic research effort into remote family interviews, conducted from home and accompanied by diary studies.</p>
<p>To gain an in-depth understanding of attitudes and decision-making trade-offs, the research focus was not limited to the interviewee alone but deliberately included the whole family. Each interviewee would tell a story that would then become much more lively and precise with the corrections or additional details coming from wives, husbands, children, or sometimes even pets. We also focused on the relationships with other meaningful people (such as colleagues or distant family) and all the behaviors that resulted from those relationships. This wide research focus allowed us to shape a vivid mental image of dynamic situations with multiple actors. </p>
<p>It’s essential that the scope of the research remains broad enough to be able to include all possible actors. Therefore, it normally works best to define broad research areas with macro questions. Interviews are best set up in a semi-structured way, where follow-up questions will dive into topics mentioned spontaneously by the interviewee. This open-minded “plan to be surprised” will yield the most insightful findings. When we asked one of our participants how his family regulated the house temperature, he replied, “My wife has not installed the thermostat’s app—she uses WhatsApp instead. If she wants to turn on the heater and she is not home, she will text me. <em>I am her thermostat.”</em></p>
<h4 id="section12">3. Analysis: Create the Dynamic Selves</h4>
<p>During the research analysis, you start representing each individual with <em>multiple</em> Dynamic Selves, each “Self” representing one of the contexts you have investigated. The core of each Dynamic Self is a quote, which comes supported by a photo and a few relevant demographics that illustrate the wider context. The research findings themselves will show which demographics are relevant to show. In our case, as our research focused on families and their lifestyle to understand their needs for thermal regulation, the important demographics were family type, number and nature of houses owned, economic status, and technological maturity. (We also included the individual’s name and age, but they’re optional—we included them to ease the stakeholders’ transition from personas and be able to connect multiple actions and contexts to the same person).</p>
<figure id="figure2" class="wp-block-image size-large"><img width="960" height="519" src="https://alistapart.com/wp-content/uploads/2021/05/cut-n-paste-persona-fig1.png?resize=960%2C519" alt="Three cards, each showing a different lifestyle photo, a quote that correlates to that dynamic self's attitude about technology, and some basic demographic info" class="wp-image-7172943" data-recalc-dims="1" /></figure><p>To capture exact quotes, interviews need to be video-recorded and notes need to be taken <em>verbatim</em> as much as possible. This is essential to the truthfulness of the several Selves of each participant. In the case of real-life ethnographic research, photos of the context and anonymized actors are essential to build realistic Selves. Ideally, these photos should come directly from field research, but an evocative and representative image will work, too, as long as it’s realistic and depicts meaningful actions that you associate with your participants. For example, one of our interviewees told us about his mountain home where he used to spend every weekend with his family. Therefore, we portrayed him hiking with his little daughter. </p>
<p>At the end of the research analysis, we displayed all of the Selves’ “cards” on a single canvas, categorized by activities. Each card displayed a situation, represented by a quote and a unique photo. All participants had multiple cards about themselves.</p>
<figure id="figure3" class="wp-block-image size-large"><img width="960" height="410" src="https://alistapart.com/wp-content/uploads/2021/05/cut-n-paste-persona-fig2.png?resize=960%2C410" alt="A collection of many cards representing many dynamic self personas" class="wp-image-7172944" data-recalc-dims="1" /></figure><h4 id="section13">4. Identify design opportunities</h4>
<p>Once you have collected all main quotes from the interview transcripts and diaries, and laid them all down as Self cards, you will see patterns emerge. These patterns will highlight the <em>opportunity areas</em> for new product creation, new functionalities, and new services—for new design. </p>
<p>In our example project, there was a particularly interesting insight around the concept of humidity. We realized that people don’t know what humidity is and why it is important to monitor it for health: an environment that’s too dry or too wet can cause respiratory problems or worsen existing ones. This highlighted a big opportunity for our client to educate users on this concept and become a health advisor.</p>
<h3 id="section14">Benefits of Dynamic Selves</h3>
<p>When you use the Dynamic Selves approach in your research, you start to notice unique social relations, peculiar situations real people face and the actions that follow, and that people are surrounded by changing environments. In our thermostat project, we have come to know one of the participants, Davide, as a boyfriend, dog-lover, and tech enthusiast. </p>
<p>Davide is an individual we might have once reduced to a persona called “tech enthusiast.” But we can have tech enthusiasts who have families or are single, who are rich or poor. Their motivations and priorities when deciding to purchase a new thermostat can be opposite according to these different frames. </p>
<p>Once you have understood Davide in multiple situations, and for each situation have understood in sufficient depth the underlying reasons for his behavior, you’re able to generalize how he would act in another situation. You can use your understanding of him to infer what he would think and do in the contexts (or scenarios) that you design for.</p>
<figure id="figure4" class="wp-block-image size-large"><img width="960" height="540" src="https://alistapart.com/wp-content/uploads/2021/05/cut-n-paste-persona-fig4.png?resize=960%2C540" alt="A comparison. On one side, three people are fused into one to create a persona; in the second, the three people exist as separate dynamic selves." class="wp-image-7172945" data-recalc-dims="1" /></figure><p>The Dynamic Selves approach aims to dismiss the conflicted dual purpose of personas—to summarize and empathize at the same time—by separating your research summary from the people you’re seeking to empathize with. This is important because our empathy for people is <a href="https://www.epicpeople.org/commodified-empathy/">affected by scale</a>: the bigger the group, the harder it is to feel empathy for others. We feel the strongest empathy for individuals we can personally relate to.  </p>
<p>If you take a <em>real</em> person as inspiration for your design, you no longer need to create an artificial character. No more inventing details to make the character more “realistic,” no more unnecessary additional bias. It’s simply how this person is in real life. In fact, in our experience, personas quickly become nothing more than a name in our <a href="https://alistapart.com/article/priority-guides-a-content-first-alternative-to-wireframes/">priority guides</a> and prototype screens, as we all know that these characters don’t really exist. </p>
<p>Another powerful benefit of the Dynamic Selves approach is that it raises the stakes of your work: if you mess up your design, someone real, a person you and the team know and have met, is going to feel the consequences. It might stop you from taking shortcuts and will remind you to conduct <a href="https://alistapart.com/article/daily-ethical-design/">daily</a> checks on your designs.</p>
<p>And finally, real people in their specific contexts are a better basis for anecdotal storytelling and therefore are more effective in persuasion. Documentation of real research is essential in achieving this result. It adds weight and urgency behind your design arguments: “When I met Alessandra, the conditions of her workplace struck me. Noise, bad ergonomics, lack of light, you name it. If we go for this functionality, I’m afraid we’re going to add complexity to her life.”</p>
<h2 id="section15">Conclusion</h2>
<p>Designit mentioned in their article on Mindsets that “design thinking tools offer a shortcut to deal with reality’s complexities, but this process of simplification can sometimes flatten out people’s lives into a few general characteristics.” Unfortunately, personas have been culprits in a crime of oversimplification. They are unsuited to represent the complex nature of our users’ decision-making processes and don’t account for the fact that humans are immersed in contexts. </p>
<p>Design needs simplification but not generalization. You have to look at the research elements that stand out: the sentences that captured your attention, the images that struck you, the sounds that linger. Portray those, use them to describe the person in their multiple contexts. Both insights and people come with a context; they cannot be cut from that context because it would remove meaning. </p>
<p>It’s high time for design to move away from fiction, and embrace reality—in its messy, surprising, and unquantifiable beauty—as our guide and inspiration.</p>]]></description>
      <link>https://alistapart.com/article/beware-the-cut-n-paste-persona/</link>
      <guid>https://alistapart.com/article/beware-the-cut-n-paste-persona/</guid>
      <pubDate>Thu, 06 May 2021 16:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Immersive Content Strategy]]></title>
      <description><![CDATA[<div class="entry-content">
<p>Beyond the severe toll of the coronavirus pandemic, perhaps no other disruption has transformed user experiences quite like how the tethers to our formerly web-biased era of content have frayed. We’re transitioning to a new world of remote work and digital content. We’re also experimenting with unprecedented content channels that, not too long ago, elicited chuckles at the watercooler, like voice interfaces, digital signage, augmented reality, and virtual reality.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>Many factors are responsible. Perhaps it’s because we yearn for immersive spaces that temporarily resurrect the Before Times, or maybe it’s due to the boredom and tedium of our now-cemented stuck-at-home routines. But aural user experiences slinging <a href="https://alistapart.com/article/usability-testing-for-voice-content/">voice content</a>, and immersive user experiences unlocking new forms of interacting with formerly web-bound content, are no longer figments of science fiction. They’re fast becoming a reality in the here and now.</p>
<p>The idea of <em>immersive experiences</em> is all the rage these days, and content strategists and designers are now seriously examining this still-amorphous trend. Immersive experiences embrace concepts like geolocation, digital signage, and extended reality (XR). XR encompasses augmented reality (AR) and virtual reality (VR) as well as their fusion: mixed reality (MR). Sales of immersive equipment like gaming and VR headsets <a href="https://www.thetimes.co.uk/article/virtual-reality-pandemic-leads-to-rise-in-headset-sales-to-escape-lockdown-jhhn8wghn">have skyrocketed during the pandemic</a>, and content strategists are increasingly attuned to the kaleidoscope of devices and interfaces users now interact with on a daily basis to acquire information.</p>
<p>Immersive user experiences are becoming commonplace, and, more importantly, <a href="https://www.smashingmagazine.com/2020/10/using-webxr-with-babylonjs/">new tools and frameworks are emerging</a> for designers and developers looking to get their hands dirty. But that doesn’t mean our content is ready for prime time in settings unbound from the web like physical spaces, digital signage, or extended reality. Recasting your fixed web content in more immersive ways will enable more than just newfangled user experiences; it’ll prepare you for flexibility in an unpredictable future as well.</p>
<h2 id="section2"><strong>Agnostic content for immersive experiences</strong><a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>These days, we interact with content through a slew of devices. It’s no longer the case that we navigate information on a single desktop computer screen. In my upcoming book <a href="https://preston.so/books/voice-content"><em>Voice Content and Usability</em></a> (A Book Apart, coming June 2021), I draw a distinction between what I call <em>macrocontent</em>—the unwieldy long-form copy plastered across browser viewports—and <a href="https://anildash.com/2002/11/13/introducing-microcontent-client/">Anil Dash’s definition of <em>microcontent</em></a>: the kind of brisk, contextless bursts of content that we find nowadays on Apple Watches, Samsung TVs, and Amazon Alexas.</p>
<p>Today, content also has to be ready for contextless situations—not only in truncated form when we struggle to make out tiny text on our smartwatches or scroll through new television series on Roku but also in places it’s never ended up before. As the twenty-first century continues apace, our clients and our teams are beginning to come to terms with the fact that the way copy is consumed in just a few decades will bear no resemblance whatsoever to the prosaic browsers and even smartphones of today.</p>
<h3 id="section3">What do we mean by immersive content?<a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h3>
<p><em>Immersive experiences</em> are those that, <a href="https://www.cmswire.com/customer-experience/immersive-experiences-be-there-or-be-left-behind/">according to Forrester</a>, blur “the boundaries between the human, digital, physical, and virtual realms” to facilitate smarter, more interactive user experiences. But what do we mean by immersive content? I define <em>immersive content</em> as content that plays in the sandbox of physical and virtual space—copy and media that are situationally or locationally aware rather than rooted in a static, unmoving computer screen.</p>
<p>Whether a space is real or virtual, immersive content (or <em>spatialcontent</em>) will be a key way in which our customers and users deal with information in the coming years. Unlike voice content, which deals with time and sound, immersive content works with space and sight. Immersive content operates not along the axis of links and page changes but rather along <em>situational changes</em>, as the following figure illustrates.</p>
<div class="wp-block-image">
<figure id="figure1" class="aligncenter size-large"><img width="623" height="383" src="https://alistapart.com/wp-content/uploads/2021/04/situational-change-diagram.png?resize=623%2C383" alt="" class="wp-image-7172894" data-recalc-dims="1" /><figcaption><em>In this illustration, each rectangle represents different displays that appear based on situational changes such as movement in space or adjustment of perspective that result in the delivery of different content from the previous context. One of these, such as the rightmost display, can be a web-enabled content display with links to other content presented in the same display. This illustration thus demonstrates two forms of navigation: traditional link navigation and immersive situational navigation.</em></figcaption></figure></div>
<p>Acknowledging the actual or imagined surroundings of where we are as human beings will have vast implications for content strategy, omnichannel marketing, usability testing, and accessibility. Before we dig deeper, let’s define a few clear categories of immersive content:</p>
<ul><li><strong>Digital signage content.</strong> Though it may seem a misnomer, digital signage is one of the most widespread examples of immersive content already in use today. For example, you may have seen it used to display a guide of stores at a mall or to aid wayfinding in an airport. While still largely bound to flat screens, it’s an example of <em>content in space</em>.</li>
<li><strong>Locational content.</strong> Locational content involves copy that is delivered to a user on a personal device based on their current location in the world or within an identified physical space. Most often mediated through Bluetooth low-energy (BLE) beacon technology or GPS location services, it’s an example of <em>content at a point in space.</em></li>
<li><strong>Augmented reality content.</strong> Unlike locational content, which doesn’t usually adjust itself seamlessly based on how users move in real-world space, AR content is now common in museums and other environments—typically as overlays that are superimposed over actual physical surroundings and adjust dynamically according to the user’s position and perspective. It’s <em>content projected into real-world space</em>.</li>
<li><strong>Virtual reality content.</strong> Like AR content, VR content is dependent on its imagined surroundings in terms of how it displays, but it’s part of a nonexistent space that is fully immersive, an example of <em>content projected into virtual space</em>.</li>
<li><strong>Navigable content.</strong> Long a gimmicky playground for designers and developers interested in pushing the envelope, navigable content is copy that users can move across and sift through as if it were a physical space itself: true <em>content as space</em>.</li>
</ul><p>The following illustration depicts these types of immersive content in their typical habitats.</p>
<figure id="figure2" class="wp-block-image size-large"><img width="960" height="640" src="https://alistapart.com/wp-content/uploads/2021/04/types-of-immersive-content.jpg?resize=960%2C640" alt="Digital signage content typically appears to everyone within a space. Locational content is delivered via personal devices. AR is content projected into the real world through an overlay, while VR creates an immersive virtual environment. Finally, navigable content is content as the space itself." class="wp-image-7172895" data-recalc-dims="1" /></figure><h3 id="section4">Why auditing immersive content is important<a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h3>
<p>Alongside conversational and voice content, immersive content is a compelling example of <a href="https://www.youtube.com/watch?v=I1Chq_E8uBM">breaking content out of the limiting box</a> where it has long lived: the browser viewport, the computer screen, and the 8.5”x11” or broadsheet borders of print media. For centuries, our written copy has been affixed to the staid standards of whatever bookbinders, newspaper printing presses, and screen manufacturers decided. Today, however, for the first time, we’re surmounting those arbitrary barriers and situating content in contexts that challenge all the assumptions we’ve made since the era of Gutenberg—and, arguably, since clay tablets, papyrus manuscripts, and ancient scrolls.</p>
<p>Today, it’s never been more pressing to implement an <a href="https://preston.so/writing/building-usable-conversations-conversational-content-strategy/"><em>omnichannel content strategy</em></a>that centers the reality our customers increasingly live in: a world in which information can end up on any device, even if it has no tether to a clickable or scrollable setting. One of the most important elements of such a future-proof content strategy is an <em>omnichannel content audit</em> that evaluates your content from a variety of standpoints so you can manage and plan it effectively. These audits generally consist of several steps:</p>
<ul><li><strong>Write a questionnaire.</strong> Each content item needs to be examined from the perspective of each channel through a series of channel-relevant questions, like whether content is <em>legible</em> or <em>discoverable</em> on every conduit through which it travels.</li>
<li><strong>Settle the criteria.</strong> No questionnaire is complete for a content audit without <em>evaluation criteria</em> that measure how the content performs and <em>recommendation criteria</em> that determine necessary steps to improve its efficacy.</li>
<li><strong>Discuss with stakeholders.</strong> At the end of any content audit, it’s important to leaf through the results and any recommendations in a frank discussion with stakeholders, including content strategists, editors, designers, and others.</li>
</ul><p>In <a href="https://alistapart.com/article/usability-testing-for-voice-content/">my previous article for <em>A List Apart</em></a>, I shared the work we did on <a href="https://www.youtube.com/watch?v=kAy6AP-MZ4o">a conversational content audit for Ask GeorgiaGov</a>, the first (but now decommissioned) <a href="https://www.youtube.com/watch?v=evHeWxeznUg">Alexa skill for residents of the state of Georgia</a>. Such a content audit is just one facet of the multifaceted omnichannel content strategy along various dimensions you’ll need to consider. Nonetheless, there are a few things all content audits share in terms of foundational evaluation criteria across all content delivery channels:</p>
<ul><li><strong>Content legibility.</strong> Is the content readable or easily consumable from a variety of vantage points and perspectives? In the case of immersive content, this can include examining <em>verbosity tolerance</em> (how long content can be before users zone out, a big factor in digital signage) and <em>phantom references</em> (like links and calls to action that make sense on the web but not on a VR headset).</li>
<li><strong>Content discoverability.</strong> It’s no longer guaranteed in immersive content experiences that every piece of content can be accessed from other content items, and content loses almost all of its context when displayed unmoored from other content in digital signs or AR overlays. For discoverability’s sake, avoid relegating content to unreachable siloes, whether content is inaccessible due to physical conditions (like walls or other obstacles) or technical ones (like a finicky VR headset).</li>
</ul><p>Like voice content, immersive content requires ample attention to the ways in which users approach and interact with content in physical and virtual spaces. And as I write in <em>Voice Content and Usability</em>, it’s also the case that <em>cross-channel interactions</em> can influence how we work with copy and media. After all, how often do subway and rail commuters glance up while scrolling through service advisories on their smartphones to consult a potentially more up-to-date alert on a digital sign?</p>
<h2 id="section5"><strong>Digital signage content: Content in space</strong><a class="subhead-anchor" href="https://alistapart.com#section5">#section5</a></h2>
<p>Signage has long been a fixture of how we find our way through physical spaces, ever since the earliest roads crisscrossed civilizations. Today, digital signs are becoming ubiquitous across shopping centers, university campuses, and especially transit systems, with the New York City subway recently introducing countdown clocks that display service advisories on a ticker along the bottom of the screen, just below train arrival times.</p>
<p>Digital signs can deliver critical content at important times, such as during emergencies, without the limitations imposed by the static nature of analog signs. News tickers on digital signs, for instance, can stretch for however long they need to, though succinctness is still highly prized. But digital signage’s rich potential to deliver immersive content also presents challenges when it comes to content modeling and governance.</p>
<p>Are news items delivered to digital signs simply teaser or summary versions of full articles? Without a fully functional and configurable digital sign in your office, how will you preview them in context before they go live? To solve this problem for the New York City subway, the Metropolitan Transportation Authority (MTA) <a href="https://www.acquia.com/resources/case-studies/metropolitan-transportation-authority">manages all digital signage content across all signs</a> within a central Drupal content management system (CMS), which synthesizes data such as train arrival times from real-time feeds and transit messages administered in the CMS for arbitrary delivery to any platform across the network.</p>
<p>How to present content items in digital signs also poses problems. As the following figure illustrates, do you overtake the entire screen at the risk of obscuring other information, do you leave it in a ticker that may be ignored, or do you use both depending on the priority or urgency of the content you’re presenting?</p>
<div class="wp-block-image">
<figure id="figure3" class="aligncenter size-large"><img width="623" height="369" src="https://alistapart.com/wp-content/uploads/2021/04/digital-signage-info-priority.png?resize=623%2C369" alt="On the left are examples of digital signage where informational messages obscure important data. On the right are examples of digital signage where informational messages are constricted to a small scrolling ticker at the bottom of the screen." class="wp-image-7172896" data-recalc-dims="1" /></figure></div>
<p>While some digital signs have the benefit of touch screens and occupying entire digital kiosks, many are tasked with providing key information in as little space as possible, where users don’t have the luxury of manipulating the interface to customize the content they wish to view. The New York City subway makes a deliberate choice to allow urgent alerts to spill across the entire screen, which limits the sign’s usefulness for those who simply need to know when the next train is arriving in the interest of more important information that is relevant to all passengers—and those who need captions for loudspeaker announcements.</p>
<h3 id="section6">Auditing for digital signage content<a class="subhead-anchor" href="https://alistapart.com#section6">#section6</a></h3>
<p>Because digital signs value brevity and efficiency, digital signage content often isn’t the main focus of what’s displayed. Digital signs on the São Paulo metro, for instance, juggle service alerts, breaking news, and health advisories. For this reason, auditing digital signage content for legibility and discoverability is key to ensuring users can interact with it gracefully, regardless of how often it appears, how highly prioritized it is, or what it covers.</p>
<p>When it comes to legibility, ask yourself these questions and consider the digital sign content you’re authoring based on these concerns:</p>
<ul><li><strong>Font size and typography.</strong> Many digital signs use sans-serif typefaces, which are easier to read from a distance, and many also employ uppercase for all text, especially in tickers. Consider which typefaces advance rather than obscure legibility, even when the digital sign content overtakes the entire screen.</li>
<li><strong>Angles and perspective.</strong> Is your digital sign content readily readable from various angles and various vantage points? Does the reflectivity of the screen impact your content’s legibility when standing just below the sign? How does your content look when it’s displayed to a user craning their neck and peering at it askew?</li>
<li><strong>Color contrast and lighting.</strong> Digital signs are no longer just fixtures of subterranean worlds; they’re above-ground and in well-lit spaces too. Color contrast and lighting strongly influence how legible your digital sign content can be.</li>
</ul><p>As for discoverability, digital signs present challenges of both physical discoverability (can the sign itself be easily found and consulted?) and content discoverability (how long does a reader have to stare at the sign for the content they need to show up?):</p>
<ul><li><strong>Physical discoverability.</strong> Are signs placed in prominent locations where users will come across them? The MTA was criticized for <a href="https://www.amny.com/transit/subway-countdown-clocks-at-some-stations-are-difficult-to-see-riders-say-1-14115447/">the poor placement of many of its digital countdown clocks</a> in the New York City subway, something that can block a user from ever accessing content they need.</li>
<li><strong>Content discoverability.</strong> Because digital signs can only display so much content at once, even if there’s a large amount of copy to deliver eventually, users of digital signs may need to wait too long for their desired content to appear, or the content they seek may be too deprioritized for it to show up while they’re looking at the sign.</li>
</ul><p>Both legibility and discoverability of digital sign content require thorough approaches when authoring, designing, and implementing content for digital signs.</p>
<h3 id="section7">Usability and accessibility in digital signage content<a class="subhead-anchor" href="https://alistapart.com#section7">#section7</a></h3>
<p>In addition to audits, in any physical environment, immersive content on digital signs requires a careful and bespoke approach to consider not only how content will be consumed on the sign itself but also all the ways in which users move around and refer to digital signage as they consult it for information. After all, our content is no longer couched in a web page or recited by a screen reader, both objects we can control ourselves; instead, it’s flashed and displayed on flat screens and kiosks in physical spaces. </p>
<p>Consider how the digital sign and the content it presents appear to people who use mobility aids such as wheelchairs or walkers. Is the surrounding physical environment accessible enough so that wheelchair users can easily read and discover the content they seek on a digital sign, which may be positioned too high for a seated reader? By the same token, can colorblind and dyslexic people read the chosen typeface in the color scheme it’s rendered in? Is there an aural equivalent of the content for Blind people navigating your digital signage, in close proximity to the sign itself, serving as synchronized captions?</p>
<h2 id="section8"><strong>Locational content: Content at a point in space</strong><a class="subhead-anchor" href="https://alistapart.com#section8">#section8</a></h2>
<p>Unlike digital signage content, which is copy or media displayed in a space, <em>locational</em> (or <em>geolocational</em>) <em>content</em> is copy or media delivered to a device—usually a phone or watch—based on a point in space (if precise location is acquired through GPS location services) or a swath of space (typically driven by Bluetooth Low Energy beacons that have certain ranges). For smartphone and smartwatch users, GPS location services can often pinpoint a relatively accurate sense of where a person is, while Bluetooth Low Energy (BLE) beacons can triangulate their position based on devices that have Bluetooth enabled.</p>
<div class="wp-block-image">
<figure id="figure4" class="aligncenter size-large"><img width="622" height="398" src="https://alistapart.com/wp-content/uploads/2021/04/locational-content.png?resize=622%2C398" alt="Examples of locational content might include links to more detailed information online, coupons, and sales relevant to merchandise or objects near the person viewing it." class="wp-image-7172897" data-recalc-dims="1" /></figure></div>
<p>Though BLE beacons remain a fairly finicky and untested realm of spatial technology, they’ve quickly gained traction in large shopping centers and <a href="https://www.youtube.com/watch?v=I2MuPdt5anI">public spaces such as airports</a> where users agree to receive content relevant to their current location, most often in the form of push notifications that whisk users away into a separate view with more comprehensive information. But because these tiny chunks of copy are often tightly contained and contextless, teams designing for locational content need to focus on how users interact with their devices as they move through physical spaces.</p>
<h3 id="section9">Auditing for locational content<a class="subhead-anchor" href="https://alistapart.com#section9">#section9</a></h3>
<p>Fortunately, because locational content is often delivered to the same visual devices that we use on a regular basis—smartphones, smartwatches, and tablets—auditing for content legibility can embrace many of the same principles we employ to evaluate other content. For discoverability, some of the most important considerations include:</p>
<ul><li><strong>Locational discoverability.</strong> BLE beacons are notorious for their imprecision, though they continue to improve in quality. GPS location, too, can be an inaccurate measure of where someone is at any given time. The last thing you want your customers to experience is an incorrect triangulation of where they are leading to embarrassing mistakes and bewilderment when unexpected content travels down the wire.</li>
<li><strong>Proximity.</strong> Because of the relative lack of precision when it comes to BLE beacons and GPS location services, placing content items too close together in a coordinate map may trigger too many notifications or resource deliveries to a user, thus overwhelming them, or a certain content item may inadvertently supersede another because they’re spaced too closely together.</li>
</ul><p>As push notifications and location sharing become more common, locational content is rapidly becoming an important way to funnel users toward somewhat longer-form content that might otherwise go unnoticed when a customer is in a brick-and-mortar store.</p>
<h3 id="section10">Usability and accessibility in locational content<a class="subhead-anchor" href="https://alistapart.com#section10">#section10</a></h3>
<p>Because locational content requires users to move around physical spaces and trigger triangulation, consider how different types of users will move and also whether unforeseen issues can arise. For example, researchers in Japan found that users who walk while staring at their phones are <a href="https://www.nytimes.com/2021/03/18/science/distracted-walking-phone.html">highly disruptive to the flow and movement of those around them</a>. Is your locational content possibly creating a situation where users bump into others, or worse, get into accidents? For instance, writing copy that’s quick and to the point or preventing notifications from being prematurely dismissed could allow users to ignore their devices until they have time to safely glance at them.</p>
<p>Limited mobility and cognitive disabilities can place many disabled users of locational content at a deep disadvantage. While gamification may encourage users to seek as many items of locational content as possible in a given span of time for promotional purposes, consider whether it excludes wheelchair users or people who encounter obstacles when switching between contexts rapidly. There are good use cases for locational content, but what’s compelling for some users might be confounding for others.</p>
<h2 id="section11"><strong>AR and VR content: Content projected into space</strong><a class="subhead-anchor" href="https://alistapart.com#section11">#section11</a></h2>
<p>Augmented reality, once the stuff of science fiction holograms and futuristic cityscapes, is becoming more available to the masses thanks to wearable AR devices, high-performing smartphones and tablets, and innovation in machine vision capabilities, though the utopian future of true “holographic” content remains as yet unrealized. Meanwhile, virtual reality has seen incredible growth over the pandemic as homebound users—by interacting with copy and media in fictional worlds—increasingly seek escapist ways to access content normally spread across flat screens.</p>
<p>While AR and VR content is still in its infancy, the vast majority is currently couched in <em>overlays</em> that are superimposed over real-world environments or objects and can be opaque (<a href="https://commons.wikimedia.org/wiki/File:Augmented_reality_at_Museu_de_Matar%C3%B3_linking_to_Catalan_Wikipedia_%2818%29.JPG">occupying some of a device’s field of vision</a>) or semi-transparent (creating an eerie, shimmery film on which text or media is displayed). Thanks to advancements in machine vision, these content overlays can track the motion of perceived objects in the physical or virtual world, bamboozling us into thinking these overlays are traveling in our fields of vision just like the things we see around us do.</p>
<p>Formerly restricted to realms like museums, expensive video games, and gimmicky prototypes, AR and VR content is now becoming much more popular among companies that are <a href="https://www.forbes.com/sites/theyec/2019/02/06/augmented-reality-in-business-how-ar-may-change-the-way-we-work/">interested in more immersive experiences</a> capable of <a href="https://www.information-age.com/augmented-reality-revolutionising-way-people-shop-123469739/">delivering content alongside objects</a> in real-life brick-and-mortar environments, as well as virtual or imagined landscapes, like fully immersive brand experiences that transport customers to a pop-up store in their living room.</p>
<p>To demonstrate this, my former team at Acquia Labs built an experimental proof of concept that examines <a href="https://dri.es/virtual-reality-on-campus-with-drupal">how VR content can be administered within a CMS</a> and a pilot project for grocery stores that explores what can happen when <a href="https://dri.es/shopping-with-augmented-reality">product information is displayed as AR content</a> next to consumer goods in supermarket aisles. The following illustration shows, in the context of this latter experiment, how a smartphone camera interacts with a machine vision service and a Drupal CMS to acquire information to render alongside the item.</p>
<div class="wp-block-image">
<figure id="figure5" class="aligncenter size-large"><img width="624" height="331" src="https://alistapart.com/wp-content/uploads/2021/04/ar-cms-example.jpg?resize=624%2C331" alt="A diagram depicting how someone might look at a physical object through their phone, and AR tools can connect to a CMS to download and display relevant information about the object virtually beside it." class="wp-image-7172898" data-recalc-dims="1" /></figure></div>
<h3 id="section12">Auditing for AR and VR content<a class="subhead-anchor" href="https://alistapart.com#section12">#section12</a></h3>
<p>Because AR and VR content, unlike other forms of immersive content, fundamentally plays in the same sandbox as the real world (or an imaginary one), legibility and discoverability can become challenging. The potential risks for AR and VR content are in many regards a fusion of the problems found in both digital signage and locational content, encompassing both physical placement and visual perspective, especially when it comes to legibility:</p>
<ul><li><strong>Content visibility.</strong> Is the AR or VR overlay too transparent to comfortably read the copy or view the image contained therein, or is it so opaque that it obscures its surroundings? AR and VR content must coexist gracefully with its exterior, and the two must enhance rather than obfuscate each other. Does the way your content is delivered compromise a user’s feeling of immersion in the environment behind it?</li>
<li><strong>Content perspective.</strong> Unless you’re limited to a smartphone or similar handheld device, many AR and VR overlays, especially in immersive headsets, don’t display content or media as an immobile rectangular box, as it defeats the purpose of the illusion and can be jarring to users as they adjust their field of vision, breaking them out of the fantasy you’re hoping to create. For this reason, your AR or VR experience must not only dictate how environments and objects are angled and lit but also how the content associated with them is perceived. Is your content readable from various angles and points in the AR view or VR world?</li>
</ul><p>When it comes to discoverability of your AR and VR content, issues like accuracy in machine vision and triangulation of your user’s location and orientation become much more important:</p>
<ul><li><strong>Machine vision.</strong> Most relevantly for AR content, if your copy or media is predicated on machine vision that perceives an object by identifying it according to certain characteristics, how accurate is that prediction? Does some content go undiscovered because certain objects go undetected in your AR-enabled device?</li>
<li><strong>Location accuracy.</strong> If your content relies on the user’s current location and orientation in relation to some point in space, as is common in both AR and VR content use cases, how accurately do devices dictate correct delivery at just the right time and place? Are the ranges within which content is accessible too limited, leading to flashes of content as you take a step to the left or right? Are there locations that simply can’t be reached, leading to forever-siloed copy or media?</li>
</ul><p>Due to the intersection of technical considerations and design concerns, AR and VR content, like voice content and indeed other forms of immersive content, requires a concerted effort across multiple teams to ensure resources are delivered not just legibly but also discoverably.</p>
<h3 id="section13">Usability and accessibility in AR and VR content<a class="subhead-anchor" href="https://alistapart.com#section13">#section13</a></h3>
<p>Out of all the forms of immersive content we’ve covered so far, AR and VR content is possibly the medium that demands the most assiduously crafted solutions in accessibility testing and usability testing. Because AR and VR content, especially in headsets or wearable devices, requires motion through real or imagined space, its impact on accessibility cannot be overstated. Adding a third dimension—and arguably, a fourth: time—to our perception of content requires attention not only to how content is accessed but also all the other elements that comprise a fully immersive visual experience.</p>
<p>VR headsets commonly induce <a href="https://abcnews.go.com/Technology/feel-motion-sickness-virtual-reality/story?id=65153805"><em>virtual reality motion sickness</em></a> in many individuals. Poorly implemented transitions between states occurring in quick succession where content is visible and then invisible, and then visible again, can lead to epileptic seizures if not built with the utmost care. Finally, users moving quickly through spaces may inadvertently trigger vertigo in themselves or even collide with hazardous objects, resulting in potentially serious injuries. There’s a reason we aren’t wearing wearable headsets outside carefully secured environments.</p>
<h2 id="section14"><strong>Navigable content: Content as space</strong><a class="subhead-anchor" href="https://alistapart.com#section14">#section14</a></h2>
<p>This is only the beginning of immersive content. Increasingly, we’re also toying with ideas that seemed harebrained even a few decades ago, like <em>navigable content</em>—copy and media that can be traversed as if the content <em>itself</em> were a navigable space. Imagine zooming in and out of tracts of text and stepping across glyphs like hopping between islands in a Super Mario game. Ambitious designers and developers are exploring this emerging concept of navigable content in exciting ways, both in and out of AR and VR. In many ways, truly navigable content is the endgame of how virtual reality presents information.</p>
<p>Imagining an encyclopedia that we can browse like the classic <a href="https://www.youtube.com/watch?v=jR0vRuZkxdw">1990s opening sequence of the BBC’s <em>Eyewitness</em> television episodes</a> is no longer as far-fetched as we think. Consider, for instance, <a href="http://www.rleonardi.com/interactive-resume/">Robby Leonardi’s interactive résumé</a>, which invites you to play a character as you learn about his career, or <a href="https://bruno-simon.com/">Bruno Simon’s ambitious portfolio</a>, where you drive an animated truck around his website. For navigable content, the risks and rewards for user experience and accessibility remain largely unexplored, just like the hazy fringes of the infinite maps VR worlds make possible.</p>
<h2 id="section15">Conclusion<a class="subhead-anchor" href="https://alistapart.com#section15">#section15</a></h2>
<p>The story of immersive content is in its early stages. As newly emerging channels for content see greater adoption, requiring us to relay resources like text and media to never-before-seen destinations like digital signage, location-enabled devices, and AR and VR overlays, the demands on our content strategy and design approaches will become both fascinating and frustrating. As seemingly fantastical new interfaces continue to emerge over the horizon, we’ll need an omnichannel content strategy to guide our own journeys as creatives and to orient the voyages of our users into the immersive.</p>
<p>Content audits and effective content strategies aren’t just the domain of staid websites and boxy mobile or tablet interfaces—or even <a href="https://preston.so/books/voice-content">aurally rooted voice interfaces</a>. They’re a key component of our increasingly digitized spaces, too, cornerstones of immersive experiences that beckon us to consume content where we are at any moment, unmoored from a workstation or a handheld. Because it lacks long-standing motifs of the web like context and clickable links, immersive content invites us to revisit our content with a fresh perspective. How will immersive content reinvent how we deliver information like the web did only a few decades ago, like voice has done in the past ten years?</p>
<p>Only the test of time, and the allure of immersion, will tell.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Publish global, think local. Discover how to use your website as a communication tool to gain new markets in different cultures. (Hint: Translating your content may not be enough.)</div><div class="entry-content">JavaScript gives us many ways to do things, but deciding which way can be tricky. Laurie Barth gives some insight into how to make these decisions for your team.</div><div class="entry-content">Looking to maximize the performance of your site with minimal effort? Check out Jeremy Wagner’s streaming Service Worker.</div><div class="entry-content">In this excerpt from Volume 2 of RECOGNIZE, Regine Gilbert offers a helpful mnemonic for approaching our design work from a fresh perspective: “WOQE” for watch, observe, question, and explore.</div><div class="entry-content">How to face reality when your team screws up, and get everyone back on track.</div>]]></description>
      <link>https://alistapart.com/article/immersive-content-strategy/</link>
      <guid>https://alistapart.com/article/immersive-content-strategy/</guid>
      <pubDate>Thu, 29 Apr 2021 16:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Immersive Content Strategy]]></title>
      <description><![CDATA[<p>Beyond the severe toll of the coronavirus pandemic, perhaps no other disruption has transformed user experiences quite like how the tethers to our formerly web-biased era of content have frayed. We’re transitioning to a new world of remote work and digital content. We’re also experimenting with unprecedented content channels that, not too long ago, elicited chuckles at the watercooler, like voice interfaces, digital signage, augmented reality, and virtual reality.</p><div class="aside-breaker">Article Continues Below</div>
<p>Many factors are responsible. Perhaps it’s because we yearn for immersive spaces that temporarily resurrect the Before Times, or maybe it’s due to the boredom and tedium of our now-cemented stuck-at-home routines. But aural user experiences slinging <a href="https://alistapart-production.mystagingwebsite.com/article/usability-testing-for-voice-content/">voice content</a>, and immersive user experiences unlocking new forms of interacting with formerly web-bound content, are no longer figments of science fiction. They’re fast becoming a reality in the here and now.</p>
<p>The idea of <em>immersive experiences</em> is all the rage these days, and content strategists and designers are now seriously examining this still-amorphous trend. Immersive experiences embrace concepts like geolocation, digital signage, and extended reality (XR). XR encompasses augmented reality (AR) and virtual reality (VR) as well as their fusion: mixed reality (MR). Sales of immersive equipment like gaming and VR headsets <a href="https://www.thetimes.co.uk/article/virtual-reality-pandemic-leads-to-rise-in-headset-sales-to-escape-lockdown-jhhn8wghn">have skyrocketed during the pandemic</a>, and content strategists are increasingly attuned to the kaleidoscope of devices and interfaces users now interact with on a daily basis to acquire information.</p>
<p>Immersive user experiences are becoming commonplace, and, more importantly, <a href="https://www.smashingmagazine.com/2020/10/using-webxr-with-babylonjs/">new tools and frameworks are emerging</a> for designers and developers looking to get their hands dirty. But that doesn’t mean our content is ready for prime time in settings unbound from the web like physical spaces, digital signage, or extended reality. Recasting your fixed web content in more immersive ways will enable more than just newfangled user experiences; it’ll prepare you for flexibility in an unpredictable future as well.</p>
<h2><strong>Agnostic content for immersive experiences</strong><a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/immersive-content-strategy#section2">#section2</a></h2>
<p>These days, we interact with content through a slew of devices. It’s no longer the case that we navigate information on a single desktop computer screen. In my upcoming book <a href="https://preston.so/books/voice-content"><em>Voice Content and Usability</em></a> (A Book Apart, coming June 2021), I draw a distinction between what I call <em>macrocontent</em>—the unwieldy long-form copy plastered across browser viewports—and <a href="https://anildash.com/2002/11/13/introducing-microcontent-client/">Anil Dash’s definition of <em>microcontent</em></a>: the kind of brisk, contextless bursts of content that we find nowadays on Apple Watches, Samsung TVs, and Amazon Alexas.</p>
<p>Today, content also has to be ready for contextless situations—not only in truncated form when we struggle to make out tiny text on our smartwatches or scroll through new television series on Roku but also in places it’s never ended up before. As the twenty-first century continues apace, our clients and our teams are beginning to come to terms with the fact that the way copy is consumed in just a few decades will bear no resemblance whatsoever to the prosaic browsers and even smartphones of today.</p>
<h3>What do we mean by immersive content?<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/immersive-content-strategy#section3">#section3</a></h3>
<p><em>Immersive experiences</em> are those that, <a href="https://www.cmswire.com/customer-experience/immersive-experiences-be-there-or-be-left-behind/">according to Forrester</a>, blur “the boundaries between the human, digital, physical, and virtual realms” to facilitate smarter, more interactive user experiences. But what do we mean by immersive content? I define <em>immersive content</em> as content that plays in the sandbox of physical and virtual space—copy and media that are situationally or locationally aware rather than rooted in a static, unmoving computer screen.</p>
<p>Whether a space is real or virtual, immersive content (or <em>spatialcontent</em>) will be a key way in which our customers and users deal with information in the coming years. Unlike voice content, which deals with time and sound, immersive content works with space and sight. Immersive content operates not along the axis of links and page changes but rather along <em>situational changes</em>, as the following figure illustrates.</p>
<div class="wp-block-image">
<figure class="aligncenter size-large"><img width="623" height="383" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/04/situational-change-diagram.png" alt="" class="wp-image-7172894" /><figcaption><em>In this illustration, each rectangle represents different displays that appear based on situational changes such as movement in space or adjustment of perspective that result in the delivery of different content from the previous context. One of these, such as the rightmost display, can be a web-enabled content display with links to other content presented in the same display. This illustration thus demonstrates two forms of navigation: traditional link navigation and immersive situational navigation.</em></figcaption></figure></div>
<p>Acknowledging the actual or imagined surroundings of where we are as human beings will have vast implications for content strategy, omnichannel marketing, usability testing, and accessibility. Before we dig deeper, let’s define a few clear categories of immersive content:</p>
<ul><li><strong>Digital signage content.</strong> Though it may seem a misnomer, digital signage is one of the most widespread examples of immersive content already in use today. For example, you may have seen it used to display a guide of stores at a mall or to aid wayfinding in an airport. While still largely bound to flat screens, it’s an example of <em>content in space</em>.</li>
<li><strong>Locational content.</strong> Locational content involves copy that is delivered to a user on a personal device based on their current location in the world or within an identified physical space. Most often mediated through Bluetooth low-energy (BLE) beacon technology or GPS location services, it’s an example of <em>content at a point in space.</em></li>
<li><strong>Augmented reality content.</strong> Unlike locational content, which doesn’t usually adjust itself seamlessly based on how users move in real-world space, AR content is now common in museums and other environments—typically as overlays that are superimposed over actual physical surroundings and adjust dynamically according to the user’s position and perspective. It’s <em>content projected into real-world space</em>.</li>
<li><strong>Virtual reality content.</strong> Like AR content, VR content is dependent on its imagined surroundings in terms of how it displays, but it’s part of a nonexistent space that is fully immersive, an example of <em>content projected into virtual space</em>.</li>
<li><strong>Navigable content.</strong> Long a gimmicky playground for designers and developers interested in pushing the envelope, navigable content is copy that users can move across and sift through as if it were a physical space itself: true <em>content as space</em>.</li>
</ul><p>The following illustration depicts these types of immersive content in their typical habitats.</p>
<figure class="wp-block-image size-large"><img width="1600" height="1066" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/04/types-of-immersive-content.jpg?resize=1024,682" alt="Digital signage content typically appears to everyone within a space. Locational content is delivered via personal devices. AR is content projected into the real world through an overlay, while VR creates an immersive virtual environment. Finally, navigable content is content as the space itself." class="wp-image-7172895" /></figure><h3>Why auditing immersive content is important<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/immersive-content-strategy#section4">#section4</a></h3>
<p>Alongside conversational and voice content, immersive content is a compelling example of <a href="https://www.youtube.com/watch?v=I1Chq_E8uBM">breaking content out of the limiting box</a> where it has long lived: the browser viewport, the computer screen, and the 8.5”x11” or broadsheet borders of print media. For centuries, our written copy has been affixed to the staid standards of whatever bookbinders, newspaper printing presses, and screen manufacturers decided. Today, however, for the first time, we’re surmounting those arbitrary barriers and situating content in contexts that challenge all the assumptions we’ve made since the era of Gutenberg—and, arguably, since clay tablets, papyrus manuscripts, and ancient scrolls.</p>
<p>Today, it’s never been more pressing to implement an <a href="https://preston.so/writing/building-usable-conversations-conversational-content-strategy/"><em>omnichannel content strategy</em></a>that centers the reality our customers increasingly live in: a world in which information can end up on any device, even if it has no tether to a clickable or scrollable setting. One of the most important elements of such a future-proof content strategy is an <em>omnichannel content audit</em> that evaluates your content from a variety of standpoints so you can manage and plan it effectively. These audits generally consist of several steps:</p>
<ul><li><strong>Write a questionnaire.</strong> Each content item needs to be examined from the perspective of each channel through a series of channel-relevant questions, like whether content is <em>legible</em> or <em>discoverable</em> on every conduit through which it travels.</li>
<li><strong>Settle the criteria.</strong> No questionnaire is complete for a content audit without <em>evaluation criteria</em> that measure how the content performs and <em>recommendation criteria</em> that determine necessary steps to improve its efficacy.</li>
<li><strong>Discuss with stakeholders.</strong> At the end of any content audit, it’s important to leaf through the results and any recommendations in a frank discussion with stakeholders, including content strategists, editors, designers, and others.</li>
</ul><p>In <a href="https://alistapart-production.mystagingwebsite.com/article/usability-testing-for-voice-content/">my previous article for <em>A List Apart</em></a>, I shared the work we did on <a href="https://www.youtube.com/watch?v=kAy6AP-MZ4o">a conversational content audit for Ask GeorgiaGov</a>, the first (but now decommissioned) <a href="https://www.youtube.com/watch?v=evHeWxeznUg">Alexa skill for residents of the state of Georgia</a>. Such a content audit is just one facet of the multifaceted omnichannel content strategy along various dimensions you’ll need to consider. Nonetheless, there are a few things all content audits share in terms of foundational evaluation criteria across all content delivery channels:</p>
<ul><li><strong>Content legibility.</strong> Is the content readable or easily consumable from a variety of vantage points and perspectives? In the case of immersive content, this can include examining <em>verbosity tolerance</em> (how long content can be before users zone out, a big factor in digital signage) and <em>phantom references</em> (like links and calls to action that make sense on the web but not on a VR headset).</li>
<li><strong>Content discoverability.</strong> It’s no longer guaranteed in immersive content experiences that every piece of content can be accessed from other content items, and content loses almost all of its context when displayed unmoored from other content in digital signs or AR overlays. For discoverability’s sake, avoid relegating content to unreachable siloes, whether content is inaccessible due to physical conditions (like walls or other obstacles) or technical ones (like a finicky VR headset).</li>
</ul><p>Like voice content, immersive content requires ample attention to the ways in which users approach and interact with content in physical and virtual spaces. And as I write in <em>Voice Content and Usability</em>, it’s also the case that <em>cross-channel interactions</em> can influence how we work with copy and media. After all, how often do subway and rail commuters glance up while scrolling through service advisories on their smartphones to consult a potentially more up-to-date alert on a digital sign?</p>
<h2><strong>Digital signage content: Content in space</strong><a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/immersive-content-strategy#section5">#section5</a></h2>
<p>Signage has long been a fixture of how we find our way through physical spaces, ever since the earliest roads crisscrossed civilizations. Today, digital signs are becoming ubiquitous across shopping centers, university campuses, and especially transit systems, with the New York City subway recently introducing countdown clocks that display service advisories on a ticker along the bottom of the screen, just below train arrival times.</p>
<p>Digital signs can deliver critical content at important times, such as during emergencies, without the limitations imposed by the static nature of analog signs. News tickers on digital signs, for instance, can stretch for however long they need to, though succinctness is still highly prized. But digital signage’s rich potential to deliver immersive content also presents challenges when it comes to content modeling and governance.</p>
<p>Are news items delivered to digital signs simply teaser or summary versions of full articles? Without a fully functional and configurable digital sign in your office, how will you preview them in context before they go live? To solve this problem for the New York City subway, the Metropolitan Transportation Authority (MTA) <a href="https://www.acquia.com/resources/case-studies/metropolitan-transportation-authority">manages all digital signage content across all signs</a> within a central Drupal content management system (CMS), which synthesizes data such as train arrival times from real-time feeds and transit messages administered in the CMS for arbitrary delivery to any platform across the network.</p>
<p>How to present content items in digital signs also poses problems. As the following figure illustrates, do you overtake the entire screen at the risk of obscuring other information, do you leave it in a ticker that may be ignored, or do you use both depending on the priority or urgency of the content you’re presenting?</p>
<div class="wp-block-image">
<figure class="aligncenter size-large"><img width="623" height="369" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/04/digital-signage-info-priority.png" alt="On the left are examples of digital signage where informational messages obscure important data. On the right are examples of digital signage where informational messages are constricted to a small scrolling ticker at the bottom of the screen." class="wp-image-7172896" /></figure></div>
<p>While some digital signs have the benefit of touch screens and occupying entire digital kiosks, many are tasked with providing key information in as little space as possible, where users don’t have the luxury of manipulating the interface to customize the content they wish to view. The New York City subway makes a deliberate choice to allow urgent alerts to spill across the entire screen, which limits the sign’s usefulness for those who simply need to know when the next train is arriving in the interest of more important information that is relevant to all passengers—and those who need captions for loudspeaker announcements.</p>
<h3>Auditing for digital signage content<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/immersive-content-strategy#section6">#section6</a></h3>
<p>Because digital signs value brevity and efficiency, digital signage content often isn’t the main focus of what’s displayed. Digital signs on the São Paulo metro, for instance, juggle service alerts, breaking news, and health advisories. For this reason, auditing digital signage content for legibility and discoverability is key to ensuring users can interact with it gracefully, regardless of how often it appears, how highly prioritized it is, or what it covers.</p>
<p>When it comes to legibility, ask yourself these questions and consider the digital sign content you’re authoring based on these concerns:</p>
<ul><li><strong>Font size and typography.</strong> Many digital signs use sans-serif typefaces, which are easier to read from a distance, and many also employ uppercase for all text, especially in tickers. Consider which typefaces advance rather than obscure legibility, even when the digital sign content overtakes the entire screen.</li>
<li><strong>Angles and perspective.</strong> Is your digital sign content readily readable from various angles and various vantage points? Does the reflectivity of the screen impact your content’s legibility when standing just below the sign? How does your content look when it’s displayed to a user craning their neck and peering at it askew?</li>
<li><strong>Color contrast and lighting.</strong> Digital signs are no longer just fixtures of subterranean worlds; they’re above-ground and in well-lit spaces too. Color contrast and lighting strongly influence how legible your digital sign content can be.</li>
</ul><p>As for discoverability, digital signs present challenges of both physical discoverability (can the sign itself be easily found and consulted?) and content discoverability (how long does a reader have to stare at the sign for the content they need to show up?):</p>
<ul><li><strong>Physical discoverability.</strong> Are signs placed in prominent locations where users will come across them? The MTA was criticized for <a href="https://www.amny.com/transit/subway-countdown-clocks-at-some-stations-are-difficult-to-see-riders-say-1-14115447/">the poor placement of many of its digital countdown clocks</a> in the New York City subway, something that can block a user from ever accessing content they need.</li>
<li><strong>Content discoverability.</strong> Because digital signs can only display so much content at once, even if there’s a large amount of copy to deliver eventually, users of digital signs may need to wait too long for their desired content to appear, or the content they seek may be too deprioritized for it to show up while they’re looking at the sign.</li>
</ul><p>Both legibility and discoverability of digital sign content require thorough approaches when authoring, designing, and implementing content for digital signs.</p>
<h3>Usability and accessibility in digital signage content<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/immersive-content-strategy#section7">#section7</a></h3>
<p>In addition to audits, in any physical environment, immersive content on digital signs requires a careful and bespoke approach to consider not only how content will be consumed on the sign itself but also all the ways in which users move around and refer to digital signage as they consult it for information. After all, our content is no longer couched in a web page or recited by a screen reader, both objects we can control ourselves; instead, it’s flashed and displayed on flat screens and kiosks in physical spaces. </p>
<p>Consider how the digital sign and the content it presents appear to people who use mobility aids such as wheelchairs or walkers. Is the surrounding physical environment accessible enough so that wheelchair users can easily read and discover the content they seek on a digital sign, which may be positioned too high for a seated reader? By the same token, can colorblind and dyslexic people read the chosen typeface in the color scheme it’s rendered in? Is there an aural equivalent of the content for Blind people navigating your digital signage, in close proximity to the sign itself, serving as synchronized captions?</p>
<h2><strong>Locational content: Content at a point in space</strong><a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/immersive-content-strategy#section8">#section8</a></h2>
<p>Unlike digital signage content, which is copy or media displayed in a space, <em>locational</em> (or <em>geolocational</em>) <em>content</em> is copy or media delivered to a device—usually a phone or watch—based on a point in space (if precise location is acquired through GPS location services) or a swath of space (typically driven by Bluetooth Low Energy beacons that have certain ranges). For smartphone and smartwatch users, GPS location services can often pinpoint a relatively accurate sense of where a person is, while Bluetooth Low Energy (BLE) beacons can triangulate their position based on devices that have Bluetooth enabled.</p>
<div class="wp-block-image">
<figure class="aligncenter size-large"><img width="622" height="398" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/04/locational-content.png" alt="Examples of locational content might include links to more detailed information online, coupons, and sales relevant to merchandise or objects near the person viewing it." class="wp-image-7172897" /></figure></div>
<p>Though BLE beacons remain a fairly finicky and untested realm of spatial technology, they’ve quickly gained traction in large shopping centers and <a href="https://www.youtube.com/watch?v=I2MuPdt5anI">public spaces such as airports</a> where users agree to receive content relevant to their current location, most often in the form of push notifications that whisk users away into a separate view with more comprehensive information. But because these tiny chunks of copy are often tightly contained and contextless, teams designing for locational content need to focus on how users interact with their devices as they move through physical spaces.</p>
<h3>Auditing for locational content<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/immersive-content-strategy#section9">#section9</a></h3>
<p>Fortunately, because locational content is often delivered to the same visual devices that we use on a regular basis—smartphones, smartwatches, and tablets—auditing for content legibility can embrace many of the same principles we employ to evaluate other content. For discoverability, some of the most important considerations include:</p>
<ul><li><strong>Locational discoverability.</strong> BLE beacons are notorious for their imprecision, though they continue to improve in quality. GPS location, too, can be an inaccurate measure of where someone is at any given time. The last thing you want your customers to experience is an incorrect triangulation of where they are leading to embarrassing mistakes and bewilderment when unexpected content travels down the wire.</li>
<li><strong>Proximity.</strong> Because of the relative lack of precision when it comes to BLE beacons and GPS location services, placing content items too close together in a coordinate map may trigger too many notifications or resource deliveries to a user, thus overwhelming them, or a certain content item may inadvertently supersede another because they’re spaced too closely together.</li>
</ul><p>As push notifications and location sharing become more common, locational content is rapidly becoming an important way to funnel users toward somewhat longer-form content that might otherwise go unnoticed when a customer is in a brick-and-mortar store.</p>
<h3>Usability and accessibility in locational content<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/immersive-content-strategy#section10">#section10</a></h3>
<p>Because locational content requires users to move around physical spaces and trigger triangulation, consider how different types of users will move and also whether unforeseen issues can arise. For example, researchers in Japan found that users who walk while staring at their phones are <a href="https://www.nytimes.com/2021/03/18/science/distracted-walking-phone.html">highly disruptive to the flow and movement of those around them</a>. Is your locational content possibly creating a situation where users bump into others, or worse, get into accidents? For instance, writing copy that’s quick and to the point or preventing notifications from being prematurely dismissed could allow users to ignore their devices until they have time to safely glance at them.</p>
<p>Limited mobility and cognitive disabilities can place many disabled users of locational content at a deep disadvantage. While gamification may encourage users to seek as many items of locational content as possible in a given span of time for promotional purposes, consider whether it excludes wheelchair users or people who encounter obstacles when switching between contexts rapidly. There are good use cases for locational content, but what’s compelling for some users might be confounding for others.</p>
<h2><strong>AR and VR content: Content projected into space</strong><a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/immersive-content-strategy#section11">#section11</a></h2>
<p>Augmented reality, once the stuff of science fiction holograms and futuristic cityscapes, is becoming more available to the masses thanks to wearable AR devices, high-performing smartphones and tablets, and innovation in machine vision capabilities, though the utopian future of true “holographic” content remains as yet unrealized. Meanwhile, virtual reality has seen incredible growth over the pandemic as homebound users—by interacting with copy and media in fictional worlds—increasingly seek escapist ways to access content normally spread across flat screens.</p>
<p>While AR and VR content is still in its infancy, the vast majority is currently couched in <em>overlays</em> that are superimposed over real-world environments or objects and can be opaque (<a href="https://commons.wikimedia.org/wiki/File:Augmented_reality_at_Museu_de_Matar%C3%B3_linking_to_Catalan_Wikipedia_%2818%29.JPG">occupying some of a device’s field of vision</a>) or semi-transparent (creating an eerie, shimmery film on which text or media is displayed). Thanks to advancements in machine vision, these content overlays can track the motion of perceived objects in the physical or virtual world, bamboozling us into thinking these overlays are traveling in our fields of vision just like the things we see around us do.</p>
<p>Formerly restricted to realms like museums, expensive video games, and gimmicky prototypes, AR and VR content is now becoming much more popular among companies that are <a href="https://www.forbes.com/sites/theyec/2019/02/06/augmented-reality-in-business-how-ar-may-change-the-way-we-work/">interested in more immersive experiences</a> capable of <a href="https://www.information-age.com/augmented-reality-revolutionising-way-people-shop-123469739/">delivering content alongside objects</a> in real-life brick-and-mortar environments, as well as virtual or imagined landscapes, like fully immersive brand experiences that transport customers to a pop-up store in their living room.</p>
<p>To demonstrate this, my former team at Acquia Labs built an experimental proof of concept that examines <a href="https://dri.es/virtual-reality-on-campus-with-drupal">how VR content can be administered within a CMS</a> and a pilot project for grocery stores that explores what can happen when <a href="https://dri.es/shopping-with-augmented-reality">product information is displayed as AR content</a> next to consumer goods in supermarket aisles. The following illustration shows, in the context of this latter experiment, how a smartphone camera interacts with a machine vision service and a Drupal CMS to acquire information to render alongside the item.</p>
<div class="wp-block-image">
<figure class="aligncenter size-large"><img width="624" height="331" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/04/ar-cms-example.jpg" alt="A diagram depicting how someone might look at a physical object through their phone, and AR tools can connect to a CMS to download and display relevant information about the object virtually beside it." class="wp-image-7172898" /></figure></div>
<h3>Auditing for AR and VR content<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/immersive-content-strategy#section12">#section12</a></h3>
<p>Because AR and VR content, unlike other forms of immersive content, fundamentally plays in the same sandbox as the real world (or an imaginary one), legibility and discoverability can become challenging. The potential risks for AR and VR content are in many regards a fusion of the problems found in both digital signage and locational content, encompassing both physical placement and visual perspective, especially when it comes to legibility:</p>
<ul><li><strong>Content visibility.</strong> Is the AR or VR overlay too transparent to comfortably read the copy or view the image contained therein, or is it so opaque that it obscures its surroundings? AR and VR content must coexist gracefully with its exterior, and the two must enhance rather than obfuscate each other. Does the way your content is delivered compromise a user’s feeling of immersion in the environment behind it?</li>
<li><strong>Content perspective.</strong> Unless you’re limited to a smartphone or similar handheld device, many AR and VR overlays, especially in immersive headsets, don’t display content or media as an immobile rectangular box, as it defeats the purpose of the illusion and can be jarring to users as they adjust their field of vision, breaking them out of the fantasy you’re hoping to create. For this reason, your AR or VR experience must not only dictate how environments and objects are angled and lit but also how the content associated with them is perceived. Is your content readable from various angles and points in the AR view or VR world?</li>
</ul><p>When it comes to discoverability of your AR and VR content, issues like accuracy in machine vision and triangulation of your user’s location and orientation become much more important:</p>
<ul><li><strong>Machine vision.</strong> Most relevantly for AR content, if your copy or media is predicated on machine vision that perceives an object by identifying it according to certain characteristics, how accurate is that prediction? Does some content go undiscovered because certain objects go undetected in your AR-enabled device?</li>
<li><strong>Location accuracy.</strong> If your content relies on the user’s current location and orientation in relation to some point in space, as is common in both AR and VR content use cases, how accurately do devices dictate correct delivery at just the right time and place? Are the ranges within which content is accessible too limited, leading to flashes of content as you take a step to the left or right? Are there locations that simply can’t be reached, leading to forever-siloed copy or media?</li>
</ul><p>Due to the intersection of technical considerations and design concerns, AR and VR content, like voice content and indeed other forms of immersive content, requires a concerted effort across multiple teams to ensure resources are delivered not just legibly but also discoverably.</p>
<h3>Usability and accessibility in AR and VR content<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/immersive-content-strategy#section13">#section13</a></h3>
<p>Out of all the forms of immersive content we’ve covered so far, AR and VR content is possibly the medium that demands the most assiduously crafted solutions in accessibility testing and usability testing. Because AR and VR content, especially in headsets or wearable devices, requires motion through real or imagined space, its impact on accessibility cannot be overstated. Adding a third dimension—and arguably, a fourth: time—to our perception of content requires attention not only to how content is accessed but also all the other elements that comprise a fully immersive visual experience.</p>
<p>VR headsets commonly induce <a href="https://abcnews.go.com/Technology/feel-motion-sickness-virtual-reality/story?id=65153805"><em>virtual reality motion sickness</em></a> in many individuals. Poorly implemented transitions between states occurring in quick succession where content is visible and then invisible, and then visible again, can lead to epileptic seizures if not built with the utmost care. Finally, users moving quickly through spaces may inadvertently trigger vertigo in themselves or even collide with hazardous objects, resulting in potentially serious injuries. There’s a reason we aren’t wearing wearable headsets outside carefully secured environments.</p>
<h2><strong>Navigable content: Content as space</strong><a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/immersive-content-strategy#section14">#section14</a></h2>
<p>This is only the beginning of immersive content. Increasingly, we’re also toying with ideas that seemed harebrained even a few decades ago, like <em>navigable content</em>—copy and media that can be traversed as if the content <em>itself</em> were a navigable space. Imagine zooming in and out of tracts of text and stepping across glyphs like hopping between islands in a Super Mario game. Ambitious designers and developers are exploring this emerging concept of navigable content in exciting ways, both in and out of AR and VR. In many ways, truly navigable content is the endgame of how virtual reality presents information.</p>
<p>Imagining an encyclopedia that we can browse like the classic <a href="https://www.youtube.com/watch?v=jR0vRuZkxdw">1990s opening sequence of the BBC’s <em>Eyewitness</em> television episodes</a> is no longer as far-fetched as we think. Consider, for instance, <a href="http://www.rleonardi.com/interactive-resume/">Robby Leonardi’s interactive résumé</a>, which invites you to play a character as you learn about his career, or <a href="https://bruno-simon.com/">Bruno Simon’s ambitious portfolio</a>, where you drive an animated truck around his website. For navigable content, the risks and rewards for user experience and accessibility remain largely unexplored, just like the hazy fringes of the infinite maps VR worlds make possible.</p>
<p>The story of immersive content is in its early stages. As newly emerging channels for content see greater adoption, requiring us to relay resources like text and media to never-before-seen destinations like digital signage, location-enabled devices, and AR and VR overlays, the demands on our content strategy and design approaches will become both fascinating and frustrating. As seemingly fantastical new interfaces continue to emerge over the horizon, we’ll need an omnichannel content strategy to guide our own journeys as creatives and to orient the voyages of our users into the immersive.</p>
<p>Content audits and effective content strategies aren’t just the domain of staid websites and boxy mobile or tablet interfaces—or even <a href="https://preston.so/books/voice-content">aurally rooted voice interfaces</a>. They’re a key component of our increasingly digitized spaces, too, cornerstones of immersive experiences that beckon us to consume content where we are at any moment, unmoored from a workstation or a handheld. Because it lacks long-standing motifs of the web like context and clickable links, immersive content invites us to revisit our content with a fresh perspective. How will immersive content reinvent how we deliver information like the web did only a few decades ago, like voice has done in the past ten years?</p>
<p>Only the test of time, and the allure of immersion, will tell.</p>]]></description>
      <link>https://alistapart-production.mystagingwebsite.com/article/immersive-content-strategy/</link>
      <guid>https://alistapart-production.mystagingwebsite.com/article/immersive-content-strategy/</guid>
      <pubDate>Thu, 29 Apr 2021 16:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Do You Need to Localize Your Website?]]></title>
      <description><![CDATA[<div class="entry-content">
<p>Global markets give you access to new customers. All you need to do is inform potential buyers about your product or service. </p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>Your website is a good place to introduce your product or service outside your locale. Localizing your web content sounds like the right way to reach out to the global market. Localization will bridge the language barriers, or the wider scope of differing cultures. </p>
<p>Before we move on further with the discussion, let’s focus on the definition of “localization.” </p>
<h2 id="section2"><strong>What is localization?</strong><a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>According to the Cambridge Dictionary, <a href="https://dictionary.cambridge.org/dictionary/english/localization"><em>localization</em></a> (as a marketing term) is “the process of making a product or service more suitable for a particular country, area, etc.,” while <a href="https://dictionary.cambridge.org/dictionary/english/translation"><em>translation</em></a> is “something that is translated, or the process of translating something, from one language to another.” </p>
<p>In practice, <a href="https://www.simultrans.com/blog/what-is-marketing-localization">the difference can be a little blurred</a>. While it’s true that localization includes both language and non-language aspects, most cultural adjustments in the localization process are done through the language. Hence, the two terms are often interchangeable. </p>
<p>Good translators will <em>not</em> simply find an equivalent of a word in another language. They will <a href="https://bookmachine.org/2017/06/26/makes-good-translator/">actively research their materials and have an in-depth understanding of the languages they work in</a>. </p>
<p>Depending on the situation, they may or may not <a href="https://www.argotrans.com/blog/best-practices-measurement-conversion-translation/">convert measurement units</a> and date formats. <a href="https://www.mentalfloss.com/article/25845/quick-6-six-unit-conversion-disasters">Technical guide books may need accurate unit conversion</a>, but changing “<a href="https://galaxypress.com/story-behind-fahrenheit-451/">Fahrenheit 451</a>” to “Celsius 233” would be simply awkward. A good translator will suggest what to change and what to leave as it is. </p>
<p>Some people call this conversion process “localization.” The truth is, unit conversions had become a part of translation, long before the word “localization” was used to describe the process. </p>
<p>When we talk about linguistic versus non-linguistic aspects of a medium, and view them as separate entities, localization and translation may look different. However, when we look at the whole process of translating the message, seeing both elements as translatable items, the terms are interchangeable. </p>
<p>In this article, the terms “localization” and “translation” will be used interchangeably. We are going to discuss how to use a website as a communication tool to gain a new market in different cultures. </p>
<h2 id="section3"><strong>Localization: who is it for?</strong><a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h2>
<p>A good localization is not cheap, so it would be wise to ask yourselves several questions beforehand: </p>
<ul><li>Who is your audience?</li>
<li>What kind of culture do they live in?</li>
<li>What kind of problems may arise during the localization process? </li>
</ul><p>I will explain the details below. </p>
<h2 id="section4"><strong>Who is your ideal audience?</strong><a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h2>
<p>Knowing your target audience should be at the top of your business plan. </p>
<p>For some, localization is not needed because they live in the same region and speak the same language as their target market. For example, daycare services, local coffee shops, and restaurants. </p>
<p>In some cases, <a href="https://www.businessinsider.com/new-york-city-brooklyn-manhattan-language-maps-2018-5?op=1#heres-the-no-3-most-commonly-spoken-language-in-each-neighborhood-in-brooklyn-and-queens-6">people who live in the same region may speak different languages</a>. In a bilingual society, you may want to cater to speakers of both languages as a sign of respect. In a multilingual society, aim to translate to the lingua franca and/or the language used by the majority. It makes people feel seen and it can create a positive image to your brand. </p>
<p>Sometimes, website translation is required by law. In Quebec, for instance, where French is spoken as <a href="https://www.canada.ca/en/canadian-heritage/services/provincial-territorial-symbols-canada/quebec.html">the provincial language</a>, you’ll need to include a French version of your website. You may also want to check <a href="https://www.osler.com/en/resources/business-in-canada/browse-topics/selling/french-language-rules">other types of linguistic experiences you need to provide</a>. </p>
<p>If your target market lives across the sea and speaks a different language, you may not have any choice but to localize. However, if those people can speak your  language, consider other aspects (cultural and/or legal) to make an informed decision on whether to translate.  </p>
<p>Although there are many benefits of website translation, you don’t always have to do it <em>now</em>. Especially when your budget is tight or you can spend it on something more urgent. It’s better to postpone than to have a badly translated website. <a href="https://www.ulatus.com/translation-blog/bad-translation-can-cost-money-and-reputation/">The price of cheap translation is costly</a>.  </p>
<p>If you’re legally required to launch a bilingual website but you don’t have the budget, you may want to check if you can be exempted. If you are not exempted, hire volunteers or seek government support, if possible. </p>
<p>Unless required otherwise by law, there is nothing wrong with using your current language in your product or service. You can maintain the already-formed relationship by focusing on what you have in common: the same interest. </p>
<h2 id="section5"><strong>Understanding cultural and linguistic intricacies</strong><a class="subhead-anchor" href="https://alistapart.com#section5">#section5</a></h2>
<p>For example, you have a coding tutorial website. Your current audience is IT professionals—mostly college graduates. You see an opportunity to expand to India. </p>
<p>Localization is <a href="https://www.livemint.com/news/india/in-india-who-speaks-in-english-and-where-1557814101428.html">unlikely to be needed in this case</a>, as most Indian engineers have a good grasp of English. So, instead of doing a web translation project, you can use your money to improve or develop a new product or service for your Indian audience. Maybe you want to set up a workshop or a meetup in India. Or a bootcamp retreat in the country. </p>
<p>You can achieve this by focusing on the similarities you have with your audience. </p>
<p>The same rule applies to other countries where English language is commonly used by IT professionals. In the developing world, where English is rarely used, <a href="https://www.vice.com/en/article/evwkyk/these-small-town-hackers-are-making-a-living-showing-companies-how-insecure-their-sites-really-are">some self-taught programmers become “good hackers” to earn some money</a>. You may wonder how, <a href="https://www.ef.com/wwen/epi/regions/asia/indonesia/">despite their lack of English skill</a>, they can learn programming.</p>
<p>There’s an explanation for it. </p>
<p>There are two types of language skills: <a href="https://www.languagesoftware.net/blog/developing-passive-skills-in-language-learning/"><em>passive</em> (listening, reading) and <em>active</em> (speaking, writing)</a>. Passive language skills are usually learned first. Active language skills are developed later. You learn to speak by listening, and learn to write by reading. You go through this process as a child and, again, when you learn a new language as an adult. (This is not to confuse <a href="https://www.utesinternationallounge.com/language-acquisition-versus-language-learning/">language acquisition with language learning</a>, but to note that the process is relatively the same.) </p>
<p>As most free IT course materials are available online in English, some programmers may have to adapt and <a href="https://jlptbootcamp.com/2012/10/passive-language-skills/">study English (passively) as they go</a>. They may not be considered “fluent” in a formal way, but it doesn’t mean they lack the ability to grasp the language. They may not be able to speak or write perfectly, but they can understand technical texts. </p>
<p>In short, passive and active language skills can grow at different speeds. This fact leads you to <em>a new group of potential audience</em>: those who can understand English, but only passively. </p>
<p>If your product is in a text format, translation won’t be necessary for this type of audience. If it’s an audio or video format, you may need to add subtitles, since native English speakers speak in so many different accents and at various speeds. Captioning will also help the hard of hearing. It may be required by regional or national accessibility legislation too. And it’s the right thing to do.</p>
<p>One might argue that if these people can understand English, they will understand the text better in their native tongue. </p>
<p>Well, if all the programs you’re using or referring to are available in their native language version, it may not be a problem. But in reality, this is often not the case. </p>
<p>Linguistic consistency helps programmers work faster. And this alone should trump the presumed ease that comes with translation. </p>
<h2 id="section6"><strong>Some problems with localization </strong><a class="subhead-anchor" href="https://alistapart.com#section6">#section6</a></h2>
<p>I was once involved in a global internet company’s localization project in Indonesia. </p>
<p>Indonesian SMEs mostly speak Indonesian since they mainly serve the domestic market. So, it was the right decision to target Indonesian SMEs using Indonesian language. </p>
<p>The company had the budget to target Indonesia’s market of 58 million SMEs, and there weren’t too many competitors yet. I think the localization plan was justified. But even with this generally well-thought-out plan, there were some problems in its execution. </p>
<p>The materials were filled with jargon and annoying outlinks. You could not just read an instruction until it was completed, because after a few words, you would be confronted with a “smart term.” Now to understand this smart term, you would have to follow a link that would take you to a separate page that was supposed to explain everything, but in that page you would find more smart terms that you’d need to click. At this point, the scent of information would have grown cold, and you’d likely have forgotten what you were reading or why. </p>
<p>Small business owners are among the busiest folks you can find. They do almost everything by themselves. They would not waste their time trying to read pages of instructions that throw them right and left. </p>
<p>Language-wise, the instructions could have been simplified. Design-wise, a hover/focus pop-up containing a brief definition or description could have been used to explain special terms. </p>
<p>I agree pop-ups can be distracting, but in terms of ease, for this use case, they would have worked far better than outlinks. There are <a href="https://accessuse.eu/en/Content-hover-focus.html">some ways to improve hover/focus pop-ups</a> to make them more readable. </p>
<p>However, if the content of those pop-ups (definition, description, etc.) cannot be brief, it is wiser to write it down as a separate paragraph. </p>
<p>In my client’s case, they could have started each instruction by describing the definitions of those special terms. Those definitions ought to be written in one page so as to reduce the amount of time spent on clicking and returning to the intended page. This solution can also be applied when a definition is too long to be put inside a hover/focus bubble. </p>
<p>The text problem, in my client’s case, came with the source language. It was later transferred to the target language thanks to localization. They could have solved the problem at the source language level, but I think it would have been too late at that point. </p>
<p><em>Transcreation</em>, i.e., “<a href="https://www.articulatemarketing.com/blog/translation-vs-transcreation">taking a concept in one language and completely recreating it in another language</a>,” doesn’t solve a problem like this because the issue is more technical than linguistic. Translators would still have to adjust their work to the given environment. They’d still have to retain all the links and translate all jargon-laden content. </p>
<p>The company should have hired a local writer to rewrite the content in the target language. It would have worked better. They didn’t take this route for a reason: namely, those “smart terms” were used as keywords. So as much as we hated them, we had to keep them there.  </p>
<h2 id="section7"><strong>How to prepare a web localization project</strong><a class="subhead-anchor" href="https://alistapart.com#section7">#section7</a></h2>
<p>Let’s say you have considered everything. You’ve learned about your target audience, how your product will solve their problem, and that you have the budget to reach out to them. Naturally, you want to reach them now before your competitors do. </p>
<p>Now you can proceed with your web localization project plan. </p>
<p>One thing I want to repeat is that localization will transfer any errors you have in your original content to the translated pages. So you’ll need to do some content pre-checks before starting a web translation project. It will be cheaper to fix the problems <em>before</em> the translation project commences. </p>
<p>Pre-localization checks should include assessing the text you intend to translate. Ask someone outside the team to read the text and ask them to give their feedback. It’s even better if that someone represents the target audience. </p>
<p>Then make corrections, if need be. Use as little jargon as possible. Let readers focus on one article with no interruption. </p>
<p>Some companies like to coin new terms to create keywords that will lead people to their sites. This can be a smart move, and it is arguably good for search engine optimization. But if you want to <a href="https://www.psychologytoday.com/us/blog/turning-point/201504/how-build-rapport-powerful-technique">build rapport with your audience</a>, you must make your message clear and understandable. Clear communication, not the invention of new words, should be your priority. </p>
<p>Following this course of action might mean sacrificing keywords for clarity, but <a href="https://neilpatel.com/blog/13-ways-to-reduce-bounce-rate-and-increase-your-conversions/">it also promises a lower bounce rate</a> since visitors will stay longer on your site. After all, people are more likely to read your writing to the end if they are not being frustrated by difficult terms.</p>
<p>Once your text is ready, you can start your localization project. You can hire a language agency or build your own team. </p>
<p>If you have a lot of content, it may be wise to outsource your project to a language agency. Doing so can save you time and money. An outside specialist consultancy will have the technology and skills to work on various types of localization projects. They can also translate your website to different languages at once. </p>
<p>As an alternative, you might directly hire freelance editors and translators to work on your project. Depending on many factors, this might end up less or more expensive than hiring an agency. </p>
<p>Make sure that the translators you hire, whether directly or through an agency, have relevant experience. If your text is about marketing, for instance, the translators and editors must be experts in this field. This is to make sure they can get your message across. </p>
<p>Most translation tools used today can retain sentence formatting, links, and HTML code, so you don’t need to worry about these. </p>
<p>Focus on the message you want to carry to your target audience. Be sensitive about cultural remarks and be careful about any potential misunderstanding caused by your translation. Consult with your language team about certain phrases that may become problematic when translated. Pick your words carefully. Choose the right expressions. </p>
<p>If you localize a website, you must be sure to provide customer service support in target-friendly language. This allows you to reply to customers immediately, rather than having to wait for a translator to become involved.  </p>
<p>In summary, don’t be hasty when doing a web localization/translation project. There are a lot of things to consider beforehand. A well prepared plan will yield a better result. A good quality translation will not only bridge the language gap but it can also build trust and solidify your brand image in the mind of your target audience.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">JavaScript gives us many ways to do things, but deciding which way can be tricky. Laurie Barth gives some insight into how to make these decisions for your team.</div><div class="entry-content">Looking to maximize the performance of your site with minimal effort? Check out Jeremy Wagner’s streaming Service Worker.</div><div class="entry-content">In this excerpt from Volume 2 of RECOGNIZE, Regine Gilbert offers a helpful mnemonic for approaching our design work from a fresh perspective: “WOQE” for watch, observe, question, and explore.</div><div class="entry-content">How to face reality when your team screws up, and get everyone back on track.</div><div class="entry-content">Matt E. Patterson shows why a new WebSockets-driven approach is catching developers' attention, and how it can mean faster, easier development that results in an experience just as rich as client-side SPAs.</div>]]></description>
      <link>https://alistapart.com/article/do-you-need-to-localize-your-website/</link>
      <guid>https://alistapart.com/article/do-you-need-to-localize-your-website/</guid>
      <pubDate>Thu, 22 Apr 2021 16:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Do You Need to Localize Your Website?]]></title>
      <description><![CDATA[<p>Global markets give you access to new customers. All you need to do is inform potential buyers about your product or service. </p><div class="aside-breaker">Article Continues Below</div>
<p>Your website is a good place to introduce your product or service outside your locale. Localizing your web content sounds like the right way to reach out to the global market. Localization will bridge the language barriers, or the wider scope of differing cultures. </p>
<p>Before we move on further with the discussion, let’s focus on the definition of “localization.” </p>
<h2><strong>What is localization?</strong><a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/do-you-need-to-localize-your-website#section2">#section2</a></h2>
<p>According to the Cambridge Dictionary, <a href="https://dictionary.cambridge.org/dictionary/english/localization"><em>localization</em></a> (as a marketing term) is “the process of making a product or service more suitable for a particular country, area, etc.,” while <a href="https://dictionary.cambridge.org/dictionary/english/translation"><em>translation</em></a> is “something that is translated, or the process of translating something, from one language to another.” </p>
<p>In practice, <a href="https://www.simultrans.com/blog/what-is-marketing-localization">the difference can be a little blurred</a>. While it’s true that localization includes both language and non-language aspects, most cultural adjustments in the localization process are done through the language. Hence, the two terms are often interchangeable. </p>
<p>Good translators will <em>not</em> simply find an equivalent of a word in another language. They will <a href="https://bookmachine.org/2017/06/26/makes-good-translator/">actively research their materials and have an in-depth understanding of the languages they work in</a>. </p>
<p>Depending on the situation, they may or may not <a href="https://www.argotrans.com/blog/best-practices-measurement-conversion-translation/">convert measurement units</a> and date formats. <a href="https://www.mentalfloss.com/article/25845/quick-6-six-unit-conversion-disasters">Technical guide books may need accurate unit conversion</a>, but changing “<a href="https://galaxypress.com/story-behind-fahrenheit-451/">Fahrenheit 451</a>” to “Celsius 233” would be simply awkward. A good translator will suggest what to change and what to leave as it is. </p>
<p>Some people call this conversion process “localization.” The truth is, unit conversions had become a part of translation, long before the word “localization” was used to describe the process. </p>
<p>When we talk about linguistic versus non-linguistic aspects of a medium, and view them as separate entities, localization and translation may look different. However, when we look at the whole process of translating the message, seeing both elements as translatable items, the terms are interchangeable. </p>
<p>In this article, the terms “localization” and “translation” will be used interchangeably. We are going to discuss how to use a website as a communication tool to gain a new market in different cultures. </p>
<h2><strong>Localization: who is it for?</strong><a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/do-you-need-to-localize-your-website#section3">#section3</a></h2>
<p>A good localization is not cheap, so it would be wise to ask yourselves several questions beforehand: </p>
<ul><li>Who is your audience?</li>
<li>What kind of culture do they live in?</li>
<li>What kind of problems may arise during the localization process? </li>
</ul><p>I will explain the details below. </p>
<h2><strong>Who is your ideal audience?</strong><a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/do-you-need-to-localize-your-website#section4">#section4</a></h2>
<p>Knowing your target audience should be at the top of your business plan. </p>
<p>For some, localization is not needed because they live in the same region and speak the same language as their target market. For example, daycare services, local coffee shops, and restaurants. </p>
<p>In some cases, <a href="https://www.businessinsider.com/new-york-city-brooklyn-manhattan-language-maps-2018-5?op=1#heres-the-no-3-most-commonly-spoken-language-in-each-neighborhood-in-brooklyn-and-queens-6">people who live in the same region may speak different languages</a>. In a bilingual society, you may want to cater to speakers of both languages as a sign of respect. In a multilingual society, aim to translate to the lingua franca and/or the language used by the majority. It makes people feel seen and it can create a positive image to your brand. </p>
<p>Sometimes, website translation is required by law. In Quebec, for instance, where French is spoken as <a href="https://www.canada.ca/en/canadian-heritage/services/provincial-territorial-symbols-canada/quebec.html">the provincial language</a>, you’ll need to include a French version of your website. You may also want to check <a href="https://www.osler.com/en/resources/business-in-canada/browse-topics/selling/french-language-rules">other types of linguistic experiences you need to provide</a>. </p>
<p>If your target market lives across the sea and speaks a different language, you may not have any choice but to localize. However, if those people can speak your  language, consider other aspects (cultural and/or legal) to make an informed decision on whether to translate.  </p>
<p>Although there are many benefits of website translation, you don’t always have to do it <em>now</em>. Especially when your budget is tight or you can spend it on something more urgent. It’s better to postpone than to have a badly translated website. <a href="https://www.ulatus.com/translation-blog/bad-translation-can-cost-money-and-reputation/">The price of cheap translation is costly</a>.  </p>
<p>If you’re legally required to launch a bilingual website but you don’t have the budget, you may want to check if you can be exempted. If you are not exempted, hire volunteers or seek government support, if possible. </p>
<p>Unless required otherwise by law, there is nothing wrong with using your current language in your product or service. You can maintain the already-formed relationship by focusing on what you have in common: the same interest. </p>
<h2><strong>Understanding cultural and linguistic intricacies</strong><a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/do-you-need-to-localize-your-website#section5">#section5</a></h2>
<p>For example, you have a coding tutorial website. Your current audience is IT professionals—mostly college graduates. You see an opportunity to expand to India. </p>
<p>Localization is <a href="https://www.livemint.com/news/india/in-india-who-speaks-in-english-and-where-1557814101428.html">unlikely to be needed in this case</a>, as most Indian engineers have a good grasp of English. So, instead of doing a web translation project, you can use your money to improve or develop a new product or service for your Indian audience. Maybe you want to set up a workshop or a meetup in India. Or a bootcamp retreat in the country. </p>
<p>You can achieve this by focusing on the similarities you have with your audience. </p>
<p>The same rule applies to other countries where English language is commonly used by IT professionals. In the developing world, where English is rarely used, <a href="https://www.vice.com/en/article/evwkyk/these-small-town-hackers-are-making-a-living-showing-companies-how-insecure-their-sites-really-are">some self-taught programmers become “good hackers” to earn some money</a>. You may wonder how, <a href="https://www.ef.com/wwen/epi/regions/asia/indonesia/">despite their lack of English skill</a>, they can learn programming.</p>
<p>There’s an explanation for it. </p>
<p>There are two types of language skills: <a href="https://www.languagesoftware.net/blog/developing-passive-skills-in-language-learning/"><em>passive</em> (listening, reading) and <em>active</em> (speaking, writing)</a>. Passive language skills are usually learned first. Active language skills are developed later. You learn to speak by listening, and learn to write by reading. You go through this process as a child and, again, when you learn a new language as an adult. (This is not to confuse <a href="https://www.utesinternationallounge.com/language-acquisition-versus-language-learning/">language acquisition with language learning</a>, but to note that the process is relatively the same.) </p>
<p>As most free IT course materials are available online in English, some programmers may have to adapt and <a href="https://jlptbootcamp.com/2012/10/passive-language-skills/">study English (passively) as they go</a>. They may not be considered “fluent” in a formal way, but it doesn’t mean they lack the ability to grasp the language. They may not be able to speak or write perfectly, but they can understand technical texts. </p>
<p>In short, passive and active language skills can grow at different speeds. This fact leads you to <em>a new group of potential audience</em>: those who can understand English, but only passively. </p>
<p>If your product is in a text format, translation won’t be necessary for this type of audience. If it’s an audio or video format, you may need to add subtitles, since native English speakers speak in so many different accents and at various speeds. Captioning will also help the hard of hearing. It may be required by regional or national accessibility legislation too. And it’s the right thing to do.</p>
<p>One might argue that if these people can understand English, they will understand the text better in their native tongue. </p>
<p>Well, if all the programs you’re using or referring to are available in their native language version, it may not be a problem. But in reality, this is often not the case. </p>
<p>Linguistic consistency helps programmers work faster. And this alone should trump the presumed ease that comes with translation. </p>
<h2><strong>Some problems with localization </strong><a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/do-you-need-to-localize-your-website#section6">#section6</a></h2>
<p>I was once involved in a global internet company’s localization project in Indonesia. </p>
<p>Indonesian SMEs mostly speak Indonesian since they mainly serve the domestic market. So, it was the right decision to target Indonesian SMEs using Indonesian language. </p>
<p>The company had the budget to target Indonesia’s market of 58 million SMEs, and there weren’t too many competitors yet. I think the localization plan was justified. But even with this generally well-thought-out plan, there were some problems in its execution. </p>
<p>The materials were filled with jargon and annoying outlinks. You could not just read an instruction until it was completed, because after a few words, you would be confronted with a “smart term.” Now to understand this smart term, you would have to follow a link that would take you to a separate page that was supposed to explain everything, but in that page you would find more smart terms that you’d need to click. At this point, the scent of information would have grown cold, and you’d likely have forgotten what you were reading or why. </p>
<p>Small business owners are among the busiest folks you can find. They do almost everything by themselves. They would not waste their time trying to read pages of instructions that throw them right and left. </p>
<p>Language-wise, the instructions could have been simplified. Design-wise, a hover/focus pop-up containing a brief definition or description could have been used to explain special terms. </p>
<p>I agree pop-ups can be distracting, but in terms of ease, for this use case, they would have worked far better than outlinks. There are <a href="https://accessuse.eu/en/Content-hover-focus.html">some ways to improve hover/focus pop-ups</a> to make them more readable. </p>
<p>However, if the content of those pop-ups (definition, description, etc.) cannot be brief, it is wiser to write it down as a separate paragraph. </p>
<p>In my client’s case, they could have started each instruction by describing the definitions of those special terms. Those definitions ought to be written in one page so as to reduce the amount of time spent on clicking and returning to the intended page. This solution can also be applied when a definition is too long to be put inside a hover/focus bubble. </p>
<p>The text problem, in my client’s case, came with the source language. It was later transferred to the target language thanks to localization. They could have solved the problem at the source language level, but I think it would have been too late at that point. </p>
<p><em>Transcreation</em>, i.e., “<a href="https://www.articulatemarketing.com/blog/translation-vs-transcreation">taking a concept in one language and completely recreating it in another language</a>,” doesn’t solve a problem like this because the issue is more technical than linguistic. Translators would still have to adjust their work to the given environment. They’d still have to retain all the links and translate all jargon-laden content. </p>
<p>The company should have hired a local writer to rewrite the content in the target language. It would have worked better. They didn’t take this route for a reason: namely, those “smart terms” were used as keywords. So as much as we hated them, we had to keep them there.  </p>
<h2><strong>How to prepare a web localization project</strong><a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/do-you-need-to-localize-your-website#section7">#section7</a></h2>
<p>Let’s say you have considered everything. You’ve learned about your target audience, how your product will solve their problem, and that you have the budget to reach out to them. Naturally, you want to reach them now before your competitors do. </p>
<p>Now you can proceed with your web localization project plan. </p>
<p>One thing I want to repeat is that localization will transfer any errors you have in your original content to the translated pages. So you’ll need to do some content pre-checks before starting a web translation project. It will be cheaper to fix the problems <em>before</em> the translation project commences. </p>
<p>Pre-localization checks should include assessing the text you intend to translate. Ask someone outside the team to read the text and ask them to give their feedback. It’s even better if that someone represents the target audience. </p>
<p>Then make corrections, if need be. Use as little jargon as possible. Let readers focus on one article with no interruption. </p>
<p>Some companies like to coin new terms to create keywords that will lead people to their sites. This can be a smart move, and it is arguably good for search engine optimization. But if you want to <a href="https://www.psychologytoday.com/us/blog/turning-point/201504/how-build-rapport-powerful-technique">build rapport with your audience</a>, you must make your message clear and understandable. Clear communication, not the invention of new words, should be your priority. </p>
<p>Following this course of action might mean sacrificing keywords for clarity, but <a href="https://neilpatel.com/blog/13-ways-to-reduce-bounce-rate-and-increase-your-conversions/">it also promises a lower bounce rate</a> since visitors will stay longer on your site. After all, people are more likely to read your writing to the end if they are not being frustrated by difficult terms.</p>
<p>Once your text is ready, you can start your localization project. You can hire a language agency or build your own team. </p>
<p>If you have a lot of content, it may be wise to outsource your project to a language agency. Doing so can save you time and money. An outside specialist consultancy will have the technology and skills to work on various types of localization projects. They can also translate your website to different languages at once. </p>
<p>As an alternative, you might directly hire freelance editors and translators to work on your project. Depending on many factors, this might end up less or more expensive than hiring an agency. </p>
<p>Make sure that the translators you hire, whether directly or through an agency, have relevant experience. If your text is about marketing, for instance, the translators and editors must be experts in this field. This is to make sure they can get your message across. </p>
<p>Most translation tools used today can retain sentence formatting, links, and HTML code, so you don’t need to worry about these. </p>
<p>Focus on the message you want to carry to your target audience. Be sensitive about cultural remarks and be careful about any potential misunderstanding caused by your translation. Consult with your language team about certain phrases that may become problematic when translated. Pick your words carefully. Choose the right expressions. </p>
<p>If you localize a website, you must be sure to provide customer service support in target-friendly language. This allows you to reply to customers immediately, rather than having to wait for a translator to become involved.  </p>
<p>In summary, don’t be hasty when doing a web localization/translation project. There are a lot of things to consider beforehand. A well prepared plan will yield a better result. A good quality translation will not only bridge the language gap but it can also build trust and solidify your brand image in the mind of your target audience.</p>]]></description>
      <link>https://alistapart-production.mystagingwebsite.com/article/do-you-need-to-localize-your-website/</link>
      <guid>https://alistapart-production.mystagingwebsite.com/article/do-you-need-to-localize-your-website/</guid>
      <pubDate>Thu, 22 Apr 2021 16:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Human-Readable JavaScript: A Tale of Two Experts]]></title>
      <description><![CDATA[<div class="entry-content">
<p>Everyone wants to be an expert. But what does that even mean? Over the years I’ve seen two types of people who are referred to as “experts.” Expert 1 is someone who knows every tool in the language and makes sure to use every bit of it, whether it helps or not. Expert 2 also knows every piece of syntax, but they’re pickier about what they employ to solve problems, considering a number of factors, both code-related and not. </p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>Can you take a guess at which expert we want working on our team? If you said Expert 2, you’d be right. They’re a developer focused on delivering readable code—lines of JavaScript others can understand and maintain. Someone who can make the complex simple. But “readable” is rarely definitive—in fact, it’s largely based on the eyes of the beholder. So where does that leave us? What should experts aim for when writing readable code? Are there clear right and wrong choices? The answer is, it depends.</p>
<h2 id="section2">The obvious choice<a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>In order to improve developer experience, TC39 has been adding lots of new features to ECMAScript in recent years, including many proven patterns borrowed from other languages. One such addition, added in ES2019, is <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/flat"><code>Array.prototype.flat()</code></a> It takes an argument of depth or <code>Infinity</code>, and flattens an array. If no argument is given, the depth defaults to 1.</p>
<p>Prior to this addition, we needed the following syntax to flatten an array to a single level.</p>
<pre id="snippet1"><code class="language-javascript">let arr = [1, 2, [3, 4]];
[].concat.apply([], arr);
// [1, 2, 3, 4]</code></pre>
<p>When we added <code>flat()</code>, that same functionality could be expressed using a single, descriptive function.</p>
<pre id="snippet2"><code class="language-javascript">arr.flat();
// [1, 2, 3, 4]</code></pre>
<p>Is the second line of code more readable? The answer is emphatically yes. In fact, both experts would agree.</p>
<p>Not every developer is going to be aware that <code>flat()</code> exists. But they don’t need to because <code>flat()</code> is a descriptive verb that conveys the meaning of what is happening. It’s a lot more intuitive than <code>concat.apply()</code>.</p>
<p>This is the rare case where there is a definitive answer to the question of whether new syntax is better than old. Both experts, each of whom is familiar with the two syntax options, will choose the second. They’ll choose the shorter, clearer, more easily maintained line of code.</p>
<p>But choices and trade-offs aren’t always so decisive.</p>
<h2 id="section3">The gut check<a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h2>
<p>The wonder of JavaScript is that it’s incredibly versatile. There is a reason it’s all over the web. Whether you think that’s a good or <a href="https://alistapart.com/article/responsible-javascript-part-1/">bad</a> thing is another story.</p>
<p>But with that versatility comes the paradox of choice. You can write the same code in many different ways. How do you determine which way is “right”? You can’t even begin to make a decision unless you understand the available options and their limitations.</p>
<p>Let’s use functional programming with <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map"><code>map()</code></a> as the example. I’ll walk through various iterations that all yield the same result.</p>
<p>This is the tersest version of our <code>map()</code> examples. It uses the fewest characters, all fit into one line. This is our baseline.</p>
<pre id="snippet3"><code class="language-javascript">const arr = [1, 2, 3];
let multipliedByTwo = arr.map(el =&gt; el * 2);
// multipliedByTwo is [2, 4, 6]</code></pre>
<p>This next example adds only two characters: parentheses. Is anything lost? How about gained? Does it make a difference that a function with more than one parameter will always need to use the parentheses? I’d argue that it does. There is little to no detriment  in adding them here, and it improves consistency when you inevitably write a function with multiple parameters. In fact, when I wrote this, <a href="https://prettier.io">Prettier</a> enforced that constraint; it didn’t want me to create an arrow function without the parentheses.</p>
<pre id="snippet4"><code class="language-javascript">let multipliedByTwo = arr.map((el) =&gt; el * 2);</code></pre>
<p>Let’s take it a step further. We’ve added curly braces and a return. Now this is starting to look more like a traditional function definition. Right now, it may seem like overkill to have a keyword as long as the function logic. Yet, if the function is more than one line, this extra syntax is again required. Do we presume that we will not have any other functions that go beyond a single line? That seems dubious.</p>
<pre id="snippet5"><code class="language-javascript">let multipliedByTwo = arr.map((el) =&gt; {
  return el * 2;
});</code></pre>
<p>Next we’ve removed the arrow function altogether. We’re using the same syntax as before, but we’ve swapped out for the <code>function</code> keyword. This is interesting because there is no scenario in which this syntax won’t work; no number of parameters or lines will cause problems, so consistency is on our side. It’s more verbose than our initial definition, but is that a bad thing? How does this hit a new coder, or someone who is well versed in something other than JavaScript? Is someone who knows JavaScript well going to be frustrated by this syntax in comparison?</p>
<pre id="snippet6"><code class="language-javascript">let multipliedByTwo = arr.map(function(el) {
  return el * 2;
});</code></pre>
<p>Finally we get to the last option: passing just the function. And <code>timesTwo</code> can be written using any syntax we like. Again, there is no scenario in which passing the function name causes a problem. But step back for a moment and think about whether or not this could be confusing. If you’re new to this codebase, is it clear that <code>timesTwo</code> is a function and not an object? Sure, <code>map()</code> is there to give you a hint, but it’s not unreasonable to miss that detail. How about the location of where <code>timesTwo</code> is declared and initialized? Is it easy to find? Is it clear what it’s doing and how it’s affecting this result? All of these are important considerations.</p>
<pre id="snippet7"><code class="language-javascript">const timesTwo = (el) =&gt; el * 2;
let multipliedByTwo = arr.map(timesTwo);</code></pre>
<p>As you can see, there is no obvious answer here. But making the right choice for your codebase means understanding all the options and their limitations. And knowing that consistency requires parentheses and curly braces and <code>return</code> keywords.</p>
<p>There are a number of questions you have to ask yourself when writing code. Questions of <a href="https://alistapart.com/article/responsible-javascript-part-2/#section9">performance</a> are typically the most common. But when you’re looking at code that is functionally identical, your determination should be based on humans—how humans consume code.</p>
<h2 id="section4">Maybe newer isn’t always better<a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h2>
<p>So far we’ve found a clear-cut example of where both experts would reach for the newest syntax, even if it’s not universally known. We’ve also looked at an example that poses a lot of questions but not as many answers.</p>
<p>Now it’s time to dive into code that I’ve written before…and removed. This is code that made me the first expert, using a little-known piece of syntax to solve a problem to the detriment of my colleagues and the maintainability of our codebase.</p>
<p><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment">Destructuring assignment</a> lets you unpack values from objects (or arrays). It typically looks something like this.</p>
<pre id="snippet8"><code class="language-javascript">const {node} = exampleObject;</code></pre>
<p>It initializes a variable and assigns it a value all in one line. But it doesn’t have to.</p>
<pre id="snippet9"><code class="language-javascript">let node
;({node} = exampleObject)</code></pre>
<p>The last line of code assigns a variable to a value using destructuring, but the variable declaration takes place one line before it. It’s not an uncommon thing to want to do, but many people don’t realize you can do it.</p>
<p>But look at that code closely. It forces an awkward semicolon for code that doesn’t use semicolons to terminate lines. It wraps the command in parentheses and adds the curly braces; it’s entirely unclear what this is doing. It’s not easy to read, and, as an expert, it shouldn’t be in code that I write.</p>
<pre id="snippet10"><code class="language-javascript">let node
node = exampleObject.node</code></pre>
<p>This code solves the problem. It works, it’s clear what it does, and my colleagues will understand it without having to look it up. With the destructuring syntax, just because I <em>can</em> doesn’t mean I <em>should</em>.</p>
<h2 id="section5">Code isn’t everything<a class="subhead-anchor" href="https://alistapart.com#section5">#section5</a></h2>
<p>As we’ve seen, the Expert 2 solution is rarely obvious based on code alone; yet there are still clear distinctions between which code each expert would write. That’s because code is for machines to read and humans to interpret. So there are non-code factors to consider!</p>
<p>The syntax choices you make for a team of JavaScript developers is different than those you should make for a team of polyglots who aren’t steeped in the minutiae. </p>
<p>Let’s take spread vs. <code>concat()</code> as an example.</p>
<p>Spread was added to ECMAScript a few years ago, and it’s enjoyed wide adoption. It’s sort of a utility syntax in that it can do a lot of different things. One of them is concatenating a number of arrays.</p>
<pre id="snippet11"><code class="language-javascript">const arr1 = [1, 2, 3];
const arr2 = [9, 11, 13];
const nums = [...arr1, ...arr2];</code></pre>
<p>As powerful as spread is, it isn’t a very intuitive symbol. So unless you already know what it does, it’s not super helpful. While both experts <em>may</em> safely assume a team of JavaScript specialists are familiar with this syntax, Expert 2 will probably question whether that’s true of a team of polyglot programmers. Instead, Expert 2 may select the <code>concat()</code> method instead, as it’s a descriptive verb that you can probably understand from the context of the code.</p>
<p>This code snippet gives us the same nums result as the spread example above.</p>
<pre id="snippet12"><code class="language-javascript">const arr1 = [1, 2, 3];
const arr2 = [9, 11, 13];
const nums = arr1.concat(arr2);</code></pre>
<p>And that’s but one example of how human factors influence code choices. A codebase that’s touched by a lot of different teams, for example, may have to hold more stringent standards that don’t necessarily keep up with the latest and greatest syntax. Then you move beyond the main source code and consider other factors in your tooling chain that make life easier, or harder, for the humans who work on that code. There is code that can be structured in a way that’s <a href="https://www.freecodecamp.org/news/how-to-write-testable-code/">hostile to testing</a>. There is code that backs you into a corner for <a href="https://www.codeproject.com/Articles/701862/How-Not-to-Back-Yourself-into-a-Corner">future scaling or feature addition</a>. There is code that’s <a href="https://laurieontech.com/posts/performance-diagnosis/">less performant</a>, doesn’t <a href="https://alistapart.com/article/fromswitchestotargets/">handle different browsers</a>, or <a href="https://a11y.coffee/">isn’t accessible</a>. All of these factor into the recommendations Expert 2 makes.</p>
<p>Expert 2 also considers the impact of naming. But let’s be honest, even <em>they</em> can’t get that right most of the time.</p>
<h2 id="section6">Conclusion<a class="subhead-anchor" href="https://alistapart.com#section6">#section6</a></h2>
<p>Experts don’t prove themselves by using every piece of the spec; they prove themselves by knowing the spec well enough to deploy syntax judiciously and make well-reasoned decisions. This is how experts become multipliers—how they make new experts.</p>
<p>So what does this mean for those of us who consider ourselves experts or aspiring experts? It means that writing code involves asking yourself a lot of questions. It means considering your developer audience in a real way. The best code you can write is code that accomplishes something complex, but is inherently understood by those who examine your codebase.</p>
<p>And no, it’s not easy. And there often isn’t a clear-cut answer. But it’s something you should consider with every function you write.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Looking to maximize the performance of your site with minimal effort? Check out Jeremy Wagner’s streaming Service Worker.</div><div class="entry-content">In this excerpt from Volume 2 of RECOGNIZE, Regine Gilbert offers a helpful mnemonic for approaching our design work from a fresh perspective: “WOQE” for watch, observe, question, and explore.</div><div class="entry-content">How to face reality when your team screws up, and get everyone back on track.</div><div class="entry-content">Matt E. Patterson shows why a new WebSockets-driven approach is catching developers' attention, and how it can mean faster, easier development that results in an experience just as rich as client-side SPAs.</div><div class="entry-content">Are your content models excluding people? This piece from Daniel Carter and Carra Martinez will help you recognize how this happens and what we can do about it.</div>]]></description>
      <link>https://alistapart.com/article/human-readable-javascript/</link>
      <guid>https://alistapart.com/article/human-readable-javascript/</guid>
      <pubDate>Thu, 25 Mar 2021 15:00:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[Human-Readable JavaScript: A Tale of Two Experts]]></title>
      <description><![CDATA[<p>Everyone wants to be an expert. But what does that even mean? Over the years I’ve seen two types of people who are referred to as “experts.” Expert 1 is someone who knows every tool in the language and makes sure to use every bit of it, whether it helps or not. Expert 2 also knows every piece of syntax, but they’re pickier about what they employ to solve problems, considering a number of factors, both code-related and not. </p><div class="aside-breaker">Article Continues Below</div>
<p>Can you take a guess at which expert we want working on our team? If you said Expert 2, you’d be right. They’re a developer focused on delivering readable code—lines of JavaScript others can understand and maintain. Someone who can make the complex simple. But “readable” is rarely definitive—in fact, it’s largely based on the eyes of the beholder. So where does that leave us? What should experts aim for when writing readable code? Are there clear right and wrong choices? The answer is, it depends.</p>
<p>In order to improve developer experience, TC39 has been adding lots of new features to ECMAScript in recent years, including many proven patterns borrowed from other languages. One such addition, added in ES2019, is <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/flat"><code>Array.prototype.flat()</code></a> It takes an argument of depth or <code>Infinity</code>, and flattens an array. If no argument is given, the depth defaults to 1.</p>
<p>Prior to this addition, we needed the following syntax to flatten an array to a single level.</p>
<pre class="language-javascript">let arr = [1, 2, [3, 4]];
[].concat.apply([], arr);
// [1, 2, 3, 4]</pre>
<p>When we added <code>flat()</code>, that same functionality could be expressed using a single, descriptive function.</p>
<pre class="language-javascript">arr.flat();
// [1, 2, 3, 4]</pre>
<p>Is the second line of code more readable? The answer is emphatically yes. In fact, both experts would agree.</p>
<p>Not every developer is going to be aware that <code>flat()</code> exists. But they don’t need to because <code>flat()</code> is a descriptive verb that conveys the meaning of what is happening. It’s a lot more intuitive than <code>concat.apply()</code>.</p>
<p>This is the rare case where there is a definitive answer to the question of whether new syntax is better than old. Both experts, each of whom is familiar with the two syntax options, will choose the second. They’ll choose the shorter, clearer, more easily maintained line of code.</p>
<p>But choices and trade-offs aren’t always so decisive.</p>
<p>The wonder of JavaScript is that it’s incredibly versatile. There is a reason it’s all over the web. Whether you think that’s a good or <a href="https://alistapart-production.mystagingwebsite.com/article/responsible-javascript-part-1/">bad</a> thing is another story.</p>
<p>But with that versatility comes the paradox of choice. You can write the same code in many different ways. How do you determine which way is “right”? You can’t even begin to make a decision unless you understand the available options and their limitations.</p>
<p>Let’s use functional programming with <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map"><code>map()</code></a> as the example. I’ll walk through various iterations that all yield the same result.</p>
<p>This is the tersest version of our <code>map()</code> examples. It uses the fewest characters, all fit into one line. This is our baseline.</p>
<pre class="language-javascript">const arr = [1, 2, 3];
let multipliedByTwo = arr.map(el =&gt; el * 2);
// multipliedByTwo is [2, 4, 6]</pre>
<p>This next example adds only two characters: parentheses. Is anything lost? How about gained? Does it make a difference that a function with more than one parameter will always need to use the parentheses? I’d argue that it does. There is little to no detriment  in adding them here, and it improves consistency when you inevitably write a function with multiple parameters. In fact, when I wrote this, <a href="https://prettier.io">Prettier</a> enforced that constraint; it didn’t want me to create an arrow function without the parentheses.</p>
<pre class="language-javascript">let multipliedByTwo = arr.map((el) =&gt; el * 2);</pre>
<p>Let’s take it a step further. We’ve added curly braces and a return. Now this is starting to look more like a traditional function definition. Right now, it may seem like overkill to have a keyword as long as the function logic. Yet, if the function is more than one line, this extra syntax is again required. Do we presume that we will not have any other functions that go beyond a single line? That seems dubious.</p>
<pre class="language-javascript">let multipliedByTwo = arr.map((el) =&gt; {
  return el * 2;
});</pre>
<p>Next we’ve removed the arrow function altogether. We’re using the same syntax as before, but we’ve swapped out for the <code>function</code> keyword. This is interesting because there is no scenario in which this syntax won’t work; no number of parameters or lines will cause problems, so consistency is on our side. It’s more verbose than our initial definition, but is that a bad thing? How does this hit a new coder, or someone who is well versed in something other than JavaScript? Is someone who knows JavaScript well going to be frustrated by this syntax in comparison?</p>
<pre class="language-javascript">let multipliedByTwo = arr.map(function(el) {
  return el * 2;
});</pre>
<p>Finally we get to the last option: passing just the function. And <code>timesTwo</code> can be written using any syntax we like. Again, there is no scenario in which passing the function name causes a problem. But step back for a moment and think about whether or not this could be confusing. If you’re new to this codebase, is it clear that <code>timesTwo</code> is a function and not an object? Sure, <code>map()</code> is there to give you a hint, but it’s not unreasonable to miss that detail. How about the location of where <code>timesTwo</code> is declared and initialized? Is it easy to find? Is it clear what it’s doing and how it’s affecting this result? All of these are important considerations.</p>
<pre class="language-javascript">const timesTwo = (el) =&gt; el * 2;
let multipliedByTwo = arr.map(timesTwo);</pre>
<p>As you can see, there is no obvious answer here. But making the right choice for your codebase means understanding all the options and their limitations. And knowing that consistency requires parentheses and curly braces and <code>return</code> keywords.</p>
<p>There are a number of questions you have to ask yourself when writing code. Questions of <a href="https://alistapart-production.mystagingwebsite.com/article/responsible-javascript-part-2/#section9">performance</a> are typically the most common. But when you’re looking at code that is functionally identical, your determination should be based on humans—how humans consume code.</p>
<h2>Maybe newer isn’t always better<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/human-readable-javascript#section4">#section4</a></h2>
<p>So far we’ve found a clear-cut example of where both experts would reach for the newest syntax, even if it’s not universally known. We’ve also looked at an example that poses a lot of questions but not as many answers.</p>
<p>Now it’s time to dive into code that I’ve written before…and removed. This is code that made me the first expert, using a little-known piece of syntax to solve a problem to the detriment of my colleagues and the maintainability of our codebase.</p>
<p><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment">Destructuring assignment</a> lets you unpack values from objects (or arrays). It typically looks something like this.</p>
<pre class="language-javascript">const {node} = exampleObject;</pre>
<p>It initializes a variable and assigns it a value all in one line. But it doesn’t have to.</p>
<pre class="language-javascript">let node
;({node} = exampleObject)</pre>
<p>The last line of code assigns a variable to a value using destructuring, but the variable declaration takes place one line before it. It’s not an uncommon thing to want to do, but many people don’t realize you can do it.</p>
<p>But look at that code closely. It forces an awkward semicolon for code that doesn’t use semicolons to terminate lines. It wraps the command in parentheses and adds the curly braces; it’s entirely unclear what this is doing. It’s not easy to read, and, as an expert, it shouldn’t be in code that I write.</p>
<pre class="language-javascript">let node
node = exampleObject.node</pre>
<p>This code solves the problem. It works, it’s clear what it does, and my colleagues will understand it without having to look it up. With the destructuring syntax, just because I <em>can</em> doesn’t mean I <em>should</em>.</p>
<h2>Code isn’t everything<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/human-readable-javascript#section5">#section5</a></h2>
<p>As we’ve seen, the Expert 2 solution is rarely obvious based on code alone; yet there are still clear distinctions between which code each expert would write. That’s because code is for machines to read and humans to interpret. So there are non-code factors to consider!</p>
<p>The syntax choices you make for a team of JavaScript developers is different than those you should make for a team of polyglots who aren’t steeped in the minutiae. </p>
<p>Let’s take spread vs. <code>concat()</code> as an example.</p>
<p>Spread was added to ECMAScript a few years ago, and it’s enjoyed wide adoption. It’s sort of a utility syntax in that it can do a lot of different things. One of them is concatenating a number of arrays.</p>
<pre class="language-javascript">const arr1 = [1, 2, 3];
const arr2 = [9, 11, 13];
const nums = [...arr1, ...arr2];</pre>
<p>As powerful as spread is, it isn’t a very intuitive symbol. So unless you already know what it does, it’s not super helpful. While both experts <em>may</em> safely assume a team of JavaScript specialists are familiar with this syntax, Expert 2 will probably question whether that’s true of a team of polyglot programmers. Instead, Expert 2 may select the <code>concat()</code> method instead, as it’s a descriptive verb that you can probably understand from the context of the code.</p>
<p>This code snippet gives us the same nums result as the spread example above.</p>
<pre class="language-javascript">const arr1 = [1, 2, 3];
const arr2 = [9, 11, 13];
const nums = arr1.concat(arr2);</pre>
<p>And that’s but one example of how human factors influence code choices. A codebase that’s touched by a lot of different teams, for example, may have to hold more stringent standards that don’t necessarily keep up with the latest and greatest syntax. Then you move beyond the main source code and consider other factors in your tooling chain that make life easier, or harder, for the humans who work on that code. There is code that can be structured in a way that’s <a href="https://www.freecodecamp.org/news/how-to-write-testable-code/">hostile to testing</a>. There is code that backs you into a corner for <a href="https://www.codeproject.com/Articles/701862/How-Not-to-Back-Yourself-into-a-Corner">future scaling or feature addition</a>. There is code that’s <a href="https://laurieontech.com/posts/performance-diagnosis/">less performant</a>, doesn’t <a href="https://alistapart-production.mystagingwebsite.com/article/fromswitchestotargets/">handle different browsers</a>, or <a href="https://a11y.coffee/">isn’t accessible</a>. All of these factor into the recommendations Expert 2 makes.</p>
<p>Expert 2 also considers the impact of naming. But let’s be honest, even <em>they</em> can’t get that right most of the time.</p>
<p>Experts don’t prove themselves by using every piece of the spec; they prove themselves by knowing the spec well enough to deploy syntax judiciously and make well-reasoned decisions. This is how experts become multipliers—how they make new experts.</p>
<p>So what does this mean for those of us who consider ourselves experts or aspiring experts? It means that writing code involves asking yourself a lot of questions. It means considering your developer audience in a real way. The best code you can write is code that accomplishes something complex, but is inherently understood by those who examine your codebase.</p>
<p>And no, it’s not easy. And there often isn’t a clear-cut answer. But it’s something you should consider with every function you write.</p>]]></description>
      <link>https://alistapart-production.mystagingwebsite.com/article/human-readable-javascript/</link>
      <guid>https://alistapart-production.mystagingwebsite.com/article/human-readable-javascript/</guid>
      <pubDate>Thu, 25 Mar 2021 15:00:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[Now THAT&#8217;S What I Call Service Worker!]]></title>
      <description><![CDATA[<div class="entry-content">
<p>The <a href="https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API">Service Worker</a> API is the <a href="https://en.wikipedia.org/wiki/Dremel">Dremel</a> of the web platform. It offers incredibly broad utility while also yielding resiliency and better performance. If you’ve not used Service Worker yet—and you couldn’t be blamed if so, as <a href="https://almanac.httparchive.org/en/2020/pwa#service-workers">it hasn’t seen wide adoption as of 2020</a>—it goes something like this:</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<ol><li>On the initial visit to a website, the browser <a href="https://developers.google.com/web/fundamentals/primers/service-workers#register_a_service_worker">registers</a> what amounts to a client-side proxy powered by <a href="https://www.weeklytimber.com/sw.js">a comparably paltry amount of JavaScript</a> that—like a Web Worker—runs on its own thread.</li>
<li>After the Service Worker’s registration, you can intercept requests and decide how to respond to them in the <a href="https://developer.mozilla.org/en-US/docs/Web/API/FetchEvent">Service Worker’s fetch() event</a>.</li>
</ol><p>What you decide to do with requests you intercept is a) your call and b) depends on your website. You can <a href="https://alistapart.com/article/request-with-intent-caching-strategies-in-the-age-of-pwas/#section8">rewrite requests</a>, <a href="https://web.dev/offline-cookbook/#on-install-as-dependency">precache static assets</a> during install, <a href="https://www.madebymike.com.au/writing/service-workers/#a-better-offline-page-deeper-down-the-rabbit-hole">provide offline functionality</a>, and—as will be our eventual focus—<a href="https://philipwalton.com/articles/smaller-html-payloads-with-service-workers/">deliver smaller HTML payloads and better performance</a> for repeat visitors.</p>
<h2 id="section2">Getting out of the woods<a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>Weekly Timber is a client of mine that provides logging services in central Wisconsin. For them, a fast website is vital. Their business is located in <a href="https://en.wikipedia.org/wiki/Waushara_County,_Wisconsin">Waushara County</a>, and like many rural stretches in the United States, <a href="https://maps.psc.wi.gov/apps/WisconsinBroadbandMap/">network quality and reliability isn’t great</a>.</p>
<div class="wp-block-image">
<figure id="figure1" class="aligncenter size-large"><img width="960" height="500" src="https://alistapart.com/wp-content/uploads/2021/03/fig-1.png?resize=960%2C500" alt="A screenshot of a wireless coverage map for Waushara County, Wisconsin with a color overlay. Most of the overlay is colored tan, which represents areas of the county which have downlink speeds between 3 and 9.99 megabits per second. There are sparse light blue and dark blue areas which indicate faster service, but are far from being the majority of the county." class="wp-image-7172790" data-recalc-dims="1" /><figcaption><em><strong>Figure 1.</strong> A wireless coverage map of Waushara County, Wisconsin. The tan areas of the map indicate downlink speeds between 3 and 9.99 Mbps. Red areas are even slower, while the pale and dark blue areas are faster.</em></figcaption></figure></div>
<p>Wisconsin has farmland for <em>days</em>, but it also has plenty of forests. When you need a company that cuts logs, Google is probably your first stop. How fast a given logging company’s website is might be enough to get you looking elsewhere if you’re left waiting too long on a crappy network connection.</p>
<p>I initially didn’t believe a Service Worker was necessary for Weekly Timber’s website. After all, if things were plenty fast to start with, why complicate things? On the other hand, knowing that my client services not just Waushara County, but much of central Wisconsin, even a barebones Service Worker could be the kind of progressive enhancement that adds resilience in the places it might be needed most.</p>
<p>The first Service Worker I wrote for my client’s website—which I’ll refer to henceforth as the “standard” Service Worker—used three <a href="https://web.dev/offline-cookbook/">well-documented caching strategies</a>:</p>
<ol><li>Precache CSS and JavaScript assets for all pages when the Service Worker is installed when the window’s load event fires.</li>
<li>Serve static assets out of <a href="https://developer.mozilla.org/en-US/docs/Web/API/CacheStorage"><code>CacheStorage</code></a> if available. If a static asset isn’t in <code>CacheStorage</code>, retrieve it from the network, then cache it for future visits.</li>
<li>For HTML assets, hit the network first and place the HTML response into <code>CacheStorage</code>. If the network is unavailable the next time the visitor arrives, serve the cached markup from <code>CacheStorage</code>.</li>
</ol><p>These are neither new nor special strategies, but they provide two benefits:</p>
<ul><li>Offline capability, which is handy when network conditions are spotty.</li>
<li>A performance boost for loading static assets.</li>
</ul><p>That performance boost translated to a 42% and 48% decrease in the median time to <a href="https://web.dev/fcp/">First Contentful Paint (FCP)</a> and <a href="https://web.dev/lcp/">Largest Contentful Paint (LCP)</a>, respectively. Better yet, these insights are based on <a href="https://en.wikipedia.org/wiki/Real_user_monitoring">Real User Monitoring (RUM)</a>. That means these gains aren’t just theoretical, but a real improvement for real people.</p>
<div class="wp-block-image">
<figure id="figure2" class="aligncenter size-large"><img width="960" height="282" src="https://alistapart.com/wp-content/uploads/2021/03/fig-2.png?resize=960%2C282" alt="A screenshot of request/response timings in Chrome's developer tools. It depicts a service worker on a page serving a static asset from CacheStorage in roughly 23 milliseconds." class="wp-image-7172791" data-recalc-dims="1" /><figcaption><em><strong>Figure 2.</strong> A breakdown of request/response timings depicted in Chrome’s developer tools. The request is for a static asset from CacheStorage. Because the Service Worker doesn’t need to access the network, it takes about 23 milliseconds to “download” the asset from <code>CacheStorage</code>.</em></figcaption></figure></div>
<p>This performance boost is from bypassing the network entirely for static assets already in <code>CacheStorage</code>—particularly render-blocking stylesheets. A similar benefit is realized when we rely on the HTTP cache, only the FCP and LCP improvements I just described are in comparison to pages with a primed HTTP cache without an installed Service Worker.</p>
<p>If you’re wondering why <a href="https://blog.yoav.ws/tale-of-four-caches/"><code>CacheStorage</code> and the HTTP cache aren’t equal</a>, it’s because the HTTP cache—at least in <a href="https://jakearchibald.com/2016/caching-best-practices/#pattern-2-mutable-content-always-server-revalidated">some cases</a>—may still involve a trip to the server to verify asset freshness. <a href="https://hacks.mozilla.org/2017/01/using-immutable-caching-to-speed-up-the-web/">Cache-Control’s <code>immutable</code> flag gets around this</a>, but <a href="https://caniuse.com/mdn-http_headers_cache-control_immutable"><code>immutable</code> doesn’t have great support</a> yet. A long max-age value works, too, but the combination of Service Worker API and <code>CacheStorage</code> gives you a lot more flexibility.</p>
<p>Details aside, the takeaway is that the simplest and most well-established Service Worker caching practices can improve performance. Potentially more than what well-configured <code>Cache-Control</code> headers can provide. Even so, Service Worker is an incredible technology with far more possibilities. It’s possible to go farther, and I’ll show you how.</p>
<h2 id="section3">A better, faster Service Worker<a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h2>
<p>The web <em>loves</em> itself some “innovation,” which is a word we equally love to throw around. To me, true innovation isn’t when we create new frameworks or patterns solely for the benefit of developers, but whether those inventions benefit people who end up using whatever it is we slap up on the web. <a href="https://www.w3.org/TR/html-design-principles/#priority-of-constituencies">The priority of constituencies</a> is a thing we ought to respect. Users above all else, always.</p>
<p>The Service Worker API’s innovation space is considerable. How you work within that space can have a big effect on how the web is experienced. Things like <a href="https://developers.google.com/web/updates/2017/02/navigation-preload">navigation preload</a> and <a href="https://developer.mozilla.org/en-US/docs/Web/API/ReadableStream#examples"><code>ReadableStream</code></a> have taken Service Worker from great to killer. We can do the following with these new capabilities, respectively:</p>
<ul><li>Reduce Service Worker latency by parallelizing Service Worker startup time and <a href="https://fetch.spec.whatwg.org/#navigation-request">navigation requests</a>.</li>
<li>Stream content in from <code>CacheStorage</code> and the network.</li>
</ul><p>Moreover, we’re going to combine these capabilities and pull out one more trick: precache header and footer partials, then combine them with content partials from the network. This not only reduces how much data we download from the network, but it also improves perceptual performance for repeat visits. That’s innovation that helps everyone.</p>
<p>Grizzled, I turn to you and say <em>“let’s do this.”</em></p>
<h3 id="section4">Laying the groundwork<a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h3>
<p>If the idea of combining precached header and footer partials with network content on the fly seems like a Single Page Application (SPA), you’re not far off. Like an SPA, you’ll need to apply the “app shell” model to your website. Only instead of a client-side router plowing content into one piece of minimal markup, you have to think of your website as three separate parts:</p>
<ul><li>The header.</li>
<li>The content.</li>
<li>The footer.</li>
</ul><p>For my client’s website, that looks like this:</p>
<div class="wp-block-image">
<figure id="figure3" class="aligncenter size-large"><img width="960" height="2006" src="https://alistapart.com/wp-content/uploads/2021/03/fig-3.png?resize=960%2C2006" alt="A screenshot of the Weekly Timber website color coded to delineate each partial that makes up the page. The header is color coded as blue, the footer as red, and the main content in between as yellow." class="wp-image-7172792" data-recalc-dims="1" /><figcaption><em><strong>Figure 3.</strong> A color coding of the Weekly Timber website’s different partials. The Footer and Header partials are stored in <code>CacheStorage</code>, while the Content partial is retrieved from the network unless the user is offline.</em></figcaption></figure></div>
<p>The thing to remember here is that the individual partials don’t have to be valid markup in the sense that all tags need to be closed within each partial. The only thing that counts in the final sense is that the combination of these partials must be valid markup.</p>
<p>To start, you’ll need to precache separate header and footer partials when the Service Worker is installed. For my client’s website, these partials are served from the <code>/partial-header</code> and <code>/partial-footer</code> pathnames:</p>
<pre id="snippet1" class="wp-block-code"><code>self.addEventListener("install", event =&gt; {
  const cacheName = "fancy_cache_name_here";
  const precachedAssets = [
    "/partial-header",  // The header partial
    "/partial-footer",  // The footer partial
    // Other assets worth precaching
  ];
  event.waitUntil(caches.open(cacheName).then(cache =&gt; {
    return cache.addAll(precachedAssets);
  }).then(() =&gt; {
    return self.skipWaiting();
  }));
});</code></pre>
<p>Every page must be fetchable as a content partial minus the header and footer, as well as a full page with the header and footer. This is key because the initial visit to a page won’t be controlled by a Service Worker. Once the Service Worker takes over, then you serve content partials and assemble them into complete responses with the header and footer partials from <code>CacheStorage</code>.</p>
<p>If your site is static, this means generating a whole other mess of markup partials that you can rewrite requests to in the Service Worker’s <code>fetch()</code> event. If your website has a back end—as is the case with my client—you can use an HTTP request header to instruct the server to deliver full pages or content partials.</p>
<p>The hard part is putting all the pieces together—but we’ll do just that.</p>
<h3 id="section5">Putting it all together<a class="subhead-anchor" href="https://alistapart.com#section5">#section5</a></h3>
<p>Writing even a basic Service Worker can be challenging, but things get real complicated real fast when assembling multiple responses into one. One reason for this is that in order to avoid the Service Worker startup penalty, we’ll need to set up navigation preload.</p>
<h4 id="section6">Implementing navigation preload<a class="subhead-anchor" href="https://alistapart.com#section6">#section6</a></h4>
<p>Navigation preload addresses the problem of Service Worker startup time, which delays navigation requests to the network. The last thing you want to do with a Service Worker is hold up the show.</p>
<p>Navigation preload must be explicitly enabled. Once enabled, the Service Worker won’t hold up navigation requests during startup. Navigation preload is enabled in the Service Worker’s <code>activate</code> event:</p>
<pre id="snippet2" class="wp-block-code"><code>self.addEventListener("activate", event =&gt; {
  const cacheName = "fancy_cache_name_here";
  const preloadAvailable = "navigationPreload" in self.registration;
  event.waitUntil(caches.keys().then(keys =&gt; {
    return Promise.all([
      keys.filter(key =&gt; {
        return key !== cacheName;
      }).map(key =&gt; {
        return caches.delete(key);
      }),
      self.clients.claim(),
      preloadAvailable ? self.registration.navigationPreload.enable() : true
    ]);
  }));
});</code></pre>
<p><a href="https://caniuse.com/mdn-api_navigationpreloadmanager">Because navigation preload isn’t supported everywhere</a>, we have to do the usual feature check, which we store in the above example in the <code>preloadAvailable</code> variable.</p>
<p>Additionally, we need to use <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/all"><code>Promise.all()</code></a> to resolve multiple asynchronous operations before the Service Worker activates. This includes pruning those old caches, as well as waiting for both <a href="https://developer.mozilla.org/en-US/docs/Web/API/Clients/claim"><code>clients.claim()</code></a> (which tells the Service Worker to assert control immediately rather than waiting until the next navigation) and navigation preload to be enabled.</p>
<p>A ternary operator is used to enable navigation preload in supporting browsers and avoid throwing errors in browsers that don’t. If <code>preloadAvailable</code> is <code>true</code>, we enable navigation preload. If it isn’t, we pass a Boolean that won’t affect how <code>Promise.all()</code> resolves.</p>
<p>With navigation preload enabled, we need to write code in our Service Worker’s <code>fetch()</code> event handler to make use of the preloaded response:</p>
<pre id="snippet3" class="wp-block-code"><code>self.addEventListener("fetch", event =&gt; {
  const { request } = event;
  // Static asset handling code omitted for brevity
  // ...
  // Check if this is a request for a document
  if (request.mode === "navigate") {
    const networkContent = Promise.resolve(event.preloadResponse).then(response =&gt; {
      if (response) {
        addResponseToCache(request, response.clone());
        return response;
      }
      return fetch(request.url, {
        headers: {
          "X-Content-Mode": "partial"
        }
      }).then(response =&gt; {
        addResponseToCache(request, response.clone());
        return response;
      });
    }).catch(() =&gt; {
      return caches.match(request.url);
    });
    // More to come...
  }
});</code></pre>
<p>Though this isn’t the entirety of the Service Worker’s <code>fetch()</code> event code, there’s a lot that needs explaining:</p>
<ol><li>The preloaded response is available in <code>event.preloadResponse</code>. However, <a href="https://developers.google.com/web/updates/2017/02/navigation-preload">as Jake Archibald notes</a>, the value of <code>event.preloadResponse</code> will be <code>undefined</code> in browsers that don’t support navigation preload. Therefore, we must pass <code>event.preloadResponse</code> to <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/resolve"><code>Promise.resolve()</code></a> to avoid compatibility issues.</li>
<li>We adapt in the resulting <code>then</code> callback. If event.<code>preloadResponse</code> is supported, we use the preloaded response and add it to <code>CacheStorage</code> via an <code>addResponseToCache()</code> helper function. If not, we send a <code>fetch()</code> request to the network to get the content partial using a custom <code>X-Content-Mode</code> header with a value of <code>partial</code>.</li>
<li>Should the network be unavailable, we fall back to the most recently accessed content partial in <code>CacheStorage</code>.</li>
<li>The response—regardless of where it was procured from—is then returned to a variable named <code>networkContent</code> that we use later.</li>
</ol><p>How the content partial is retrieved is tricky. With navigation preload enabled, a special <code>Service-Worker-Navigation-Preload</code> header with a value of <code>true</code> is added to navigation requests. We then work with that header on the back end to ensure the response is a content partial rather than the full page markup.</p>
<p>However, because navigation preload isn’t available in all browsers, we send a different header in those scenarios. In Weekly Timber’s case, we fall back to a custom <code>X-Content-Mode</code> header. In my client’s PHP back end, I’ve created some handy constants:</p>
<pre id="snippet4" class="wp-block-code"><code>&lt;?php
// Is this a navigation preload request?
define("NAVIGATION_PRELOAD", isset($_SERVER["HTTP_SERVICE_WORKER_NAVIGATION_PRELOAD"]) &amp;&amp; stristr($_SERVER["HTTP_SERVICE_WORKER_NAVIGATION_PRELOAD"], "true") !== false);
// Is this an explicit request for a content partial?
define("PARTIAL_MODE", isset($_SERVER["HTTP_X_CONTENT_MODE"]) &amp;&amp; stristr($_SERVER["HTTP_X_CONTENT_MODE"], "partial") !== false);
// If either is true, this is a request for a content partial
define("USE_PARTIAL", NAVIGATION_PRELOAD === true || PARTIAL_MODE === true);
?&gt;</code></pre>
<p>From there, the <code>USE_PARTIAL</code> constant is used to adapt the response:</p>
<pre id="snippet5" class="wp-block-code"><code>&lt;?php
if (USE_PARTIAL === false) {
  require_once("partial-header.php");
}
require_once("includes/home.php");
if (USE_PARTIAL === false) {
  require_once("partial-footer.php");
}
?&gt;</code></pre>
<p>The thing to be hip to here is that you should specify <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Vary">a <code>Vary</code> header</a> for HTML responses to take the <code>Service-Worker-Navigation-Preload</code> (and in this case, the <code>X-Content-Mode</code> header) into account for HTTP caching purposes—assuming you’re caching HTML at all, which may not be the case for you.</p>
<p>With our handling of navigation preloads complete, we can then move onto the work of streaming content partials from the network and stitching them together with the header and footer partials from <code>CacheStorage</code> into a single response that the Service Worker will provide.</p>
<h4 id="section7">Streaming partial content and stitching together responses<a class="subhead-anchor" href="https://alistapart.com#section7">#section7</a></h4>
<p>While the header and footer partials will be available almost instantaneously because they’ve been in <code>CacheStorage</code> since the Service Worker’s installation, it’s the content partial we retrieve from the network that will be the bottleneck. It’s therefore vital that we <a href="https://developers.google.com/web/updates/2016/06/sw-readablestreams">stream responses</a> so we can start pushing markup to the browser as quickly as possible. <code>ReadableStream</code> can do this for us.</p>
<p>This <code>ReadableStream</code> business is a mind-bender. Anyone who tells you it’s “easy” is whispering sweet nothings to you. It’s <em>hard</em>. After I wrote my own function to merge streamed responses and messed up a critical step—which ended up not improving page performance, mind you—I modified <a href="https://gist.github.com/jakearchibald/d0b7e65496a8ec362f10739c3e28da6e">Jake Archibald’s <code>mergeResponses()</code> function</a> to suit my needs:</p>
<pre id="snippet6" class="wp-block-code"><code>async function mergeResponses (responsePromises) {
  const readers = responsePromises.map(responsePromise =&gt; {
    return Promise.resolve(responsePromise).then(response =&gt; {
      return response.body.getReader();
    });
  });
  let doneResolve,
      doneReject;
  const done = new Promise((resolve, reject) =&gt; {
    doneResolve = resolve;
    doneReject = reject;
  });
  const readable = new ReadableStream({
    async pull (controller) {
      const reader = await readers[0];
      try {
        const { done, value } = await reader.read();
        if (done) {
          readers.shift();
          if (!readers[0]) {
            controller.close();
            doneResolve();
            return;
          }
          return this.pull(controller);
        }
        controller.enqueue(value);
      } catch (err) {
        doneReject(err);
        throw err;
      }
    },
    cancel () {
      doneResolve();
    }
  });
  const headers = new Headers();
  headers.append("Content-Type", "text/html");
  return {
    done,
    response: new Response(readable, {
      headers
    })
  };
}</code></pre>
<p>As usual, there’s a lot going on:</p>
<ol><li><code>mergeResponses()</code> accepts an argument named <code>responsePromises</code>, which is an array of <a href="https://developer.mozilla.org/en-US/docs/Web/API/Response"><code>Response</code></a> objects returned from either a navigation preload, <code>fetch()</code>, or <a href="https://developer.mozilla.org/en-US/docs/Web/API/CacheStorage/match"><code>caches.match()</code></a>. Assuming the network is available, this will always contain three responses: two from <code>caches.match()</code> and (hopefully) one from the network.</li>
<li>Before we can stream the responses in the <code>responsePromises</code> array, we must map <code>responsePromises</code> to an array containing one reader for each response. Each reader is used later in a <code>ReadableStream()</code> constructor to stream each response’s contents.</li>
<li>A promise named <code>done</code> is created. In it, we assign the promise’s <code>resolve()</code> and <code>reject()</code> functions to the external variables <code>doneResolve</code> and <code>doneReject</code>, respectively. These will be used in the <code>ReadableStream()</code> to signal whether the stream is finished or has hit a snag.</li>
<li>The new <code>ReadableStream()</code> instance is created with a name of <code>readable</code>. As responses stream in from <code>CacheStorage</code> and the network, their contents will be appended to <code>readable</code>.</li>
<li>The stream’s <code>pull()</code> method streams the contents of the first response in the array. If the stream isn’t canceled somehow, the reader for each response is discarded by calling the readers array’s <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/shift"><code>shift()</code> method</a> when the response is fully streamed. This repeats until there are no more readers to process.</li>
<li>When all is done, the merged stream of responses is returned as a single response, and we return it with a <code>Content-Type</code> header value of <code>text/html</code>.</li>
</ol><p>This is <a href="https://gist.github.com/jakearchibald/32b2155708a665e9c8e06642b7c09d86">much simpler</a> if you use <a href="https://developer.mozilla.org/en-US/docs/Web/API/TransformStream"><code>TransformStream</code></a>, but depending on when you read this, that may not be an option for every browser. For now, we’ll have to stick with this approach.</p>
<p>Now let’s revisit the Service Worker’s <code>fetch()</code> event from earlier, and apply the <code>mergeResponses()</code> function:</p>
<pre id="snippet7" class="wp-block-code"><code>self.addEventListener("fetch", event =&gt; {
  const { request } = event;
  // Static asset handling code omitted for brevity
  // ...
  // Check if this is a request for a document
  if (request.mode === "navigate") {
    // Navigation preload/fetch() fallback code omitted.
    // ...
    const { done, response } = await mergeResponses([
      caches.match("/partial-header"),
      networkContent,
      caches.match("/partial-footer")
    ]);
    event.waitUntil(done);
    event.respondWith(response);
  }
});</code></pre>
<p>At the end of the <code>fetch()</code> event handler, we pass the header and footer partials from <code>CacheStorage</code> to the <code>mergeResponses()</code> function, and pass the result to the <code>fetch()</code> event’s <a href="https://developer.mozilla.org/en-us/docs/Web/API/FetchEvent/respondWith"><code>respondWith()</code> method</a>, which serves the merged response on behalf of the Service Worker.</p>
<h2 id="section8">Are the results worth the hassle?<a class="subhead-anchor" href="https://alistapart.com#section8">#section8</a></h2>
<p>This is a lot of stuff to do, and it’s complicated! You might mess something up, or maybe your website’s architecture isn’t well-suited to this exact approach. So it’s important to ask: are the performance benefits worth the work? In my view? Yes! The synthetic performance gains aren’t bad at all:</p>
<div class="wp-block-image">
<figure id="figure4" class="aligncenter size-large"><img width="960" height="530" src="https://alistapart.com/wp-content/uploads/2021/03/fig-4.png?resize=960%2C530" alt="A bar graph comparing First Contentful Paint and Largest Contentful Paint performance for the Weekly Timber website for scenarios in which there is no service worker, a &quot;standard&quot; service worker, and a streaming service worker that stitches together content partials from CacheStorage and the network. The first two scenarios are basically the same, while the streaming service worker delivers measurably better performance for both FCP and LCP—especially for FCP!" class="wp-image-7172793" data-recalc-dims="1" /><figcaption><em><strong>Figure 4.</strong> A bar chart of median FCP and LCP synthetic performance data across various Service Worker types for the Weekly Timber website.</em></figcaption></figure></div>
<p>Synthetic tests don’t measure performance for anything except the specific device and internet connection they’re performed on. Even so, these tests were conducted on a staging version of my client’s website with a low-end <a href="https://www.gsmarena.com/nokia_2-8513.php">Nokia 2 Android phone</a> on a throttled “Fast 3G” connection in Chrome’s developer tools. Each category was tested ten times on the homepage. The takeaways here are:</p>
<ul><li>No Service Worker at all is slightly faster than the “standard” Service Worker with simpler caching patterns than the streaming variant. Like, ever so slightly faster. This may be due to the delay introduced by Service Worker startup, however, the RUM data I’ll go over shows a different case.</li>
<li>Both LCP and FCP are tightly coupled in scenarios where there’s no Service Worker or when the “standard” Service Worker is used. This is because the content of the page is pretty simple and the CSS is fairly small. The Largest Contentful Paint is usually the opening paragraph on a page.</li>
<li>However, the streaming Service Worker decouples FCP and LCP because the header content partial streams in right away from <code>CacheStorage</code>.</li>
<li>Both FCP and LCP are lower in the streaming Service Worker than in other cases.</li>
</ul><div class="wp-block-image">
<figure id="figure5" class="aligncenter size-large"><img width="960" height="541" src="https://alistapart.com/wp-content/uploads/2021/03/fig-5.png?resize=960%2C541" alt="A bar chart comparing the RUM median FCP and LCP performance of no service worker, a &quot;standard&quot; service worker, and a streaming service worker. Both the &quot;standard&quot; and streaming service worker offer better FCP and LCP performance over no service worker, but the streaming service worker excels at FCP performance, while only being slightly slower at LCP than the &quot;standard&quot; service worker." class="wp-image-7172794" data-recalc-dims="1" /><figcaption><em><strong>Figure 5.</strong> A bar chart of median FCP and LCP RUM performance data across various Service Worker types for the Weekly Timber website.</em></figcaption></figure></div>
<p>The benefits of the streaming Service Worker for real users is pronounced. For FCP, we receive an 79% improvement over no Service Worker at all, and a 63% improvement over the “standard” Service Worker. The benefits for LCP are more subtle. Compared to no Service Worker at all, we realize a 41% improvement in LCP—which is incredible! However, compared to the “standard” Service Worker, LCP is a touch slower.</p>
<p>Because <a href="https://timkadlec.com/remembers/2018-06-07-prioritizing-the-long-tail-of-performance/">the long tail of performance</a> is important, let’s look at the 95th percentile of FCP and LCP performance:</p>
<div class="wp-block-image">
<figure id="figure6" class="aligncenter size-large"><img width="960" height="534" src="https://alistapart.com/wp-content/uploads/2021/03/fig-6.png?resize=960%2C534" alt="A bar chart comparing the RUM median FCP and LCP performance of no service worker, a &quot;standard&quot; service worker, and a streaming service worker. Both the &quot;standard&quot; and streaming service workers are faster than no service worker at all, but the streaming service worker beats out the &quot;standard&quot; service worker for both FCP and LCP." class="wp-image-7172795" data-recalc-dims="1" /><figcaption><em><strong>Figure 6.</strong> A bar chart of 95th percentile FCP and LCP RUM performance data across various Service Worker types for the Weekly Timber website.</em></figcaption></figure></div>
<p>The 95th percentile of RUM data is a great place to assess the slowest experiences. In this case, we see that the streaming Service Worker confers a 40% and 51% improvement in FCP and LCP, respectively, over no Service Worker at all. Compared to the “standard” Service Worker, we see a reduction in FCP and LCP by 19% and 43%, respectively. If these results seem a bit squirrely compared to synthetic metrics, remember: that’s RUM data for you! You never know who’s going to visit your website on which device on what network.</p>
<p>While both FCP and LCP are boosted by the myriad benefits of streaming, navigation preload (in Chrome’s case), and sending less markup by stitching together partials from both CacheStorage and the network, FCP is the clear winner. Perceptually speaking, the benefit is pronounced, as this video would suggest:</p>
<figure id="figure7" class="wp-block-video aligncenter"><figcaption><em><strong>Figure 7.</strong> Two WebPageTest videos of a repeat view of the Weekly Timber homepage. On the left is the page not controlled by a Service Worker, with a primed HTTP cache. On the right is the same page controlled by a streaming Service Worker, with CacheStorage primed.</em></figcaption></figure><p>Now ask yourself this: If this is the kind of improvement we can expect on such a small and simple website, what might we expect on a website with larger header and footer markup payloads?</p>
<h2 id="section9">Caveats and conclusions<a class="subhead-anchor" href="https://alistapart.com#section9">#section9</a></h2>
<p>Are there trade-offs with this on the development side? <em>Oh</em> yeah.</p>
<p><a href="https://philipwalton.com/articles/smaller-html-payloads-with-service-workers/#5)-set-the-correct-title">As Philip Walton has noted</a>, a cached header partial means the document title must be updated in JavaScript on each navigation by changing the value of <a href="https://developer.mozilla.org/en-US/docs/Web/API/Document/title"><code>document.title</code></a>. It also means you’ll need to update the navigation state in JavaScript to reflect the current page if that’s something you do on your website. Note that this shouldn’t cause indexing issues, as Googlebot crawls pages with an unprimed cache.</p>
<p>There may also be some challenges on sites with authentication. For example, if your site’s header displays the current authenticated user on log in, you may have to update the header partial markup provided by <code>CacheStorage</code> in JavaScript on each navigation to reflect who is authenticated. You may be able to do this by storing basic user data in <code>localStorage</code> and updating the UI from there.</p>
<p>There are certainly other challenges, but it’ll be up to you to weigh the user-facing benefits versus the development costs. In my opinion, this approach has broad applicability in applications such as blogs, marketing websites, news websites, ecommerce, and other typical use cases.</p>
<p>All in all, though, it’s akin to the performance improvements and efficiency gains that you’d get from an SPA. Only the difference is that you’re not replacing time-tested navigation mechanisms and grappling with all the messiness that entails, but <em>enhancing</em> them. That’s the part I think is really important to consider in a world where client-side routing is all the rage.</p>
<p>“What about <a href="https://developers.google.com/web/tools/workbox">Workbox</a>?,” you might ask—and you’d be right to. Workbox simplifies a lot when it comes to using the Service Worker API, and you’re not wrong to reach for it. Personally, I prefer to work as close to the metal as I can so I can gain a better understanding of what lies beneath abstractions like Workbox. Even so, Service Worker is hard. Use Workbox if it suits you. As far as frameworks go, its abstraction cost is very low.</p>
<p>Regardless of this approach, I think there’s incredible utility and power in using the Service Worker API to reduce the amount of markup you send. It benefits my client and all the people that use their website. Because of Service Worker and the innovation around its use, my client’s website is faster in the far-flung parts of Wisconsin. That’s something I feel good about.</p>
<p><em>Special thanks to</em> <a href="https://jakearchibald.com/"><em>Jake Archibald</em></a> <em>for his valuable editorial advice, which, to put it mildly, considerably improved the quality of this article.</em></p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">In this excerpt from Volume 2 of RECOGNIZE, Regine Gilbert offers a helpful mnemonic for approaching our design work from a fresh perspective: “WOQE” for watch, observe, question, and explore.</div><div class="entry-content">How to face reality when your team screws up, and get everyone back on track.</div><div class="entry-content">Matt E. Patterson shows why a new WebSockets-driven approach is catching developers' attention, and how it can mean faster, easier development that results in an experience just as rich as client-side SPAs.</div><div class="entry-content">Are your content models excluding people? This piece from Daniel Carter and Carra Martinez will help you recognize how this happens and what we can do about it.</div><div class="entry-content">Successful design requires buy-in from the top. Ben Callahan shows how to convince executives not just to fund the initial push of design system work, but to keep funding it.</div>]]></description>
      <link>https://alistapart.com/article/now-thats-what-i-call-service-worker/</link>
      <guid>https://alistapart.com/article/now-thats-what-i-call-service-worker/</guid>
      <pubDate>Thu, 18 Mar 2021 15:00:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[Now THAT&#8217;S What I Call Service Worker!]]></title>
      <description><![CDATA[<p>The <a href="https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API">Service Worker</a> API is the <a href="https://en.wikipedia.org/wiki/Dremel">Dremel</a> of the web platform. It offers incredibly broad utility while also yielding resiliency and better performance. If you’ve not used Service Worker yet—and you couldn’t be blamed if so, as <a href="https://almanac.httparchive.org/en/2020/pwa#service-workers">it hasn’t seen wide adoption as of 2020</a>—it goes something like this:</p><div class="aside-breaker">Article Continues Below</div>
<ol><li>On the initial visit to a website, the browser <a href="https://developers.google.com/web/fundamentals/primers/service-workers#register_a_service_worker">registers</a> what amounts to a client-side proxy powered by <a href="https://www.weeklytimber.com/sw.js">a comparably paltry amount of JavaScript</a> that—like a Web Worker—runs on its own thread.</li>
<li>After the Service Worker’s registration, you can intercept requests and decide how to respond to them in the <a href="https://developer.mozilla.org/en-US/docs/Web/API/FetchEvent">Service Worker’s <code>fetch()</code> event</a>.</li>
</ol><p>What you decide to do with requests you intercept is a) your call and b) depends on your website. You can <a href="https://alistapart-production.mystagingwebsite.com/article/request-with-intent-caching-strategies-in-the-age-of-pwas/#section8">rewrite requests</a>, <a href="https://web.dev/offline-cookbook/#on-install-as-dependency">precache static assets</a> during install, <a href="https://www.madebymike.com.au/writing/service-workers/#a-better-offline-page-deeper-down-the-rabbit-hole">provide offline functionality</a>, and—as will be our eventual focus—<a href="https://philipwalton.com/articles/smaller-html-payloads-with-service-workers/">deliver smaller HTML payloads and better performance</a> for repeat visitors.</p>
<h2>Getting out of the woods<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/now-thats-what-i-call-service-worker#section2">#section2</a></h2>
<p>Weekly Timber is a client of mine that provides logging services in central Wisconsin. For them, a fast website is vital. Their business is located in <a href="https://en.wikipedia.org/wiki/Waushara_County,_Wisconsin">Waushara County</a>, and like many rural stretches in the United States, <a href="https://maps.psc.wi.gov/apps/WisconsinBroadbandMap/">network quality and reliability isn’t great</a>.</p>
<div class="wp-block-image">
<figure class="aligncenter size-large"><img width="4214" height="2194" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/03/fig-1.png?resize=1024,533" alt="A screenshot of a wireless coverage map for Waushara County, Wisconsin with a color overlay. Most of the overlay is colored tan, which represents areas of the county which have downlink speeds between 3 and 9.99 megabits per second. There are sparse light blue and dark blue areas which indicate faster service, but are far from being the majority of the county." class="wp-image-7172790" /><figcaption><em><strong>Figure 1.</strong> A wireless coverage map of Waushara County, Wisconsin. The tan areas of the map indicate downlink speeds between 3 and 9.99 Mbps. Red areas are even slower, while the pale and dark blue areas are faster.</em></figcaption></figure></div>
<p>Wisconsin has farmland for <em>days</em>, but it also has plenty of forests. When you need a company that cuts logs, Google is probably your first stop. How fast a given logging company’s website is might be enough to get you looking elsewhere if you’re left waiting too long on a crappy network connection.</p>
<p>I initially didn’t believe a Service Worker was necessary for Weekly Timber’s website. After all, if things were plenty fast to start with, why complicate things? On the other hand, knowing that my client services not just Waushara County, but much of central Wisconsin, even a barebones Service Worker could be the kind of progressive enhancement that adds resilience in the places it might be needed most.</p>
<p>The first Service Worker I wrote for my client’s website—which I’ll refer to henceforth as the “standard” Service Worker—used three <a href="https://web.dev/offline-cookbook/">well-documented caching strategies</a>:</p>
<ol><li>Precache CSS and JavaScript assets for all pages when the Service Worker is installed when the window’s load event fires.</li>
<li>Serve static assets out of <a href="https://developer.mozilla.org/en-US/docs/Web/API/CacheStorage"><code>CacheStorage</code></a> if available. If a static asset isn’t in <code>CacheStorage</code>, retrieve it from the network, then cache it for future visits.</li>
<li>For HTML assets, hit the network first and place the HTML response into <code>CacheStorage</code>. If the network is unavailable the next time the visitor arrives, serve the cached markup from <code>CacheStorage</code>.</li>
</ol><p>These are neither new nor special strategies, but they provide two benefits:</p>
<ul><li>Offline capability, which is handy when network conditions are spotty.</li>
<li>A performance boost for loading static assets.</li>
</ul><p>That performance boost translated to a 42% and 48% decrease in the median time to <a href="https://web.dev/fcp/">First Contentful Paint (FCP)</a> and <a href="https://web.dev/lcp/">Largest Contentful Paint (LCP)</a>, respectively. Better yet, these insights are based on <a href="https://en.wikipedia.org/wiki/Real_user_monitoring">Real User Monitoring (RUM)</a>. That means these gains aren’t just theoretical, but a real improvement for real people.</p>
<div class="wp-block-image">
<figure class="aligncenter size-large"><img width="1144" height="336" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/03/fig-2.png?resize=1024,301" alt="A screenshot of request/response timings in Chrome's developer tools. It depicts a service worker on a page serving a static asset from CacheStorage in roughly 23 milliseconds." class="wp-image-7172791" /><figcaption><em><strong>Figure 2.</strong> A breakdown of request/response timings depicted in Chrome’s developer tools. The request is for a static asset from <code>CacheStorage</code>. Because the Service Worker doesn’t need to access the network, it takes about 23 milliseconds to “download” the asset from <code>CacheStorage</code>.</em></figcaption></figure></div>
<p>This performance boost is from bypassing the network entirely for static assets already in <code>CacheStorage</code>—particularly render-blocking stylesheets. A similar benefit is realized when we rely on the HTTP cache, only the FCP and LCP improvements I just described are in comparison to pages with a primed HTTP cache without an installed Service Worker.</p>
<p>If you’re wondering why <a href="https://blog.yoav.ws/tale-of-four-caches/"><code>CacheStorage</code> and the HTTP cache aren’t equal</a>, it’s because the HTTP cache—at least in <a href="https://jakearchibald.com/2016/caching-best-practices/#pattern-2-mutable-content-always-server-revalidated">some cases</a>—may still involve a trip to the server to verify asset freshness. <a href="https://hacks.mozilla.org/2017/01/using-immutable-caching-to-speed-up-the-web/">Cache-Control’s <code>immutable</code> flag gets around this</a>, but <a href="https://caniuse.com/mdn-http_headers_cache-control_immutable"><code>immutable</code> doesn’t have great support</a> yet. A long max-age value works, too, but the combination of Service Worker API and <code>CacheStorage</code> gives you a lot more flexibility.</p>
<p>Details aside, the takeaway is that the simplest and most well-established Service Worker caching practices can improve performance. Potentially more than what well-configured <code>Cache-Control</code> headers can provide. Even so, Service Worker is an incredible technology with far more possibilities. It’s possible to go farther, and I’ll show you how.</p>
<h2>A better, faster Service Worker<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/now-thats-what-i-call-service-worker#section3">#section3</a></h2>
<p>The web <em>loves</em> itself some “innovation,” which is a word we equally love to throw around. To me, true innovation isn’t when we create new frameworks or patterns solely for the benefit of developers, but whether those inventions benefit people who end up using whatever it is we slap up on the web. <a href="https://www.w3.org/TR/html-design-principles/#priority-of-constituencies">The priority of constituencies</a> is a thing we ought to respect. Users above all else, always.</p>
<p>The Service Worker API’s innovation space is considerable. How you work within that space can have a big effect on how the web is experienced. Things like <a href="https://developers.google.com/web/updates/2017/02/navigation-preload">navigation preload</a> and <a href="https://developer.mozilla.org/en-US/docs/Web/API/ReadableStream#examples"><code>ReadableStream</code></a> have taken Service Worker from great to killer. We can do the following with these new capabilities, respectively:</p>
<ul><li>Reduce Service Worker latency by parallelizing Service Worker startup time and <a href="https://fetch.spec.whatwg.org/#navigation-request">navigation requests</a>.</li>
<li>Stream content in from <code>CacheStorage</code> and the network.</li>
</ul><p>Moreover, we’re going to combine these capabilities and pull out one more trick: precache header and footer partials, then combine them with content partials from the network. This not only reduces how much data we download from the network, but it also improves perceptual performance for repeat visits. That’s innovation that helps everyone.</p>
<p>Grizzled, I turn to you and say <em>“let’s do this.”</em></p>
<h3>Laying the groundwork<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/now-thats-what-i-call-service-worker#section4">#section4</a></h3>
<p>If the idea of combining precached header and footer partials with network content on the fly seems like a Single Page Application (SPA), you’re not far off. Like an SPA, you’ll need to apply the “app shell” model to your website. Only instead of a client-side router plowing content into one piece of minimal markup, you have to think of your website as three separate parts:</p>
<ul><li>The header.</li>
<li>The content.</li>
<li>The footer.</li>
</ul><p>For my client’s website, that looks like this:</p>
<div class="wp-block-image">
<figure class="aligncenter size-large"><img width="1344" height="2809" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/03/fig-3.png?resize=490,1024" alt="A screenshot of the Weekly Timber website color coded to delineate each partial that makes up the page. The header is color coded as blue, the footer as red, and the main content in between as yellow." class="wp-image-7172792" /><figcaption><em><strong>Figure 3.</strong> A color coding of the Weekly Timber website’s different partials. The Footer and Header partials are stored in <code>CacheStorage</code>, while the Content partial is retrieved from the network unless the user is offline.</em></figcaption></figure></div>
<p>The thing to remember here is that the individual partials don’t have to be valid markup in the sense that all tags need to be closed within each partial. The only thing that counts in the final sense is that the combination of these partials must be valid markup.</p>
<p>To start, you’ll need to precache separate header and footer partials when the Service Worker is installed. For my client’s website, these partials are served from the <code>/partial-header</code> and <code>/partial-footer</code> pathnames:</p>
<pre>self.addEventListener("install", event =&gt; {
  const cacheName = "fancy_cache_name_here";
  const precachedAssets = [
    "/partial-header",  // The header partial
    "/partial-footer",  // The footer partial
    // Other assets worth precaching
  ];
  event.waitUntil(caches.open(cacheName).then(cache =&gt; {
    return cache.addAll(precachedAssets);
  }).then(() =&gt; {
    return self.skipWaiting();
  }));
});</pre>
<p>Every page must be fetchable as a content partial minus the header and footer, as well as a full page with the header and footer. This is key because the initial visit to a page won’t be controlled by a Service Worker. Once the Service Worker takes over, then you serve content partials and assemble them into complete responses with the header and footer partials from <code>CacheStorage</code>.</p>
<p>If your site is static, this means generating a whole other mess of markup partials that you can rewrite requests to in the Service Worker’s <code>fetch()</code> event. If your website has a back end—as is the case with my client—you can use an HTTP request header to instruct the server to deliver full pages or content partials.</p>
<p>The hard part is putting all the pieces together—but we’ll do just that.</p>
<h3>Putting it all together<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/now-thats-what-i-call-service-worker#section5">#section5</a></h3>
<p>Writing even a basic Service Worker can be challenging, but things get real complicated real fast when assembling multiple responses into one. One reason for this is that in order to avoid the Service Worker startup penalty, we’ll need to set up navigation preload.</p>
<h4>Implementing navigation preload<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/now-thats-what-i-call-service-worker#section6">#section6</a></h4>
<p>Navigation preload addresses the problem of Service Worker startup time, which delays navigation requests to the network. The last thing you want to do with a Service Worker is hold up the show.</p>
<p>Navigation preload must be explicitly enabled. Once enabled, the Service Worker won’t hold up navigation requests during startup. Navigation preload is enabled in the Service Worker’s <code>activate</code> event:</p>
<pre>self.addEventListener("activate", event =&gt; {
  const cacheName = "fancy_cache_name_here";
  const preloadAvailable = "navigationPreload" in self.registration;
  event.waitUntil(caches.keys().then(keys =&gt; {
    return Promise.all([
      keys.filter(key =&gt; {
        return key !== cacheName;
      }).map(key =&gt; {
        return caches.delete(key);
      }),
      self.clients.claim(),
      preloadAvailable ? self.registration.navigationPreload.enable() : true
    ]);
  }));
});</pre>
<p><a href="https://caniuse.com/mdn-api_navigationpreloadmanager">Because navigation preload isn’t supported everywhere</a>, we have to do the usual feature check, which we store in the above example in the <code>preloadAvailable</code> variable.</p>
<p>Additionally, we need to use <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/all"><code>Promise.all()</code></a> to resolve multiple asynchronous operations before the Service Worker activates. This includes pruning those old caches, as well as waiting for both <a href="https://developer.mozilla.org/en-US/docs/Web/API/Clients/claim"><code>clients.claim()</code></a> (which tells the Service Worker to assert control immediately rather than waiting until the next navigation) and navigation preload to be enabled.</p>
<p>A ternary operator is used to enable navigation preload in supporting browsers and avoid throwing errors in browsers that don’t. If <code>preloadAvailable</code> is <code>true</code>, we enable navigation preload. If it isn’t, we pass a Boolean that won’t affect how <code>Promise.all()</code> resolves.</p>
<p>With navigation preload enabled, we need to write code in our Service Worker’s <code>fetch()</code> event handler to make use of the preloaded response:</p>
<pre>self.addEventListener("fetch", event =&gt; {
  const { request } = event;
  // Static asset handling code omitted for brevity
  // ...
  // Check if this is a request for a document
  if (request.mode === "navigate") {
    const networkContent = Promise.resolve(event.preloadResponse).then(response =&gt; {
      if (response) {
        addResponseToCache(request, response.clone());
        return response;
      }
      return fetch(request.url, {
        headers: {
          "X-Content-Mode": "partial"
        }
      }).then(response =&gt; {
        addResponseToCache(request, response.clone());
        return response;
      });
    }).catch(() =&gt; {
      return caches.match(request.url);
    });
    // More to come...
  }
});</pre>
<p>Though this isn’t the entirety of the Service Worker’s <code>fetch()</code> event code, there’s a lot that needs explaining:</p>
<ol><li>The preloaded response is available in <code>event.preloadResponse</code>. However, <a href="https://developers.google.com/web/updates/2017/02/navigation-preload">as Jake Archibald notes</a>, the value of <code>event.preloadResponse</code> will be <code>undefined</code> in browsers that don’t support navigation preload. Therefore, we must pass <code>event.preloadResponse</code> to <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/resolve"><code>Promise.resolve()</code></a> to avoid compatibility issues.</li>
<li>We adapt in the resulting <code>then</code> callback. If event.<code>preloadResponse</code> is supported, we use the preloaded response and add it to <code>CacheStorage</code> via an <code>addResponseToCache()</code> helper function. If not, we send a <code>fetch()</code> request to the network to get the content partial using a custom <code>X-Content-Mode</code> header with a value of <code>partial</code>.</li>
<li>Should the network be unavailable, we fall back to the most recently accessed content partial in <code>CacheStorage</code>.</li>
<li>The response—regardless of where it was procured from—is then returned to a variable named <code>networkContent</code> that we use later.</li>
</ol><p>How the content partial is retrieved is tricky. With navigation preload enabled, a special <code>Service-Worker-Navigation-Preload</code> header with a value of <code>true</code> is added to navigation requests. We then work with that header on the back end to ensure the response is a content partial rather than the full page markup.</p>
<p>However, because navigation preload isn’t available in all browsers, we send a different header in those scenarios. In Weekly Timber’s case, we fall back to a custom <code>X-Content-Mode</code> header. In my client’s PHP back end, I’ve created some handy constants:</p>
<pre>&lt;?php
// Is this a navigation preload request?
define("NAVIGATION_PRELOAD", isset($_SERVER["HTTP_SERVICE_WORKER_NAVIGATION_PRELOAD"]) &amp;&amp; stristr($_SERVER["HTTP_SERVICE_WORKER_NAVIGATION_PRELOAD"], "true") !== false);
// Is this an explicit request for a content partial?
define("PARTIAL_MODE", isset($_SERVER["HTTP_X_CONTENT_MODE"]) &amp;&amp; stristr($_SERVER["HTTP_X_CONTENT_MODE"], "partial") !== false);
// If either is true, this is a request for a content partial
define("USE_PARTIAL", NAVIGATION_PRELOAD === true || PARTIAL_MODE === true);
?&gt;</pre>
<p>From there, the <code>USE_PARTIAL</code> constant is used to adapt the response:</p>
<pre>&lt;?php
if (USE_PARTIAL === false) {
  require_once("partial-header.php");
}
require_once("includes/home.php");
if (USE_PARTIAL === false) {
  require_once("partial-footer.php");
}
?&gt;</pre>
<p>The thing to be hip to here is that you should specify <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Vary">a <code>Vary</code> header</a> for HTML responses to take the <code>Service-Worker-Navigation-Preload</code> (and in this case, the <code>X-Content-Mode</code> header) into account for HTTP caching purposes—assuming you’re caching HTML at all, which may not be the case for you.</p>
<p>With our handling of navigation preloads complete, we can then move onto the work of streaming content partials from the network and stitching them together with the header and footer partials from <code>CacheStorage</code> into a single response that the Service Worker will provide.</p>
<h4>Streaming partial content and stitching together responses<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/now-thats-what-i-call-service-worker#section7">#section7</a></h4>
<p>While the header and footer partials will be available almost instantaneously because they’ve been in <code>CacheStorage</code> since the Service Worker’s installation, it’s the content partial we retrieve from the network that will be the bottleneck. It’s therefore vital that we <a href="https://developers.google.com/web/updates/2016/06/sw-readablestreams">stream responses</a> so we can start pushing markup to the browser as quickly as possible. <code>ReadableStream</code> can do this for us.</p>
<p>This <code>ReadableStream</code> business is a mind-bender. Anyone who tells you it’s “easy” is whispering sweet nothings to you. It’s <em>hard</em>. After I wrote my own function to merge streamed responses and messed up a critical step—which ended up not improving page performance, mind you—I modified <a href="https://gist.github.com/jakearchibald/d0b7e65496a8ec362f10739c3e28da6e">Jake Archibald’s <code>mergeResponses()</code> function</a> to suit my needs:</p>
<pre>async function mergeResponses (responsePromises) {
  const readers = responsePromises.map(responsePromise =&gt; {
    return Promise.resolve(responsePromise).then(response =&gt; {
      return response.body.getReader();
    });
  });
  let doneResolve,
      doneReject;
  const done = new Promise((resolve, reject) =&gt; {
    doneResolve = resolve;
    doneReject = reject;
  });
  const readable = new ReadableStream({
    async pull (controller) {
      const reader = await readers[0];
      try {
        const { done, value } = await reader.read();
        if (done) {
          readers.shift();
          if (!readers[0]) {
            controller.close();
            doneResolve();
            return;
          }
          return this.pull(controller);
        }
        controller.enqueue(value);
      } catch (err) {
        doneReject(err);
        throw err;
      }
    },
    cancel () {
      doneResolve();
    }
  });
  const headers = new Headers();
  headers.append("Content-Type", "text/html");
  return {
    done,
    response: new Response(readable, {
      headers
    })
  };
}</pre>
<p>As usual, there’s a lot going on:</p>
<ol><li><code>mergeResponses()</code> accepts an argument named <code>responsePromises</code>, which is an array of <a href="https://developer.mozilla.org/en-US/docs/Web/API/Response"><code>Response</code></a> objects returned from either a navigation preload, <code>fetch()</code>, or <a href="https://developer.mozilla.org/en-US/docs/Web/API/CacheStorage/match"><code>caches.match()</code></a>. Assuming the network is available, this will always contain three responses: two from <code>caches.match()</code> and (hopefully) one from the network.</li>
<li>Before we can stream the responses in the <code>responsePromises</code> array, we must map <code>responsePromises</code> to an array containing one reader for each response. Each reader is used later in a <code>ReadableStream()</code> constructor to stream each response’s contents.</li>
<li>A promise named <code>done</code> is created. In it, we assign the promise’s <code>resolve()</code> and <code>reject()</code> functions to the external variables <code>doneResolve</code> and <code>doneReject</code>, respectively. These will be used in the <code>ReadableStream()</code> to signal whether the stream is finished or has hit a snag.</li>
<li>The new <code>ReadableStream()</code> instance is created with a name of <code>readable</code>. As responses stream in from <code>CacheStorage</code> and the network, their contents will be appended to <code>readable</code>.</li>
<li>The stream’s <code>pull()</code> method streams the contents of the first response in the array. If the stream isn’t canceled somehow, the reader for each response is discarded by calling the readers array’s <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/shift"><code>shift()</code> method</a> when the response is fully streamed. This repeats until there are no more readers to process.</li>
<li>When all is done, the merged stream of responses is returned as a single response, and we return it with a <code>Content-Type</code> header value of <code>text/html</code>.</li>
</ol><p>This is <a href="https://gist.github.com/jakearchibald/32b2155708a665e9c8e06642b7c09d86">much simpler</a> if you use <a href="https://developer.mozilla.org/en-US/docs/Web/API/TransformStream"><code>TransformStream</code></a>, but depending on when you read this, that may not be an option for every browser. For now, we’ll have to stick with this approach.</p>
<p>Now let’s revisit the Service Worker’s <code>fetch()</code> event from earlier, and apply the <code>mergeResponses()</code> function:</p>
<pre>self.addEventListener("fetch", event =&gt; {
  const { request } = event;
  // Static asset handling code omitted for brevity
  // ...
  // Check if this is a request for a document
  if (request.mode === "navigate") {
    // Navigation preload/fetch() fallback code omitted.
    // ...
    const { done, response } = await mergeResponses([
      caches.match("/partial-header"),
      networkContent,
      caches.match("/partial-footer")
    ]);
    event.waitUntil(done);
    event.respondWith(response);
  }
});</pre>
<p>At the end of the <code>fetch()</code> event handler, we pass the header and footer partials from <code>CacheStorage</code> to the <code>mergeResponses()</code> function, and pass the result to the <code>fetch()</code> event’s <a href="https://developer.mozilla.org/en-us/docs/Web/API/FetchEvent/respondWith"><code>respondWith()</code> method</a>, which serves the merged response on behalf of the Service Worker.</p>
<h2>Are the results worth the hassle?<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/now-thats-what-i-call-service-worker#section8">#section8</a></h2>
<p>This is a lot of stuff to do, and it’s complicated! You might mess something up, or maybe your website’s architecture isn’t well-suited to this exact approach. So it’s important to ask: are the performance benefits worth the work? In my view? Yes! The synthetic performance gains aren’t bad at all:</p>
<div class="wp-block-image">
<figure class="aligncenter size-large"><img width="3987" height="2200" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/03/fig-4.png?resize=1024,565" alt="A bar graph comparing First Contentful Paint and Largest Contentful Paint performance for the Weekly Timber website for scenarios in which there is no service worker, a &quot;standard&quot; service worker, and a streaming service worker that stitches together content partials from CacheStorage and the network. The first two scenarios are basically the same, while the streaming service worker delivers measurably better performance for both FCP and LCP—especially for FCP!" class="wp-image-7172793" /><figcaption><em><strong>Figure 4.</strong> A bar chart of median FCP and LCP synthetic performance data across various Service Worker types for the Weekly Timber website.</em></figcaption></figure></div>
<p>Synthetic tests don’t measure performance for anything except the specific device and internet connection they’re performed on. Even so, these tests were conducted on a staging version of my client’s website with a low-end <a href="https://www.gsmarena.com/nokia_2-8513.php">Nokia 2 Android phone</a> on a throttled “Fast 3G” connection in Chrome’s developer tools. Each category was tested ten times on the homepage. The takeaways here are:</p>
<ul><li>No Service Worker at all is slightly faster than the “standard” Service Worker with simpler caching patterns than the streaming variant. Like, ever so slightly faster. This may be due to the delay introduced by Service Worker startup, however, the RUM data I’ll go over shows a different case.</li>
<li>Both LCP and FCP are tightly coupled in scenarios where there’s no Service Worker or when the “standard” Service Worker is used. This is because the content of the page is pretty simple and the CSS is fairly small. The Largest Contentful Paint is usually the opening paragraph on a page.</li>
<li>However, the streaming Service Worker decouples FCP and LCP because the header content partial streams in right away from <code>CacheStorage</code>.</li>
<li>Both FCP and LCP are lower in the streaming Service Worker than in other cases.</li>
</ul><div class="wp-block-image">
<figure class="aligncenter size-large"><img width="4001" height="2255" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/03/fig-5.png?resize=1024,577" alt="A bar chart comparing the RUM median FCP and LCP performance of no service worker, a &quot;standard&quot; service worker, and a streaming service worker. Both the &quot;standard&quot; and streaming service worker offer better FCP and LCP performance over no service worker, but the streaming service worker excels at FCP performance, while only being slightly slower at LCP than the &quot;standard&quot; service worker." class="wp-image-7172794" /><figcaption><em><strong>Figure 5.</strong> A bar chart of median FCP and LCP RUM performance data across various Service Worker types for the Weekly Timber website.</em></figcaption></figure></div>
<p>The benefits of the streaming Service Worker for real users is pronounced. For FCP, we receive an 79% improvement over no Service Worker at all, and a 63% improvement over the “standard” Service Worker. The benefits for LCP are more subtle. Compared to no Service Worker at all, we realize a 41% improvement in LCP—which is incredible! However, compared to the “standard” Service Worker, LCP is a touch slower.</p>
<p>Because <a href="https://timkadlec.com/remembers/2018-06-07-prioritizing-the-long-tail-of-performance/">the long tail of performance</a> is important, let’s look at the 95th percentile of FCP and LCP performance:</p>
<div class="wp-block-image">
<figure class="aligncenter size-large"><img width="3982" height="2213" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/03/fig-6.png?resize=1024,569" alt="A bar chart comparing the RUM median FCP and LCP performance of no service worker, a &quot;standard&quot; service worker, and a streaming service worker. Both the &quot;standard&quot; and streaming service workers are faster than no service worker at all, but the streaming service worker beats out the &quot;standard&quot; service worker for both FCP and LCP." class="wp-image-7172795" /><figcaption><em><strong>Figure 6.</strong> A bar chart of 95th percentile FCP and LCP RUM performance data across various Service Worker types for the Weekly Timber website.</em></figcaption></figure></div>
<p>The 95th percentile of RUM data is a great place to assess the slowest experiences. In this case, we see that the streaming Service Worker confers a 40% and 51% improvement in FCP and LCP, respectively, over no Service Worker at all. Compared to the “standard” Service Worker, we see a reduction in FCP and LCP by 19% and 43%, respectively. If these results seem a bit squirrely compared to synthetic metrics, remember: that’s RUM data for you! You never know who’s going to visit your website on which device on what network.</p>
<p>While both FCP and LCP are boosted by the myriad benefits of streaming, navigation preload (in Chrome’s case), and sending less markup by stitching together partials from both <code>CacheStorage</code> and the network, FCP is the clear winner. Perceptually speaking, the benefit is pronounced, as this video would suggest:</p>
<figure class="wp-block-video aligncenter"><figcaption><em><strong>Figure 7.</strong> Three WebPageTest videos of a repeat view of the Weekly Timber homepage. On the left is the page not controlled by a Service Worker, with a primed HTTP cache. On the right is the same page controlled by a streaming Service Worker, with CacheStorage primed.</em></figcaption></figure><p>Now ask yourself this: If this is the kind of improvement we can expect on such a small and simple website, what might we expect on a website with larger header and footer markup payloads?</p>
<h2>Caveats and conclusions<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/now-thats-what-i-call-service-worker#section9">#section9</a></h2>
<p>Are there trade-offs with this on the development side? <em>Oh</em> yeah.</p>
<p><a href="https://philipwalton.com/articles/smaller-html-payloads-with-service-workers/#5)-set-the-correct-title">As Philip Walton has noted</a>, a cached header partial means the document title must be updated in JavaScript on each navigation by changing the value of <a href="https://developer.mozilla.org/en-US/docs/Web/API/Document/title"><code>document.title</code></a>. It also means you’ll need to update the navigation state in JavaScript to reflect the current page if that’s something you do on your website. Note that this shouldn’t cause indexing issues, as Googlebot crawls pages with an unprimed cache.</p>
<p>There may also be some challenges on sites with authentication. For example, if your site’s header displays the current authenticated user on log in, you may have to update the header partial markup provided by <code>CacheStorage</code> in JavaScript on each navigation to reflect who is authenticated. You may be able to do this by storing basic user data in <code>localStorage</code> and updating the UI from there.</p>
<p>There are certainly other challenges, but it’ll be up to you to weigh the user-facing benefits versus the development costs. In my opinion, this approach has broad applicability in applications such as blogs, marketing websites, news websites, ecommerce, and other typical use cases.</p>
<p>All in all, though, it’s akin to the performance improvements and efficiency gains that you’d get from an SPA. Only the difference is that you’re not replacing time-tested navigation mechanisms and grappling with all the messiness that entails, but <em>enhancing</em> them. That’s the part I think is really important to consider in a world where client-side routing is all the rage.</p>
<p>“What about <a href="https://developers.google.com/web/tools/workbox">Workbox</a>?,” you might ask—and you’d be right to. Workbox simplifies a lot when it comes to using the Service Worker API, and you’re not wrong to reach for it. Personally, I prefer to work as close to the metal as I can so I can gain a better understanding of what lies beneath abstractions like Workbox. Even so, Service Worker is hard. Use Workbox if it suits you. As far as frameworks go, its abstraction cost is very low.</p>
<p>Regardless of this approach, I think there’s incredible utility and power in using the Service Worker API to reduce the amount of markup you send. It benefits my client and all the people that use their website. Because of Service Worker and the innovation around its use, my client’s website is faster in the far-flung parts of Wisconsin. That’s something I feel good about.</p>
<p><em>Special thanks to</em> <a href="https://jakearchibald.com/"><em>Jake Archibald</em></a> <em>for his valuable editorial advice, which, to put it mildly, considerably improved the quality of this article.</em></p>]]></description>
      <link>https://alistapart-production.mystagingwebsite.com/article/now-thats-what-i-call-service-worker/</link>
      <guid>https://alistapart-production.mystagingwebsite.com/article/now-thats-what-i-call-service-worker/</guid>
      <pubDate>Thu, 18 Mar 2021 15:00:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[Keeping Your Design Mind New and Fresh]]></title>
      <description><![CDATA[<div class="entry-content">
<blockquote class="wp-block-quote">
<p><em>“Only a fool knows everything.”</em></p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<div><cite>— <em>African Proverb</em></cite></div></blockquote>
<p>Since March 2020, most of us have been working from home, and the days blend into each other and look the same. This is not the first time I have experienced this type of feeling. </p>
<p>My commute — New York to New Jersey — is what folks in my area call the reverse commute.While going to the office, my days began to look the same: riding the subway to a bus to a shuttle to get to my job. Have you ever arrived at a destination and not even realized how you got there? This is how I began to experience the world everyday. I stopped paying attention to my surroundings.</p>
<p>Because I worked a lot, the only time I would take off was for the holidays. During this time, I was a consultant and was coming to the end of an existing contract. For six years straight, I did this, until I decided to take six weeks off work to travel to Europe and visit places I had not seen before.</p>
<p>A family friend let me stay with her in Munich, Germany; I did not speak German, and so began my adventure. I was in a new place, where I did not know anyone, and I got lost every single day. My eyes were opened to the fact that every day is an opportunity. It just took me going on a trip and traveling halfway around the world to realize it. There are new things to experience each and every day.</p>
<p>When I returned to the U.S. and went back to work, I made a conscious decision to make each day different. Sometimes I would walk a new route. Some days I would take another train. Each change meant I saw something new: new clothing, new buildings, and new faces. It really impacted the way I viewed myself in the world.</p>
<p>But what do you do when you cannot travel? Seeing a situation with new eyes takes practice, and you can still create the opportunity to see something by not taking your surroundings for granted.</p>
<p>How do we do this? For me, I adopted a new philosophy of being WOQE: watching, observing, questioning, and exploring.</p>
<figure id="figure1" class="wp-block-image size-large"><img width="960" height="960" src="https://alistapart.com/wp-content/uploads/2021/03/woqe.jpg?resize=960%2C960" alt="Two people sit on a bench, one in a suit with arms crossed and the other wearing a backpack while looking through a camera. The letters WOQE surround them." class="wp-image-7172776" data-recalc-dims="1" /></figure><h2 id="section2">Watching<a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>Let go of assumptions to open up your mind. This takes looking at yourself and understanding your beliefs.</p>
<p>When I am looking to design something, I always have to tell myself that I am not the user. I don’t know where they come from, and I don’t know their reason for making the decisions they do. I begin the work to understand where they are coming from. It all starts with why.</p>
<h2 id="section3">Observing<a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h2>
<p>View the situation from different angles. Architects think about the details of a building and look at different viewpoints and perspectives (i.e., outside the building, different sides of the building, etc.)</p>
<p>How can you apply this approach to your designs? Here’s an example. I sketched something once as part of an augmented reality experience. Using my mobile device, I was able to walk around the sketch and see it from all sides, including the top and bottom. As a UX Designer, I have had to view items from both a user’s perspective and the business’ perspective. If I am giving a talk at a conference, I look at the talk from an audience perspective and my own.</p>
<h2 id="section4">Questioning<a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h2>
<p>Use the “5 Why Technique” to get to the root of the problem. This involves asking “why” 5 times.</p>
<p>You know how kids keep asking “why” when you answer a question from them? This approach is how you can get to the root of problems. For example, a friend of mine who is blind expressed interest in playing a popular augmented reality game. This intrigued me and I used a whiteboard as I worked through the 5 Whys with my friend. Here is the process we took:</p>
<blockquote class="wp-block-quote">
<p><em>“Why can’t someone who is blind play Pokémon Go?” I asked.</em></p>
<p><em>“Because the game is visual and requires someone to see what is on the screen.”</em></p>
<p><em>“Why is the game only a visual perspective?”</em></p>
<p><em>“Because this is the way it was designed.”</em></p>
<p><em>“Why was it designed this way?”</em></p>
<p><em>“Because frequently designers are creating for themselves and may not think about who they might be excluding.”</em></p>
<p><em>“Why are designers excluding people?”</em></p>
<p><em>“Because they were never taught to include them.”</em></p>
<p><em>“Why were they never taught?”</em></p>
<p><em>“Design programs often do not include an inclusive and accessible curriculum.”</em></p>
</blockquote>
<p>This may not be a scientific way of approaching a problem, but it is a starting point. My friend could not play this augmented reality game because designers were not taught to make this game for someone who is blind. After this exercise, I was able to work with a group of students who worked with my friend to create an augmented reality concept and ultimately a game using audio and haptic feedback.</p>
<p>It all started with why.</p>
<h2 id="section5">Exploring<a class="subhead-anchor" href="https://alistapart.com#section5">#section5</a></h2>
<p>Collaborate with others to learn from others and teach others what you know. Let your friends and colleagues know what you are working on, and perhaps talk it through with them.</p>
<p>When I was a freelance designer, I worked on my own and found it challenging when I would get stuck on a design. I searched online and found a group of designers who would come and share their work with each other for feedback. Through this group, I was able to get some insightful comments on my designs and explain some of my decisions. I began to collaborate with the folks in the group and found it very helpful. When talking to clients, this made me feel more confident explaining my designs because I had already been through the process with my online group.</p>
<p>With all of our days blending into each other in this pandemic, we as designers have an unprecedented opportunity to really shake things up. Furthermore, we are problem solvers. As you move forward with your design practice, consider being WOQE to design with a fresh mind.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">How to face reality when your team screws up, and get everyone back on track.</div><div class="entry-content">Matt E. Patterson shows why a new WebSockets-driven approach is catching developers' attention, and how it can mean faster, easier development that results in an experience just as rich as client-side SPAs.</div><div class="entry-content">Are your content models excluding people? This piece from Daniel Carter and Carra Martinez will help you recognize how this happens and what we can do about it.</div><div class="entry-content">Successful design requires buy-in from the top. Ben Callahan shows how to convince executives not just to fund the initial push of design system work, but to keep funding it.</div><div class="entry-content">How to be human, build trust, and sustain relationships with our design and development clients and partners.</div>]]></description>
      <link>https://alistapart.com/article/keeping-a-fresh-design-mind/</link>
      <guid>https://alistapart.com/article/keeping-a-fresh-design-mind/</guid>
      <pubDate>Thu, 11 Mar 2021 16:00:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[Keeping Your Design Mind New and Fresh]]></title>
      <description><![CDATA[<blockquote class="wp-block-quote">
<p><em>“Only a fool knows everything.”</em></p>
<div class="aside-breaker">Article Continues Below</div>
<div><cite>— <em>African Proverb</em></cite></div></blockquote><p>Since March 2020, most of us have been working from home, and the days blend into each other and look the same. This is not the first time I have experienced this type of feeling. </p>
<p>My commute — New York to New Jersey — is what folks in my area call the reverse commute.While going to the office, my days began to look the same: riding the subway to a bus to a shuttle to get to my job. Have you ever arrived at a destination and not even realized how you got there? This is how I began to experience the world everyday. I stopped paying attention to my surroundings.</p>
<p>Because I worked a lot, the only time I would take off was for the holidays. During this time, I was a consultant and was coming to the end of an existing contract. For six years straight, I did this, until I decided to take six weeks off work to travel to Europe and visit places I had not seen before.</p>
<p>A family friend let me stay with her in Munich, Germany; I did not speak German, and so began my adventure. I was in a new place, where I did not know anyone, and I got lost every single day. My eyes were opened to the fact that every day is an opportunity. It just took me going on a trip and traveling halfway around the world to realize it. There are new things to experience each and every day.</p>
<p>When I returned to the U.S. and went back to work, I made a conscious decision to make each day different. Sometimes I would walk a new route. Some days I would take another train. Each change meant I saw something new: new clothing, new buildings, and new faces. It really impacted the way I viewed myself in the world.</p>
<p>But what do you do when you cannot travel? Seeing a situation with new eyes takes practice, and you can still create the opportunity to see something by not taking your surroundings for granted.</p>
<p>How do we do this? For me, I adopted a new philosophy of being WOQE: watching, observing, questioning, and exploring.</p>
<figure class="wp-block-image size-large"><img width="1280" height="1280" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/03/woqe.jpg?resize=1024,1024" alt="Two people sit on a bench, one in a suit with arms crossed and the other wearing a backpack while looking through a camera. The letters WOQE surround them." class="wp-image-7172776" /></figure>
<p>Let go of assumptions to open up your mind. This takes looking at yourself and understanding your beliefs.</p>
<p>When I am looking to design something, I always have to tell myself that I am not the user. I don’t know where they come from, and I don’t know their reason for making the decisions they do. I begin the work to understand where they are coming from. It all starts with why.</p>
<p>View the situation from different angles. Architects think about the details of a building and look at different viewpoints and perspectives (i.e., outside the building, different sides of the building, etc.)</p>
<p>How can you apply this approach to your designs? Here’s an example. I sketched something once as part of an augmented reality experience. Using my mobile device, I was able to walk around the sketch and see it from all sides, including the top and bottom. As a UX Designer, I have had to view items from both a user’s perspective and the business’ perspective. If I am giving a talk at a conference, I look at the talk from an audience perspective and my own.</p>
<p>Use the “5 Why Technique” to get to the root of the problem. This involves asking “why” 5 times.</p>
<p>You know how kids keep asking “why” when you answer a question from them? This approach is how you can get to the root of problems. For example, a friend of mine who is blind expressed interest in playing a popular augmented reality game. This intrigued me and I used a whiteboard as I worked through the 5 Whys with my friend. Here is the process we took:</p>
<blockquote class="wp-block-quote">
<p><em>“Why can’t someone who is blind play Pokémon Go?” I asked.</em></p>
<p><em>“Because the game is visual and requires someone to see what is on the screen.”</em></p>
<p><em>“Why is the game only a visual perspective?”</em></p>
<p><em>“Because this is the way it was designed.”</em></p>
<p><em>“Why was it designed this way?”</em></p>
<p><em>“Because frequently designers are creating for themselves and may not think about who they might be excluding.”</em></p>
<p><em>“Why are designers excluding people?”</em></p>
<p><em>“Because they were never taught to include them.”</em></p>
<p><em>“Why were they never taught?”</em></p>
<p><em>“Design programs often do not include an inclusive and accessible curriculum.”</em></p>
</blockquote>
<p>This may not be a scientific way of approaching a problem, but it is a starting point. My friend could not play this augmented reality game because designers were not taught to make this game for someone who is blind. After this exercise, I was able to work with a group of students who worked with my friend to create an augmented reality concept and ultimately a game using audio and haptic feedback.</p>
<p>It all started with why.</p>
<p>Collaborate with others to learn from others and teach others what you know. Let your friends and colleagues know what you are working on, and perhaps talk it through with them.</p>
<p>When I was a freelance designer, I worked on my own and found it challenging when I would get stuck on a design. I searched online and found a group of designers who would come and share their work with each other for feedback. Through this group, I was able to get some insightful comments on my designs and explain some of my decisions. I began to collaborate with the folks in the group and found it very helpful. When talking to clients, this made me feel more confident explaining my designs because I had already been through the process with my online group.</p>
<p>With all of our days blending into each other in this pandemic, we as designers have an unprecedented opportunity to really shake things up. Furthermore, we are problem solvers. As you move forward with your design practice, consider being WOQE to design with a fresh mind.</p>]]></description>
      <link>https://alistapart-production.mystagingwebsite.com/article/keeping-a-fresh-design-mind/</link>
      <guid>https://alistapart-production.mystagingwebsite.com/article/keeping-a-fresh-design-mind/</guid>
      <pubDate>Thu, 11 Mar 2021 16:00:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[How to Get a Dysfunctional Team Back on Track]]></title>
      <description><![CDATA[<div class="entry-content">
<p>Maybe you’ve been part of a team that you’ve seen slowly slide into a rut. You didn’t notice it happen, but you’re now not shipping anything, no one’s talking to each other, and the management’s Eye of Sauron has cast its gaze upon you.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>Maybe you’ve just joined a team that’s in the doldrums.</p>
<p>Maybe the people who used to oil the wheels that kept everyone together have moved on and you’re having to face facts—you all hate each other.</p>
<p>However you’ve ended up in this situation, the fact is that you’re now here and it’s up to someone to do something about it. And that person might be you.</p>
<h2 id="section2"><strong>You’re not alone</strong><a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>The first thing to understand is that you’re not the only person to ever encounter problems. Things like this happen all the time at work, but there are simple steps you can take and habits you can form to ease the situation and even dig yourself (and your team) out of the hole. I’ll share some techniques that have helped me, and maybe they can work for you, too.</p>
<p>So let me tell you a story about a hot mess I found myself in and how we turned it around. Names and details have been changed to protect the innocent.</p>
<h2 id="section3"><strong>It always starts out great</strong><a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h2>
<p>An engineer called Jen was working with me on a new feature on our product that lets people create new meal recipes themselves. I was the Project Manager. We were working in six-week cycles.</p>
<p>She had to rely on an API that was managed by Tom (who was in another team) to allow her to get and set the new recipe information on a central database. Before we kicked off, everyone knew the overall objective and everyone was all smiles and ready to go.</p>
<p>The system architecture was a legacy mishmash of different parts of local databases and API endpoints. And, no prizes for guessing what’s coming next, the API documentation was like Swiss cheese.</p>
<p>Two weeks into a six-week cycle, Jen hit Tom up with a list of her dream API calls that she wanted to use to build her feature. She asked him to confirm or deny they would work—or even if they existed at all—because once she started digging into the docs, it wasn’t clear to her if the API could support her plans.</p>
<p>However, Tom had form for sticking his head in the sand and not responding to requests he didn’t like. Tom went to ground and didn’t respond. Tom’s manager, Frankie, was stretched too thin, and hence wasn’t paying attention to this until I was persistently asking about it, in increasingly fraught tones.</p>
<p>In the meantime, Jen tried to do as much as she could. Every day she built a bit more based on her as-yet unapproved design, hoping it would all work out.</p>
<p>With two weeks left to go, Tom eventually responded with a short answer—which boiled down to “The API doesn’t support these calls and I don’t see why I should build something that does. Why don’t you get the data from the other part of the system? And by the way, if I’m forced to do this, it will take at least six weeks.”</p>
<p>And as we know, six weeks into two weeks doesn’t go. Problem.</p>
<p>How did we sort it?</p>
<h2 id="section4"><strong>Step 1 — Accept</strong><a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h2>
<p>When things go south, what do you do?</p>
<p>Accept it.</p>
<p>Acknowledge whatever has happened to get you into this predicament. Take some notes about it to use in team appraisals and retrospectives. Take a long hard look at yourself, too.</p>
<p>Write a concise, impersonal summary of where you are. Try not to write it from your point of view. Imagine that you’re in your boss’ seat and just give them the facts as they are. Don’t dress things up to make them sound better. Don’t over-exaggerate the bad. Leave the emotions to the side.</p>
<p>When you can see your situation clearly, you’ll make better decisions.</p>
<p>Now, pointing out the importance of taking some time to cool down and gather your thoughts seems obvious, but it’s based on the study of some of the most basic circuitry in our brains. Daniel Goleman’s 1995 book, <em>Emotional Intelligence: Why It Can Matter More Than IQ</em>, introduces the concept of <em>emotional hijacking</em>; the idea that the part of our brain that deals with emotion—the limbic system—can biologically interrupt rational thinking when it is overstimulated. For instance, experiments show that <a href="https://citeseerx.ist.psu.edu/viewdoc/download?doi=10.1.1.220.4820&amp;rep=rep1&amp;type=pdf">the angrier men get, the poorer are the decisions they make</a> at the casino. And another study found that people in a negative emotional state are <a href="https://www.ncbi.nlm.nih.gov/pmc/articles/PMC4050437/">more likely to deviate from logical norms</a>. To put it another way, if you’re pissed off, you can’t think straight.</p>
<p>So when you are facing up to the facts, avoid the temptation to keep it off-the-record and only discuss it on the telephone or in person with your colleagues. There’s nothing to be scared of by writing it down. If it turns out that you’re wrong about something, you can always admit it and update your notes. If you don’t write it down, then there’s always scope for misunderstanding or misremembering in future.</p>
<p>In our case, we summarized how we’d ended up at that juncture; the salient points were:</p>
<ul><li>I hadn’t checked to ensure we had scoped it properly before committing to the work. It wasn’t a surprise that the API coverage was patchy, but I turned a blind eye because we were excited about the new feature.</li>
<li>Jen should have looked for the hard problem first rather than do a couple of weeks’ worth of nice, easy work around the edges. That’s why we lost two weeks off the top.</li>
<li>Tom and Frankie’s communication was poor. The reasons for that don’t form part of this discussion, but something wasn’t right in that team.</li>
</ul><p>And that’s step one.</p>
<h2 id="section5"><strong>Step 2 — Rejoice</strong><a class="subhead-anchor" href="https://alistapart.com#section5">#section5</a></h2>
<p>Few people like to make mistakes, but everyone <em>will</em> make one at some point in their life. Big ones, small ones, important ones, silly ones—we all do it. Don’t beat yourself up.</p>
<figure id="figure1" class="wp-block-image size-full"><img width="960" height="604" src="https://alistapart.com/wp-content/uploads/2021/03/people-who-make-mistakes.jpg?resize=960%2C604" alt="A Venn diagram with one circle showing the set of people who make mistakes. In a smaller circle completely inside the first is the set of people who think they don't make mistakes." class="wp-image-7172758" data-recalc-dims="1" /></figure><p>At the start of my career, I worked on a team whose manager had a very high opinion of himself. He was good, but what I learned from him was that he spread that confidence around the team. If something was looking shaky, he insisted that if we could “smell smoke,” that he had to be the first to know so he could do something about it. If we made a mistake, there was no hiding from it. We learned how to face up to it and accept responsibility, but what was more important was learning from him the feeling we were the best people to fix it.</p>
<p>There was no holding of grudges. What was done, was done. It was all about putting it behind us.</p>
<p>He would tell us that we were only in this team because he had handpicked us because we were the best and he only wanted the best around him. Now, that might all have been manipulative nonsense, but it worked.</p>
<p>The only thing you can control is what you do now, so try not to fret about what happened in the past or get anxious about what might happen in the future.</p>
<p>With that in mind, once you’ve written the summary of your sticky situation, set it aside!</p>
<p>I’ll let you in on a secret. No one else is interested in how you got here. They might be asking you about it (probably because they are scared that someone will ask them), but they’re always going to be more interested in how you’re going to sort the problem out.</p>
<p>So don’t waste time pointing fingers. Don’t prepare slide decks to throw someone under the bus. Tag that advice with a more general “don’t be an asshole” rule.</p>
<p>If you’re getting consistent heat about the past, it’s because you’re not doing a good enough job filling the bandwidth with a solid, robust, and realistic plan for getting out of the mess.</p>
<p>So focus on the future.</p>
<p>Sometimes it’s not easy to do that, but remember that none of this is permanent. Trust in the fact that if you pull it together, you’ll be in a much more powerful position to decide what to do next.</p>
<p>Maybe the team will hold together with a new culture or, if it is irretrievably broken, once you’re out of the hole then you can do something about it and switch teams or even switch jobs. But be the person who sorted it out, or at the very least, be part of the gang who sorted it out. That will be obvious to outsiders and makes for a much better interview question response.</p>
<p>In our story with Jen, we had a short ten-minute call with everyone involved on the line. We read out the summary and asked if anyone had anything to add.</p>
<p>Tom spoke up and said that he never gets time to update the API documentation because he always has to work on emergencies. We added that to our summary:</p>
<ul><li>Tom has an ongoing time management problem. He doesn’t have enough time allocated to maintain and improve the API documentation.</li>
</ul><p>After that was added, everyone agreed that the summary was accurate.</p>
<p>I explained that the worst thing that could now happen was that we had to report back to the wider business that we’d messed up and couldn’t hit our deadline.</p>
<p>If we did that, we’d lose face. There would be real financial consequences. It would show up on our appraisals. It wouldn’t be good. It wouldn’t be the end of the world, but it wasn’t something that we wanted. Everyone probably knew all that already, but there’s a power in saying it out loud. Suddenly, it doesn’t seem so scary.</p>
<p>Jen spoke up to say that she was new here and really didn’t want to start out like this. There was some murmuring in general support. I wrapped up that part of the discussion.</p>
<p>I purposefully didn’t enter into a discussion about the solution yet. We had all come together to admit the circumstances we were in. We’d done that. It was enough for now.</p>
<h2 id="section6"><strong>Step 3 — Move on</strong><a class="subhead-anchor" href="https://alistapart.com#section6">#section6</a></h2>
<p>Stepping back for a second, as the person who is going to lead the team out of the wilderness, you may want to start getting in everyone’s face. You’ll be tempted to rely on your unlimited reserves of personal charm or enthusiasm to vibe everyone up. Resist the urge! Don’t do it!</p>
<p>Your job is to give people the space to let them do their best work.</p>
<p>I learned this the hard way. I’m lucky enough that I can bounce back quickly, but when someone is under pressure, funnily enough, a super-positive person who wants to throw the curtains open and talk about what a wonderful day it is might not be the most motivational person to be around. I’ve unwittingly walked into some short-tempered conversations that way.</p>
<p>Don’t micromanage. In fact, scrap all of your management tricks. Your job is to listen to what people are telling you—even if they’re telling you things by not talking.</p>
<p>Reframe the current problem. Break it up into manageable chunks.</p>
<p>The first task to add to your list of things to do is simply to “Decide what we’re going to do about [the thing].”</p>
<p>It’s likely that there’s a nasty old JIRA ticket that everyone has been avoiding or has been bounced back and forth between different team members. Set that aside. There’s too much emotional content invested in that ticket now.</p>
<p>Create a new task that’s entirely centered on making a decision. Now, break it down into subtasks for each member of the team, like “Submit a proposal for what to do next.” Put your own suggestions in the mix but do your best to dissociate yourself from them.</p>
<p>Once you start getting some suggestions back and can tick those tasks off the list, you start to generate positive momentum. Nurture that.</p>
<p>If a plan emerges, champion it. Be wary of naysayers. Challenge them respectfully with “How do you think we should…?” questions. If they have a better idea, champion that instead; if they don’t respond at all, then gently suggest “Maybe we should go with this if no one else has a better idea.”</p>
<p>Avoid words like “need,” “just,” “one,” or “small.” Basically, anything that imposes a view of other people’s work. It seems trivial, but try to see it from the other side.</p>
<p>Saying, “I just need you to change that one small thing” hits the morale-killing jackpot. It unthinkingly diminishes someone else’s efforts. An engineer or a designer could reasonably react by thinking “What do you know about how to do this?!” Your job is to help everyone drop their guard and feel safe enough to contribute.</p>
<p>Instead, try “We’re all looking at you here because you’re good at this and this is a nasty problem. Maybe you know a way to make this part work?”</p>
<p>More often than not, <a href="https://www.sciencedaily.com/releases/2020/06/200603144334.htm">people want to help</a>.</p>
<p>So I asked Jen, Tom, and Frankie to submit their proposals for a way through the mess.</p>
<p>It wasn’t straightforward. Just because we’d all agreed how we got here didn’t just magically make all the problems disappear. Tom was still digging his heels in about not wanting to write more code, and kept pushing back on Jen.</p>
<p>There was a certain amount of back and forth. Although, with some constant reminders that we should maybe focus on what will move us forward, we eventually settled on a plan.</p>
<p>Like most compromises, it wasn’t pretty or simple. Jen was going to have to rely on using the local database for a certain amount of the lower-priority features. Tom was going to have to create some additional API functions and would end up with some unnecessary traffic that might create too much load on the API.</p>
<p>And even with the compromise, Tom wouldn’t be finished in time. He’d need another couple of weeks.</p>
<p>But it was a plan!</p>
<p><em>N.B. Estimating is a whole other subject that I won’t cover here. Check out the</em> <a href="https://basecamp.com/shapeup"><em>Shape Up</em></a> <em>process for some great advice on that.</em></p>
<h2 id="section7"><strong>Step 4 — Spread the word</strong><a class="subhead-anchor" href="https://alistapart.com#section7">#section7</a></h2>
<p>Once you’ve got a plan, commit to it and tell everyone affected what’s going on.</p>
<p>When communicating with people who are depending on you, take the last line of your email, which usually contains the summary or the “ask,” and put it at the top. When your recipient reads the message, the opener is the meat. Good news or bad news, that’s what they’re interested in. They’ll read on if they want more.</p>
<p>If it’s bad news, set someone up for it with a simple “I’m sorry to say I’ve got bad news” before you break it to them. No matter who they are, kindly <a href="https://www.ncbi.nlm.nih.gov/pmc/articles/PMC5578619/">framing the conversation will help them digest it</a>.</p>
<p>When discussing it with the team, put the plan somewhere everyone can see it. Transparency is key.</p>
<p>Don’t pull any moves—like publishing deadline dates to the team that are two weeks earlier than the date you’ve told the business. Teams aren’t stupid. They’ll know that’s what you do.</p>
<p>Publish the new deadlines in a place where everyone on the team can see them, and say we’re aiming for this date but we’re telling the business that we’ll definitely be done by that date.</p>
<p>In our case, I posted an update to the rest of the business as part of our normal weekly reporting cycle to announce we’d hit a bump that was going to affect our end date.</p>
<p>Here’s an extract:</p>
<blockquote class="wp-block-quote">
<p><em>Hi everyone,</em></p>
<p><em>Here’s the update for the week. I’m afraid there’s a bit of bad news to start but there is some good news too.</em></p>
<p><em>First:</em></p>
<p><em>We uncovered a misunderstanding between Jen and Tom this week. The outcome is that Tom has more API work to do than he anticipated. This affects the delivery date and means we’re now planning to finish 10 working days later on November 22.</em></p>
<p><em>**Expected completion date ** CHANGED ****<br />
Original estimate: November 8<br />
Current estimate: November 22<br /></em></p>
<p><em>Second: </em></p>
<p><em>We successfully released version 1.3 of the app into the App Store ?.</em></p>
</blockquote>
<p>And so on…</p>
<p>That post was available for everyone within the team to see. Everyone knew what was to be done and what the target was.</p>
<p>I had to field some questions from above, but I was ready with my summary of what went wrong and what we’d all agreed to do as a course of action. All I had to do was refer to it. Then I could focus on sharing the plan.</p>
<h2 id="section8"><strong>And all manner of things shall be well</strong><a class="subhead-anchor" href="https://alistapart.com#section8">#section8</a></h2>
<p>Now, I’d like to say that we then had tea and scones every day for the next month and it was all rather spiffing. But that would be a lie.</p>
<p>There was some more wailing and gnashing of teeth, but we all got through it and—even though we tried to finish early but failed—we did manage to finish by the November 22 date.</p>
<p>And then, after a bit of a tidy up, we all moved on to the next project, a bit older and a bit wiser. I hope that helps you if you’re in a similar scenario. <a href="https://twitter.com/liamjnugent" data-type="url" data-id="https://twitter.com/liamjnugent" target="_blank" rel="noreferrer noopener">Send me a tweet</a> or email me at <a href="mailto:liam.nugent@hey.com" data-type="mailto" data-id="mailto:liam.nugent@hey.com" target="_blank" rel="noreferrer noopener">liam.nugent@hey.com</a> with any questions or comments. I’d love to hear about your techniques and advice.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Matt E. Patterson shows why a new WebSockets-driven approach is catching developers' attention, and how it can mean faster, easier development that results in an experience just as rich as client-side SPAs.</div><div class="entry-content">Are your content models excluding people? This piece from Daniel Carter and Carra Martinez will help you recognize how this happens and what we can do about it.</div><div class="entry-content">Successful design requires buy-in from the top. Ben Callahan shows how to convince executives not just to fund the initial push of design system work, but to keep funding it.</div><div class="entry-content">How to be human, build trust, and sustain relationships with our design and development clients and partners.</div><div class="entry-content">In this excerpt from World Wide Waste, Gerry McGovern examines the environmental impact of bloated websites and unnecessary assets.</div>]]></description>
      <link>https://alistapart.com/article/dysfunctional-teams-back-on-track/</link>
      <guid>https://alistapart.com/article/dysfunctional-teams-back-on-track/</guid>
      <pubDate>Thu, 04 Mar 2021 16:00:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[How to Get a Dysfunctional Team Back on Track]]></title>
      <description><![CDATA[<p>Maybe you’ve been part of a team that you’ve seen slowly slide into a rut. You didn’t notice it happen, but you’re now not shipping anything, no one’s talking to each other, and the management’s Eye of Sauron has cast its gaze upon you.</p><div class="aside-breaker">Article Continues Below</div>
<p>Maybe you’ve just joined a team that’s in the doldrums.</p>
<p>Maybe the people who used to oil the wheels that kept everyone together have moved on and you’re having to face facts—you all hate each other.</p>
<p>However you’ve ended up in this situation, the fact is that you’re now here and it’s up to someone to do something about it. And that person might be you.</p>
<p>The first thing to understand is that you’re not the only person to ever encounter problems. Things like this happen all the time at work, but there are simple steps you can take and habits you can form to ease the situation and even dig yourself (and your team) out of the hole. I’ll share some techniques that have helped me, and maybe they can work for you, too.</p>
<p>So let me tell you a story about a hot mess I found myself in and how we turned it around. Names and details have been changed to protect the innocent.</p>
<h2><strong>It always starts out great</strong><a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/dysfunctional-teams-back-on-track#section3">#section3</a></h2>
<p>An engineer called Jen was working with me on a new feature on our product that lets people create new meal recipes themselves. I was the Project Manager. We were working in six-week cycles.</p>
<p>She had to rely on an API that was managed by Tom (who was in another team) to allow her to get and set the new recipe information on a central database. Before we kicked off, everyone knew the overall objective and everyone was all smiles and ready to go.</p>
<p>The system architecture was a legacy mishmash of different parts of local databases and API endpoints. And, no prizes for guessing what’s coming next, the API documentation was like Swiss cheese.</p>
<p>Two weeks into a six-week cycle, Jen hit Tom up with a list of her dream API calls that she wanted to use to build her feature. She asked him to confirm or deny they would work—or even if they existed at all—because once she started digging into the docs, it wasn’t clear to her if the API could support her plans.</p>
<p>However, Tom had form for sticking his head in the sand and not responding to requests he didn’t like. Tom went to ground and didn’t respond. Tom’s manager, Frankie, was stretched too thin, and hence wasn’t paying attention to this until I was persistently asking about it, in increasingly fraught tones.</p>
<p>In the meantime, Jen tried to do as much as she could. Every day she built a bit more based on her as-yet unapproved design, hoping it would all work out.</p>
<p>With two weeks left to go, Tom eventually responded with a short answer—which boiled down to “The API doesn’t support these calls and I don’t see why I should build something that does. Why don’t you get the data from the other part of the system? And by the way, if I’m forced to do this, it will take at least six weeks.”</p>
<p>And as we know, six weeks into two weeks doesn’t go. Problem.</p>
<p>How did we sort it?</p>
<p>When things go south, what do you do?</p>
<p>Accept it.</p>
<p>Acknowledge whatever has happened to get you into this predicament. Take some notes about it to use in team appraisals and retrospectives. Take a long hard look at yourself, too.</p>
<p>Write a concise, impersonal summary of where you are. Try not to write it from your point of view. Imagine that you’re in your boss’ seat and just give them the facts as they are. Don’t dress things up to make them sound better. Don’t over-exaggerate the bad. Leave the emotions to the side.</p>
<p>When you can see your situation clearly, you’ll make better decisions.</p>
<p>Now, pointing out the importance of taking some time to cool down and gather your thoughts seems obvious, but it’s based on the study of some of the most basic circuitry in our brains. Daniel Goleman’s 1995 book, <em>Emotional Intelligence: Why It Can Matter More Than IQ</em>, introduces the concept of <em>emotional hijacking</em>; the idea that the part of our brain that deals with emotion—the limbic system—can biologically interrupt rational thinking when it is overstimulated. For instance, experiments show that <a href="https://citeseerx.ist.psu.edu/viewdoc/download?doi=10.1.1.220.4820&amp;rep=rep1&amp;type=pdf">the angrier men get, the poorer are the decisions they make</a> at the casino. And another study found that people in a negative emotional state are <a href="https://www.ncbi.nlm.nih.gov/pmc/articles/PMC4050437/">more likely to deviate from logical norms</a>. To put it another way, if you’re pissed off, you can’t think straight.</p>
<p>So when you are facing up to the facts, avoid the temptation to keep it off-the-record and only discuss it on the telephone or in person with your colleagues. There’s nothing to be scared of by writing it down. If it turns out that you’re wrong about something, you can always admit it and update your notes. If you don’t write it down, then there’s always scope for misunderstanding or misremembering in future.</p>
<p>In our case, we summarized how we’d ended up at that juncture; the salient points were:</p>
<ul><li>I hadn’t checked to ensure we had scoped it properly before committing to the work. It wasn’t a surprise that the API coverage was patchy, but I turned a blind eye because we were excited about the new feature.</li>
<li>Jen should have looked for the hard problem first rather than do a couple of weeks’ worth of nice, easy work around the edges. That’s why we lost two weeks off the top.</li>
<li>Tom and Frankie’s communication was poor. The reasons for that don’t form part of this discussion, but something wasn’t right in that team.</li>
</ul><p>And that’s step one.</p>
<p>Few people like to make mistakes, but everyone <em>will</em> make one at some point in their life. Big ones, small ones, important ones, silly ones—we all do it. Don’t beat yourself up.</p>
<figure class="wp-block-image size-full"><img width="972" height="612" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/03/people-who-make-mistakes.jpg" alt="A Venn diagram with one circle showing the set of people who make mistakes. In a smaller circle completely inside the first is the set of people who think they don't make mistakes." class="wp-image-7172758" /></figure><p>At the start of my career, I worked on a team whose manager had a very high opinion of himself. He was good, but what I learned from him was that he spread that confidence around the team. If something was looking shaky, he insisted that if we could “smell smoke,” that he had to be the first to know so he could do something about it. If we made a mistake, there was no hiding from it. We learned how to face up to it and accept responsibility, but what was more important was learning from him the feeling we were the best people to fix it.</p>
<p>There was no holding of grudges. What was done, was done. It was all about putting it behind us.</p>
<p>He would tell us that we were only in this team because he had handpicked us because we were the best and he only wanted the best around him. Now, that might all have been manipulative nonsense, but it worked.</p>
<p>The only thing you can control is what you do now, so try not to fret about what happened in the past or get anxious about what might happen in the future.</p>
<p>With that in mind, once you’ve written the summary of your sticky situation, set it aside!</p>
<p>I’ll let you in on a secret. No one else is interested in how you got here. They might be asking you about it (probably because they are scared that someone will ask them), but they’re always going to be more interested in how you’re going to sort the problem out.</p>
<p>So don’t waste time pointing fingers. Don’t prepare slide decks to throw someone under the bus. Tag that advice with a more general “don’t be an asshole” rule.</p>
<p>If you’re getting consistent heat about the past, it’s because you’re not doing a good enough job filling the bandwidth with a solid, robust, and realistic plan for getting out of the mess.</p>
<p>So focus on the future.</p>
<p>Sometimes it’s not easy to do that, but remember that none of this is permanent. Trust in the fact that if you pull it together, you’ll be in a much more powerful position to decide what to do next.</p>
<p>Maybe the team will hold together with a new culture or, if it is irretrievably broken, once you’re out of the hole then you can do something about it and switch teams or even switch jobs. But be the person who sorted it out, or at the very least, be part of the gang who sorted it out. That will be obvious to outsiders and makes for a much better interview question response.</p>
<p>In our story with Jen, we had a short ten-minute call with everyone involved on the line. We read out the summary and asked if anyone had anything to add.</p>
<p>Tom spoke up and said that he never gets time to update the API documentation because he always has to work on emergencies. We added that to our summary:</p>
<ul><li>Tom has an ongoing time management problem. He doesn’t have enough time allocated to maintain and improve the API documentation.</li>
</ul><p>After that was added, everyone agreed that the summary was accurate.</p>
<p>I explained that the worst thing that could now happen was that we had to report back to the wider business that we’d messed up and couldn’t hit our deadline.</p>
<p>If we did that, we’d lose face. There would be real financial consequences. It would show up on our appraisals. It wouldn’t be good. It wouldn’t be the end of the world, but it wasn’t something that we wanted. Everyone probably knew all that already, but there’s a power in saying it out loud. Suddenly, it doesn’t seem so scary.</p>
<p>Jen spoke up to say that she was new here and really didn’t want to start out like this. There was some murmuring in general support. I wrapped up that part of the discussion.</p>
<p>I purposefully didn’t enter into a discussion about the solution yet. We had all come together to admit the circumstances we were in. We’d done that. It was enough for now.</p>
<p>Stepping back for a second, as the person who is going to lead the team out of the wilderness, you may want to start getting in everyone’s face. You’ll be tempted to rely on your unlimited reserves of personal charm or enthusiasm to vibe everyone up. Resist the urge! Don’t do it!</p>
<p>Your job is to give people the space to let them do their best work.</p>
<p>I learned this the hard way. I’m lucky enough that I can bounce back quickly, but when someone is under pressure, funnily enough, a super-positive person who wants to throw the curtains open and talk about what a wonderful day it is might not be the most motivational person to be around. I’ve unwittingly walked into some short-tempered conversations that way.</p>
<p>Don’t micromanage. In fact, scrap all of your management tricks. Your job is to listen to what people are telling you—even if they’re telling you things by not talking.</p>
<p>Reframe the current problem. Break it up into manageable chunks.</p>
<p>The first task to add to your list of things to do is simply to “Decide what we’re going to do about [the thing].”</p>
<p>It’s likely that there’s a nasty old JIRA ticket that everyone has been avoiding or has been bounced back and forth between different team members. Set that aside. There’s too much emotional content invested in that ticket now.</p>
<p>Create a new task that’s entirely centered on making a decision. Now, break it down into subtasks for each member of the team, like “Submit a proposal for what to do next.” Put your own suggestions in the mix but do your best to dissociate yourself from them.</p>
<p>Once you start getting some suggestions back and can tick those tasks off the list, you start to generate positive momentum. Nurture that.</p>
<p>If a plan emerges, champion it. Be wary of naysayers. Challenge them respectfully with “How do you think we should…?” questions. If they have a better idea, champion that instead; if they don’t respond at all, then gently suggest “Maybe we should go with this if no one else has a better idea.”</p>
<p>Avoid words like “need,” “just,” “one,” or “small.” Basically, anything that imposes a view of other people’s work. It seems trivial, but try to see it from the other side.</p>
<p>Saying, “I just need you to change that one small thing” hits the morale-killing jackpot. It unthinkingly diminishes someone else’s efforts. An engineer or a designer could reasonably react by thinking “What do you know about how to do this?!” Your job is to help everyone drop their guard and feel safe enough to contribute.</p>
<p>Instead, try “We’re all looking at you here because you’re good at this and this is a nasty problem. Maybe you know a way to make this part work?”</p>
<p>More often than not, <a href="https://www.sciencedaily.com/releases/2020/06/200603144334.htm">people want to help</a>.</p>
<p>So I asked Jen, Tom, and Frankie to submit their proposals for a way through the mess.</p>
<p>It wasn’t straightforward. Just because we’d all agreed how we got here didn’t just magically make all the problems disappear. Tom was still digging his heels in about not wanting to write more code, and kept pushing back on Jen.</p>
<p>There was a certain amount of back and forth. Although, with some constant reminders that we should maybe focus on what will move us forward, we eventually settled on a plan.</p>
<p>Like most compromises, it wasn’t pretty or simple. Jen was going to have to rely on using the local database for a certain amount of the lower-priority features. Tom was going to have to create some additional API functions and would end up with some unnecessary traffic that might create too much load on the API.</p>
<p>And even with the compromise, Tom wouldn’t be finished in time. He’d need another couple of weeks.</p>
<p>But it was a plan!</p>
<p><em>N.B. Estimating is a whole other subject that I won’t cover here. Check out the</em> <a href="https://basecamp.com/shapeup"><em>Shape Up</em></a> <em>process for some great advice on that.</em></p>
<h2><strong>Step 4 — Spread the word</strong><a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/dysfunctional-teams-back-on-track#section7">#section7</a></h2>
<p>Once you’ve got a plan, commit to it and tell everyone affected what’s going on.</p>
<p>When communicating with people who are depending on you, take the last line of your email, which usually contains the summary or the “ask,” and put it at the top. When your recipient reads the message, the opener is the meat. Good news or bad news, that’s what they’re interested in. They’ll read on if they want more.</p>
<p>If it’s bad news, set someone up for it with a simple “I’m sorry to say I’ve got bad news” before you break it to them. No matter who they are, kindly <a href="https://www.ncbi.nlm.nih.gov/pmc/articles/PMC5578619/">framing the conversation will help them digest it</a>.</p>
<p>When discussing it with the team, put the plan somewhere everyone can see it. Transparency is key.</p>
<p>Don’t pull any moves—like publishing deadline dates to the team that are two weeks earlier than the date you’ve told the business. Teams aren’t stupid. They’ll know that’s what you do.</p>
<p>Publish the new deadlines in a place where everyone on the team can see them, and say we’re aiming for this date but we’re telling the business that we’ll definitely be done by that date.</p>
<p>In our case, I posted an update to the rest of the business as part of our normal weekly reporting cycle to announce we’d hit a bump that was going to affect our end date.</p>
<p>Here’s an extract:</p>
<blockquote class="wp-block-quote">
<p><em>Hi everyone,</em></p>
<p><em>Here’s the update for the week. I’m afraid there’s a bit of bad news to start but there is some good news too.</em></p>
<p><em>First:</em></p>
<p><em>We uncovered a misunderstanding between Jen and Tom this week. The outcome is that Tom has more API work to do than he anticipated. This affects the delivery date and means we’re now planning to finish 10 working days later on November 22.</em></p>
<p><em>**Expected completion date ** CHANGED ****<br />Original estimate: November 8<br />Current estimate: November 22<br /></em></p>
<p><em>Second: </em></p>
<p><em>We successfully released version 1.3 of the app into the App Store ?.</em></p>
</blockquote>
<p>And so on…</p>
<p>That post was available for everyone within the team to see. Everyone knew what was to be done and what the target was.</p>
<p>I had to field some questions from above, but I was ready with my summary of what went wrong and what we’d all agreed to do as a course of action. All I had to do was refer to it. Then I could focus on sharing the plan.</p>
<h2><strong>And all manner of things shall be well</strong><a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/dysfunctional-teams-back-on-track#section8">#section8</a></h2>
<p>Now, I’d like to say that we then had tea and scones every day for the next month and it was all rather spiffing. But that would be a lie.</p>
<p>There was some more wailing and gnashing of teeth, but we all got through it and—even though we tried to finish early but failed—we did manage to finish by the November 22 date.</p>
<p>And then, after a bit of a tidy up, we all moved on to the next project, a bit older and a bit wiser. I hope that helps you if you’re in a similar scenario. <a href="https://twitter.com/liamjnugent" data-type="url" data-id="https://twitter.com/liamjnugent" target="_blank" rel="noreferrer noopener">Send me a tweet</a> or email me at <a href="mailto:liam.nugent@hey.com" data-type="mailto" data-id="mailto:liam.nugent@hey.com" target="_blank" rel="noreferrer noopener">liam.nugent@hey.com</a> with any questions or comments. I’d love to hear about your techniques and advice.</p>]]></description>
      <link>https://alistapart-production.mystagingwebsite.com/article/dysfunctional-teams-back-on-track/</link>
      <guid>https://alistapart-production.mystagingwebsite.com/article/dysfunctional-teams-back-on-track/</guid>
      <pubDate>Thu, 04 Mar 2021 16:00:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[The Future of Web Software Is HTML-over-WebSockets]]></title>
      <description><![CDATA[<div class="entry-content">
<p>The future of web-based software architectures is already taking form, and this time it’s server-rendered (again). Papa’s got a brand new bag: HTML-over-WebSockets and broadcast everything all the time.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>The dual approach of marrying a Single Page App with an API service has left many dev teams mired in endless JSON wrangling and state discrepancy bugs across two layers. This costs dev time, slows release cycles, and saps the bandwidth for innovation.</p>
<p>But a new WebSockets-driven approach is catching web developers’ attention. One that reaffirms the promises of classic server-rendered frameworks: fast prototyping, server-side state management, solid rendering performance, rapid feature development, and straightforward SEO. One that enables multi-user collaboration and reactive, responsive designs <em>without building two separate apps</em>. The end result is a single-repo application that feels to users just as responsive as a client-side all-JavaScript affair, but with straightforward templating and far fewer loading spinners, and no state misalignments, since state only lives in one place. All of this sets us up for a considerably easier (and faster!) development path. </p>
<p>Reclaiming all of that time spent addressing architecture difficulties grants you a pool of surplus hours that you can use to do awesome. Spend your dev budget, and your company’s salary budget, happily building full-stack features yourself, and innovating on things that benefit your company and customers. </p>
<p>And in my opinion, there’s no better app framework for reclaiming tedious development time than Ruby on Rails. Take another look at the underappreciated Stimulus. Beef up the View in your MVC with ViewComponents. Add in the <a href="https://cableready.stimulusreflex.com/">CableReady</a> and <a href="https://docs.stimulusreflex.com/">StimulusReflex</a> libraries for that Reactive Rails (as it has been dubbed) new car smell, and you’re off to the races. But we’ll get back to Rails in a bit…</p>
<h2 id="section2">This all started with web frameworks…<a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>Web frameworks burst onto the scene around 2005 amidst a sea of mostly figure-it-out-for-yourself scripting language libraries glued together and thrown onto hand-maintained Apache servers. This new architecture promised developers a more holistic approach that wrapped up all the fiddly stuff in no-touch conventions, freeing developers to focus on programming ergonomics, code readability, and fast-to-market features. All a developer had to do was learn the framework’s core language, get up to speed on the framework itself and its conventions, and then start churning out sophisticated web apps while their friends were still writing XML configuration files for all those <em>other</em> approaches.</p>
<p>Despite the early criticisms that always plague new approaches, these server-rendered frameworks became tools of choice, especially for fast-moving startups—strapped for resources—that needed an attractive, feature-rich app up <em>yesterday</em>.</p>
<h2 id="section3">But then the <em>JavaScript everything</em> notion took hold…<a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h2>
<p>As the web development world pushed deeper into the 2010s, the tides began to turn, and server-rendered frameworks took something of a backseat to the Single Page Application, wholly built in JavaScript and run entirely on the client’s computer. At many companies, the “server” became relegated to hosting an API data service only, with most of the business logic and all of the HTML rendering happening on the client, courtesy of the big ’ol package of JavaScript that visitors were forced to download when they first hit the site. </p>
<p>This is where things started to get ugly.</p>
<p>Fast-forward to 2020 and the <a href="https://www.nngroup.com/articles/the-need-for-speed/">web isn’t getting any faster</a>, as we were promised it would with SPAs. Shoving megabytes of JavaScript down an iPhone 4’s throat doesn’t make for a great user experience. And if you thought building a professional web app took serious resources, what about building a web app <em>and</em> an API service <em>and</em> a communication layer between them? Do we really believe that every one of our users is going to have a device capable of digesting 100 kB of JSON and rendering a complicated HTML table <em>faster</em> than a server-side app could on even a mid-grade server?</p>
<p>Developing and hosting these JavaScript-forward apps didn’t get any cheaper either. In many cases we’re now doing twice the work, and maybe even paying twice the developers, to achieve the same results we had before with server-side app development.</p>
<p>In 2005, app frameworks blew everyone’s minds with “build a blog app in 15 minutes” videos. Fifteen years <em>later</em>, doing the same thing with an SPA approach can require two codebases, a JSON serialization layer, and dozens of spinners all over the place so we can still claim a 50ms First Contentful Paint. Meanwhile, the user watches some blank gray boxes, hoping for HTML to finally render from all the JSON their browser is requesting and digesting. </p>
<p>How did we get here? This is not my beautiful house! Were we smart in giving up all of that server-rendered <em>developer happiness</em> and doubling down on staff and the time to implement in order to chase the promise of providing our users some fancier user interfaces?</p>
<p>Well. Yes. Sort of.</p>
<p>We’re not building web software for <em>us</em>. We’re building it for <em>them</em>. The users of our software have expectations of how it’s going to work for <em>them</em>. We have to meet them where they are. Our users are no longer excited about full-page refreshes and ugly Rube Goldberg-ian multi-form workflows. The SPA approach was the next logical leap from piles of unorganized spaghetti JavaScript living on the server. The problem, though: it was a 5% improvement, not a 500% improvement. </p>
<h2 id="section4">Is 5% better worth twice the work? What about the developer cost?<a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h2>
<p>Bedazzling the web app certainly makes things <em>fancier</em> from the user’s perspective. Done well, it can make the app feel slicker and more interactive, and it opens up a wealth of new non-native interaction elements. Canonizing those elements as <em>components</em> was the next natural evolution. Gone are the days of thinking through how an entire HTML document could be mutated to give the <em>illusion</em> of the user interacting with an atomic widget on the page—now, that can be implemented directly, and we can think about our UX in terms of component breakdowns. But, alas, the costs begin to bite us almost immediately.</p>
<p>Go ahead, write that slick little rating stars component. Add some cool animations, make the mouseover and click area feel good, give some endorphin-generating feedback when a selection is made. But now what? In a real app, we need to <em>persist</em> that change, right? The database has to be changed to reflect this new state, and the app in front of the user’s eyes needs to reflect that new reality too. </p>
<p>In the old days, we’d give the user a couple star GIFs, each a link that hit the same server endpoint with a different param value. Server-side, we’d save that change to the database, then send back a whole new HTML page for their browser to re-render; maybe we’d even get fancy and use AJAX to do it <em>behind the scenes</em>, obviating the need for the full HTML and render. Let’s say the former costs <em>x</em> in developer time and salary (and we won’t even talk about lost opportunity cost for features rolled out too late for the market). In that case, the fancy AJAX-based approach costs <em>x</em> + <em>n (you know, some “extra JavaScript sprinkles”)</em>, but the cost of lots and lots of <em>n</em> grows as our app becomes more and more of a JavaScript spaghetti sprinkles mess.</p>
<p>Over in the SPA world, we’re now writing JavaScript in the client-side app and using JSX or Handlebars templates to render the component, then code to persist that change to the front-end data store, then a PUT request to the API, where we’re also writing an API endpoint to handle the request, a JSON serializer (probably with its own pseudo-template) to package up our successful response, and then front-end code to ensure we re-render the component (and some branching logic to maybe rollback and re-render the client-side state change if the backend failed on us). This costs a lot more than even <em>x + n</em> in developer time and salary. And if you’ve split your team into “front-end” and “back-end” people, you might as well go ahead and double <em>that</em> cost (both time and money) for many non-trivial components where you need two different people to finish the implementation. Sure, the SPA mitigates some of the ever-growing spaghetti problem, but at what cost for a business racing to be relevant in the market or get something important out to the people who need it?</p>
<p>One of the other arguments we hear in support of the SPA is the reduction in cost of cyber infrastructure. As if pushing that hosting burden onto the client (without their consent, for the most part, but that’s another topic) is somehow saving us on our cloud bills. But that’s ridiculous. For any non-trivial application, you’re still paying for a server to host the API and maybe another for the database, not to mention load balancers, DNS, etc. And here’s the thing: <em>none of that cost even comes close to what a software company pays its developers!</em> Seriously, think about it. I’ve yet to work at any business where our technical infrastructure was anything more than a fraction of our salary overhead. And good developers expect raises. Cloud servers generally just get <em>cheaper</em> over time.</p>
<p>If you want to be efficient with your money—especially as a cash-strapped startup—you don’t need to cheap out on cloud servers; you need to get <em>more features faster out of your existing high-performance team</em>.</p>
<p>In the old, old days, before the web frameworks, you’d pay a developer for six weeks to finally unveil…the log-in page. Cue the sad trombone. Then frameworks made that log-in page an hour of work, total, and people were launching web startups overnight. The trumpets sound! Now, with our SPA approach, we’re back to a bunch of extra work. <em>It’s costing us more money because we’re writing two apps at once</em>. There’s that trombone again…</p>
<p>We’re paying a lot of money for that 5% user experience improvement.</p>
<p>But what if we could take the best client-side JavaScript ideas and libraries from that 5% improvement and reconnect them with the developer ergonomics and salary savings of a single codebase? What if components and organized JavaScript could all live in one rock-solid app framework optimized for server-side rendering? What if there <em>is</em> a path to a 500% jump?</p>
<p>Sound impossible? It’s not. I’ve seen it, like C-beams glittering in the dark near the Tannhäuser Gate. I’ve built that 500% app, in my free time, with my kids running around behind me barking like dogs. Push broadcasts to logged-in users. Instant updates to the client-side DOM in milliseconds. JavaScript-driven 3D animations that interact with real-time chat windows. All in a single codebase, running on the same server hardware I’d use for a “classic” server-rendered app (and maybe I can even scale that hardware down since I’m rendering HTML fragments more often than full-page documents). No separate front-end app. Clean, componentized JavaScript and server-side code, married like peanut butter and jelly. It’s real, I tell you!</p>
<h2 id="section5">Socket to me! (Get it? Get it? Ah, nevermind…)<a class="subhead-anchor" href="https://alistapart.com#section5">#section5</a></h2>
<p>Finalized in 2011, support for WebSockets in modern browsers ramped up throughout the 2010s and is now fully supported in all modern browsers. With the help of a small bit of client-side JavaScript, you get a <a href="https://en.wikipedia.org/wiki/Duplex_(telecommunications)#FULL-DUPLEX">full-duplex</a> socket connection between browser and server. Data can pass both ways, and can be pushed from either side at any time, no user-initiated request needed.</p>
<p>Like the game industry’s ever-expanding moves into cloud-based gaming, the future of web apps is not going to be about pushing even heavier obligations onto the user/client, but rather the opposite: let the client act as a thin terminal that renders the state of things for the human. WebSockets provide the communication layer, seamless and fast; a direct shot from the server to the human.</p>
<p>But this wasn’t terribly easy for many developers to grok at first. I sure didn’t. And the benefits weren’t exactly clear either. After years (decades, even) of wrapping our heads around the HTTP request cycle, to which all server-handled features must conform, adopting this WebSocket tech layer required a lot of head scratching. As with many clever new technologies or protocols, we needed a higher-level abstraction that provided something really effective for getting a new feature in front of a user, fast.</p>
<h2 id="section6">Enter HTML-over-WebSockets…<a class="subhead-anchor" href="https://alistapart.com#section6">#section6</a></h2>
<p>Want a hyper-responsive datalist typeahead that is perfectly synced with the database? On every keystroke, send a query down the WebSocket and get back <em>precisely</em> the changed set of <strong>option</strong> tags, nothing more, nothing less.</p>
<p>How about client-side validations? Easy. On every input change, round up the form values and send ’em down the WebSocket. Let your server framework validate and send back changes to the HTML of the form, including any errors that need to be rendered. No need for JSON or complicated error objects.</p>
<p>User presence indicators? Dead simple. Just check who has an active socket connection.</p>
<p>What about multi-user chat? Or document collaboration? In classic frameworks and SPAs, these are the features we put off because of their difficulty and the code acrobatics needed to keep everyone’s states aligned. With HTML-over-the-wire, we’re just pushing tiny bits of HTML based on one user’s changes to <em>every other</em> <em>user</em> currently subscribed to the channel. They’ll see <em>exactly</em> the same thing as if they hit refresh and asked the server for the entire HTML page anew. And you can get those bits to every user in under 30ms.</p>
<p>We’re not throwing away the promise of components either. Where this WebSockets-based approach can be seen as a thick server/thin client, so too can our components. It’s fractal, baby! Make that component <em>do</em> delightful things for the user with smart JavaScript, and then just ask the server for updated HTML, and mutate the DOM. No need for a client-side data store to manage the component’s state since it’ll render itself to look <em>exactly like what the server knows it should look like now</em>. The HTML comes from the server, so no need for JSX or Handlebars or &lt;insert other JavaScript templating library here&gt;. The server is always in control: rendering the initial component’s appearance <em>and</em> updating it in response to any state change, all through the socket. </p>
<p>And there’s nothing saying you have to use those socket channels to send <em>only</em> HTML. Send a tiny bit of text, and have the client do something smart. Send a chat message from one user to every other user, and have their individual clients render that message in whatever app theme they’re currently using. Imagine the possibilities!</p>
<h2 id="section7">But it’s complex/expensive/requires a bunch of new infrastructure, right?<a class="subhead-anchor" href="https://alistapart.com#section7">#section7</a></h2>
<p>Nope. Prominent open-source web servers support it natively, generally without needing any kind of extra configuration or setup. Many server-side frameworks will automatically ship the JS code to the client for native support in communicating over the socket. In Rails, for example, setting up your app to use WebSockets is as easy as configuring the built-in ActionCable and then deploying as usual on the same hardware you would have used otherwise. Anecdotally, the typical single Rails server process seems to be perfectly happy supporting nearly 4,000 active connections. And you can easily swap in the excellent <a href="https://docs.anycable.io">AnyCable</a> to bump that up to around 10,000+ connections per node by not relying on the built-in Ruby WebSocket server. Again, this is on the usual hardware you’d be running your web server on in the first place. You don’t need to set up any extra hardware or increase your cloud infrastructure.</p>
<p>This new approach is quickly appearing as extensions, libraries, or alternative configurations in a variety of languages and web frameworks, from Django’s <a href="https://sockpuppet.argpar.se">Sockpuppet</a> to Phoenix’s <a href="https://dockyard.com/blog/2018/12/12/phoenix-liveview-interactive-real-time-apps-no-need-to-write-javascript">LiveView</a> and beyond. Seriously, go dig around for WebSockets-based libraries for your favorite app framework and then step into a new way of thinking about your app architectures. Build something amazing and marvel at the glorious HTML bits zipping along on the socket, like jet fighters passing in the night. It’s more than a new technical approach; it’s a new mindset, and maybe even a new wellspring of key app features that will drive your startup success.</p>
<p>But I’d be remiss if I didn’t highlight for the reader <em>my</em> contender for Best Framework in a Leading Role. Sure, any app framework can adopt this approach, but for my money, there’s a strong case to be made that the vanguard could be Ruby on Rails. </p>
<h2 id="section8">So we come back around to Rails, 15 years on from its launch…<a class="subhead-anchor" href="https://alistapart.com#section8">#section8</a></h2>
<p>Set up a Rails 6 app with the latest versions of <a href="https://github.com/turbolinks/turbolinks">Turbolinks</a>, <a href="https://stimulus.hotwire.dev">Stimulus</a>, <a href="https://docs.stimulusreflex.com">StimulusReflex</a>, <a href="https://cableready.stimulusreflex.com">CableReady</a>, and GitHub’s <a href="https://github.com/github/view_component">ViewComponent</a> gem, and you can be working with Reactive Rails in a way that simultaneously feels like building a classic Rails app <em>and</em> like building a modern, componentized SPA, in a single codebase, with all the benefits of server-side rendering, HTML fragment caching, easy SEO, rock-solid security, and the like. You’ll suddenly find your toolbelt bursting with straightforward tools to solve previously daunting challenges.</p>
<p>Oh, and with Turbolinks, you also get wrappers allowing for hybrid native/HTML UIs in the same codebase. Use a quick deploy solution like Heroku or Hatchbox, and one developer can build a responsive, reactive, multi-platform app in their spare time. Just see <a href="https://dev.to/julianrubisch/twitter-clone-with-stimulusreflex-gone-hybrid-native-app-17fm">this Twitter clone</a> if you don’t believe me. </p>
<p>OK, that all sounds exciting, but why Rails specifically? Isn’t it old and boring? You already said any framework can benefit from this new WebSocket, DOM-morphing approach, right? </p>
<p>Sure. But where Rails has always shined is in its ability to make rapid prototyping, well…<em>rapid</em>, and in its deep ecosystem of well-polished gems. Rails also hasn’t stopped pushing the envelope forward, with the latest version 6.1.3 of the framework boasting a ton of cool features. </p>
<p>If you’ve got a small, resource-strapped team, Rails (and Ruby outside of the framework) still serves as a potent force multiplier that lets you punch way above your weight, which probably explains the <a href="https://charliereese.ca/article/top-50-y-combinator-tech-startups">$92 billion in revenue it’s helped drive over the years</a>. With this new approach, there’s a <em>ton</em> more weight behind that punch. While your competitors are fiddling with their JSON serializers and struggling to optimize away all the loading spinners, you’re rolling out a new multi-user collaborative feature every week…or every <em>day</em>. </p>
<p>You win. Your fellow developers win. Your business wins. And, most importantly, your <em>users</em> win.</p>
<p>That’s what Rails promised from the day it was released to the community. That’s why Rails spawned so many imitators in other languages, and why it saw such explosive growth in the startup world for years. And that same old rapid prototyping spirit, married to this new HTML-over-the-wire approach, positions Rails for a powerful resurgence. </p>
<p>Ruby luminary and <a href="https://www.amazon.com/Obie-Fernandez/e/B001IGV0LS">author</a> of <em>The Ruby Way</em>, Obie Fernandez, <a href="https://medium.com/@obie/react-is-dead-long-live-reactive-rails-long-live-stimulusreflex-and-viewcomponent-cd061e2b0fe2">seems to think so</a>.</p>
<p>Heck, even <a href="https://www.youtube.com/watch?v=utxCm3uLhIE">Russ Hanneman thinks this approach with StimulusReflex is the new hotness</a>.</p>
<p>And the good folks over at Basecamp (creators of Rails in the first place), dropped their own take on the concept, <a href="https://hotwire.dev">Hotwire</a>, just in time for the 2020 holidays, so your options for tackling this new and exciting technique continue to expand.</p>
<p>Don’t call it a comeback, because Rails has been here for years. With this new architectural approach, brimming with HTML-over-WebSockets and full-duplex JavaScript interactions, Rails becomes something new, something beautiful, something that demands attention (again). </p>
<p>Reactive Rails, with StimulusReflex and friends, is a must-look for anyone exhausted from toiling with JSON endpoints or JSX, and I’m super excited to see the new crop of apps that it enables.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Are your content models excluding people? This piece from Daniel Carter and Carra Martinez will help you recognize how this happens and what we can do about it.</div><div class="entry-content">Successful design requires buy-in from the top. Ben Callahan shows how to convince executives not just to fund the initial push of design system work, but to keep funding it.</div><div class="entry-content">How to be human, build trust, and sustain relationships with our design and development clients and partners.</div><div class="entry-content">In this excerpt from World Wide Waste, Gerry McGovern examines the environmental impact of bloated websites and unnecessary assets.</div><div class="entry-content">In this excerpt from Creative Culture, Justin Dauer walks us through many ways in which an organizations’ culture and the design work that it does play off of one another.</div>]]></description>
      <link>https://alistapart.com/article/the-future-of-web-software-is-html-over-websockets/</link>
      <guid>https://alistapart.com/article/the-future-of-web-software-is-html-over-websockets/</guid>
      <pubDate>Thu, 25 Feb 2021 16:00:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[The Future of Web Software Is HTML-over-WebSockets]]></title>
      <description><![CDATA[<p>The future of web-based software architectures is already taking form, and this time it’s server-rendered (again). Papa’s got a brand new bag: HTML-over-WebSockets and broadcast everything all the time.</p><div class="aside-breaker">Article Continues Below</div>
<p>The dual approach of marrying a Single Page App with an API service has left many dev teams mired in endless JSON wrangling and state discrepancy bugs across two layers. This costs dev time, slows release cycles, and saps the bandwidth for innovation.</p>
<p>But a new WebSockets-driven approach is catching web developers’ attention. One that reaffirms the promises of classic server-rendered frameworks: fast prototyping, server-side state management, solid rendering performance, rapid feature development, and straightforward SEO. One that enables multi-user collaboration and reactive, responsive designs <em>without building two separate apps</em>. The end result is a single-repo application that feels to users just as responsive as a client-side all-JavaScript affair, but with straightforward templating and far fewer loading spinners, and no state misalignments, since state only lives in one place. All of this sets us up for a considerably easier (and faster!) development path. </p>
<p>Reclaiming all of that time spent addressing architecture difficulties grants you a pool of surplus hours that you can use to do awesome. Spend your dev budget, and your company’s salary budget, happily building full-stack features yourself, and innovating on things that benefit your company and customers. </p>
<p>And in my opinion, there’s no better app framework for reclaiming tedious development time than Ruby on Rails. Take another look at the underappreciated Stimulus. Beef up the View in your MVC with ViewComponents. Add in the <a href="https://cableready.stimulusreflex.com/">CableReady</a> and <a href="https://docs.stimulusreflex.com/">StimulusReflex</a> libraries for that Reactive Rails (as it has been dubbed) new car smell, and you’re off to the races. But we’ll get back to Rails in a bit…</p>
<h2>This all started with web frameworks…<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/the-future-of-web-software-is-html-over-websockets#section2">#section2</a></h2>
<p>Web frameworks burst onto the scene around 2005 amidst a sea of mostly figure-it-out-for-yourself scripting language libraries glued together and thrown onto hand-maintained Apache servers. This new architecture promised developers a more holistic approach that wrapped up all the fiddly stuff in no-touch conventions, freeing developers to focus on programming ergonomics, code readability, and fast-to-market features. All a developer had to do was learn the framework’s core language, get up to speed on the framework itself and its conventions, and then start churning out sophisticated web apps while their friends were still writing XML configuration files for all those <em>other</em> approaches.</p>
<p>Despite the early criticisms that always plague new approaches, these server-rendered frameworks became tools of choice, especially for fast-moving startups—strapped for resources—that needed an attractive, feature-rich app up <em>yesterday</em>.</p>
<h2>But then the <em>JavaScript everything</em> notion took hold…<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/the-future-of-web-software-is-html-over-websockets#section3">#section3</a></h2>
<p>As the web development world pushed deeper into the 2010s, the tides began to turn, and server-rendered frameworks took something of a backseat to the Single Page Application, wholly built in JavaScript and run entirely on the client’s computer. At many companies, the “server” became relegated to hosting an API data service only, with most of the business logic and all of the HTML rendering happening on the client, courtesy of the big ’ol package of JavaScript that visitors were forced to download when they first hit the site. </p>
<p>This is where things started to get ugly.</p>
<p>Fast-forward to 2020 and the <a href="https://www.nngroup.com/articles/the-need-for-speed/">web isn’t getting any faster</a>, as we were promised it would with SPAs. Shoving megabytes of JavaScript down an iPhone 4’s throat doesn’t make for a great user experience. And if you thought building a professional web app took serious resources, what about building a web app <em>and</em> an API service <em>and</em> a communication layer between them? Do we really believe that every one of our users is going to have a device capable of digesting 100 kB of JSON and rendering a complicated HTML table <em>faster</em> than a server-side app could on even a mid-grade server?</p>
<p>Developing and hosting these JavaScript-forward apps didn’t get any cheaper either. In many cases we’re now doing twice the work, and maybe even paying twice the developers, to achieve the same results we had before with server-side app development.</p>
<p>In 2005, app frameworks blew everyone’s minds with “build a blog app in 15 minutes” videos. Fifteen years <em>later</em>, doing the same thing with an SPA approach can require two codebases, a JSON serialization layer, and dozens of spinners all over the place so we can still claim a 50ms First Contentful Paint. Meanwhile, the user watches some blank gray boxes, hoping for HTML to finally render from all the JSON their browser is requesting and digesting. </p>
<p>How did we get here? This is not my beautiful house! Were we smart in giving up all of that server-rendered <em>developer happiness</em> and doubling down on staff and the time to implement in order to chase the promise of providing our users some fancier user interfaces?</p>
<p>Well. Yes. Sort of.</p>
<p>We’re not building web software for <em>us</em>. We’re building it for <em>them</em>. The users of our software have expectations of how it’s going to work for <em>them</em>. We have to meet them where they are. Our users are no longer excited about full-page refreshes and ugly Rube Goldberg-ian multi-form workflows. The SPA approach was the next logical leap from piles of unorganized spaghetti JavaScript living on the server. The problem, though: it was a 5% improvement, not a 500% improvement. </p>
<h2>Is 5% better worth twice the work? What about the developer cost?<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/the-future-of-web-software-is-html-over-websockets#section4">#section4</a></h2>
<p>Bedazzling the web app certainly makes things <em>fancier</em> from the user’s perspective. Done well, it can make the app feel slicker and more interactive, and it opens up a wealth of new non-native interaction elements. Canonizing those elements as <em>components</em> was the next natural evolution. Gone are the days of thinking through how an entire HTML document could be mutated to give the <em>illusion</em> of the user interacting with an atomic widget on the page—now, that can be implemented directly, and we can think about our UX in terms of component breakdowns. But, alas, the costs begin to bite us almost immediately.</p>
<p>Go ahead, write that slick little rating stars component. Add some cool animations, make the mouseover and click area feel good, give some endorphin-generating feedback when a selection is made. But now what? In a real app, we need to <em>persist</em> that change, right? The database has to be changed to reflect this new state, and the app in front of the user’s eyes needs to reflect that new reality too. </p>
<p>In the old days, we’d give the user a couple star GIFs, each a link that hit the same server endpoint with a different param value. Server-side, we’d save that change to the database, then send back a whole new HTML page for their browser to re-render; maybe we’d even get fancy and use AJAX to do it <em>behind the scenes</em>, obviating the need for the full HTML and render. Let’s say the former costs <em>x</em> in developer time and salary (and we won’t even talk about lost opportunity cost for features rolled out too late for the market). In that case, the fancy AJAX-based approach costs <em>x</em> + <em>n (you know, some “extra JavaScript sprinkles”)</em>, but the cost of lots and lots of <em>n</em> grows as our app becomes more and more of a JavaScript spaghetti sprinkles mess.</p>
<p>Over in the SPA world, we’re now writing JavaScript in the client-side app and using JSX or Handlebars templates to render the component, then code to persist that change to the front-end data store, then a PUT request to the API, where we’re also writing an API endpoint to handle the request, a JSON serializer (probably with its own pseudo-template) to package up our successful response, and then front-end code to ensure we re-render the component (and some branching logic to maybe rollback and re-render the client-side state change if the backend failed on us). This costs a lot more than even <em>x + n</em> in developer time and salary. And if you’ve split your team into “front-end” and “back-end” people, you might as well go ahead and double <em>that</em> cost (both time and money) for many non-trivial components where you need two different people to finish the implementation. Sure, the SPA mitigates some of the ever-growing spaghetti problem, but at what cost for a business racing to be relevant in the market or get something important out to the people who need it?</p>
<p>One of the other arguments we hear in support of the SPA is the reduction in cost of cyber infrastructure. As if pushing that hosting burden onto the client (without their consent, for the most part, but that’s another topic) is somehow saving us on our cloud bills. But that’s ridiculous. For any non-trivial application, you’re still paying for a server to host the API and maybe another for the database, not to mention load balancers, DNS, etc. And here’s the thing: <em>none of that cost even comes close to what a software company pays its developers!</em> Seriously, think about it. I’ve yet to work at any business where our technical infrastructure was anything more than a fraction of our salary overhead. And good developers expect raises. Cloud servers generally just get <em>cheaper</em> over time.</p>
<p>If you want to be efficient with your money—especially as a cash-strapped startup—you don’t need to cheap out on cloud servers; you need to get <em>more features faster out of your existing high-performance team</em>.</p>
<p>In the old, old days, before the web frameworks, you’d pay a developer for six weeks to finally unveil…the log-in page. Cue the sad trombone. Then frameworks made that log-in page an hour of work, total, and people were launching web startups overnight. The trumpets sound! Now, with our SPA approach, we’re back to a bunch of extra work. <em>It’s costing us more money because we’re writing two apps at once</em>. There’s that trombone again…</p>
<p>We’re paying a lot of money for that 5% user experience improvement.</p>
<p>But what if we could take the best client-side JavaScript ideas and libraries from that 5% improvement and reconnect them with the developer ergonomics and salary savings of a single codebase? What if components and organized JavaScript could all live in one rock-solid app framework optimized for server-side rendering? What if there <em>is</em> a path to a 500% jump?</p>
<p>Sound impossible? It’s not. I’ve seen it, like C-beams glittering in the dark near the Tannhäuser Gate. I’ve built that 500% app, in my free time, with my kids running around behind me barking like dogs. Push broadcasts to logged-in users. Instant updates to the client-side DOM in milliseconds. JavaScript-driven 3D animations that interact with real-time chat windows. All in a single codebase, running on the same server hardware I’d use for a “classic” server-rendered app (and maybe I can even scale that hardware down since I’m rendering HTML fragments more often than full-page documents). No separate front-end app. Clean, componentized JavaScript and server-side code, married like peanut butter and jelly. It’s real, I tell you!</p>
<h2>Socket to me! (Get it? Get it? Ah, nevermind…)<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/the-future-of-web-software-is-html-over-websockets#section5">#section5</a></h2>
<p>Finalized in 2011, support for WebSockets in modern browsers ramped up throughout the 2010s and is now fully supported in all modern browsers. With the help of a small bit of client-side JavaScript, you get a <a href="https://en.wikipedia.org/wiki/Duplex_(telecommunications)#FULL-DUPLEX">full-duplex</a> socket connection between browser and server. Data can pass both ways, and can be pushed from either side at any time, no user-initiated request needed.</p>
<p>Like the game industry’s ever-expanding moves into cloud-based gaming, the future of web apps is not going to be about pushing even heavier obligations onto the user/client, but rather the opposite: let the client act as a thin terminal that renders the state of things for the human. WebSockets provide the communication layer, seamless and fast; a direct shot from the server to the human.</p>
<p>But this wasn’t terribly easy for many developers to grok at first. I sure didn’t. And the benefits weren’t exactly clear either. After years (decades, even) of wrapping our heads around the HTTP request cycle, to which all server-handled features must conform, adopting this WebSocket tech layer required a lot of head scratching. As with many clever new technologies or protocols, we needed a higher-level abstraction that provided something really effective for getting a new feature in front of a user, fast.</p>
<h2>Enter HTML-over-WebSockets…<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/the-future-of-web-software-is-html-over-websockets#section6">#section6</a></h2>
<p>Want a hyper-responsive datalist typeahead that is perfectly synced with the database? On every keystroke, send a query down the WebSocket and get back <em>precisely</em> the changed set of <strong>option</strong> tags, nothing more, nothing less.</p>
<p>How about client-side validations? Easy. On every input change, round up the form values and send ’em down the WebSocket. Let your server framework validate and send back changes to the HTML of the form, including any errors that need to be rendered. No need for JSON or complicated error objects.</p>
<p>User presence indicators? Dead simple. Just check who has an active socket connection.</p>
<p>What about multi-user chat? Or document collaboration? In classic frameworks and SPAs, these are the features we put off because of their difficulty and the code acrobatics needed to keep everyone’s states aligned. With HTML-over-the-wire, we’re just pushing tiny bits of HTML based on one user’s changes to <em>every other</em> <em>user</em> currently subscribed to the channel. They’ll see <em>exactly</em> the same thing as if they hit refresh and asked the server for the entire HTML page anew. And you can get those bits to every user in under 30ms.</p>
<p>We’re not throwing away the promise of components either. Where this WebSockets-based approach can be seen as a thick server/thin client, so too can our components. It’s fractal, baby! Make that component <em>do</em> delightful things for the user with smart JavaScript, and then just ask the server for updated HTML, and mutate the DOM. No need for a client-side data store to manage the component’s state since it’ll render itself to look <em>exactly like what the server knows it should look like now</em>. The HTML comes from the server, so no need for JSX or Handlebars or &lt;insert other JavaScript templating library here&gt;. The server is always in control: rendering the initial component’s appearance <em>and</em> updating it in response to any state change, all through the socket. </p>
<p>And there’s nothing saying you have to use those socket channels to send <em>only</em> HTML. Send a tiny bit of text, and have the client do something smart. Send a chat message from one user to every other user, and have their individual clients render that message in whatever app theme they’re currently using. Imagine the possibilities!</p>
<h2>But it’s complex/expensive/requires a bunch of new infrastructure, right?<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/the-future-of-web-software-is-html-over-websockets#section7">#section7</a></h2>
<p>Nope. Prominent open-source web servers support it natively, generally without needing any kind of extra configuration or setup. Many server-side frameworks will automatically ship the JS code to the client for native support in communicating over the socket. In Rails, for example, setting up your app to use WebSockets is as easy as configuring the built-in ActionCable and then deploying as usual on the same hardware you would have used otherwise. Anecdotally, the typical single Rails server process seems to be perfectly happy supporting nearly 4,000 active connections. And you can easily swap in the excellent <a href="https://docs.anycable.io">AnyCable</a> to bump that up to around 10,000+ connections per node by not relying on the built-in Ruby WebSocket server. Again, this is on the usual hardware you’d be running your web server on in the first place. You don’t need to set up any extra hardware or increase your cloud infrastructure.</p>
<p>This new approach is quickly appearing as extensions, libraries, or alternative configurations in a variety of languages and web frameworks, from Django’s <a href="https://sockpuppet.argpar.se">Sockpuppet</a> to Phoenix’s <a href="https://dockyard.com/blog/2018/12/12/phoenix-liveview-interactive-real-time-apps-no-need-to-write-javascript">LiveView</a> and beyond. Seriously, go dig around for WebSockets-based libraries for your favorite app framework and then step into a new way of thinking about your app architectures. Build something amazing and marvel at the glorious HTML bits zipping along on the socket, like jet fighters passing in the night. It’s more than a new technical approach; it’s a new mindset, and maybe even a new wellspring of key app features that will drive your startup success.</p>
<p>But I’d be remiss if I didn’t highlight for the reader <em>my</em> contender for Best Framework in a Leading Role. Sure, any app framework can adopt this approach, but for my money, there’s a strong case to be made that the vanguard could be Ruby on Rails. </p>
<h2>So we come back around to Rails, 15 years on from its launch…<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/the-future-of-web-software-is-html-over-websockets#section8">#section8</a></h2>
<p>Set up a Rails 6 app with the latest versions of <a href="https://github.com/turbolinks/turbolinks">Turbolinks</a>, <a href="https://stimulus.hotwire.dev">Stimulus</a>, <a href="https://docs.stimulusreflex.com">StimulusReflex</a>, <a href="https://cableready.stimulusreflex.com">CableReady</a>, and GitHub’s <a href="https://github.com/github/view_component">ViewComponent</a> gem, and you can be working with Reactive Rails in a way that simultaneously feels like building a classic Rails app <em>and</em> like building a modern, componentized SPA, in a single codebase, with all the benefits of server-side rendering, HTML fragment caching, easy SEO, rock-solid security, and the like. You’ll suddenly find your toolbelt bursting with straightforward tools to solve previously daunting challenges.</p>
<p>Oh, and with Turbolinks, you also get wrappers allowing for hybrid native/HTML UIs in the same codebase. Use a quick deploy solution like Heroku or Hatchbox, and one developer can build a responsive, reactive, multi-platform app in their spare time. Just see <a href="https://dev.to/julianrubisch/twitter-clone-with-stimulusreflex-gone-hybrid-native-app-17fm">this Twitter clone</a> if you don’t believe me. </p>
<p>OK, that all sounds exciting, but why Rails specifically? Isn’t it old and boring? You already said any framework can benefit from this new WebSocket, DOM-morphing approach, right? </p>
<p>Sure. But where Rails has always shined is in its ability to make rapid prototyping, well…<em>rapid</em>, and in its deep ecosystem of well-polished gems. Rails also hasn’t stopped pushing the envelope forward, with the latest version 6.1.3 of the framework boasting a ton of cool features. </p>
<p>If you’ve got a small, resource-strapped team, Rails (and Ruby outside of the framework) still serves as a potent force multiplier that lets you punch way above your weight, which probably explains the <a href="https://charliereese.ca/article/top-50-y-combinator-tech-startups">$92 billion in revenue it’s helped drive over the years</a>. With this new approach, there’s a <em>ton</em> more weight behind that punch. While your competitors are fiddling with their JSON serializers and struggling to optimize away all the loading spinners, you’re rolling out a new multi-user collaborative feature every week…or every <em>day</em>. </p>
<p>You win. Your fellow developers win. Your business wins. And, most importantly, your <em>users</em> win.</p>
<p>That’s what Rails promised from the day it was released to the community. That’s why Rails spawned so many imitators in other languages, and why it saw such explosive growth in the startup world for years. And that same old rapid prototyping spirit, married to this new HTML-over-the-wire approach, positions Rails for a powerful resurgence. </p>
<p>Ruby luminary and <a href="https://www.amazon.com/Obie-Fernandez/e/B001IGV0LS">author</a> of <em>The Ruby Way</em>, Obie Fernandez, <a href="https://medium.com/@obie/react-is-dead-long-live-reactive-rails-long-live-stimulusreflex-and-viewcomponent-cd061e2b0fe2">seems to think so</a>.</p>
<p>Heck, even <a href="https://www.youtube.com/watch?v=utxCm3uLhIE">Russ Hanneman thinks this approach with StimulusReflex is the new hotness</a>.</p>
<p>And the good folks over at Basecamp (creators of Rails in the first place), dropped their own take on the concept, <a href="https://hotwire.dev">Hotwire</a>, just in time for the 2020 holidays, so your options for tackling this new and exciting technique continue to expand.</p>
<p>Don’t call it a comeback, because Rails has been here for years. With this new architectural approach, brimming with HTML-over-WebSockets and full-duplex JavaScript interactions, Rails becomes something new, something beautiful, something that demands attention (again). </p>
<p>Reactive Rails, with StimulusReflex and friends, is a must-look for anyone exhausted from toiling with JSON endpoints or JSX, and I’m super excited to see the new crop of apps that it enables.</p>]]></description>
      <link>https://alistapart-production.mystagingwebsite.com/article/the-future-of-web-software-is-html-over-websockets/</link>
      <guid>https://alistapart-production.mystagingwebsite.com/article/the-future-of-web-software-is-html-over-websockets/</guid>
      <pubDate>Thu, 25 Feb 2021 16:00:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[Designing Inclusive Content Models]]></title>
      <description><![CDATA[<div class="entry-content">
<p>In the 1920s, Robert Moses designed a system of parkways surrounding New York City. His designs, which included overpasses too low for public buses, have become an often-cited example of exclusionary design and are argued by biographer Robert A. Caro to represent a purposeful barrier between the city’s Black and Puerto Rican residents and nearby beaches. </p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p><a href="https://www.bloomberg.com/news/articles/2017-07-09/robert-moses-and-his-racist-parkway-explained">Regardless of the details of Moses’s parkway project</a>, it’s a particularly memorable reminder of the political power of design and the ways that choices can exclude various groups based on abilities and resources. The growing interest in <a href="https://alistapart.com/article/building-the-woke-web/">inclusive design</a> highlights questions of who can participate, and in relation to the web, this has often meant a focus on accessibility and user experience, as well as on questions related to team diversity and governance. </p>
<p>But principles of inclusive design should also play a role early in the design and development process, during content modeling. Modeling defines what content objects consist of and, by extension, who will be able to create them. So if web professionals are interested in inclusion, we need to go beyond asking who can access content and also think about how the design of content can install barriers that make it difficult for some people to participate in creation. </p>
<p>Currently, content models are primarily seen as mirrors that reflect inherent structures in the world. But if the world is biased or exclusionary, this means our content models will be too. Instead, we need to approach content modeling as an opportunity to filter out harmful structures and create systems in which more people can participate in making the web. Content models designed for inclusivity welcome a variety of voices and can ultimately increase products’ diversity and reach.</p>
<h2 id="section2">Content models as mirrors<a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>Content models are tools for describing the objects that will make up a project, their attributes, and the possible relations between them. A content model for an art museum, for example, would typically describe, among other things, artists (including attributes such as name, nationality, and perhaps styles or schools), and artists could then be associated with artworks, exhibitions, etc. (The content model would also likely include objects like blog posts, but in this article we’re interested in how we model and represent objects that are “out there” in the real world, rather than content objects like articles and quizzes that live natively on websites and in apps.)</p>
<p>The common wisdom when designing content models is to go out and research the project’s subject domain by talking with subject matter experts and project stakeholders. As Mike Atherton and Carrie Hane describe the process in <em>Designing Connected Content</em>, talking with the people who know the most about a subject domain (like art in the museum example above) helps to reveal an “inherent” structure, and discovering or revealing that structure ensures that your content is complete and comprehensible.</p>
<p>Additional research might go on to investigate how a project’s end users understand a domain, but Atherton and Hane describe this stage as mostly about terminology and level of detail. End users might use a different word than experts do or care less about the nuanced distinctions between Fauvism and neo-Expressionism, but ultimately, everybody is talking about the same thing. A good content model is just a mirror that reflects the structure you find.  </p>
<h2 id="section3">Cracks in the mirrors<a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h2>
<p>The mirror approach works well in many cases, but there are times when the structures that subject matter experts perceive as inherent are actually the products of biased systems that quietly exclude. Like machine learning algorithms trained on <a href="https://www.insidehighered.com/admissions/article/2020/12/14/u-texas-will-stop-using-controversial-algorithm-evaluate-phd">past school admissions</a> or <a href="https://hbr.org/2019/05/all-the-ways-hiring-algorithms-can-introduce-bias">hiring decisions</a>, existing structures tend to work for some people and harm others. Rather than recreating these structures, content modelers should consider ways to improve them. </p>
<p>A basic example is LinkedIn’s choice to require users to specify a company when creating a new work experience. Modeling experience in this way is obvious to HR managers, recruiters, and most people who participate in conventional career paths, but it assumes that valuable experience is only obtained through companies, and could potentially discourage people from entering other types of experiences that would allow them to represent alternative career paths and shape their own stories.</p>
<figure id="figure1" class="wp-block-image size-large"><img width="716" height="362" src="https://alistapart.com/wp-content/uploads/2021/02/fig1.png?resize=716%2C362" alt="" class="wp-image-7172736" data-recalc-dims="1" /><figcaption><strong>Figure 1.</strong> LinkedIn’s current model for experience includes Company as a required attribute.</figcaption></figure><p>These kinds of mismatches between required content attributes and people’s experiences either create explicit barriers (“I can’t participate because I don’t know how to fill in this field”) or increase the labor required to participate (“It’s not obvious what I should put here, so I’ll have to spend time thinking of a workaround”). </p>
<p>Setting as optional fields that might not apply to everyone is one inclusive solution, as is increasing the available options for responses requiring a selection. However, while gender-inclusive choices provide <a href="https://alistapart.com/article/trans-inclusive-design/">an inclusive way to handle form inputs</a>, it’s also worth considering when business objectives would be met just as well by providing open text inputs that allow users to describe themselves in their own terms. </p>
<p>Instead of LinkedIn’s highly prescribed content, for example, Twitter bios’ lack of structure lets people describe themselves in more inclusive ways. Some people use the space to list formal credentials, while others provide alternate forms of identification (e.g., mother, cyclist, or coffee enthusiast) or jokes. Because the content is unstructured, there are fewer expectations about its use, taking pressure off those who don’t have formal credentials and giving more flexibility to those who do. </p>
<p>Browsing the Twitter bios of designers, for example, reveals a range of identification strategies, from listing credentials and affiliations to providing broad descriptions. </p>
<figure id="figure2" class="wp-block-image size-large"><img width="960" height="172" src="https://alistapart.com/wp-content/uploads/2021/02/fig2.png?resize=960%2C172" alt="" class="wp-image-7172737" data-recalc-dims="1" /><figcaption><strong>Figure 2.</strong> Veerle Pieters’s Twitter bio uses credentials, affiliations, and personal interests. <br /></figcaption></figure><figure id="figure3" class="wp-block-image size-large"><img width="960" height="141" src="https://alistapart.com/wp-content/uploads/2021/02/fig3.png?resize=960%2C141" alt="" class="wp-image-7172738" data-recalc-dims="1" /><figcaption><strong>Figure 3.</strong> Jason Santa Maria’s Twitter bio uses a broad description. <br /></figcaption></figure><figure id="figure4" class="wp-block-image size-large"><img width="960" height="141" src="https://alistapart.com/wp-content/uploads/2021/02/fig4.png?resize=960%2C141" alt="" class="wp-image-7172739" data-recalc-dims="1" /><figcaption><strong>Figure 4.</strong> Erik Spiekermann’s Twitter bio uses a single word.<br /></figcaption></figure><p>In addition to considering where structured content might exclude, content modelers should also consider how length guidelines can implicitly create barriers for content creators. In the following section, we look at a project in which we chose to reduce the length of contributor bios as a way to ensure that our content model didn’t leave anyone out. </p>
<h2 id="section4">Live in America<a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h2>
<p>Live in America is a performing arts festival scheduled to take place in October 2021 in Bentonville, Arkansas. The goal of the project is to survey the diversity of live performance from across the United States, its territories, and Mexico, and bring together groups of artists that represent distinct local traditions. Groups of performers will come from Alabama, Las Vegas, Detroit, and the border city of El Paso<strong>–</strong>Juárez. Indigineous performers from Albuquerque are scheduled to put on a queer powwow. Performers from Puerto Rico will organize a cabaret. </p>
<p>An important part of the festival’s mission is that many of the performers involved aren’t integrated into the world of large art institutions, with their substantial fiscal resources and social connections. Indeed, the project’s purpose is to locate and showcase examples of live performance that fly under curators’ radars and that, as a result of their lack of exposure, reveal what makes different communities truly unique. </p>
<p>As we began to think about content modeling for the festival’s website, these goals had two immediate consequences:</p>
<p>First, the idea of exploring the subject domain of live performance doesn’t exactly work for this project because the experts we might have approached would have told us about a version of the performing arts world that festival organizers were specifically trying to avoid. Experts’ mental models of performers, for example, might include attributes like residencies, fellowships and grants, curricula vitae and awards, artist statements and long, detailed bios. All of these attributes might be perceived as inherent or natural within one, homogenous community—but outside that community they’re not only a sign of misalignment, they represent barriers to participation.</p>
<p>Second, the purposeful diversity of festival participants meant that locating a shared mental model wasn’t the goal. Festival organizers want to preserve the diversity of the communities involved, not bring them all together or show how they’re the same. It’s important that people in Las Vegas think about performance differently than people in Alabama and that they structure their projects and working relationships in distinct ways. </p>
<p>Content modeling for Live in America involved defining what a community is, what a project is, and how these are related. But one of the most interesting challenges we faced was how to model a person—what attributes would stand in for the people that would make the event possible. </p>
<p>It was important that we model participants in a way that preserved and highlighted diversity and also in a way that included everyone—that let everyone take part in their own way and that didn’t overburden some people or ask them to experience undue anxiety or perform extra work to make themselves fit within a model of performance that didn’t match their own. </p>
<p>Designing an inclusive content model for Live in America meant thinking hard about what a bio would look like. Some participants come from the institutionalized art world, where bios are long and detailed and often engage in intricate and esoteric forms of credentialing. Other participants create art but don’t have the same resources. Others are just people who were chosen to speak for and about their communities: writers, chefs, teachers, and musicians. </p>
<p>The point of the project is to highlight both performance that has not been recognized and the people who have not been recognized for making it. Asking for a written form that has historically been built around institutional recognition would only highlight the hierarchies that festival organizers want to leave behind.</p>
<p>The first time we brought up the idea of limiting bios to five words, our immediate response was, “Can we get away with that?” Would some artists balk at not being allowed the space to list their awards? It’s a ridiculously simple idea, but it also gets at the heart of content modeling: what are the things and how do we describe them? What are the formats and limitations that we put on the content that would be submitted to us? What are we asking of the people who will write the content? How can we configure the rules so that everyone can participate?</p>
<p>Five-word bios place everyone on the same ground. They ask everyone to create something new but also manageable. They’re comparable. They set well-known artists next to small-town poets, and let them play together. They let in diverse languages, but keep out the historical structures that set people apart. They’re also fun:</p>
<ul><li>Byron F. Aspaas of Albuquerque is “Diné. Táchii’nii nishłį́ Tódichii’nii bashishchiin.”</li>
<li>Danny R.W. Baskin of Northwest Arkansas is “Baroque AF but eating well.”</li>
<li>Brandi Dobney of New Orleans is “Small boobs, big dreams.”</li>
<li>Imani Mixon of Detroit is “best dresser, dream catcher, storyteller.”</li>
<li>Erika P. Rodríguez of Puerto Rico is “Anti-Colonialist Photographer. Caribeña. ♡ Ice Cream.”</li>
<li>David Dorado Romo of El Paso<strong>–</strong>Juárez is “Fonterizo historian wordsmith saxophonist glossolalian.”</li>
<li>Mikayla Whitmore of Las Vegas is “hold the mayo, thank you.”</li>
<li>Mary Zeno of Alabama is “a down home folk poet.”</li>
</ul><h2 id="section5">Modeling for inclusion<a class="subhead-anchor" href="https://alistapart.com#section5">#section5</a></h2>
<p>We tend to think of inclusive design in terms of removing barriers to access, but content modeling also has an important role to play in ensuring that the web is a place where there are fewer barriers to creating content, especially for people with diverse and underrepresented backgrounds. This might involve rethinking the use of structured content or asking how length guidelines might create burdens for some people. But regardless of the tactics, designing inclusive content models begins by acknowledging the political work that these models perform and asking whom they include or exclude from participation. </p>
<p>All modeling is, after all, the creation of a world. Modelers establish what things exist and how they relate to each other. They make some things impossible and others so difficult that they might as well be. They let some people in and keep others out. Like overpasses that prevent public buses from reaching the beach, exclusionary models can quietly shape the landscape of the web, exacerbating the existing lack of diversity and making it harder for those who are already underrepresented to gain entry.</p>
<p>As discussions of inclusive design continue to gain momentum, content modeling should play a role precisely because of the world-building that is core to the process. If we’re building worlds, we should build worlds that let in as many people as possible. To do this, our discussions of content modeling need to include an expanded range of metaphors that go beyond just mirroring what we find in the world. We should also, when needed, filter out structures that are harmful or exclusionary. We should create spaces that ask the same of everyone and that use the generativity of everyone’s responses to create web products that emerge out of more diverse voices.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Successful design requires buy-in from the top. Ben Callahan shows how to convince executives not just to fund the initial push of design system work, but to keep funding it.</div><div class="entry-content">How to be human, build trust, and sustain relationships with our design and development clients and partners.</div><div class="entry-content">In this excerpt from World Wide Waste, Gerry McGovern examines the environmental impact of bloated websites and unnecessary assets.</div><div class="entry-content">In this excerpt from Creative Culture, Justin Dauer walks us through many ways in which an organizations’ culture and the design work that it does play off of one another.</div><div class="entry-content">Amy Bucher shares insights into using personalization to create meaningful user experiences.</div>]]></description>
      <link>https://alistapart.com/article/designing-inclusive-content-models/</link>
      <guid>https://alistapart.com/article/designing-inclusive-content-models/</guid>
      <pubDate>Thu, 18 Feb 2021 16:00:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[Designing Inclusive Content Models]]></title>
      <description><![CDATA[<p>In the 1920s, Robert Moses designed a system of parkways surrounding New York City. His designs, which included overpasses too low for public buses, have become an often-cited example of exclusionary design and are argued by biographer Robert A. Caro to represent a purposeful barrier between the city’s Black and Puerto Rican residents and nearby beaches. </p><div class="aside-breaker">Article Continues Below</div>
<p><a href="https://www.bloomberg.com/news/articles/2017-07-09/robert-moses-and-his-racist-parkway-explained">Regardless of the details of Moses’s parkway project</a>, it’s a particularly memorable reminder of the political power of design and the ways that choices can exclude various groups based on abilities and resources. The growing interest in <a href="https://alistapart-production.mystagingwebsite.com/article/building-the-woke-web/">inclusive design</a> highlights questions of who can participate, and in relation to the web, this has often meant a focus on accessibility and user experience, as well as on questions related to team diversity and governance. </p>
<p>But principles of inclusive design should also play a role early in the design and development process, during content modeling. Modeling defines what content objects consist of and, by extension, who will be able to create them. So if web professionals are interested in inclusion, we need to go beyond asking who can access content and also think about how the design of content can install barriers that make it difficult for some people to participate in creation. </p>
<p>Currently, content models are primarily seen as mirrors that reflect inherent structures in the world. But if the world is biased or exclusionary, this means our content models will be too. Instead, we need to approach content modeling as an opportunity to filter out harmful structures and create systems in which more people can participate in making the web. Content models designed for inclusivity welcome a variety of voices and can ultimately increase products’ diversity and reach.</p>
<h2>Content models as mirrors<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/designing-inclusive-content-models#section2">#section2</a></h2>
<p>Content models are tools for describing the objects that will make up a project, their attributes, and the possible relations between them. A content model for an art museum, for example, would typically describe, among other things, artists (including attributes such as name, nationality, and perhaps styles or schools), and artists could then be associated with artworks, exhibitions, etc. (The content model would also likely include objects like blog posts, but in this article we’re interested in how we model and represent objects that are “out there” in the real world, rather than content objects like articles and quizzes that live natively on websites and in apps.)</p>
<p>The common wisdom when designing content models is to go out and research the project’s subject domain by talking with subject matter experts and project stakeholders. As Mike Atherton and Carrie Hane describe the process in <em>Designing Connected Content</em>, talking with the people who know the most about a subject domain (like art in the museum example above) helps to reveal an “inherent” structure, and discovering or revealing that structure ensures that your content is complete and comprehensible.</p>
<p>Additional research might go on to investigate how a project’s end users understand a domain, but Atherton and Hane describe this stage as mostly about terminology and level of detail. End users might use a different word than experts do or care less about the nuanced distinctions between Fauvism and neo-Expressionism, but ultimately, everybody is talking about the same thing. A good content model is just a mirror that reflects the structure you find.  </p>
<h2>Cracks in the mirrors<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/designing-inclusive-content-models#section3">#section3</a></h2>
<p>The mirror approach works well in many cases, but there are times when the structures that subject matter experts perceive as inherent are actually the products of biased systems that quietly exclude. Like machine learning algorithms trained on <a href="https://www.insidehighered.com/admissions/article/2020/12/14/u-texas-will-stop-using-controversial-algorithm-evaluate-phd">past school admissions</a> or <a href="https://hbr.org/2019/05/all-the-ways-hiring-algorithms-can-introduce-bias">hiring decisions</a>, existing structures tend to work for some people and harm others. Rather than recreating these structures, content modelers should consider ways to improve them. </p>
<p>A basic example is LinkedIn’s choice to require users to specify a company when creating a new work experience. Modeling experience in this way is obvious to HR managers, recruiters, and most people who participate in conventional career paths, but it assumes that valuable experience is only obtained through companies, and could potentially discourage people from entering other types of experiences that would allow them to represent alternative career paths and shape their own stories.</p>
<figure class="wp-block-image size-large"><img width="716" height="362" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/02/fig1.png" alt="" class="wp-image-7172736" /><figcaption><strong>Figure 1.</strong> LinkedIn’s current model for experience includes Company as a required attribute.</figcaption></figure><p>These kinds of mismatches between required content attributes and people’s experiences either create explicit barriers (“I can’t participate because I don’t know how to fill in this field”) or increase the labor required to participate (“It’s not obvious what I should put here, so I’ll have to spend time thinking of a workaround”). </p>
<p>Setting as optional fields that might not apply to everyone is one inclusive solution, as is increasing the available options for responses requiring a selection. However, while gender-inclusive choices provide <a href="https://alistapart-production.mystagingwebsite.com/article/trans-inclusive-design/">an inclusive way to handle form inputs</a>, it’s also worth considering when business objectives would be met just as well by providing open text inputs that allow users to describe themselves in their own terms. </p>
<p>Instead of LinkedIn’s highly prescribed content, for example, Twitter bios’ lack of structure lets people describe themselves in more inclusive ways. Some people use the space to list formal credentials, while others provide alternate forms of identification (e.g., mother, cyclist, or coffee enthusiast) or jokes. Because the content is unstructured, there are fewer expectations about its use, taking pressure off those who don’t have formal credentials and giving more flexibility to those who do. </p>
<p>Browsing the Twitter bios of designers, for example, reveals a range of identification strategies, from listing credentials and affiliations to providing broad descriptions. </p>
<figure class="wp-block-image size-large"><img width="1196" height="214" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/02/fig2.png?resize=1024,183" alt="" class="wp-image-7172737" /><figcaption><strong>Figure 2.</strong> Veerle Pieters’s Twitter bio uses credentials, affiliations, and personal interests. <br /></figcaption></figure><figure class="wp-block-image size-large"><img width="1196" height="176" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/02/fig3.png?resize=1024,151" alt="" class="wp-image-7172738" /><figcaption><strong>Figure 3.</strong> Jason Santa Maria’s Twitter bio uses a broad description. <br /></figcaption></figure><figure class="wp-block-image size-large"><img width="1200" height="176" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/02/fig4.png?resize=1024,150" alt="" class="wp-image-7172739" /><figcaption><strong>Figure 4.</strong> Erik Spiekermann’s Twitter bio uses a single word.<br /></figcaption></figure><p>In addition to considering where structured content might exclude, content modelers should also consider how length guidelines can implicitly create barriers for content creators. In the following section, we look at a project in which we chose to reduce the length of contributor bios as a way to ensure that our content model didn’t leave anyone out. </p>
<p>Live in America is a performing arts festival scheduled to take place in October 2021 in Bentonville, Arkansas. The goal of the project is to survey the diversity of live performance from across the United States, its territories, and Mexico, and bring together groups of artists that represent distinct local traditions. Groups of performers will come from Alabama, Las Vegas, Detroit, and the border city of El Paso<strong>–</strong>Juárez. Indigineous performers from Albuquerque are scheduled to put on a queer powwow. Performers from Puerto Rico will organize a cabaret. </p>
<p>An important part of the festival’s mission is that many of the performers involved aren’t integrated into the world of large art institutions, with their substantial fiscal resources and social connections. Indeed, the project’s purpose is to locate and showcase examples of live performance that fly under curators’ radars and that, as a result of their lack of exposure, reveal what makes different communities truly unique. </p>
<p>As we began to think about content modeling for the festival’s website, these goals had two immediate consequences:</p>
<p>First, the idea of exploring the subject domain of live performance doesn’t exactly work for this project because the experts we might have approached would have told us about a version of the performing arts world that festival organizers were specifically trying to avoid. Experts’ mental models of performers, for example, might include attributes like residencies, fellowships and grants, curricula vitae and awards, artist statements and long, detailed bios. All of these attributes might be perceived as inherent or natural within one, homogenous community—but outside that community they’re not only a sign of misalignment, they represent barriers to participation.</p>
<p>Second, the purposeful diversity of festival participants meant that locating a shared mental model wasn’t the goal. Festival organizers want to preserve the diversity of the communities involved, not bring them all together or show how they’re the same. It’s important that people in Las Vegas think about performance differently than people in Alabama and that they structure their projects and working relationships in distinct ways. </p>
<p>Content modeling for Live in America involved defining what a community is, what a project is, and how these are related. But one of the most interesting challenges we faced was how to model a person—what attributes would stand in for the people that would make the event possible. </p>
<p>It was important that we model participants in a way that preserved and highlighted diversity and also in a way that included everyone—that let everyone take part in their own way and that didn’t overburden some people or ask them to experience undue anxiety or perform extra work to make themselves fit within a model of performance that didn’t match their own. </p>
<p>Designing an inclusive content model for Live in America meant thinking hard about what a bio would look like. Some participants come from the institutionalized art world, where bios are long and detailed and often engage in intricate and esoteric forms of credentialing. Other participants create art but don’t have the same resources. Others are just people who were chosen to speak for and about their communities: writers, chefs, teachers, and musicians. </p>
<p>The point of the project is to highlight both performance that has not been recognized and the people who have not been recognized for making it. Asking for a written form that has historically been built around institutional recognition would only highlight the hierarchies that festival organizers want to leave behind.</p>
<p>The first time we brought up the idea of limiting bios to five words, our immediate response was, “Can we get away with that?” Would some artists balk at not being allowed the space to list their awards? It’s a ridiculously simple idea, but it also gets at the heart of content modeling: what are the things and how do we describe them? What are the formats and limitations that we put on the content that would be submitted to us? What are we asking of the people who will write the content? How can we configure the rules so that everyone can participate?</p>
<p>Five-word bios place everyone on the same ground. They ask everyone to create something new but also manageable. They’re comparable. They set well-known artists next to small-town poets, and let them play together. They let in diverse languages, but keep out the historical structures that set people apart. They’re also fun:</p>
<ul><li>Byron F. Aspaas of Albuquerque is “Diné. Táchii’nii nishłį́ Tódichii’nii bashishchiin.”</li>
<li>Danny R.W. Baskin of Northwest Arkansas is “Baroque AF but eating well.”</li>
<li>Brandi Dobney of New Orleans is “Small boobs, big dreams.”</li>
<li>Imani Mixon of Detroit is “best dresser, dream catcher, storyteller.”</li>
<li>Erika P. Rodríguez of Puerto Rico is “Anti-Colonialist Photographer. Caribeña. ♡ Ice Cream.”</li>
<li>David Dorado Romo of El Paso<strong>–</strong>Juárez is “Fonterizo historian wordsmith saxophonist glossolalian.”</li>
<li>Mikayla Whitmore of Las Vegas is “hold the mayo, thank you.”</li>
<li>Mary Zeno of Alabama is “a down home folk poet.”</li>
</ul><h2>Modeling for inclusion<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/designing-inclusive-content-models#section5">#section5</a></h2>
<p>We tend to think of inclusive design in terms of removing barriers to access, but content modeling also has an important role to play in ensuring that the web is a place where there are fewer barriers to creating content, especially for people with diverse and underrepresented backgrounds. This might involve rethinking the use of structured content or asking how length guidelines might create burdens for some people. But regardless of the tactics, designing inclusive content models begins by acknowledging the political work that these models perform and asking whom they include or exclude from participation. </p>
<p>All modeling is, after all, the creation of a world. Modelers establish what things exist and how they relate to each other. They make some things impossible and others so difficult that they might as well be. They let some people in and keep others out. Like overpasses that prevent public buses from reaching the beach, exclusionary models can quietly shape the landscape of the web, exacerbating the existing lack of diversity and making it harder for those who are already underrepresented to gain entry.</p>
<p>As discussions of inclusive design continue to gain momentum, content modeling should play a role precisely because of the world-building that is core to the process. If we’re building worlds, we should build worlds that let in as many people as possible. To do this, our discussions of content modeling need to include an expanded range of metaphors that go beyond just mirroring what we find in the world. We should also, when needed, filter out structures that are harmful or exclusionary. We should create spaces that ask the same of everyone and that use the generativity of everyone’s responses to create web products that emerge out of more diverse voices.</p>]]></description>
      <link>https://alistapart-production.mystagingwebsite.com/article/designing-inclusive-content-models/</link>
      <guid>https://alistapart-production.mystagingwebsite.com/article/designing-inclusive-content-models/</guid>
      <pubDate>Thu, 18 Feb 2021 16:00:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[The Never-Ending Job of Selling Design Systems]]></title>
      <description><![CDATA[<div class="entry-content">
<p>I’m willing to bet that you probably didn’t start your web career because you wanted to be a politician or a salesperson. But here’s the cold, hard truth, friend: if you want to work on design systems, you don’t have a choice. Someone has to pay for your time, and that means someone has to sell what you do to an audience that speaks value in an entirely different language. </p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>It’s not exactly easy to connect the benefits of a design system directly to revenue. With an ecomm site, you can add a feature and measure the impact. With other conversion-based digital experiences, if your work is good, your customers will convert more. But because a design system is (usually) an internal tool, it’s just harder to connect those dots. </p>
<p>This article boils down the methods I’ve put into practice convincing executives not just to fund the initial push of design system work, but to <em>keep funding it</em>. I’ll share how I’ve adjusted the language I use to describe common design system benefits, allowing me to more clearly communicate with decision makers.</p>
<h2 id="section2">Know your audience<a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>In my experience, design systems can be owned by information technology teams, marketing and communications departments, or (best case scenario) cross-disciplinary teams that bring many specialists together. The first thing you need to do is determine where the system lives, as in which department owns and cares for it. </p>
<p>If it’s part of IT, for example, you need to think like a CIO or an IT Director and speak to their objectives and values. These leaders are typically more <em>internally</em> focused; they’ll filter the value of the design system in terms of the employees of the company. In contrast, if the system belongs to Marketing, put on your CMO or Marketing Director hat. Marketing teams are often <em>externally</em> focused; they think in terms of B2B audiences and end users. </p>
<p>The way organizations structure the ownership of a design system can be more complex, but let’s use these two paths (internal vs external) as frameworks for building a persuasive case for those owners.</p>
<h2 id="section3">Internal-orientation motivators<a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h2>
<p><a href="https://designsystemssurvey.seesparkbox.com/2020/">Based on the research we’ve done since 2018</a>, there are three very specific internal motivators for having a design system:</p>
<ul><li>Efficiency</li>
<li>Onboarding</li>
<li>Scale.</li>
</ul><h3 id="section4">Efficiency benefit<a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h3>
<p>Design systems allow for the rapid prototyping of new ideas using existing, production-ready components. They allow teams to reuse design and code, and they allow individuals to focus their creative energy on new problems instead of wasting it on old ones. Executives and decision-makers may abstractly understand all that, but you need to be able to tell them what it will take to realize the efficiency benefit. </p>
<p>There’s a theoretical maximum to how productive a team can be. When you talk about a design system creating more efficiency in your processes, you’re really talking about raising the ceiling on that max. As happens with so many things in life, though, that comes with a trade-off. Early on, while a team is actually building the system, they won’t be as productive on the rest of their work.</p>
<p>The efficiency curve looks like this:</p>
<figure id="figure1" class="wp-block-image size-large"><img width="960" height="540" src="https://alistapart.com/wp-content/uploads/2021/02/ala-ds-efficiency-1-e1612891151253.png?w=960&amp;resize=960%2C540" alt="The Design System Efficiency Curve. Line graph illustrating the curvilinear relationship of productivity over time in terms of overall efficiency, in situations of transition from having no design system in place through in-process set up of the system, to eventually having an established design system. Productivity is represented on the y-axis and Time on the x-axis. Starting at 0,0 productivity dips down as the team diverts resources to set up the system, but eventually surpasses standard productivity once the system is in place." class="wp-image-7172722" data-recalc-dims="1" /><figcaption><em><strong>Figure 1.</strong> With Productivity on the y-axis and Time on the x-axis, the Design System Efficiency Curve dips down at the start as the team ramps up on the system, but eventually surpasses standard productivity once the system is in place.</em></figcaption></figure><p>If you’re talking to an executive, it’s important to acknowledge this dip in productivity. </p>
<p>Spend some time working out these specific calculations for your organization. For example, you might need four team members for three months to reach a point where the system will save everyone on the team approximately two hours per week. You’re candidly acknowledging the necessary investment while demonstrating the eventual benefits. And make sure to mention that the productivity benefits will continue indefinitely! The math will almost always end up on your side. </p>
<p>Another critical point to raise is that simply having a design system has a cumulative effect on the efficiency of your teams. Since the system is an internal tool that can be used 1) across multiple products or experiences, 2) by many teams throughout the organization, and 3) in many phases of the product design and development process, you are gaining efficiencies on many levels. </p>
<p>The team working on in-store kiosks can build their interface with a well-tested set of components. Your UX people can use the system to prototype and test with production-ready code. The people responsible for grooming the backlog know there is a stable pattern library upon which they are building new features or fixing old ones. Anyone looking for answers to what, why, or how your organization designs and builds products will find those answers in the living system.</p>
<p>The efficiency at each of these (and many other) decision points is how we can raise the ceiling on our <em>total</em> possible efficiency. How this plays out is very different in each organization. I’m here to tell you that part of the work is thinking about how a design system will impact <em>every</em> part of your process—not just design or development.</p>
<h4 id="section5">What to measure<a class="subhead-anchor" href="https://alistapart.com#section5">#section5</a></h4>
<p><strong><em>Action: Measure the cost of productivity with and without a design system.</em></strong></p>
<p>If you aren’t already, start measuring how productive your team is now. The easiest way to do this is to break your team’s work down into measurable cycles. Once you have a rough idea of how much you can get done in a cycle of work, you’ll be able to compare your efficiency before the system was in place with your efficiency after. This kind of measurable benefit will speak volumes to your executive team.</p>
<h3 id="section6">Onboarding benefits<a class="subhead-anchor" href="https://alistapart.com#section6">#section6</a></h3>
<p>Growth is expensive. When you hire a new team member, you don’t just supply a salary and benefits. You need a computer, a desk, a chair, accounts to all the software/services…the list goes on. And all these expenses hit before your new employee is a fully contributing member of the team. You won’t start to recoup your investment for a few months, at least. </p>
<p>Design systems can reduce the time it takes your new hire to become a productive contributor. Once you have a healthy design system in place, you’re able to provide an employee with a clearly-defined and effective toolset that is well-documented and can be applied across multiple initiatives. More specifically, assigning new hires to start out working on the design system team will allow them to quickly learn how your organization designs and builds digital products.</p>
<figure id="figure2" class="wp-block-image size-large"><img width="960" height="540" src="https://alistapart.com/wp-content/uploads/2021/02/ala-ds-onboarding-e1612891563971.png?w=960&amp;resize=960%2C540" alt="Onboarding Model. Diagram illustrating the movement and eventual cycling (depicted by arrows pointing to the right) of individuals in a &quot;Hiring Pool&quot;(represented by a cluster of dots on the left of the graphic) into the DS Team (design system team), represented by a diamond shape in the center of the graphic, then exiting the DS Team to join Other Teams (smaller diamond shapes on the right of the graphic), and finally, back into the DS Team (dashed-line arrow looping below and to the left, back into the DS Team diamond shape)." class="wp-image-7172723" data-recalc-dims="1" /><figcaption><em><strong>Figure 2.</strong> A Model for Onboarding</em>. <em>As you bring people into your organization from your hiring pool, consider having them start on your design system team and then rotate out onto other teams. As you grow, folks who haven’t had a turn on the system team can rotate in as well.</em></figcaption></figure><p>On the left in <strong>Fig. 2</strong>, you have a pool of potential employees. As you hire individuals, you can bring them into the design system team, where they’ll gain a deep understanding of how your organization builds digital products. Once they’re up to speed, you can seamlessly move them to another product, discipline, or feature-based team where they’ll take this knowledge and hit the ground running. Additionally, your organization can benefit from having all team members (even those who have been around for a while) periodically work a rotation with the design system team. This continuously spreads the design systemexpertise around the organization and makes it part of the fabric of how you work.</p>
<p>And don’t think this approach is only valuable for designers or developers. A healthy design system team comprises people from many disciplines. In addition to team member rotation, building in time to mentor folks from many different disciplines can prove tremendously valuable in the long run. A highly functional design system team can serve as an ideal model of workflow and can educate many team members dispersed throughout the organization about how to approach their work.</p>
<p>Believe me, executives’ eyes will light up when you share how a design system can ensure high productivity in record time. As a caution, though, rotating people in and out of any team <em>too</em> often can leave them feeling exhausted and can make it hard for them to be productive. Remember, you have the flexibility to scale this to a level that makes sense for your team. Be smart and use this approach as it works in your context.</p>
<h4 id="section7">What to measure<a class="subhead-anchor" href="https://alistapart.com#section7">#section7</a></h4>
<p><strong><em>Action: Measure the time it takes for teams to become productive.</em></strong></p>
<p>As new people are added, a team typically returns to the “forming” stage of <a href="https://en.wikipedia.org/wiki/Tuckman%27s_stages_of_group_development">Tuckman’s stages of group development</a>. This is part of the reason that growth is expensive. But with a design system in place and a healthy culture, you can reduce the time it takes the team to get back to “performing.”</p>
<h3 id="section8">Scale benefits<a class="subhead-anchor" href="https://alistapart.com#section8">#section8</a></h3>
<p>Traditionally, you have to hire more people to scale productivity. A design system enables a team to accomplish more with less. <a href="https://designsystemssurvey.seesparkbox.com/2019/#table3a">Reusability is a major reason</a> teams choose to work in a more systematic way. Small teams with an effective system can design, build, and maintain hundreds of sites each year. They’d never come close without a design system to work with. </p>
<p>UX Pin has a <a href="https://www.uxpin.com/create-design-system-guide/">design system guide</a> that starts by acknowledging something that most of us ignore.</p>
<blockquote class="wp-block-quote">
<p>Scaling design through hiring, without putting standards in place, is a myth. With every new hire, new ideas for color palettes, typography and patterns appear in the product, growing the inconsistency and increasing the maintenance cost. Every new hire increases the design entropy<em>.</em></p>
</blockquote>
<p>A well-executed system allows a team to scale while keeping design entropy at bay.</p>
<h4 id="section9">What to measure<a class="subhead-anchor" href="https://alistapart.com#section9">#section9</a></h4>
<p><strong><em>Action: Compare the amount of people on your team to the amount of work they are accomplishing.</em></strong></p>
<p>Adding people to a team doesn’t necessarily mean they’ll get more work done faster. This is well-documented in historical software books like Fred Brooks’ <a href="https://en.wikipedia.org/wiki/The_Mythical_Man-Month#The_mythical_man-month"><em>The Mythical Man-Month</em></a>. Eventually, you will have to investigate changing other factors (besides just adding more people) to increase productivity. A good design system can be one of these factors that increases the productivity of the team members you already have. It’s this change in productivity over scale that you need to measure and compare in order to prove value for this benefit.</p>
<h2 id="section10">External-orientation motivators<a class="subhead-anchor" href="https://alistapart.com#section10">#section10</a></h2>
<p>Let’s shift to thinking about the benefits that a design system offers to end-users. The four primary external motivators are:</p>
<ul><li>Consistency</li>
<li>Trust</li>
<li>Accessibility</li>
<li>Usability.</li>
</ul><h3 id="section11">Consistency and Trust benefits<a class="subhead-anchor" href="https://alistapart.com#section11">#section11</a></h3>
<p>Consistency is widely assumed to be the primary benefit of a design system. We identify dozens of button designs, color variations, and inconsistent typefaces in hopes of convincing higher-ups to allow us to build a system to bring it all in line. After working on design systems for the last five or six years, I can say with confidence that a design system will not make your product more consistent. </p>
<p>You see, us web designers and developers are very scrappy. We can create the most inconsistent experiences within even the most rigid systems. It’s not the system itself that creates consistency, it’s the culture of an organization. It’s all of the unspoken expectations—the filters through which we make decisions—that give us the confidence to pause and ask if the work we’re doing fits <em>culturally</em> with the product we’re building. A good CMO knows this, and they won’t buy the oversimplified idea that a design system will solve the rampant inconsistencies in our work. </p>
<p>Because of this, these executives often have a different (and easier to measure) question: “Does it convert?” This perspective and line of conversation is not an ideal approach. Believe me, we can create experiences that convert but are not good for our users or our brands. Given this, a conversation with your CMO might go better if you <a href="https://alistapart.com/article/being-real-builds-trust/">shift the language to talk about trust</a> instead.</p>
<p>With inconsistent experiences, your <a href="https://www.nngroup.com/articles/omnichannel-consistency/">users subconsciously lose trust</a> in your brand. They’ve been conditioned to expect a certain kind of user experience, and that’s what they should be given, even across multiple websites or products. Vanessa Mitchell wrote about <a href="https://www.cmo.com.au/article/642102/why-customer-trust-more-vital-brand-survival-than-it-ever-been/">why brand trust is more vital to survival now</a> than it’s ever been:</p>
<blockquote class="wp-block-quote">
<p>“Brand trust as an ‘“insurance policy”’ against future issues is not a new concept. Most organizations know trust bestowed by the consumer can not only make or break a business, it can also ensure you survive a problem in the future. But few achieve brand trust adequately, preferring to pay lip service rather than delve into what it really means: Authentically caring about customers and their needs.”</p>
</blockquote>
<p>When your customer is using your product to accomplish a very specific task, <em>that one task is the only thing that matters to them.</em> Creating a consistent experience that works for everyone and allows them to accomplish their goals <em>is</em> building trust. CMOs need to understand how design systems empower trusted relationships so those relationships contribute to your bottom line.</p>
<h4 id="section12">What to measure<a class="subhead-anchor" href="https://alistapart.com#section12">#section12</a></h4>
<p><strong><em>Action: Measure the engagement of your customers.</em></strong></p>
<p>Customer engagement can be measured with web analytics platforms. What you’re looking for will vary depending on the context for your organization, but trends in things like time on site, visit frequency, subscription rates, and bounce rates will give you meaningful data to work with. It’s also very common to track customer engagement with metrics like <a href="https://en.wikipedia.org/wiki/Net_Promoter">Net Promoter Score</a> (NPS) by asking simple questions of customers repeatedly over time. There are so many ways to structure tests of the usability of your work, so I’d encourage you to loop in the UX team to help you find tests that will demonstrate the user engagement success of the design system effort.</p>
<h3 id="section13">Accessibility benefits<a class="subhead-anchor" href="https://alistapart.com#section13">#section13</a></h3>
<p>Accessibility can be a tremendous benefit of a design system. Do the work properly the first time, then allow that beautifully accessible component to serve your customers each time it is used. Certainly, it’s not a fail-safe measure—there is still integration-level testing to ensure component accessibility translates to the larger experience—but ensuring the accessibility of individual components will result in more accessible experiences. And integrating good accessibility practices into your system means more folks within your organization are aligned with this important work. </p>
<p>You might find at first that marketers aren’t all that interested in accessibility, but they should be. Did you know that there were 814 <a href="https://blog.usablenet.com/2018-ada-web-accessibility-lawsuit-recap-report">web accessibility related lawsuits</a> (just in the US!) in 2017? Did you know that there were almost 2,300 in 2018? That’s a <strong>181% increase</strong>. <a href="https://www.census.gov/newsroom/releases/archives/miscellaneous/cb12-134.html">This must be a priority</a>. First, because it’s the right thing to do. Second, because it’s important to the sustainability of the business. A design system can help you address this issue, <em>and</em> it can help you maintain compliance as you grow. This is the kind of message that resonates with leadership.</p>
<h4 id="section14">What to Measure<a class="subhead-anchor" href="https://alistapart.com#section14">#section14</a></h4>
<p><strong><em>Action: Measure your compliance to accessibility guidelines over time.</em></strong></p>
<p>Many organizations have a regular cadence of accessibility audits across their digital properties. While some of this can be automated, there’s always a manual aspect needed to truly evaluate the accessibility of a site or application. Tracking how often regressions occur in the properties served by your design system can be a great way to demonstrate the value that system is bringing to the organization.</p>
<h3 id="section15">Usability benefits<a class="subhead-anchor" href="https://alistapart.com#section15">#section15</a></h3>
<p>As with so many aspects of a design system, usability benefits come from repetition. Design system pros often hope to focus energy on solving a usability challenge <em>only once</em> before moving on to the next problem. This absolutely is a benefit of a well-constructed system. It’s also very true that “familiarity breeds usability.” Your customers will learn to use your products and begin to subconsciously rely on that familiarity with the experience to lower their cognitive load. This should be just as important to our executive leadership as it is to those of us who are practitioners. </p>
<p>You can also reframe this benefit in the context of conversion. Helping our users accomplish their goals is helping them convert. They are there to use your product. So make it easy to do, and they’ll do it more. This is what businesses need and what executives want to see—improving the business by helping customers. As mentioned above, we want to make sure we’re doing this in healthy ways for both our users and our brands.</p>
<h4 id="section16">What to Measure<a class="subhead-anchor" href="https://alistapart.com#section16">#section16</a></h4>
<p><strong><em>Action: This might be the easiest one—measure conversion!</em></strong></p>
<p>Running usability studies will help to validate and measure the success of your work with the system, which many organizations are already doing. Your goal should be to validate that components are usable, which will allow you to build a culture of user-centered design. Setting the bar for what it takes to evolve the system—such as requiring that changes are tested with real users—introduces this idea into the core of all your processes, where it should be.</p>
<h2 id="section17">Sell investment, not cost<a class="subhead-anchor" href="https://alistapart.com#section17">#section17</a></h2>
<p>Knowing how and which internal and external motivators to touch on during conversations is significant, but there’s one last thing I’d like to mention, and it has to do with your way of thinking. A major factor in many of these conversations lies simply in how we frame things: move the conversation about the cost of building a design system into a conversation about the present and residual benefits of the investment you’re making. It’s easy to view the time and effort required to build a system as an investment in ultimately delivering high-quality digital products. But leadership will be more willing to consider realistic budgets and timelines if you talk about it like a long-term investment that has benefits on multiple levels throughout the business. This also leaves you with the ability to regularly remind them that this product will never be done—it will require ongoing funding and support.</p>
<p>A design system project will not succeed if you don’t convince others that it’s the right thing to do. Successful, sustainable design systems start with the people, so you have to begin by building consensus. Building a design system means you’re asking everyone to change how they work—everyone has to be on board.</p>
<p>This concept of collaboration is so core to the work of design systems that it led all of us here at Sparkbox to look for opportunities to better understand how teams around the world are designing, building, and using a more systematic approach to digital product design. For the last three years, we’ve been gathering and sharing data in the form of the <a href="https://designsystemssurvey.seesparkbox.com/2020/">Design Systems Survey</a> and the <a href="https://seesparkbox.com/foundry/calendar_for_design_system_support_and_sucessful_design_systems">Design System Calendar</a>. If you are considering a design system for your organization, or if you work with a design system team, the survey and calendar may be helpful in your quest to build better products.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">How to be human, build trust, and sustain relationships with our design and development clients and partners.</div><div class="entry-content">In this excerpt from World Wide Waste, Gerry McGovern examines the environmental impact of bloated websites and unnecessary assets.</div><div class="entry-content">In this excerpt from Creative Culture, Justin Dauer walks us through many ways in which an organizations’ culture and the design work that it does play off of one another.</div><div class="entry-content">Amy Bucher shares insights into using personalization to create meaningful user experiences.</div><div class="entry-content">Noah Glushien shares the ins and outs of creating a successful career in web, despite being color blind.</div>]]></description>
      <link>https://alistapart.com/article/selling-design-systems/</link>
      <guid>https://alistapart.com/article/selling-design-systems/</guid>
      <pubDate>Thu, 11 Feb 2021 16:00:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[The Never-Ending Job of Selling Design Systems]]></title>
      <description><![CDATA[<p>I’m willing to bet that you probably didn’t start your web career because you wanted to be a politician or a salesperson. But here’s the cold, hard truth, friend: if you want to work on design systems, you don’t have a choice. Someone has to pay for your time, and that means someone has to sell what you do to an audience that speaks value in an entirely different language. </p><div class="aside-breaker">Article Continues Below</div>
<p>It’s not exactly easy to connect the benefits of a design system directly to revenue. With an ecomm site, you can add a feature and measure the impact. With other conversion-based digital experiences, if your work is good, your customers will convert more. But because a design system is (usually) an internal tool, it’s just harder to connect those dots. </p>
<p>This article boils down the methods I’ve put into practice convincing executives not just to fund the initial push of design system work, but to <em>keep funding it</em>. I’ll share how I’ve adjusted the language I use to describe common design system benefits, allowing me to more clearly communicate with decision makers.</p>
<p>In my experience, design systems can be owned by information technology teams, marketing and communications departments, or (best case scenario) cross-disciplinary teams that bring many specialists together. The first thing you need to do is determine where the system lives, as in which department owns and cares for it. </p>
<p>If it’s part of IT, for example, you need to think like a CIO or an IT Director and speak to their objectives and values. These leaders are typically more <em>internally</em> focused; they’ll filter the value of the design system in terms of the employees of the company. In contrast, if the system belongs to Marketing, put on your CMO or Marketing Director hat. Marketing teams are often <em>externally</em> focused; they think in terms of B2B audiences and end users. </p>
<p>The way organizations structure the ownership of a design system can be more complex, but let’s use these two paths (internal vs external) as frameworks for building a persuasive case for those owners.</p>
<h2>Internal-orientation motivators<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/selling-design-systems#section3">#section3</a></h2>
<p><a href="https://designsystemssurvey.seesparkbox.com/2020/">Based on the research we’ve done since 2018</a>, there are three very specific internal motivators for having a design system:</p>
<ul><li>Efficiency</li>
<li>Onboarding</li>
<li>Scale.</li>
</ul><h3>Efficiency benefit<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/selling-design-systems#section4">#section4</a></h3>
<p>Design systems allow for the rapid prototyping of new ideas using existing, production-ready components. They allow teams to reuse design and code, and they allow individuals to focus their creative energy on new problems instead of wasting it on old ones. Executives and decision-makers may abstractly understand all that, but you need to be able to tell them what it will take to realize the efficiency benefit. </p>
<p>There’s a theoretical maximum to how productive a team can be. When you talk about a design system creating more efficiency in your processes, you’re really talking about raising the ceiling on that max. As happens with so many things in life, though, that comes with a trade-off. Early on, while a team is actually building the system, they won’t be as productive on the rest of their work.</p>
<p>The efficiency curve looks like this:</p>
<figure class="wp-block-image size-large"><img width="1023" height="575" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/02/ala-ds-efficiency-1-e1612891151253.png?w=960" alt="The Design System Efficiency Curve. Line graph illustrating the curvilinear relationship of productivity over time in terms of overall efficiency, in situations of transition from having no design system in place through in-process set up of the system, to eventually having an established design system. Productivity is represented on the y-axis and Time on the x-axis. Starting at 0,0 productivity dips down as the team diverts resources to set up the system, but eventually surpasses standard productivity once the system is in place." class="wp-image-7172722" /><figcaption><em><strong>Figure 1.</strong> With Productivity on the y-axis and Time on the x-axis, the Design System Efficiency Curve dips down at the start as the team ramps up on the system, but eventually surpasses standard productivity once the system is in place.</em></figcaption></figure><p>If you’re talking to an executive, it’s important to acknowledge this dip in productivity. </p>
<p>Spend some time working out these specific calculations for your organization. For example, you might need four team members for three months to reach a point where the system will save everyone on the team approximately two hours per week. You’re candidly acknowledging the necessary investment while demonstrating the eventual benefits. And make sure to mention that the productivity benefits will continue indefinitely! The math will almost always end up on your side. </p>
<p>Another critical point to raise is that simply having a design system has a cumulative effect on the efficiency of your teams. Since the system is an internal tool that can be used 1) across multiple products or experiences, 2) by many teams throughout the organization, and 3) in many phases of the product design and development process, you are gaining efficiencies on many levels. </p>
<p>The team working on in-store kiosks can build their interface with a well-tested set of components. Your UX people can use the system to prototype and test with production-ready code. The people responsible for grooming the backlog know there is a stable pattern library upon which they are building new features or fixing old ones. Anyone looking for answers to what, why, or how your organization designs and builds products will find those answers in the living system.</p>
<p>The efficiency at each of these (and many other) decision points is how we can raise the ceiling on our <em>total</em> possible efficiency. How this plays out is very different in each organization. I’m here to tell you that part of the work is thinking about how a design system will impact <em>every</em> part of your process—not just design or development.</p>
<h4>What to measure<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/selling-design-systems#section5">#section5</a></h4>
<p><strong><em>Action: Measure the cost of productivity with and without a design system.</em></strong></p>
<p>If you aren’t already, start measuring how productive your team is now. The easiest way to do this is to break your team’s work down into measurable cycles. Once you have a rough idea of how much you can get done in a cycle of work, you’ll be able to compare your efficiency before the system was in place with your efficiency after. This kind of measurable benefit will speak volumes to your executive team.</p>
<h3>Onboarding benefits<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/selling-design-systems#section6">#section6</a></h3>
<p>Growth is expensive. When you hire a new team member, you don’t just supply a salary and benefits. You need a computer, a desk, a chair, accounts to all the software/services…the list goes on. And all these expenses hit before your new employee is a fully contributing member of the team. You won’t start to recoup your investment for a few months, at least. </p>
<p>Design systems can reduce the time it takes your new hire to become a productive contributor. Once you have a healthy design system in place, you’re able to provide an employee with a clearly-defined and effective toolset that is well-documented and can be applied across multiple initiatives. More specifically, assigning new hires to start out working on the design system team will allow them to quickly learn how your organization designs and builds digital products.</p>
<figure class="wp-block-image size-large"><img width="1024" height="576" src="https://149572954.v2.pressablecdn.com/wp-content/uploads/2021/02/ala-ds-onboarding-e1612891563971.png?w=960" alt="Onboarding Model. Diagram illustrating the movement and eventual cycling (depicted by arrows pointing to the right) of individuals in a &quot;Hiring Pool&quot;(represented by a cluster of dots on the left of the graphic) into the DS Team (design system team), represented by a diamond shape in the center of the graphic, then exiting the DS Team to join Other Teams (smaller diamond shapes on the right of the graphic), and finally, back into the DS Team (dashed-line arrow looping below and to the left, back into the DS Team diamond shape)." class="wp-image-7172723" /><figcaption><em><strong>Figure 2.</strong> A Model for Onboarding</em>. <em>As you bring people into your organization from your hiring pool, consider having them start on your design system team and then rotate out onto other teams. As you grow, folks who haven’t had a turn on the system team can rotate in as well.</em></figcaption></figure><p>On the left in <strong>Fig. 2</strong>, you have a pool of potential employees. As you hire individuals, you can bring them into the design system team, where they’ll gain a deep understanding of how your organization builds digital products. Once they’re up to speed, you can seamlessly move them to another product, discipline, or feature-based team where they’ll take this knowledge and hit the ground running. Additionally, your organization can benefit from having all team members (even those who have been around for a while) periodically work a rotation with the design system team. This continuously spreads the design systemexpertise around the organization and makes it part of the fabric of how you work.</p>
<p>And don’t think this approach is only valuable for designers or developers. A healthy design system team comprises people from many disciplines. In addition to team member rotation, building in time to mentor folks from many different disciplines can prove tremendously valuable in the long run. A highly functional design system team can serve as an ideal model of workflow and can educate many team members dispersed throughout the organization about how to approach their work.</p>
<p>Believe me, executives’ eyes will light up when you share how a design system can ensure high productivity in record time. As a caution, though, rotating people in and out of any team <em>too</em> often can leave them feeling exhausted and can make it hard for them to be productive. Remember, you have the flexibility to scale this to a level that makes sense for your team. Be smart and use this approach as it works in your context.</p>
<h4>What to measure<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/selling-design-systems#section7">#section7</a></h4>
<p><strong><em>Action: Measure the time it takes for teams to become productive.</em></strong></p>
<p>As new people are added, a team typically returns to the “forming” stage of <a href="https://en.wikipedia.org/wiki/Tuckman%27s_stages_of_group_development">Tuckman’s stages of group development</a>. This is part of the reason that growth is expensive. But with a design system in place and a healthy culture, you can reduce the time it takes the team to get back to “performing.”</p>
<h3>Scale benefits<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/selling-design-systems#section8">#section8</a></h3>
<p>Traditionally, you have to hire more people to scale productivity. A design system enables a team to accomplish more with less. <a href="https://designsystemssurvey.seesparkbox.com/2019/#table3a">Reusability is a major reason</a> teams choose to work in a more systematic way. Small teams with an effective system can design, build, and maintain hundreds of sites each year. They’d never come close without a design system to work with. </p>
<p>UX Pin has a <a href="https://www.uxpin.com/create-design-system-guide/">design system guide</a> that starts by acknowledging something that most of us ignore.</p>
<blockquote class="wp-block-quote">
<p>Scaling design through hiring, without putting standards in place, is a myth. With every new hire, new ideas for color palettes, typography and patterns appear in the product, growing the inconsistency and increasing the maintenance cost. Every new hire increases the design entropy<em>.</em></p>
</blockquote>
<p>A well-executed system allows a team to scale while keeping design entropy at bay.</p>
<h4>What to measure<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/selling-design-systems#section9">#section9</a></h4>
<p><strong><em>Action: Compare the amount of people on your team to the amount of work they are accomplishing.</em></strong></p>
<p>Adding people to a team doesn’t necessarily mean they’ll get more work done faster. This is well-documented in historical software books like Fred Brooks’ <a href="https://en.wikipedia.org/wiki/The_Mythical_Man-Month#The_mythical_man-month"><em>The Mythical Man-Month</em></a>. Eventually, you will have to investigate changing other factors (besides just adding more people) to increase productivity. A good design system can be one of these factors that increases the productivity of the team members you already have. It’s this change in productivity over scale that you need to measure and compare in order to prove value for this benefit.</p>
<h2>External-orientation motivators<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/selling-design-systems#section10">#section10</a></h2>
<p>Let’s shift to thinking about the benefits that a design system offers to end-users. The four primary external motivators are:</p>
<ul><li>Consistency</li>
<li>Trust</li>
<li>Accessibility</li>
<li>Usability.</li>
</ul><h3>Consistency and Trust benefits<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/selling-design-systems#section11">#section11</a></h3>
<p>Consistency is widely assumed to be the primary benefit of a design system. We identify dozens of button designs, color variations, and inconsistent typefaces in hopes of convincing higher-ups to allow us to build a system to bring it all in line. After working on design systems for the last five or six years, I can say with confidence that a design system will not make your product more consistent. </p>
<p>You see, us web designers and developers are very scrappy. We can create the most inconsistent experiences within even the most rigid systems. It’s not the system itself that creates consistency, it’s the culture of an organization. It’s all of the unspoken expectations—the filters through which we make decisions—that give us the confidence to pause and ask if the work we’re doing fits <em>culturally</em> with the product we’re building. A good CMO knows this, and they won’t buy the oversimplified idea that a design system will solve the rampant inconsistencies in our work. </p>
<p>Because of this, these executives often have a different (and easier to measure) question: “Does it convert?” This perspective and line of conversation is not an ideal approach. Believe me, we can create experiences that convert but are not good for our users or our brands. Given this, a conversation with your CMO might go better if you <a href="https://alistapart-production.mystagingwebsite.com/article/being-real-builds-trust/">shift the language to talk about trust</a> instead.</p>
<p>With inconsistent experiences, your <a href="https://www.nngroup.com/articles/omnichannel-consistency/">users subconsciously lose trust</a> in your brand. They’ve been conditioned to expect a certain kind of user experience, and that’s what they should be given, even across multiple websites or products. Vanessa Mitchell wrote about <a href="https://www.cmo.com.au/article/642102/why-customer-trust-more-vital-brand-survival-than-it-ever-been/">why brand trust is more vital to survival now</a> than it’s ever been:</p>
<blockquote class="wp-block-quote">
<p>“Brand trust as an ‘“insurance policy”’ against future issues is not a new concept. Most organizations know trust bestowed by the consumer can not only make or break a business, it can also ensure you survive a problem in the future. But few achieve brand trust adequately, preferring to pay lip service rather than delve into what it really means: Authentically caring about customers and their needs.”</p>
</blockquote>
<p>When your customer is using your product to accomplish a very specific task, <em>that one task is the only thing that matters to them.</em> Creating a consistent experience that works for everyone and allows them to accomplish their goals <em>is</em> building trust. CMOs need to understand how design systems empower trusted relationships so those relationships contribute to your bottom line.</p>
<h4>What to measure<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/selling-design-systems#section12">#section12</a></h4>
<p><strong><em>Action: Measure the engagement of your customers.</em></strong></p>
<p>Customer engagement can be measured with web analytics platforms. What you’re looking for will vary depending on the context for your organization, but trends in things like time on site, visit frequency, subscription rates, and bounce rates will give you meaningful data to work with. It’s also very common to track customer engagement with metrics like <a href="https://en.wikipedia.org/wiki/Net_Promoter">Net Promoter Score</a> (NPS) by asking simple questions of customers repeatedly over time. There are so many ways to structure tests of the usability of your work, so I’d encourage you to loop in the UX team to help you find tests that will demonstrate the user engagement success of the design system effort.</p>
<h3>Accessibility benefits<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/selling-design-systems#section13">#section13</a></h3>
<p>Accessibility can be a tremendous benefit of a design system. Do the work properly the first time, then allow that beautifully accessible component to serve your customers each time it is used. Certainly, it’s not a fail-safe measure—there is still integration-level testing to ensure component accessibility translates to the larger experience—but ensuring the accessibility of individual components will result in more accessible experiences. And integrating good accessibility practices into your system means more folks within your organization are aligned with this important work. </p>
<p>You might find at first that marketers aren’t all that interested in accessibility, but they should be. Did you know that there were 814 <a href="https://blog.usablenet.com/2018-ada-web-accessibility-lawsuit-recap-report">web accessibility related lawsuits</a> (just in the US!) in 2017? Did you know that there were almost 2,300 in 2018? That’s a <strong>181% increase</strong>. <a href="https://www.census.gov/newsroom/releases/archives/miscellaneous/cb12-134.html">This must be a priority</a>. First, because it’s the right thing to do. Second, because it’s important to the sustainability of the business. A design system can help you address this issue, <em>and</em> it can help you maintain compliance as you grow. This is the kind of message that resonates with leadership.</p>
<h4>What to Measure<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/selling-design-systems#section14">#section14</a></h4>
<p><strong><em>Action: Measure your compliance to accessibility guidelines over time.</em></strong></p>
<p>Many organizations have a regular cadence of accessibility audits across their digital properties. While some of this can be automated, there’s always a manual aspect needed to truly evaluate the accessibility of a site or application. Tracking how often regressions occur in the properties served by your design system can be a great way to demonstrate the value that system is bringing to the organization.</p>
<h3>Usability benefits<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/selling-design-systems#section15">#section15</a></h3>
<p>As with so many aspects of a design system, usability benefits come from repetition. Design system pros often hope to focus energy on solving a usability challenge <em>only once</em> before moving on to the next problem. This absolutely is a benefit of a well-constructed system. It’s also very true that “familiarity breeds usability.” Your customers will learn to use your products and begin to subconsciously rely on that familiarity with the experience to lower their cognitive load. This should be just as important to our executive leadership as it is to those of us who are practitioners. </p>
<p>You can also reframe this benefit in the context of conversion. Helping our users accomplish their goals is helping them convert. They are there to use your product. So make it easy to do, and they’ll do it more. This is what businesses need and what executives want to see—improving the business by helping customers. As mentioned above, we want to make sure we’re doing this in healthy ways for both our users and our brands.</p>
<h4 id="section16">What to Measure<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/selling-design-systems#section16">#section16</a></h4>
<p><strong><em>Action: This might be the easiest one—measure conversion!</em></strong></p>
<p>Running usability studies will help to validate and measure the success of your work with the system, which many organizations are already doing. Your goal should be to validate that components are usable, which will allow you to build a culture of user-centered design. Setting the bar for what it takes to evolve the system—such as requiring that changes are tested with real users—introduces this idea into the core of all your processes, where it should be.</p>
<h2 id="section17">Sell investment, not cost<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/selling-design-systems#section17">#section17</a></h2>
<p>Knowing how and which internal and external motivators to touch on during conversations is significant, but there’s one last thing I’d like to mention, and it has to do with your way of thinking. A major factor in many of these conversations lies simply in how we frame things: move the conversation about the cost of building a design system into a conversation about the present and residual benefits of the investment you’re making. It’s easy to view the time and effort required to build a system as an investment in ultimately delivering high-quality digital products. But leadership will be more willing to consider realistic budgets and timelines if you talk about it like a long-term investment that has benefits on multiple levels throughout the business. This also leaves you with the ability to regularly remind them that this product will never be done—it will require ongoing funding and support.</p>
<p>A design system project will not succeed if you don’t convince others that it’s the right thing to do. Successful, sustainable design systems start with the people, so you have to begin by building consensus. Building a design system means you’re asking everyone to change how they work—everyone has to be on board.</p>
<p>This concept of collaboration is so core to the work of design systems that it led all of us here at Sparkbox to look for opportunities to better understand how teams around the world are designing, building, and using a more systematic approach to digital product design. For the last three years, we’ve been gathering and sharing data in the form of the <a href="https://designsystemssurvey.seesparkbox.com/2020/">Design Systems Survey</a> and the <a href="https://seesparkbox.com/foundry/calendar_for_design_system_support_and_sucessful_design_systems">Design System Calendar</a>. If you are considering a design system for your organization, or if you work with a design system team, the survey and calendar may be helpful in your quest to build better products.</p>]]></description>
      <link>https://alistapart-production.mystagingwebsite.com/article/selling-design-systems/</link>
      <guid>https://alistapart-production.mystagingwebsite.com/article/selling-design-systems/</guid>
      <pubDate>Thu, 11 Feb 2021 16:00:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[Navigating the Awkward: A Framework for Design Conversations]]></title>
      <description><![CDATA[<p>We’ve all been there. A client or coworker shows us this amazing thing they (and maybe their entire team) have worked on for hours or weeks. They are so proud of it. It’s new or maybe it just looks new. They may or may not ask you what you think—but you’re there to experience it. And your brain quietly screams.</p><div class="aside-breaker">Article Continues Below</div>
<p>As an experienced designer, you often have an intuitive reaction and can quickly spot bad designs; they may be visually incongruent, poorly structured, confusing, lack social awareness, or look like they are trying too hard.</p>
<p>If your initial response is so negative that it slips through into your expression or voice or body language, it can completely sabotage any possibility of buy-in. And, far more seriously, it can ruin the relationship of trust and collaboration you’re building with that person. </p>
<p>Reflecting on my own successes and failures—and the experiences of others—I’ve put together a conversational framework for navigating these all-too-frequent design interactions, whether you’re an in-house designer, a consultant, or an agency employee. </p>
<h2>Be a relationship steward<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/navigating-the-awkward#section2">#section2</a></h2>
<p>“Getting things done” is often accomplished at the expense of relationships and sustainable design solutions. As in, the “We need to manage this situation” approach (emphasis on the “manage”) quite often looks more immediately effective on paper than the “We need to be productive while stewarding this project for this partner” mindset.  </p>
<p>The thing is, a design stewardship mindset to working with clients/partners is a better bet; thinking beyond buy-in or proving your point or getting your own way pays off in both an immediate situation, and long-term, for both sides.</p>
<p>I’ve had plenty of those “design conversations gone wrong” over the years, and have noticed a common set of whys and hows behind the scenes. To help me consciously factor them in and stay focused, I’ve developed this simple conversational framework:</p>
<p><strong>Element 1:</strong> Move from selling to helping.</p>
<p><strong>Element 2:</strong> Question your triggers and explore the problem.</p>
<p><strong>Element 3:</strong> Map the problem to the client’s values.</p>
<p><strong>Element 4:</strong> Formulate questions for the client based on values.</p>
<p><strong>Element 5:</strong> Listen and be prepared to challenge your assumptions.</p>
<p><strong>Element 6:</strong> Reflect back on the problem and share recommendations with the client.</p>
<p>We’re going to explore all that below, but here’s a <a href="https://docs.google.com/document/d/1txBFHwqyhtrevXZYCaUk4P5UNFqpc2au9sTUGTdjkWA/edit?usp=sharing">quick reference version of conversational frameworks</a> you can look at as we go.</p>
<p>When confronted with a bad design, there are some common reactions a designer might have—what we often catch ourselves saying in our head (hopefully!) or directly to our clients. (I need to preface by saying I borrowed some of these from a viral “Hi, I’m a …you might know me from my greatest hits…” on Twitter.)</p>
<ul><li>You are not your users!</li>
<li>Blindly following another organization’s best practices is not going to guarantee successful conversion for your business.</li>
<li>Have they ever heard there’s such a thing as Calls to Action?</li>
<li>Really, you couldn’t have bothered to tell the user ahead of time how many steps this process involves?</li>
<li>No, a chatbot won’t magically fix your horrible content!</li>
<li>Is this clipart?!!</li>
<li>Don’t use your org chart for navigation…not even on your intranet.</li>
<li>You can’t mix apples and oranges.</li>
<li>Views do not equal engagement metrics!</li>
<li>Stop celebrating outputs instead of outcomes!</li>
<li>Diversity is more than just white women.</li>
<li>You’re talking about implementation details, but I still don’t even know what problem we’re trying to solve.</li>
<li>Not another FAQ!</li>
<li>Does accessibility mean anything to these folks?</li>
<li>We don’t need 15 unique designs for this button. There is a style guide for that!</li>
<li>Good luck with your SEO efforts; keyword stuffing won’t get you ranking!</li>
<li>Can we start designing experiences instead of pages and features?</li>
</ul><p>I am sure you can relate. While there’s nothing inherently wrong about these statements—and there are times when it is worth being upfront and saying them as-is—we also know they might be ineffective, or worse yet, perceived as confrontational. </p>
<p>Someone worked hard on this. They put a lot of thought into it. They love it. They want this to be the solution. </p>
<p>So, how can we avoid defensiveness? How do we engage the other person in a meaningful conversation that comes from a place of empathy instead of arrogant expertise? </p>
<p>In describing “<a href="https://www.ideou.com/blogs/inspiration/how-shifting-your-mindset-can-ignite-transformation">How Shifting Your Mindset Can Ignite Transformation</a>,” Keith Yamashita points out that “each of us comes into the world curious, open, wanting to bond and wanting to have great connections with other people,” yet “our training, societal norms, school, and early jobs beat all of that out of us.” Self-awareness and inner reflection are essential to helping us reconnect with other humans. <a href="https://www.ideo.com/blog/5-ways-mindfulness-can-make-you-a-better-designer">Practicing mindfulness</a> is a great way to develop and enhance these skills.</p>
<h2>It’s not me, it’s you (Element 1)<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/navigating-the-awkward#section4">#section4</a></h2>
<p>First step to getting your message across is shifting your position from “How do I share <em>my</em> perspective” to “How can I help my (clients/partners/coworkers) improve their current product?” </p>
<p>Make room for the needs of others and create some distance from your ego and. In particular, try to refrain from saying what you find so intuitive, as well as delay providing your opinion. </p>
<p>Blair Enns, who writes about the <a href="https://www.winwithoutpitching.com/the-vulnerable-expert/">importance of being a vulnerable expert</a>, says it beautifully (emphasis is mine):</p>
<ul><li>You can be slick or the client can be slick. It’s better if it’s the client.</li>
<li>You can fumble and be awkward in the conversation or the client can fumble and be awkward. It’s better you are the awkward one.</li>
<li>You can have all the answers to the client’s questions or the client can have all the answers to your questions. <strong>It’s better to ask the questions.</strong> (Nobody has all the answers.)</li>
<li>Those who are not trained in selling often think of the cliches and think they must be seen to be in control, to have the answers, to have the polish. The opposite however is better. <strong>You can still be the expert by showing vulnerability.</strong> You don’t need to manufacture answers you do not have. It’s okay to say “let me think about that.”</li>
</ul><p>Allowing others to be in the spotlight may take some practice and requires you to <a href="https://www.ideou.com/blogs/inspiration/when-are-you-at-your-best-as-a-leader">be self-aware</a>. When you find yourself triggered and itching to comment or to disagree with something, try the following exercise:</p>
<ol><li><strong>Pause.</strong></li>
<li><strong>Acknowledge</strong> that you are frustrated and want to jump in.</li>
<li><strong>Invite</strong> yourself to be curious about the trigger instead of judging yourself or others. </li>
</ol><p>The more you practice this kind of self-awareness, the more you’ll notice your triggers and change how you respond to them. This quick mental exercise gives you the space to make an intentional choice. For similar practical strategies, take a look at “<a href="https://www.ideou.com/blogs/inspiration/how-to-turn-empathy-into-your-secret-strength">How to Turn Empathy into Your Secret Strength</a>.”</p>
<h2>Winning the moment isn’t a win (Element 2)<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/navigating-the-awkward#section5">#section5</a></h2>
<p>One potential trigger may be rooted in your mindset: are you more focused on trying to get “buy-in,” or on building positive, lasting relationships to support ongoing collaboration and stewardship?</p>
<p>To do this, you need to first ask yourself some questions to get to the bottom of what your impulse is trying to communicate. You then need to <a href="https://overthefence.com.de/manifesto/?lang=en">do some slow thinking</a> and identify a question that will engage your partner in a conversation.</p>
<p>Here’s a hypothetical situation to explore what this might look like.</p>
<p>You’re shown a very clunky, centralized system designed so users can register for recreational activities around the city. The client wants your team to create a chatbot to support it. </p>
<p><strong>Your internal reaction:</strong> “Instead of pages and features, can we start designing experiences?”</p>
<h3><strong>Analyzing your reaction:</strong><a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/navigating-the-awkward#section6">#section6</a></h3>
<h4><strong><em>Why?</em></strong><a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/navigating-the-awkward#section7">#section7</a></h4>
<p>When we focus on pages and features like chatbot solutions, we typically aren’t seeing the whole picture.</p>
<h4><strong><em>Why?</em></strong><a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/navigating-the-awkward#section8">#section8</a></h4>
<p>Organizations can get distracted by a shiny opportunity or single perceived problem in a product, but these can frequently overshadow where real impact can be made. </p>
<h4><strong><em>Why?</em></strong><a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/navigating-the-awkward#section9">#section9</a></h4>
<p>The <a href="https://www.interaction-design.org/literature/article/the-pareto-principle-and-your-user-experience-work">80/20 Pareto principle</a> has a strong pull for many organizations.</p>
<h4><strong><em>Why?</em></strong><a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/navigating-the-awkward#section10">#section10</a></h4>
<p>Organizations want solutions that take minimal perceived time and effort.</p>
<h4><strong><em>Why?</em></strong><a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/navigating-the-awkward#section11">#section11</a></h4>
<p>Organizations want to save money/go with the cheaper option. </p>
<p><strong><em>So what?</em></strong></p>
<p>As a result, organizations risk prioritizing what seems to be the easy thing at the expense of other, more user-friendly and profitable solutions. </p>
<p>This example is simplistic, but notice that by asking a few sets of questions, we were able to move from a reactive statement to a reason why something may not be working—a reason that’s a lot less emotional and more factual. You could use a modified <a href="https://www.mindtools.com/pages/article/newTMC_5W.htm">5 Whys approach</a> like this, or some other questioning method that suits the situation. </p>
<p>If you dissect our example more closely, you’ll see that unlike the initial reaction, which speaks more to design elements like pages and features, we are now talking about more broadly relatable topics across business lines, such as cost savings or risk assessment. Structuring your conversation around topics most familiar to the other person and reflecting their core values can help us be more successful in improving their product.</p>
<h2>Ask with values in mind, close with opportunities (Element 3)<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/navigating-the-awkward#section12">#section12</a></h2>
<p>I recently attended an excellent event on “Speaking Truth to Power,” presented by the Canada School of Public Service. The keynote speaker, <a href="https://twitter.com/takisarantakis?lang=en">Taki Sarantakis</a>, shared his strategies for how to be an effective expert and advisor, such as:</p>
<ul><li>Be credible and build trust</li>
<li>Have humility and empathy</li>
<li>Make sure that the person you are advising understands that the advice they do not want to hear is for their benefit.</li>
</ul><p>He also broke down a few concepts that could be a barrier to implementing this advice. If we see ourselves as “speaking truth to power” we are likely making a values judgement. We believe and project to others that <strong>we have all truth and no power</strong>, while the person on the other end <strong>has all the power, and no truth</strong>. It’s an arrogant position that weakens our ability to make any productive progress. Framing our interactions as a battle will likely result in a lose-lose situation.  </p>
<p>Sarantakis then presents an example conversation that is rooted in credibility and humility, and comes from a place of care. He underscores that any advice you choose to share has to absolutely come from a place of concern for the person making a final decision, and not from a desire to show off and say so on record. It roughly looks like this:</p>
<ul><li>Here is what you need to know…</li>
<li>You know X, but you may not know Y and Z.</li>
<li>I know this is something you may not want to hear, but I need to say it because <strong>it is important that you know this</strong>.</li>
</ul><p>As part of the panel discussion that followed the keynote, <a href="https://twitter.com/relishing?lang=en">Kym Shumsky</a>, who has lots of experience advising senior leaders, reinforced Sarantakis points by stating that valuing truth, knowledge, and accuracy over relationship-building can be detrimental. Thinking back on my personal experiences, I fully agree. </p>
<p>So how do we build trust, credibility, and share from a place of care? Steve Bryant, Head of Content at <a href="https://articlegroup.com/">Article Group</a>, has some thought-provoking words on this in his article “<a href="https://medium.com/article-group/make-relationships-not-things-4c20df2fb249">Make relationships, not things</a>”:</p>
<blockquote class="wp-block-quote">
<p><em>Relationships are based on trust. Trust takes time and honesty. You can’t just create a pile of content and be done with it. You can’t “thing” your way to people trusting you.</em></p>
<p><em>Which is to say: the question isn’t what content to create.</em></p>
<p><em>The question isn’t how to create that content.</em></p>
<p><em>The question is why do you care about the people you’re creating the content for? What makes them special? What kind of relationship do you want to have?</em></p>
<p><em>How do you want them to feel?</em></p>
</blockquote>
<h2>Translating core values into specific needs (Element 4)<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/navigating-the-awkward#section13">#section13</a></h2>
<p>Going back to the exercises we just explored and what we think could be the source of the problem, it’s time to start moving backward from the core values to specific design characteristics that need to be addressed.  </p>
<p>You have to always start the conversation as a set of questions. Beginning with questions allows you to set aside the expert hat, <a href="https://hbr.org/2018/09/curiosity">be curious</a>, and let the client share their experiences. It shows them you care and are there to <a href="https://www.ideo.com/blog/4-exercises-that-prove-listening-matters">listen generously</a>. </p>
<h2>Build rapport, be present, and be there to listen (Element 5)<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/navigating-the-awkward#section14">#section14</a></h2>
<p>Erika Hall offers timeless advice about the need to build rapport and understand our partners in her article “<a href="https://medium.com/mule-design/everyday-empathy-6a475e03fd81">Everyday Empathy</a>”:</p>
<blockquote class="wp-block-quote">
<p>And as social science shows, trying to bridge the gap with facts will never change anyone’s mind. The key is to value — truly value — and reflect the perspective of the people you want to influence. […] Attention is a gift beyond measure.</p>
</blockquote>
<p>A great bit of advice on “being present” rather than “presenting” on a topic is offered by Blair Enns (author of <em>The Win Without Pitching Manifesto</em>) in the episode “<a href="https://www.winwithoutpitching.com/replacing-presentations/">Replacing Presentations with Conversations</a>.” Being present also means being vulnerable and open to discovering something new that might change your initial reaction. </p>
<p>And then be prepared to truly listen, not convince. Sarah Richards points out how important it is to <a href="https://gathercontent.com/blog/secret-effective-content-strategy-listening">understand the different mental models that partners bring to the table</a> and work together to form new ones to accomplish common goals:</p>
<blockquote class="wp-block-quote">
<p>How many times have you said you are going to talk to someone who is blocking you? Now count how many times have you said you are going to listen to someone who is blocking you? When we have someone in our organisation who disagrees with us, we go to see if we can convince someone that our way of thinking, our way of doing things, is the best way of doing it.</p>
</blockquote>
<p>Here is what a conversation relating to “Can we start designing experiences instead of pages and features?”might look like, if we follow this approach:</p>
<p><strong>You:</strong> <em>What do you hope to accomplish with a chatbot?</em></p>
<p><strong>Partner:</strong> We want people to get answers to their questions as quickly as possible, so they can register and pay for local recreation activities of their choice faster. We live in a beautiful city and it’s a pity when residents and visitors can’t take advantage of everything it has to offer. </p>
<p><strong>You:</strong> <em>What have you heard from the people who experienced barriers to quickly registering and paying?</em></p>
<p><strong>Partner:</strong> They complain that they can’t easily find activities in community centers closest to them or that there is no way for them to see all current and upcoming classes around the city at a glance, or that additional information about different activities is not provided within the system and they often have to look up events or class instructors separately to find more information on other websites. They also are not able to browse all activities by type of recreation, like “nature” activities, which might include hiking, city tours, birdwatching, garden events, and festivals. They often do not know what terminology to use to search for events and activities, so they say it is difficult to find things they already do not know about.</p>
<p><strong>You:</strong> <em>How do you think this makes them feel?</em></p>
<p><strong>Partner:</strong> They say this frustrates them, as information on other websites might differ from the information in our system and they end up wasting their time guessing which one is correct and up-to-date. They then end up having to call the community center or organization providing an event for more information, to figure out if it is a good fit, before registering and paying; which significantly delays the process. </p>
<p>I think you see where this is going. </p>
<p>Here are a few more follow-up questions:</p>
<ul><li>Have you tried registering for an activity using the system? How did you feel/what did you experience? </li>
<li>What would you like people using your system to feel/experience?</li>
<li>You’ve mentioned a number of barriers that people experience. How well do you think a chatbot will be able to remove these barriers now?</li>
<li>What are some of the risks you foresee in trying to solve these problems?</li>
</ul><p>At this point, if you hear something that makes you pause and question your assumptions, ask further questions and consider going back to the drawing board. Maybe you need to ask yourself: <a href="https://airbnb.design/anotherlens/#answer1">What are my lenses?</a></p>
<h2>Respond with care and invite collaboration (Element 6)<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/navigating-the-awkward#section15">#section15</a></h2>
<p>If what you’ve heard confirms your assumptions, you could offer a few concise, summative statements and a recommendation. Whatever you say needs to integrate the vocabulary used by the client (mirroring), to show them that you were listening and critically reflecting on the situation. </p>
<p>Let’s see how that might look:</p>
<blockquote class="wp-block-quote">
<p>“Based on what you’ve shared, it seems that you want to make it quick and easy for anyone in the city to discover, decide on, and pay for a local recreation activity. The experience of the people using the system is very important to you, as you want them to enjoy the city they live in, as well as support the vibrancy of the city economically by registering and paying for local activities.</p>
<p>If we want to help people enjoy and experience the city through events and activities, we need to make it simple and frictionless for them. The barriers they experience cannot be solved with a chatbot solution because the information people are looking for is often missing and not integrated into the current system in a meaningful way. So the chatbot would not give them the answers they need, creating further frustration. </p>
<p>Adding a chatbot also creates an extra layer of complexity. It does not solve the underlying cause of frustration stemming from lack of relevant and integrated information. Instead, it leaves the current experience broken and creates yet another place people need to go to for possible answers.</p>
<p>It would also be a huge risk and time investment to design a chatbot, as your current content is not structured in a way that would allow us to have useful information extracted.</p>
<p>Given your time and resource constraints, I would suggest we explore some other solutions together.” </p>
</blockquote>
<h2>Framing and reinforcing the conversation<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/navigating-the-awkward#section16">#section16</a></h2>
<p>To recap, here are the six essential elements of the conversational framework:</p>
<p><strong>Element 1:</strong> Mentally move from how you can share and sell your perspective to how you can help your partner.</p>
<p><strong>Element 2:</strong> Ask yourself probing questions to better understand your reaction to the “bad design” trigger and what is at the core of the problem.</p>
<p><strong>Element 3:</strong> Map the core of the problem to value(s) you can use to begin the conversation with a partner.</p>
<p><strong>Element 4:</strong> Use value(s) identified to formulate and ask questions.</p>
<p><strong>Element 5:</strong> Get ready to truly listen to your partner and be prepared to challenge your assumptions.</p>
<p><strong>Element 6:</strong> Review your responses to probing questions and identify recommendations you can share back with the partner.</p>
<p>This conversational framework starts with us as individuals, forces us to critically deconstruct our own reactions, then asks us to reframe what we find from a perspective of what matters and is known to our clients. It reminds us that we should learn something in the process by having intentional yet open conversations.</p>
<h2>Future of design leadership is stewardship<a class="subhead-anchor" href="https://alistapart-production.mystagingwebsite.com/article/navigating-the-awkward#section17">#section17</a></h2>
<p>The work we do in the web industry touches people—so we need to be people. We need to be human, <a href="https://adamsilver.io/articles/building-trust-as-a-designer/">build trust</a>, and sustain relationships with our clients and partners. If we aren’t doing a good job there, can we really claim it’s not impinging on our designs and end users?</p>
<p>Our growth as web professionals can’t be limited to technical expertise; design leadership is stewardship. It’s rooted in listen, then respond, in learning how to pause, create space, and get to the root of the problem in a productive and respectful way. We need to learn how to intercept our reactions, so that we can shift how we approach triggering situations, stay still and listen, and open up conversations rife with <a href="https://www.boye-co.com/blog/2018/12/4/stewards-over-gatekeepers-three-principles-for-partnerships">possibilities, not progress suppressors</a>. Guide clients toward better design choices by meeting them in the moment and partnering with them.</p>
<p>In design work, being a steward does not mean that you should push to get your way. Neither does it mean you should indulge clients and create broken or unethical products. Rather, it proposes an attuned way of approaching potentially contentious conversations to arrive at a solid, ethical design. It is about framing the conversation positively and ushering it as a steward, rather than stalling discussion by being the gatekeeper. </p>]]></description>
      <link>https://alistapart-production.mystagingwebsite.com/article/navigating-the-awkward/</link>
      <guid>https://alistapart-production.mystagingwebsite.com/article/navigating-the-awkward/</guid>
      <pubDate>Thu, 10 Dec 2020 16:00:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[Navigating the Awkward: A Framework for Design Conversations]]></title>
      <description><![CDATA[<div class="entry-content">
<p>We’ve all been there. A client or coworker shows us this amazing thing they (and maybe their entire team) have worked on for hours or weeks. They are so proud of it. It’s new or maybe it just looks new. They may or may not ask you what you think—but you’re there to experience it. And your brain quietly screams.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>As an experienced designer, you often have an intuitive reaction and can quickly spot bad designs; they may be visually incongruent, poorly structured, confusing, lack social awareness, or look like they are trying too hard.</p>
<p>If your initial response is so negative that it slips through into your expression or voice or body language, it can completely sabotage any possibility of buy-in. And, far more seriously, it can ruin the relationship of trust and collaboration you’re building with that person. </p>
<p>Reflecting on my own successes and failures—and the experiences of others—I’ve put together a conversational framework for navigating these all-too-frequent design interactions, whether you’re an in-house designer, a consultant, or an agency employee. </p>
<h2 id="section2">Be a relationship steward<a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>“Getting things done” is often accomplished at the expense of relationships and sustainable design solutions. As in, the “We need to manage this situation” approach (emphasis on the “manage”) quite often looks more immediately effective on paper than the “We need to be productive while stewarding this project for this partner” mindset.  </p>
<p>The thing is, a design stewardship mindset to working with clients/partners is a better bet; thinking beyond buy-in or proving your point or getting your own way pays off in both an immediate situation, and long-term, for both sides.</p>
<p>I’ve had plenty of those “design conversations gone wrong” over the years, and have noticed a common set of whys and hows behind the scenes. To help me consciously factor them in and stay focused, I’ve developed this simple conversational framework:</p>
<p><strong>Element 1:</strong> Move from selling to helping.</p>
<p><strong>Element 2:</strong> Question your triggers and explore the problem.</p>
<p><strong>Element 3:</strong> Map the problem to the client’s values.</p>
<p><strong>Element 4:</strong> Formulate questions for the client based on values.</p>
<p><strong>Element 5:</strong> Listen and be prepared to challenge your assumptions.</p>
<p><strong>Element 6:</strong> Reflect back on the problem and share recommendations with the client.</p>
<p>We’re going to explore all that below, but here’s a <a href="https://docs.google.com/document/d/1txBFHwqyhtrevXZYCaUk4P5UNFqpc2au9sTUGTdjkWA/edit?usp=sharing">quick reference version of conversational frameworks</a> you can look at as we go.</p>
<h2 id="section3">Healthy self-talk<a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h2>
<p>When confronted with a bad design, there are some common reactions a designer might have—what we often catch ourselves saying in our head (hopefully!) or directly to our clients. (I need to preface by saying I borrowed some of these from a viral “Hi, I’m a …you might know me from my greatest hits…” on Twitter.)</p>
<ul><li>You are not your users!</li>
<li>Blindly following another organization’s best practices is not going to guarantee successful conversion for your business.</li>
<li>Have they ever heard there’s such a thing as Calls to Action?</li>
<li>Really, you couldn’t have bothered to tell the user ahead of time how many steps this process involves?</li>
<li>No, a chatbot won’t magically fix your horrible content!</li>
<li>Is this clipart?!!</li>
<li>Don’t use your org chart for navigation…not even on your intranet.</li>
<li>You can’t mix apples and oranges.</li>
<li>Views do not equal engagement metrics!</li>
<li>Stop celebrating outputs instead of outcomes!</li>
<li>Diversity is more than just white women.</li>
<li>You’re talking about implementation details, but I still don’t even know what problem we’re trying to solve.</li>
<li>Not another FAQ!</li>
<li>Does accessibility mean anything to these folks?</li>
<li>We don’t need 15 unique designs for this button. There is a style guide for that!</li>
<li>Good luck with your SEO efforts; keyword stuffing won’t get you ranking!</li>
<li>Can we start designing experiences instead of pages and features?</li>
</ul><p>I am sure you can relate. While there’s nothing inherently wrong about these statements—and there are times when it is worth being upfront and saying them as-is—we also know they might be ineffective, or worse yet, perceived as confrontational. </p>
<p>Someone worked hard on this. They put a lot of thought into it. They love it. They want this to be the solution. </p>
<p>So, how can we avoid defensiveness? How do we engage the other person in a meaningful conversation that comes from a place of empathy instead of arrogant expertise? </p>
<p>In describing “<a href="https://www.ideou.com/blogs/inspiration/how-shifting-your-mindset-can-ignite-transformation">How Shifting Your Mindset Can Ignite Transformation</a>,” Keith Yamashita points out that “each of us comes into the world curious, open, wanting to bond and wanting to have great connections with other people,” yet “our training, societal norms, school, and early jobs beat all of that out of us.” Self-awareness and inner reflection are essential to helping us reconnect with other humans. <a href="https://www.ideo.com/blog/5-ways-mindfulness-can-make-you-a-better-designer">Practicing mindfulness</a> is a great way to develop and enhance these skills.</p>
<h2 id="section4">It’s not me, it’s you (Element 1)<a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h2>
<p>First step to getting your message across is shifting your position from “How do I share <em>my</em> perspective” to “How can I help my (clients/partners/coworkers) improve their current product?” </p>
<p>Make room for the needs of others and create some distance from your ego and. In particular, try to refrain from saying what you find so intuitive, as well as delay providing your opinion. </p>
<p>Blair Enns, who writes about the <a href="https://www.winwithoutpitching.com/the-vulnerable-expert/">importance of being a vulnerable expert</a>, says it beautifully (emphasis is mine):</p>
<ul><li>You can be slick or the client can be slick. It’s better if it’s the client.</li>
<li>You can fumble and be awkward in the conversation or the client can fumble and be awkward. It’s better you are the awkward one.</li>
<li>You can have all the answers to the client’s questions or the client can have all the answers to your questions. <strong>It’s better to ask the questions.</strong> (Nobody has all the answers.)</li>
<li>Those who are not trained in selling often think of the cliches and think they must be seen to be in control, to have the answers, to have the polish. The opposite however is better. <strong>You can still be the expert by showing vulnerability.</strong> You don’t need to manufacture answers you do not have. It’s okay to say “let me think about that.”</li>
</ul><p>Allowing others to be in the spotlight may take some practice and requires you to <a href="https://www.ideou.com/blogs/inspiration/when-are-you-at-your-best-as-a-leader">be self-aware</a>. When you find yourself triggered and itching to comment or to disagree with something, try the following exercise:</p>
<ol><li><strong>Pause.</strong></li>
<li><strong>Acknowledge</strong> that you are frustrated and want to jump in.</li>
<li><strong>Invite</strong> yourself to be curious about the trigger instead of judging yourself or others. </li>
</ol><p>The more you practice this kind of self-awareness, the more you’ll notice your triggers and change how you respond to them. This quick mental exercise gives you the space to make an intentional choice. For similar practical strategies, take a look at “<a href="https://www.ideou.com/blogs/inspiration/how-to-turn-empathy-into-your-secret-strength">How to Turn Empathy into Your Secret Strength</a>.”</p>
<h2 id="section5">Winning the moment isn’t a win (Element 2)<a class="subhead-anchor" href="https://alistapart.com#section5">#section5</a></h2>
<p>One potential trigger may be rooted in your mindset: are you more focused on trying to get “buy-in,” or on building positive, lasting relationships to support ongoing collaboration and stewardship?</p>
<p>To do this, you need to first ask yourself some questions to get to the bottom of what your impulse is trying to communicate. You then need to <a href="https://overthefence.com.de/manifesto/?lang=en">do some slow thinking</a> and identify a question that will engage your partner in a conversation.</p>
<p>Here’s a hypothetical situation to explore what this might look like.</p>
<p>You’re shown a very clunky, centralized system designed so users can register for recreational activities around the city. The client wants your team to create a chatbot to support it. </p>
<p><strong>Your internal reaction:</strong> “Instead of pages and features, can we start designing experiences?”</p>
<h3 id="section6"><strong>Analyzing your reaction:</strong><a class="subhead-anchor" href="https://alistapart.com#section6">#section6</a></h3>
<h4 id="section7"><strong><em>Why?</em></strong><a class="subhead-anchor" href="https://alistapart.com#section7">#section7</a></h4>
<p>When we focus on pages and features like chatbot solutions, we typically aren’t seeing the whole picture.</p>
<h4 id="section8"><strong><em>Why?</em></strong><a class="subhead-anchor" href="https://alistapart.com#section8">#section8</a></h4>
<p>Organizations can get distracted by a shiny opportunity or single perceived problem in a product, but these can frequently overshadow where real impact can be made. </p>
<h4 id="section9"><strong><em>Why?</em></strong><a class="subhead-anchor" href="https://alistapart.com#section9">#section9</a></h4>
<p>The <a href="https://www.interaction-design.org/literature/article/the-pareto-principle-and-your-user-experience-work">80/20 Pareto principle</a> has a strong pull for many organizations.</p>
<h4 id="section10"><strong><em>Why?</em></strong><a class="subhead-anchor" href="https://alistapart.com#section10">#section10</a></h4>
<p>Organizations want solutions that take minimal perceived time and effort.</p>
<h4 id="section11"><strong><em>Why?</em></strong><a class="subhead-anchor" href="https://alistapart.com#section11">#section11</a></h4>
<p>Organizations want to save money/go with the cheaper option. </p>
<p><strong><em>So what?</em></strong></p>
<p>As a result, organizations risk prioritizing what seems to be the easy thing at the expense of other, more user-friendly and profitable solutions. </p>
<p>This example is simplistic, but notice that by asking a few sets of questions, we were able to move from a reactive statement to a reason why something may not be working—a reason that’s a lot less emotional and more factual. You could use a modified <a href="https://www.mindtools.com/pages/article/newTMC_5W.htm">5 Whys approach</a> like this, or some other questioning method that suits the situation. </p>
<p>If you dissect our example more closely, you’ll see that unlike the initial reaction, which speaks more to design elements like pages and features, we are now talking about more broadly relatable topics across business lines, such as cost savings or risk assessment. Structuring your conversation around topics most familiar to the other person and reflecting their core values can help us be more successful in improving their product.</p>
<h2 id="section12">Ask with values in mind, close with opportunities (Element 3)<a class="subhead-anchor" href="https://alistapart.com#section12">#section12</a></h2>
<p>I recently attended an excellent event on “Speaking Truth to Power,” presented by the Canada School of Public Service. The keynote speaker, <a href="https://twitter.com/takisarantakis?lang=en">Taki Sarantakis</a>, shared his strategies for how to be an effective expert and advisor, such as:</p>
<ul><li>Be credible and build trust</li>
<li>Have humility and empathy</li>
<li>Make sure that the person you are advising understands that the advice they do not want to hear is for their benefit.</li>
</ul><p>He also broke down a few concepts that could be a barrier to implementing this advice. If we see ourselves as “speaking truth to power” we are likely making a values judgement. We believe and project to others that <strong>we have all truth and no power</strong>, while the person on the other end <strong>has all the power, and no truth</strong>. It’s an arrogant position that weakens our ability to make any productive progress. Framing our interactions as a battle will likely result in a lose-lose situation.  </p>
<p>Sarantakis then presents an example conversation that is rooted in credibility and humility, and comes from a place of care. He underscores that any advice you choose to share has to absolutely come from a place of concern for the person making a final decision, and not from a desire to show off and say so on record. It roughly looks like this:</p>
<ul><li>Here is what you need to know…</li>
<li>You know X, but you may not know Y and Z.</li>
<li>I know this is something you may not want to hear, but I need to say it because <strong>it is important that you know this</strong>.</li>
</ul><p>As part of the panel discussion that followed the keynote, <a href="https://twitter.com/relishing?lang=en">Kym Shumsky</a>, who has lots of experience advising senior leaders, reinforced Sarantakis points by stating that valuing truth, knowledge, and accuracy over relationship-building can be detrimental. Thinking back on my personal experiences, I fully agree. </p>
<p>So how do we build trust, credibility, and share from a place of care? Steve Bryant, Head of Content at <a href="https://articlegroup.com/">Article Group</a>, has some thought-provoking words on this in his article “<a href="https://medium.com/article-group/make-relationships-not-things-4c20df2fb249">Make relationships, not things</a>”:</p>
<blockquote class="wp-block-quote">
<p><em>Relationships are based on trust. Trust takes time and honesty. You can’t just create a pile of content and be done with it. You can’t “thing” your way to people trusting you.</em></p>
<p><em>Which is to say: the question isn’t what content to create.</em></p>
<p><em>The question isn’t how to create that content.</em></p>
<p><em>The question is why do you care about the people you’re creating the content for? What makes them special? What kind of relationship do you want to have?</em></p>
<p><em>How do you want them to feel?</em></p>
</blockquote>
<h2 id="section13">Translating core values into specific needs (Element 4)<a class="subhead-anchor" href="https://alistapart.com#section13">#section13</a></h2>
<p>Going back to the exercises we just explored and what we think could be the source of the problem, it’s time to start moving backward from the core values to specific design characteristics that need to be addressed.  </p>
<p>You have to always start the conversation as a set of questions. Beginning with questions allows you to set aside the expert hat, <a href="https://hbr.org/2018/09/curiosity">be curious</a>, and let the client share their experiences. It shows them you care and are there to <a href="https://www.ideo.com/blog/4-exercises-that-prove-listening-matters">listen generously</a>. </p>
<h2 id="section14">Build rapport, be present, and be there to listen (Element 5)<a class="subhead-anchor" href="https://alistapart.com#section14">#section14</a></h2>
<p>Erika Hall offers timeless advice about the need to build rapport and understand our partners in her article “<a href="https://medium.com/mule-design/everyday-empathy-6a475e03fd81">Everyday Empathy</a>”:</p>
<blockquote class="wp-block-quote">
<p>And as social science shows, trying to bridge the gap with facts will never change anyone’s mind. The key is to value — truly value — and reflect the perspective of the people you want to influence. […] Attention is a gift beyond measure.</p>
</blockquote>
<p>A great bit of advice on “being present” rather than “presenting” on a topic is offered by Blair Enns (author of <em>The Win Without Pitching Manifesto</em>) in the episode “<a href="https://www.winwithoutpitching.com/replacing-presentations/">Replacing Presentations with Conversations</a>.” Being present also means being vulnerable and open to discovering something new that might change your initial reaction. </p>
<p>And then be prepared to truly listen, not convince. Sarah Richards points out how important it is to <a href="https://gathercontent.com/blog/secret-effective-content-strategy-listening">understand the different mental models that partners bring to the table</a> and work together to form new ones to accomplish common goals:</p>
<blockquote class="wp-block-quote">
<p>How many times have you said you are going to talk to someone who is blocking you? Now count how many times have you said you are going to listen to someone who is blocking you? When we have someone in our organisation who disagrees with us, we go to see if we can convince someone that our way of thinking, our way of doing things, is the best way of doing it.</p>
</blockquote>
<p>Here is what a conversation relating to “Can we start designing experiences instead of pages and features?”might look like, if we follow this approach:</p>
<p><strong>You:</strong> <em>What do you hope to accomplish with a chatbot?</em></p>
<p><strong>Partner:</strong> We want people to get answers to their questions as quickly as possible, so they can register and pay for local recreation activities of their choice faster. We live in a beautiful city and it’s a pity when residents and visitors can’t take advantage of everything it has to offer. </p>
<p><strong>You:</strong> <em>What have you heard from the people who experienced barriers to quickly registering and paying?</em></p>
<p><strong>Partner:</strong> They complain that they can’t easily find activities in community centers closest to them or that there is no way for them to see all current and upcoming classes around the city at a glance, or that additional information about different activities is not provided within the system and they often have to look up events or class instructors separately to find more information on other websites. They also are not able to browse all activities by type of recreation, like “nature” activities, which might include hiking, city tours, birdwatching, garden events, and festivals. They often do not know what terminology to use to search for events and activities, so they say it is difficult to find things they already do not know about.</p>
<p><strong>You:</strong> <em>How do you think this makes them feel?</em></p>
<p><strong>Partner:</strong> They say this frustrates them, as information on other websites might differ from the information in our system and they end up wasting their time guessing which one is correct and up-to-date. They then end up having to call the community center or organization providing an event for more information, to figure out if it is a good fit, before registering and paying; which significantly delays the process. </p>
<p>I think you see where this is going. </p>
<p>Here are a few more follow-up questions:</p>
<ul><li>Have you tried registering for an activity using the system? How did you feel/what did you experience? </li>
<li>What would you like people using your system to feel/experience?</li>
<li>You’ve mentioned a number of barriers that people experience. How well do you think a chatbot will be able to remove these barriers now?</li>
<li>What are some of the risks you foresee in trying to solve these problems?</li>
</ul><p>At this point, if you hear something that makes you pause and question your assumptions, ask further questions and consider going back to the drawing board. Maybe you need to ask yourself: <a href="https://airbnb.design/anotherlens/#answer1">What are my lenses?</a></p>
<h2 id="section15">Respond with care and invite collaboration (Element 6)<a class="subhead-anchor" href="https://alistapart.com#section15">#section15</a></h2>
<p>If what you’ve heard confirms your assumptions, you could offer a few concise, summative statements and a recommendation. Whatever you say needs to integrate the vocabulary used by the client (mirroring), to show them that you were listening and critically reflecting on the situation. </p>
<p>Let’s see how that might look:</p>
<blockquote class="wp-block-quote">
<p>“Based on what you’ve shared, it seems that you want to make it quick and easy for anyone in the city to discover, decide on, and pay for a local recreation activity. The experience of the people using the system is very important to you, as you want them to enjoy the city they live in, as well as support the vibrancy of the city economically by registering and paying for local activities.</p>
<p>If we want to help people enjoy and experience the city through events and activities, we need to make it simple and frictionless for them. The barriers they experience cannot be solved with a chatbot solution because the information people are looking for is often missing and not integrated into the current system in a meaningful way. So the chatbot would not give them the answers they need, creating further frustration. </p>
<p>Adding a chatbot also creates an extra layer of complexity. It does not solve the underlying cause of frustration stemming from lack of relevant and integrated information. Instead, it leaves the current experience broken and creates yet another place people need to go to for possible answers.</p>
<p>It would also be a huge risk and time investment to design a chatbot, as your current content is not structured in a way that would allow us to have useful information extracted.</p>
<p>Given your time and resource constraints, I would suggest we explore some other solutions together.” </p>
</blockquote>
<h2 id="section16">Framing and reinforcing the conversation<a class="subhead-anchor" href="https://alistapart.com#section16">#section16</a></h2>
<p>To recap, here are the six essential elements of the conversational framework:</p>
<p><strong>Element 1:</strong> Mentally move from how you can share and sell your perspective to how you can help your partner.</p>
<p><strong>Element 2:</strong> Ask yourself probing questions to better understand your reaction to the “bad design” trigger and what is at the core of the problem.</p>
<p><strong>Element 3:</strong> Map the core of the problem to value(s) you can use to begin the conversation with a partner.</p>
<p><strong>Element 4:</strong> Use value(s) identified to formulate and ask questions.</p>
<p><strong>Element 5:</strong> Get ready to truly listen to your partner and be prepared to challenge your assumptions.</p>
<p><strong>Element 6:</strong> Review your responses to probing questions and identify recommendations you can share back with the partner.</p>
<p>This conversational framework starts with us as individuals, forces us to critically deconstruct our own reactions, then asks us to reframe what we find from a perspective of what matters and is known to our clients. It reminds us that we should learn something in the process by having intentional yet open conversations.</p>
<h2 id="section17">Future of design leadership is stewardship<a class="subhead-anchor" href="https://alistapart.com#section17">#section17</a></h2>
<p>The work we do in the web industry touches people—so we need to be people. We need to be human, <a href="https://adamsilver.io/articles/building-trust-as-a-designer/">build trust</a>, and sustain relationships with our clients and partners. If we aren’t doing a good job there, can we really claim it’s not impinging on our designs and end users?</p>
<p>Our growth as web professionals can’t be limited to technical expertise; design leadership is stewardship. It’s rooted in listen, then respond, in learning how to pause, create space, and get to the root of the problem in a productive and respectful way. We need to learn how to intercept our reactions, so that we can shift how we approach triggering situations, stay still and listen, and open up conversations rife with <a href="https://www.boye-co.com/blog/2018/12/4/stewards-over-gatekeepers-three-principles-for-partnerships">possibilities, not progress suppressors</a>. Guide clients toward better design choices by meeting them in the moment and partnering with them.</p>
<p>In design work, being a steward does not mean that you should push to get your way. Neither does it mean you should indulge clients and create broken or unethical products. Rather, it proposes an attuned way of approaching potentially contentious conversations to arrive at a solid, ethical design. It is about framing the conversation positively and ushering it as a steward, rather than stalling discussion by being the gatekeeper. </p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">In this excerpt from World Wide Waste, Gerry McGovern examines the environmental impact of bloated websites and unnecessary assets.</div><div class="entry-content">In this excerpt from Creative Culture, Justin Dauer walks us through many ways in which an organizations’ culture and the design work that it does play off of one another.</div><div class="entry-content">Amy Bucher shares insights into using personalization to create meaningful user experiences.</div><div class="entry-content">Noah Glushien shares the ins and outs of creating a successful career in web, despite being color blind.</div><div class="entry-content">Building a more inclusive internet goes far beyond making our code more accessible. Olu offers a thoughtful approach to a more welcoming web.</div>]]></description>
      <link>https://alistapart.com/article/navigating-the-awkward/</link>
      <guid>https://alistapart.com/article/navigating-the-awkward/</guid>
      <pubDate>Thu, 10 Dec 2020 16:00:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[Webwaste]]></title>
      <description><![CDATA[<div class="entry-content">
<h2 id="section1">The Web is obese<a class="subhead-anchor" href="https://alistapart.com#section1">#section1</a></h2>
<p>In 1994, there were 3,000 websites. In 2019, there were estimated to be 1.7 billion, almost one website for every three people on the planet. Not only has the number of websites exploded, the weight of each page has also skyrocketed. Between 2003 and 2019, the average webpage weight grew from about 100 KB to about 4 MB. The results?</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>“In our analysis of 5.2 million pages,” Brian Dean reported for Backlinko in October 2019, “the average time it takes to fully load a webpage is 10.3 seconds on desktop and 27.3 seconds on mobile.” In 2013, Radware calculated that the average load time for a webpage on mobile was 4.3 seconds.</p>
<p>Study after study shows that people absolutely hate slow webpages. In 2018, Google research found that 53% of mobile site visitors left a page that took longer than three seconds to load. A 2015 study by Radware found that “a site that loads in 3 seconds experiences 22% fewer page views, a 50% higher bounce rate, and a 22% fewer conversions than a site that loads in 1 second, while a site that loads in 5 seconds experiences 35% fewer page views, a 105% higher bounce rate, and 38% fewer conversions.”</p>
<p>The causes of webpage bloat? Images and videos are mainly to blame. By 2022, it’s estimated that online videos will make up more than 82% of all consumer Internet traffic—15 times more than in 2017. However, from the code to the content, everything about Web design has become super-bloated and super-polluting. Consider that if a typical webpage that weighs 4 MB is downloaded 600,000 times, one tree will need to be planted in order to deal with the resulting pollution.</p>
<p>They say a picture paints a thousand words. Well, 1,000 words of text takes up roughly two A4 (210 mm wide and 297 mm long) pages and weighs about 6 KB. You’d place about four images that are 9 cm x 16 cm on two A4 pages. Let’s say these images are well optimized and weigh 40 KB each. (A poorly optimized image could weigh several megabytes.) Even with such high optimization, two A4 pages of images will weigh around 160 KB. That’s 27 times more than the two A4 pages of text. A 30-second video, on the other hand, could easily weigh 3 MB. Videos create massively more pollution than text. Text is the ultimate compression technique. It is by far the most environmentally friendly way to communicate. If you want to save the planet, use more text. Think about digital weight.</p>
<p>From an energy point of view, it’s not simply about page weight. Some pages may have very heavy processing demands once they are downloaded. Other pages, particularly those that are ad-driven, will download with lots of third-party websites hanging off them, either feeding them content, or else demanding to be fed data, often personal data on the site’s visitor. It’s like a type of Trojan Horse. You think you’re accessing one website or app, but then all these other third parties start accessing you. According to Trent Walton, the top 50 most visited websites had an average of 22 third-party websites hanging off them. The New York Times had 64, while Washington Post had 63. All these third-party websites create pollution and invade privacy.</p>
<p>There is a tremendous amount of out-of-date content on websites. I have worked with hundreds of websites where we had to delete up to 90% of the pages in order to start seeing improvements. Poorly written, out-of-date code is also a major problem. By cleaning up its JavaScript code, Wikipedia estimated that they saved 4.3 terabytes a day of data bandwidth for their visitors. By saving those terabytes, we saved having to plant almost 700 trees to deal with the yearly pollution that would have been caused.</p>
<p>If you want to help save the planet, reduce digital weight. Clean up your website. Before you add an image, make sure that it does something useful and it’s the most optimized image possible. Every time you add code, make sure it does something useful and it’s the leanest code possible. Always be on the lookout for waste images, waste code, waste content. Get into the habit of removing something every time you add something.</p>
<p>Publishing is an addiction. Giving a website to an organization is like giving a pub to an alcoholic. You remember the saying, “There’s a book inside everyone”? Well, the Web let the book out. It’s happy days for a while as we all publish, publish, publish. Then…</p>
<p>“Hi, I’m Gerry. I have a 5,000-page website.”</p>
<p>“Hi, Gerry.”</p>
<p>“I used to have a 500-page website, but I had no self-control. It was one more page, one more page… What harm could one more page do?”</p>
<p>Redesign is rehab for websites. Every two to three years some manager either gets bored with the design or some other manager meets a customer who tells them about how horrible it is to find anything on the website. The design team rounds up a new bunch of fake images and fake content for the top-level pages, while carefully avoiding going near the heaving mess at the lower levels. After the launch, everyone is happy for a while (except the customers, of course) because in many organizations what is important is to be seen to be doing things and producing and launching things, rather than to do something useful.</p>
<p>If you must do something, do something useful. That often means not doing, removing, minimizing, cleaning up.</p>
<p>Beware the tiny tasks. We’ve used the Top Tasks method to identify what matters and what doesn’t matter to people, whether they’re buying a car, choosing a university, looking after their health, buying some sort of technology product, or whatever. In any environment we’ve carried it out in—and we’ve done it more than 500 times—there are no more than 100 things that could potentially matter.</p>
<p>In a health environment, these might include symptoms, treatment, prevention, costs, waiting times, etc. When buying a car they might include price, engine type, warranties, service costs, etc. We’ve carried out Top Tasks surveys in some 40 countries and 30 languages, with upwards of 400,000 people voting. In every single survey the same patterns emerge. Let’s say there are 100 potential tasks. People are asked to vote on the tasks that are most important to them. When the results come in, we will find that five of the tasks will get the first 25% of the vote. 50 tasks will get the final 25% of the vote. The top five tasks get as much of the vote as the bottom 50. It’s the same pattern in Norway, New Zealand, Israel, USA, Canada, UK, Brazil, wherever.</p>
<p>The bottom 50 are what I call the tiny tasks. When a tiny task goes to sleep at night it dreams of being a top task. These tiny tasks—the true waste generators—are highly ambitious and enthusiastic. They will do everything they can to draw attention to themselves, and one of the best ways of doing that is to produce lots of content, design, code.</p>
<p>Once we get the Top Tasks results, we sometimes analyze how much organizational effort is going into each task. Invariably, there is an inverse relationship between the importance of the task to the customer and the effort that the organization is making in relation to these tasks. The more important it is to the customer, the less is being done; the less important it is to the customer, the more is being done.</p>
<p>Beware of focusing too much energy, time and resources on the tiny tasks. Reducing the tiny tasks is the number one way you can reduce the number of pages and features. Save the planet. Delete the tiny tasks.</p>
<h2 id="section3">A plague of useless images<a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h2>
<p>I was giving a talk at an international government digital conference once, and I asked people to send me examples of where digital government was working well. One suggestion was for a website in a language I don’t speak. When I visited it, I saw one of those typical big images that you see on so many websites. I thought to myself: I’m going to try and understand this website based on its images.</p>
<p>The big image was of a well-dressed, middle-aged woman walking down the street while talking on her phone. I put on my Sherlock Holmes hat. Hmm… Something to do with telecommunications, perhaps? Why would they choose a woman instead of a man, or a group of women and men? She’s married, I deduced by looking at the ring on her finger. What is that telling me? And what about her age? Why isn’t she younger or older? And why is she alone? Questions, questions, but I’m no Sherlock Holmes. I couldn’t figure out anything useful from this image.</p>
<p>I scrolled down the page. Ah, three more images. The first one is a cartoon-like image of a family on vacation. Hmm… The next one is of two men and one woman in a room. One of them has reached their hand out and placed it on something, but I can’t see what that something is, because the other two have placed their hands on top of that hand. It’s a type of pledge or something, a secret society, perhaps? Two of them are smiling and the third is trying to smile. What could that mean? And then the final picture is of a middle-aged man staring into the camera, neither smiling nor unsmiling, with a somewhat kind, thoughtful look. What is happening?</p>
<p>I must admit that after examining all the visual evidence I had absolutely no clue what this government website was about. So, I translated it. It was about the employment conditions and legal status of government employees. Now, why didn’t I deduce that from the images?</p>
<p>The Web is smothering us in useless images that create lots of pollution. These clichéd, stock images communicate absolutely nothing of value, interest or use. They are one of the worst forms of digital pollution and waste, as they cause page bloat, making it slower for pages to download, while pumping out wholly unnecessary pollution. They take up space on the page, forcing more useful content out of sight, making people scroll for no good reason.</p>
<p>Interpublic is a very large global advertising agency. As with all advertising agencies they stress how “creative” they are, which means they love huge, meaningless, happy-clappy polluting images. When I tested their homepage, it emitted almost 8 grams of CO2 as it downloaded, putting Interpublic in the worst 10% of website polluters, according to the Website Carbon Calculator. (For comparison, the Google homepage emits 0.23 grams.) One single image on its homepage weighed 3.2 MB. This image could easily have been 10 times smaller, while losing nothing in visual appeal. The Interpublic website is like a filthy, rusty 25-year-old diesel truck, belching fumes as it trundles down the Web.</p>
<p>Instead of optimizing images so that they’ll download faster, the opposite is often happening. High-resolution images are a major cost to the environment. If, for example, you move from a 4K resolution image to an 8K one, the file size doesn’t double, it trebles. For example, I saved an image at 4K and it was 6.9 MB. At 8K it was 18 MB.</p>
<p>Digital “progress” and “innovation” often means an increasing stress on the environment. Everything is more. Everything is higher. Everything is faster. And everything is exponentially more demanding of the environment. Digital is greedy for energy and the more it grows the greedier it gets. We need digital innovation that reduces environmental stress, that reduces the digital footprint. We need digital designers who think about the weight of every design decision they make.</p>
<p>We must start by trying to use the option that damages the environment least, and that is text. Don’t assume that images are automatically more powerful than text. Sometimes, text does the job better.</p>
<ul><li>In a test with an insurance company, it was found that a promotion for a retirement product was deemed less accurate when an image of a face was used than when text only was used.</li>
</ul><ul><li>An initiative by the UK government to get people to sign up to become potential organ donors tested eight approaches. The approaches that used images were least effective. Text-only worked best.</li>
</ul><p>“Hello?”</p>
<p>“Hello. Is that the Department of Useless Images?”</p>
<p>“Yes.”</p>
<p>“We have this contact form and we need a useless image for it.”</p>
<p>“How about a family cavorting in a field of spring flowers with butterflies dancing in the background?”</p>
<p>“Perfect.”</p>
<p>There are indeed many situations where images are genuinely useful, particularly when it comes to helping people better understand how a product works or looks. Airbnb, for example, found that its growth only began to accelerate after it invested in getting quality images of the rental properties on offer.</p>
<p>If you need to use images, optimize them and consider using real ones of real people doing real things.</p>
<p>They say a picture paints a thousand words but sometimes it’s a thousand words of crap.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">In this excerpt from Creative Culture, Justin Dauer walks us through many ways in which an organizations’ culture and the design work that it does play off of one another.</div><div class="entry-content">Amy Bucher shares insights into using personalization to create meaningful user experiences.</div><div class="entry-content">Noah Glushien shares the ins and outs of creating a successful career in web, despite being color blind.</div><div class="entry-content">Building a more inclusive internet goes far beyond making our code more accessible. Olu offers a thoughtful approach to a more welcoming web.</div><div class="entry-content">In this excerpt from Figure It Out, Stephen Anderson and Karl Fast take you on a deep dive into color.</div>]]></description>
      <link>https://alistapart.com/article/webwaste/</link>
      <guid>https://alistapart.com/article/webwaste/</guid>
      <pubDate>Thu, 09 Jul 2020 16:30:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Connecting the Dots]]></title>
      <description><![CDATA[<div class="entry-content">
<p>Two plans: one for design, one for culture.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>What I’ve found is that the DNA between both dynamics must be inextricable from one another. Creating <em>with </em>compassion in an environment fueled <em>by </em>compassion means we never lose sight of what it’s all about: people. Beyond functioning in this manner because “it’s the right thing to do,” quality of work, loyalty internally (team) and externally (users), and product innovation are all benefits to reap.</p>
<p>Earlier we talked through the concept of “simplicity” and its application to creation and environment. Now, let’s revisit a few other examples of healthy benchmarks from a creative culture as we’ve discussed in this book:</p>
<ul><li>Slowing down / pausing with intent</li>
<li>Everyone has a seat at the table</li>
<li>The New Day One</li>
</ul><p>In taking a focused look at these facets, their correlation to <abbr title="human-centered design">HCD</abbr> is readily apparent:</p>
<p><strong>Culture: </strong>Slowing down / pausing with intent<br /><strong>Design: </strong>Discovery / observation</p>
<p>The Swedish concept of <em>fika </em>transcends a mere “coffee break.” It’s about slowing down, the act of pausing during a typical day and making time to have a dialogue with someone (though a good cup of coffee is a vital part). I ensure this time is not only a known quantity within my team’s creative culture, but that it’s protected and actively utilized.</p>
<p>Instead of getting a product manager’s Powerpoint wireframe in your inbox with a request to “make it look nice” or a client’s request to crank out a design for their approval by EOD, we <em>must </em>slow down to understand the people who will be interacting with our design (and the design’s potential impact on others, the environment and community in which it will be used, and so on). Rushing to get something done to tick an account manager’s client-appeasement box at the expense of the human experience is to sacrifice empathy, quality, and any prospect of innovation.</p>
<p><strong>Culture: </strong>Everyone has a seat at the table<br /><strong>Design: </strong>Inclusion</p>
<p>As the very definition of cultural transparency, Nick Sarillo’s pizza parlors tack their full financial statements to a wall, daily, for all employees to see. Everyone’s hourly wage is listed on a nearby whiteboard, with the means to make more money articulated in tandem (training in more areas of business = increased hourly wage). Many managers have worked their way up in this manner, and offer training to other employees who wish to advance by taking on more responsibility. This is about collaboration yielding success to both the employee and the business, the sharing of information, and access for all; key dynamics of an inclusive culture.</p>
<p>Inclusion in the design process enables us, as creators, to recognize our own personal biases. By identifying the exclusion in our work, we humbly set aside our assumptions; connecting with people from diverse communities, building empathy, will expand our product’s reach (access). Via engaging humans throughout our design process, listening to them, and usability testing iteratively, objective solutions that yield innovation follow suit.</p>
<p><strong>Culture: </strong>The New Day One<br /><strong>Design: </strong>Ethnography</p>
<p>The New Day One concept evolves an employee’s first day from formulaic and sterile into directly personal and custom. Via the “Inspiration” portion of the day and venturing away from the office, we gain insight into a new team member as an individual that transcends what folio work can yield. What physical aspects of their selected location have impacted who they are? How did it inspire their way of creating, or approaching problems? Understanding the impact of spatial dynamics on an individual is vital toward an individualistic, yet ultimately holistic, view.</p>
<p>Ethnographic research provides an environmental context to human interaction that a video-conference interview could never yield. Through direct observation, ethnography is the qualitative study of human beings in their native environment. Is the individual sitting in a high-traffic area in an office, causing frequent distraction from their work? Are they a field worker primarily utilizing a mobile device in direct sunlight, yielding paramountcolor contrast needs? By making research truly <em>human</em>, we gain an understanding of how those we observe see the world and how they ultimately engage with it.</p>
<h2 id="section2">For the Greater Good<a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>Greater Good Studio (GGS) is a social impact-focused human- centered design firm co-founded by Sara Cantor Aye and George Aye. Their business is located within the Logan Share, a co- working space they also founded in Chicago’s Logan Square neighborhood.</p>
<p>I reached out to the Studio to ask if I could stop by their space and observe a “morning in the life” view of their process: culture and design, organically, as both unfolded. Without hesitation, Sara (a former Northwestern University instructor) extended me an offer to join the team for observation. After signing a non- disclosure agreement, we agreed on a date for my visit.</p>
<p>When I arrived on a Monday morning, George (formerly of IDEO) greeted me with a cup of coffee and walked me up the stairs into the naturally well-lit Logan Share space. I noticed the open seating in the co-working section was already nearly full, as he gave me a tour of the “configuration by human need and intent”-based layout and active-project areas. On long single sheets of cardboard suspended by custom-built fasteners, entire lifecycles of project- centric human-centered design artifacts were on display. Once a project is deployed, George explained, the cardboard is detached and saved for forthcoming iteration, with fresh sheets re-fastened to form the partitions of a new project space thereafter.</p>
<p>The six core steps of the Studio’s HCD process manifest themselves in the following way:</p>
<ol><li><strong>Framing</strong><br />
Defining questions to answer and people to engage</li>
<li><strong>Research</strong><br />
Learning from people about their needs and values</li>
<li><strong>Synthesis</strong><br />
Finding patterns of behavior and areas of opportunity</li>
<li><strong>Concepting</strong><br />
Creating a high volume of new ideas</li>
<li><strong>Prototyping</strong><br />
Making tangible mock-ups and gathering feedback</li>
<li><strong>Piloting</strong><br />
Testing solutions in real time with real people</li>
</ol><p>As a team, GGS functions via a working method called ROWE (Results Only Work Environment), a concept leveraged from Cali Ressler and Jody Thompson’s book <em>Why Work Sucks and How to Fix It: The Results-Only Revolution. </em>Taken from an article on the Studio’s blog, they describe the practice within GGS like this:</p>
<blockquote class="wp-block-quote">
<p><em>“The basic principle behind ROWE is that staff doesn’t need to be supervised, when given the tools, clear expectations, and deadlines people will not only do their work, but do it better than if they were trying to fit into a mold. Within GGS, this practice is exercised by very diligent calendar management, clear deadlines, expectations on deliverables, and Cookie Rewards (little treats we give each other if we have to move something on the calendar).”</em></p>
</blockquote>
<p>Once a month the entire team pauses for a five-hour, non-client project block of time called “internal day.” This time is reserved for studio-centric things: team members sharing learnings from conferences they’ve attended, how to improve internal practices, past project debriefs, etc. It’s the act of pausing with intent, in full effect.</p>
<p>Sara arrived a few minutes into my tour of the space, and the GGS team’s “BD charrette” was the first employee gathering (remote and in-person) of the morning. “BD” stands for “business development,” and in a cozy seating area, everyone had a seat at the table in all senses of the phrase. Sara and George ran through the status of a current request for proposal, then each team member had the opportunity to voice their opinion about whether the RFP should be pursued based on how it aligned with GGS’s (and their employees’) personal, values. Everyone was heard; every voice was respected.</p>
<p>The dialogue eventually shifted to another potential new client, this time with GGS at the presentation stage. Again, everyone at the table gave their feedback on Sara and George’s presentation plan of attack and, again, every team member’s voice carried equal value and weight. The studio-wide inclusion in the business owners’ decision making was genuine, effortless, and natural.</p>
<p>Forty-five minutes later, the group made a physical transition to a few nearby couches; less than a three-foot walk, as I eyed it. I inquired about the very minor spatial change for this next leg of the meeting and was told, “There’s a difference in purpose, so we transition to a different space.” Each member of the team then took their turn describing their weekend in three words:</p>
<blockquote class="wp-block-quote">
<p><em>“Sunshine, beach, baking.”</em></p>
</blockquote>
<p>I got my turn as well. Changing the energy on those couches, from new business to being focused on the individual, made for a palpable climate change. In a few words everyone had a sense of what their teammates got up to over the weekend, eliciting smiles and planting the seeds for future dialogues throughout the pauses- with-intent over the rest of the day.</p>
<p>Next: “validations.” In this final portion of the meeting (pre- project status), anyone who wanted to articulate their appreciation for a team member over the previous week did so. One person recognized their co-worker for their selfless collaboration, taking time from their own project work to help theirs get client-ready on time. Similar-but-unique “thanks” emerged from varied people; no one was required to speak up, but everyone did.</p>
<p>After project updates I sat with Sara for a one-on-one to chat over coffee. I asked her about the synergies between their HCD process and how she interacts with her team in the office:</p>
<blockquote class="wp-block-quote">
<p><em>“I think where it’s actually become more intentional and obvious has been with our staff who are not trained designers. Operations folks, or our community manager, etc. I’ve had to say, ‘I want you to be a designer about this’ (whatever ‘this’ is). ‘We are your users, you’re trying to get us to do our timesheets, or clean up the kitchen, etc. Observe. Talk to people. Figure out our motivations. Summarize everything you’ve learned, and then have ideas.’</em></p>
<p><em>As a designer, I am constantly designing at every level. I’m designing deliverables in many cases for clients, or coaching our teams to design deliverables. I’m also designing process by which we work by writing proposals, scoping, etc. And at the highest level, I’m designing our company. I’m designing our culture based on our customs and traditions and policies (the hard and the soft) every day. My users are not hypothetical, they’re actual people.”</em></p>
</blockquote>
<h2 id="section3">When All is Not Good<a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h2>
<p>Sara went on to cite how her previous work experience shaped the leader she is today:</p>
<blockquote class="wp-block-quote">
<p><em>“I think a lot of my design choices are based in (unhealthy dynamics) with prior employers. Where decisions were not made transparently, everything financial was completely opaque. Lots of lack of trust with other employees. It’s been so critical that I’ve had bad experiences so I can now clearly say: let’s not do that.”</em></p>
</blockquote>
<p>The tactics, mindsets, organizational shifts, and operational flexibility discussed in this book are predicated upon a simple truth: a company presently supports and operates as a creative culture, or it’s genuinely willing to evolve to become one. Along the way, I’ve been primarily speaking to those who are in a position to help implement change; even at a small scale. But what about when you’re not in a position to be heard, or the position to help facilitate change?</p>
<p>Reality isn’t always unicorns and rainbows. Bad experiences can impact us all. For example, the fabric of a company’s creative culture can become irreparably frayed thanks to management changes, acquisition, or it can lack sustainability. Whether these circumstances reveal themselves over years or overnight, your passion and evolution should never be their casualty.</p>
<p>Sometimes, creating within an environment that’s the best fit for your growth and passions means finding a new opportunity.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Amy Bucher shares insights into using personalization to create meaningful user experiences.</div><div class="entry-content">Noah Glushien shares the ins and outs of creating a successful career in web, despite being color blind.</div><div class="entry-content">Building a more inclusive internet goes far beyond making our code more accessible. Olu offers a thoughtful approach to a more welcoming web.</div><div class="entry-content">In this excerpt from Figure It Out, Stephen Anderson and Karl Fast take you on a deep dive into color.</div><div class="entry-content">"Designing Value," an excerpt from Jim Kalbach's book The Jobs To Be Done Playbook, gives advice on creating a jobs-driven roadmap and using job stories to solve specific design problems.</div>]]></description>
      <link>https://alistapart.com/article/creative-culture-excerpt/</link>
      <guid>https://alistapart.com/article/creative-culture-excerpt/</guid>
      <pubDate>Thu, 02 Jul 2020 16:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Mr. Roboto: Connecting with Technology]]></title>
      <description><![CDATA[<div class="entry-content">
<p>People don’t always need another human being to experience a sense of connection. The deep emotional bonds many people have with their pets proves this. (So might the popularity of the Pet Rock in the 1970s but that’s just speculation.) Even Link in <em>The Legend of Zelda</em> had an inanimate companion: his trusty sword (see Figure 9.1).</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<figure id="figure1" class="wp-block-image size-large"><img src="https://alistapart.com/wp-content/uploads/2020/06/engaged-9.1.jpg?fit=960%2C600&amp;w=960" alt="A screen from The Legend of Zelda where Link receives his sword from an old man saying 'It's Dangerous To Go Alone! Take This.'" class="wp-image-7172418" data-recalc-dims="1" /><figcaption><strong>Fig 9.1</strong> Even the company of a wooden sword is better than venturing into Hyrule alone.</figcaption></figure><p>It’s also possible for people to feel that sense of connection in the context of behavior change without having direct relationships with others. By building your product in a way that mimics some of the characteristics of a person-to-person relationship, you can make it possible for your users to feel connected to it. It is possible to coax your users to fall at least a little bit in love with your products; if you don’t believe me, try to get an iPhone user to switch operating systems.</p>
<p>It’s not just about really liking a product (although you definitely want users to really like your product). With the right design elements, your users might embark on a meaningful bond with your technology, where they feel engaged in an ongoing, two-way relationship with an entity that understands something important about them, yet is recognizably non<span class="c1">–</span>human. This is a true emotional attachment that supplies at least some of the benefits of a human-to-human relationship. This type of connection can help your users engage more deeply and for a longer period of time with your product. And that should ultimately help them get closer to their behavior change goals.</p>
<h2 id="section2">Amp Up the Anthropomorphization<a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>People can forge relationships with non<span class="c1">–</span>humans easily because of a process called <em>anthropomorphization</em>. To anthropomorphize something means to impose human characteristics on it. It’s what happens when you see a face in the array of shapes on the right side in Figure 9.2, or when you carry on an extended conversation with your cat.<sup>[1]</sup></p>
<figure id="figure2" class="wp-block-image size-large"><img src="https://alistapart.com/wp-content/uploads/2020/06/engaged-9.2.jpg?fit=960%2C576&amp;w=960" alt="An assortment of the same four shapes side by side. The grouping on the right looks like a face based on the shape positions." class="wp-image-7172419" data-recalc-dims="1" /><figcaption><strong>Fig 9.2</strong> The brain is built to seek and recognize human characteristics whenever a pattern suggests they might be there. That means people interpret the array of shapes on the right as face-like, but not the one on the left.</figcaption></figure><p>People will find the human qualities in shapes that slightly resemble a face, but you can help speed that process along by deliberately imbuing your product with physical or personality features that resemble people. Voice assistants like Siri, Cortana, and Alexa, for example, are easily perceived as human-like by users thanks to their ability to carry on a conversation much like a (somewhat single-minded) person.</p>
<p>Granted, almost nobody would mistake Alexa for a real person, but her human characteristics are pretty convincing. Some research suggests that children who grow up around these voice assistants may be less polite when asking for help, because they hear adults make demands of their devices without saying please or thank you. If you’re asking Siri for the weather report and there are little ones in earshot, consider adding the <em>other</em> magic words to your request.</p>
<p>So, if you want people to anthropomorphize your product, give it some human characteristics. Think names, avatars, a voice, or even something like a catchphrase. These details will put your users’ natural anthropomorphization tendencies into hyperdrive.</p>
<h2 id="section3">Everything Is Personal<a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h2>
<p>One thing humans do well is personalization. You don’t treat your parent the same way you treat your spouse the same way you treat your boss. Each interaction is different based on the identity of the person you’re interacting with and the history you have with them. Technology can offer that same kind of individualized experience as another way to mimic people, with lots of other benefits.</p>
<p>Personalization is the Swiss Army Knife of the behavior change design toolkit. It can help you craft appropriate goals and milestones, deliver the right feedback at the right time, and offer users meaningful choices in context. It can also help forge an emotional connection between users and technology when it’s applied in a way that helps users feel seen and understood.</p>
<p>Some apps have lovely interfaces that let users select colors or background images or button placements for a “personalized” experience. While these types of features are nice, they don’t scratch the itch of belonging that true personalization does. When personalization works, it’s because it reflects something essential about the user back to them. That doesn’t mean it has to be incredibly deep, but it does need to be somewhat more meaningful than whether the user has a pink or green background on their home screen.</p>
<h2 id="section4">Personalized Preferences<a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h2>
<p>During onboarding or early in your users’ product experience, allow them to personalize preferences that will shape their experiences in meaningful ways (<em>not</em> just color schemes and dashboard configurations). For example, Fitbit asks people their preferred names, and then greets them periodically using their selection. Similarly, LoseIt asks users during setup if they enjoy using data and technology as part of their weight loss process (Figure 9.3). Users who say yes are given an opportunity to integrate trackers and other devices with the app; users who say no are funneled to a manual entry experience. The user experience changes to honor something individual about the user.</p>
<figure id="figure3" class="wp-block-image size-large"><img src="https://alistapart.com/wp-content/uploads/2020/06/engaged-9.3-1.jpg?fit=960%2C889&amp;w=960" alt="Screenshots of the LoseIt app showing it asking whether a user enjoys looking at data and using technology then acknowledging their choice." class="wp-image-7172421" data-recalc-dims="1" /><figcaption><strong>Fig 9.3</strong> LoseIt gives users an opportunity to share their technology preferences during onboarding and then uses that choice to shape their future experience.</figcaption></figure><p>If you can, recall back to ancient times when Facebook introduced an algorithmic sort of posts in the newsfeed. Facebook users tend to be upset anytime there’s a dramatic change to the interface, but their frustration with this one has persisted, for one core reason: Facebook to this day reverts to its own sorting algorithm as a default, even if a user has selected to organize content by date instead. This repeated insistence on their preference over users’ makes it less likely that users will feel “seen” by Facebook.<sup>[2]</sup></p>
<h2 id="section5">Personalized Recommendations<a class="subhead-anchor" href="https://alistapart.com#section5">#section5</a></h2>
<p>If you’ve ever shopped online, you’ve probably received personalized recommendations. Amazon is the quintessential example of a recommendation engine. Other commonly encountered personalized recommendations include Facebook’s “People You May Know” and Netflix’s “Top Picks for [Your Name Here].” These tools use algorithms that suggest new items based on data about what people have done in the past.</p>
<p>Recommendation engines can follow two basic models of personalization. The first one is based on products or items. Each item is tagged with certain attributes. For example, if you were building a workout recommendation engine, you might tag the item of “bicep curls” with “arm exercise,” “upper arm,” and “uses weights.” An algorithm might then select “triceps pulldowns” as a similar item to recommend, since it matches on those attributes. This type of recommendation algorithm says, “If you liked this item, you will like this similar item.”</p>
<p>The second personalization model is based on people. People who have attributes in common are identified by a similarity index. These similarity indices can include tens or hundreds of variables to precisely match people to others who are like them in key ways. Then the algorithm makes recommendations based on items that lookalike users have chosen. This recommendation algorithm says, “People like you liked these items.”</p>
<p>In reality, many of the more sophisticated recommendation engines (like Amazon’s) blend the two types of algorithms in a hybrid approach. And they’re effective. McKinsey estimates that 35% of what Amazon sells and 75% of what Netflix users watch are recommended by these engines.</p>
<h2 id="section6">Don’t Overwhelm<a class="subhead-anchor" href="https://alistapart.com#section6">#section6</a></h2>
<p>Sometimes what appear to be personalized recommendations can come from a much simpler sort of algorithm that doesn’t take an individual user’s preferences into account at all. These algorithms might just surface the suggestions that are most popular among <em>all</em> users, which isn’t always a terrible strategy. Some things are popular for a reason. Or recommendations could be made in a set order that doesn’t depend on user characteristics at all. This appears to be the case with the Fabulous behavior change app that offers users a series of challenges like “drink water,” “eat a healthy breakfast,” and “get morning exercise,” regardless of whether these behaviors are already part of their routine or not.</p>
<p>When recommendation algorithms work well, they can help people on the receiving end feel like their preferences and needs are understood. When I browse the playlists Spotify creates for me, I see several aspects of myself reflected. There’s a playlist with my favorite 90s alt-rock, one with current artists I like, and a third with some of my favorite 80s music (Figure 9.4). Amazon has a similar ability to successfully extrapolate what a person might like from their browsing and purchasing history. I was always amazed that even though I didn’t buy any of my kitchen utensils from Amazon, they somehow figured out that I have the red KitchenAid line.</p>
<figure id="figure4" class="wp-block-image size-large"><img src="https://alistapart.com/wp-content/uploads/2020/06/engaged-9.4.jpg?fit=960%2C524&amp;w=960" alt="Spotify's Daily Mixes showcasing three distinct sets of musical styles based on the user's listening habits." class="wp-image-7172422" data-recalc-dims="1" /><figcaption><strong>Fig 9.4</strong> Spotify picks up on the details of users’ musical selections to construct playlists that reflect multiple aspects of their tastes.</figcaption></figure><p>A risk to this approach is that recommendations might become redundant as the database of items grows. Retail products are an easy example; for many items, once people have bought one, they likely don’t need another, but algorithms aren’t always smart enough to stop recommending similar purchases (see Figure 9.5). The same sort of repetition can happen with behavior change programs. There are only so many different ways to set reminders, for example, so at some point it’s a good idea to stop bombarding a user with suggestions on the topic.</p>
<figure id="figure5" class="wp-block-image size-large"><img src="https://alistapart.com/wp-content/uploads/2020/06/engaged-9.5.jpg?w=960" alt="A tweet from Andy Richter saying 'I ordered a toilet seat from Amazon and now based on the ads I see they must think I have an insatiable toilet seat addiction'" class="wp-image-7172423" data-recalc-dims="1" /><figcaption><strong>Fig 9.5</strong> When a user only needs a finite number of something, or has already satisfied a need, it’s easy for recommendations to become redundant.</figcaption></figure><h2 id="section7">Don’t Be Afraid to Learn<a class="subhead-anchor" href="https://alistapart.com#section7">#section7</a></h2>
<p>Data-driven personalization comes with another set of risks. The more you know about users, the more they expect you to provide relevant and accurate suggestions. Even the smartest technology will get things wrong sometimes. Give your users opportunities to point out if your product is off-base, and adjust accordingly. Not only will this improve your accuracy over time, but it will also reinforce your users’ feelings of being cared for.</p>
<p>Alfred was a recommendation app developed by Clever Sense to help people find new restaurants based on their own preferences, as well as input from their social networks. One of Alfred’s mechanisms for gathering data was to ask users to confirm which restaurants they liked from a list of possibilities (see Figure 9.6). Explicitly including training in the experience helped Alfred make better and better recommendations while also giving users the opportunity to chalk errors up to a need for more training.<sup>[3]</sup></p>
<figure id="figure6" class="wp-block-image size-large"><img src="https://alistapart.com/wp-content/uploads/2020/06/engaged-9.6-1.jpg?fit=731%2C1024&amp;w=960" alt="The Alfred app takes a guess at places the user might enjoy for dinner and asks if any of them are right." class="wp-image-7172425" data-recalc-dims="1" /><figcaption><strong>Fig 9.6</strong> Alfred included a learning mode where users would indicate places they already enjoyed eating. That data helped improve Alfred’s subsequent recommendations.</figcaption></figure><p>Having a mechanism for users to exclude some of their data from an algorithm can also be helpful. Amazon allows users to indicate which items in their purchase history should be ignored when making recommendations—a feature that comes in handy if you buy gifts for loved ones whose tastes are very different from yours.</p>
<p>On the flip side, deliberately throwing users a curve ball is a great way to learn more about their tastes and preferences. Over time, algorithms are likely to become more consistent as they get better at pattern matching. Adding the occasional mold-breaking suggestion can prevent boredom and better account for users’ quirks. Just because someone loves meditative yoga doesn’t mean they don’t also like going mountain biking once in a while, but most recommendation engines won’t learn that because they’ll be too busy recommending yoga videos and mindfulness exercises. Every now and then add something into the mix that users won’t expect. They’ll either reject it or give it a whirl; either way, your recommendation engine gets smarter.</p>
<h2 id="section8">Personalized Coaching<a class="subhead-anchor" href="https://alistapart.com#section8">#section8</a></h2>
<p>At some point, recommendations in the context of behavior change may become something more robust: an actual personalized plan of action. When recommendations grow out of the “you might also like” phase into “here’s a series of steps that should work for you,” they become a little more complicated. Once a group of personalized recommendations have some sort of cohesiveness to systematically guide a person toward a goal, it becomes <em>coaching</em>.</p>
<p>More deeply personalized coaching leads to more effective behavior change. One study by Dr. Vic Strecher, whom you met in Chapter 3, showed that the more a smoking cessation coaching plan was personalized, the more likely people were to successfully quit smoking. A follow-up study by Dr. Strecher’s team used fMRI technology to discover that when people read personalized information, it activates areas of their brain associated with the self (see Figure 9.7). That is, people perceive personalized information as self-relevant on a neurological level.</p>
<figure id="figure7" class="wp-block-image size-large"><img src="https://alistapart.com/wp-content/uploads/2020/06/engaged-9.7.jpg?fit=960%2C485&amp;w=960" alt="A front and side scan from an MRI showing activation (in yellow) in the prefrontal cortex." class="wp-image-7172426" data-recalc-dims="1" /><figcaption><strong>Fig 9.7</strong> This is an fMRI image showing activation in a person’s medial prefrontal cortex (mPFC), an area of the brain associated with the self. The brain activity was recorded after showing people personalized health information.</figcaption></figure><p>This is important because people are more likely to remember and act on relevant information. If you want people to <em>do</em> something, personalize the experience that shows them how.</p>
<p>From a practical perspective, personalized coaching also helps overcome a common barrier: People do not want to spend a lot of time reading content. If your program can provide only the most relevant items while leaving the generic stuff on the cutting room floor, you’ll offer more concise content that people may actually read.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Noah Glushien shares the ins and outs of creating a successful career in web, despite being color blind.</div><div class="entry-content">Building a more inclusive internet goes far beyond making our code more accessible. Olu offers a thoughtful approach to a more welcoming web.</div><div class="entry-content">In this excerpt from Figure It Out, Stephen Anderson and Karl Fast take you on a deep dive into color.</div><div class="entry-content">"Designing Value," an excerpt from Jim Kalbach's book The Jobs To Be Done Playbook, gives advice on creating a jobs-driven roadmap and using job stories to solve specific design problems.</div><div class="entry-content">Voice-driven content challenges many of our approaches to usability testing. Preston So turns them into opportunities and advantages for the medium itself.</div>]]></description>
      <link>https://alistapart.com/article/engaged-excerpt/</link>
      <guid>https://alistapart.com/article/engaged-excerpt/</guid>
      <pubDate>Thu, 25 Jun 2020 16:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Building the Woke Web: Web Accessibility, Inclusion &#038; Social Justice]]></title>
      <description><![CDATA[<div class="entry-content">
<p>What would your life be like without the internet? Not if it didn’t exist at all, but if you were locked out of it? Would your days be different? Unrecognizable, even? Keeping your answers to that in mind, do you think access to the internet is a human right? Do we need to be able to access it to fully participate in modern society? To answer “yes” to these questions would have been unthinkable 20 years ago.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<h2 id="section2">Living without internet<a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>Globally, over 40% of people still <a href="https://thenextweb.com/growth-quarters/2020/01/30/digital-trends-2020-every-single-stat-you-need-to-know-about-the-internet/">do not have access to the internet</a>. That lack of access and the issues it creates have helped motivate digital equity initiatives like <a href="https://www.techgoeshome.org/">Tech Goes Home</a> and the <a href="https://www.goodthingsfoundation.org/">Good Things Foundation</a>.</p>
<p>Having no access to the internet creates problems in many parts of modern life. In the UK, bank branches are closing, forcing many to do their banking online. Many utilities now require internet access to request or amend services, or get better deals. Civil services, such as registering to vote, are increasingly online. As this continues, people who have no access to broadband or who have limited access to mobile data fall behind—this often includes homeless people, elderly people, and those on low incomes who are already operating at a disadvantage.</p>
<p>In the UK, only <a href="https://gds.blog.gov.uk/2014/01/13/a-checklist-for-digital-inclusion-if-we-do-these-things-were-doing-digital-inclusion/">37% of people living in social housing</a> are online. Approximately 1 in 5 adults with a disability in the UK have <a href="https://www.ons.gov.uk/businessindustryandtrade/itandinternetindustry/bulletins/internetusers/2019#recent-internet-use-by-disabled-adults-reaches-10-million-adults">not used the internet recently</a>, and they make up half of the people who have not accessed the internet in the last three months. Globally, the UN target for affordable mobile data is <a href="https://a4ai.org/un-broadband-commission-adopts-a4ai-1-for-2-affordability-target/">2% of monthly income for 1GB data</a>, and yet many <a href="https://a4ai.org/extra/mobile_broadband_pricing_gnicm-2019Q2">countries are still nowhere near</a> reaching this goal. Not having access to the internet is expensive, locking you out of essential services and a surfeit of helpful information. Giving people full access to the splendors and knowledge of the online world should be imperative for everyone who works on it.</p>
<p>Digital exclusion is when someone is unable or unwilling to access information and services online. In the UK, <a href="https://www.ons.gov.uk/peoplepopulationandcommunity/householdcharacteristics/homeinternetandsocialmediausage/articles/exploringtheuksdigitaldivide/2019-03-04#the-scale-of-digital-exclusion-in-the-uk">10% of the adult population was digitally excluded</a> in 2018. The number of people in the UK lacking basic digital skills is decreasing, but in 2018, 8% of adults in the UK (4.3 million people) were estimated to have zero basic digital skills, which means they are unable to do things like buy items online, verify information, or send an email. <a href="https://www.ons.gov.uk/peoplepopulationandcommunity/householdcharacteristics/homeinternetandsocialmediausage/articles/exploringtheuksdigitaldivide/2019-03-04#how-does-internet-usage-and-digital-exclusion-vary-for-men-and-women">Women are more likely</a> to have no basic digital skills. </p>
<p>Being unable to send an email, submit an application online, or use a government site is a huge barrier to civic and societal engagement. Shopping in person, rather than online, can mean you are <a href="https://www.ons.gov.uk/peoplepopulationandcommunity/householdcharacteristics/homeinternetandsocialmediausage/articles/exploringtheuksdigitaldivide/2019-03-04#why-does-digital-exclusion-matter">consistently overcharged for your purchase</a> by as much as 13%. <a href="https://www.ons.gov.uk/peoplepopulationandcommunity/householdcharacteristics/homeinternetandsocialmediausage/articles/exploringtheuksdigitaldivide/2019-03-04#why-does-digital-exclusion-matter">Not knowing how to use computers can mean you earn less in the first place. Not being able to use the internet can mean that you spend more time doing tasks such as registering to vote, paying council tax in the UK, or researching your next holiday</a>. </p>
<p>Being able to access the internet has social and psychological ramifications too. <a href="https://www.campaigntoendloneliness.org/threat-to-health/">Loneliness is well documented</a> as a risk factor for a number of health issues, as well as early death. <a href="https://www.ons.gov.uk/peoplepopulationandcommunity/householdcharacteristics/homeinternetandsocialmediausage/articles/exploringtheuksdigitaldivide/2019-03-04">Being online can help</a> you feel less alone. Half of all people with disabilities surveyed <a href="https://www.sense.org.uk/support-us/campaigns/loneliness/">report feeling lonely</a> in the UK, and a quarter of them are lonely every day. <a href="https://www.theguardian.com/media/2018/apr/04/missing-link-why-disabled-people-cant-afford-delete-facebook-social-media">People with disabilities are more likely</a> to be a captive audience to apps and websites using their data inappropriately or engaging in other unethical practices. <a href="https://www.theguardian.com/media/2018/apr/04/missing-link-why-disabled-people-cant-afford-delete-facebook-social-media">This may be because they rely on a particular site</a> to interact with other people with disabilities, because they lack the tools to visit other sites, or lack other suitable websites or apps to use.</p>
<p>Richer households are more likely to have full basic digital skills. The UK Office for National Statistics found that <a href="https://www.ons.gov.uk/peoplepopulationandcommunity/householdcharacteristics/homeinternetandsocialmediausage/articles/exploringtheuksdigitaldivide/2019-03-04#what-other-patterns-are-there-in-internet-usage">people without basic digital skills</a> are three times as likely to be in low-income bands. In 2018, <a href="https://www.lloydsbank.com/assets/media/pdfs/banking_with_us/whats-happening/LB-Consumer-Digital-Index-2018-Report.pdf">12% of 11-to-18-year-olds had no broadband access</a> on a tablet or computer, which 68% of them said made it difficult to do homework. Further, <a href="https://www.npi.org.uk/publications/income-and-poverty/disability-and-poverty/">households in which one or more of their members have a disability</a> make up half of those living in poverty in the UK.</p>
<h2 id="section3">Provide non-online options for vital services<a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h2>
<p>If you work in government, food supply, healthcare, or utilities, there is no excuse for not providing offline options. In doing so you are excluding some of the most marginalized people. The internet is amazing, but it is not the only way to share information.</p>
<h2 id="section4">A non-exhaustive list of other barriers<a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h2>
<p>Having access to the internet in the first place is one issue, and feeling welcome, or even safe is quite another. Even when your broadband connection is as good as can be hoped for, there are many other ways you can be discouraged or stopped from using the internet.</p>
<h3 id="section5">Trolling and threats<a class="subhead-anchor" href="https://alistapart.com#section5">#section5</a></h3>
<p>Online harassment is one of many barriers stopping people from accessing the internet. Diane Abbott, the first black woman Member of Parliament (MPs) in the UK, <a href="https://www.theguardian.com/politics/2017/sep/05/diane-abbott-more-abused-than-any-other-mps-during-election">received almost half (45.14%) of all abusive tweets sent to female MPs</a> in the run-up to the 2017 General Election that decided how voters would be represented in Parliament and which party would govern. Black and Asian women MPs got 35% more abusive tweets than white women MPs. The abuse directed at Dianne Abott amounted to 10 times as much as was received by any other female MP, according to an <a href="https://medium.com/@AmnestyInsights/unsocial-media-tracking-twitter-abuse-against-women-mps-fc28aeca498a">Amnesty International study</a>.</p>
<p>Mermaids is a charity that supports transgender children and their parents in the UK. Their CEO Susie Green—herself the parent of a transgender child—<a href="https://www.pinknews.co.uk/2018/03/14/head-of-transgender-childrens-charity-mermaids-targeted-with-vile-abuse-and-threats/">has been targeted with abuse and threats</a>. The rise in abusive and threatening comments led to Mermaids’ Twitter account having to <a href="https://www.theguardian.com/society/2017/aug/27/police-investigate-online-abuse-charity-transgender-children-mermaids">block up to 20 accounts a day</a>.</p>
<p>Trolling isn’t an easy problem to fix. Allowing users to block certain words and hide certain replies on Twitter is a start, but listening to people from marginalized backgrounds and their complaints and ideas would be another critical place to begin. </p>
<p>We need to think long and hard about what good moderation looks like and what guidelines work in online spaces to ensure those accessing them don’t have to wade through a tide of bigotry.</p>
<h3 id="section6">Sidelining and hiding certain groups<a class="subhead-anchor" href="https://alistapart.com#section6">#section6</a></h3>
<p>Information and support online are vital for at-risk LGBT people, whether to help them escape dangerous situations, access support, or find community. Yet in schools, words relating to LGBT issues are <a href="https://www.microsoft.com/en-us/research/blog/helping-the-lgbt-community-access-the-internet/">often blocked</a>. On YouTube, v<a href="https://www.theverge.com/2018/6/4/17424472/youtube-lgbt-demonetization-ads-algorithm">ideos relating to LGBT issues are demonetized, age-restricted, or even removed</a>. This isn’t because the content is sexually explicit or not safe for work. It’s just discrimination. TikTok recently admitted it actively discriminates against certain kinds of users—namely the <a href="https://slate.com/technology/2019/12/tiktok-disabled-users-videos-suppressed.html">fat, queer, disabled</a>, <a href="https://www.theguardian.com/technology/2020/mar/17/tiktok-tried-to-filter-out-videos-from-ugly-poor-or-disabled-users">low-income, and “ugly”</a>—in certain feeds, under the guise of paternalistic protection from bullying.</p>
<h3 id="section7">Exclusionary design<a class="subhead-anchor" href="https://alistapart.com#section7">#section7</a></h3>
<figure id="figure1" class="quote"><blockquote>
<p><em>People with disabilities are the original life hackers because our motivation is so high. If we don’t hack we often go without.</em></p>
</blockquote>
<figcaption>Liz Jackson, “<a href="https://www.youtube.com/watch?v=qiP_W1x0cV4">Designing for Inclusivity</a>”</figcaption></figure><p>Many people with disabilities rely on screen readers and screen reader compatible sites to use the internet. Screen readers can be prohibitively expensive; while there are free options, one of the most popular screen readers at the time of writing <a href="https://abilitynet.org.uk/factsheets/introduction-screen-readers">costs nearly $1200</a> for a professional license. Even with <a href="https://www.nvaccess.org/about-nvda/">incredible innovation coming from within the disabled community</a>, there’s more that everyone else can do. In their February 2020 evaluation, WebAIM found that <a href="https://webaim.org/projects/million/#wcag">98.1% of the top million websites</a> had detectable WCAG (Web Content Accessibility Guidelines) 2 errors.</p>
<p>The most common WCAG 2 failures—such as missing alt text for images, having empty links, and missing form labels—would be relatively simple to fix. Because they’re shared among most websites, concentrating on fixing them would have a huge overall benefit for the internet. But as long as web accessibility standards are applied without rigor, aspects of a vast number of sites remain inaccessible even once users have a screen reader or other assistive technology.</p>
<h3 id="section8">Hostile conditions<a class="subhead-anchor" href="https://alistapart.com#section8">#section8</a></h3>
<p>Inclusion is just as pertinent as accessibility, and tackling only one side of the equation will leave some people just as locked out. Accessibility without inclusion is not real accessibility. The <a href="https://medium.com/@mosaicofminds/the-curb-cut-effect-how-making-public-spaces-accessible-to-people-with-disabilities-helps-everyone-d69f24c58785"><em>curb cut effect</em></a>, wherein improving access for people with disabilities improves access for all, isn’t the only reason to increase web accessibility. We have a moral responsibility as tech workers to use any privilege we may have to facilitate, respond to, and support the efforts of marginalized people who are working to carve out accessible spaces for themselves.</p>
<p>Hostile conditions, created or reinforced by engineering and design choices, make being on the internet harder for people who are <a href="https://www.independent.co.uk/voices/coming-out-lgbt-gay-queer-disabled-disability-twice-sexuality-open-family-friends-a8212431.html">queer, of color, or disabled</a>. They make it more difficult to access life-saving spaces, social spaces, and civic spaces—both on and offline. Thorough accessibility and real inclusion are the solutions to these problems. To survive, marginalized people must work both against and through the abuse and accessibility issues they face on online platforms, whereas everyone else gets to use the internet as they wish. This replicates the injustices of offline in the online world.</p>
<h2 id="section9">An incomplete list of solutions<a class="subhead-anchor" href="https://alistapart.com#section9">#section9</a></h2>
<h3 id="section10">Center the voices and experiences of the marginalized<a class="subhead-anchor" href="https://alistapart.com#section10">#section10</a></h3>
<p>There isn’t one easy solution but to start finding the solutions that are possible we need to center <a href="https://whoseknowledge.org/">the voices and experiences of the marginalized</a>. Marginalized people with insights to share aren’t hard to find when you start listening. They are your next users, your future developers, your fledgling marketing team. Excluding them reduces your options, your appeal, and your breadth of ideas.</p>
<h3 id="section11">Hire teams that are diverse on every axis<a class="subhead-anchor" href="https://alistapart.com#section11">#section11</a></h3>
<p>Hiring inclusively creates teams full of people who aren’t like you or each other. And those kinds of teams build better products, bring better ideas to the table, and better reflect the user base of the majority of products. It is important to remember that diversity isn’t just about race or hiring women; there are neurodiverse people, people with physical disabilities, people of other genders, people from various backgrounds, and many other marginalizations than could be listed here.</p>
<h3 id="section12">Proactively promote inclusion and harness your team’s diversity<a class="subhead-anchor" href="https://alistapart.com#section12">#section12</a></h3>
<p>Help disabled and otherwise marginalized people both develop and enforce policies and practices that protect them and allow them to thrive. If there are no disabled people, or otherwise marginalized or underrepresented people on your team, take a hard look at your hiring practices, your work culture, even the layout of your office. If you can’t find these problems, hire experts. Pay specialist consultants and recruiters to root out the problems. This is an investment that makes moral, logical, and business sense. The inclusive team you build will be able to spot potential issues in a way that a squad of people who pattern match to narrow ideas of what a tech worker should look and behave like never would. Create a culture where the marginalized members of your team feel supported, feel heard, and are buoyed through their work with a sense of safety in their workplace.</p>
<h3 id="section13">Avoid legal issues preemptively<a class="subhead-anchor" href="https://alistapart.com#section13">#section13</a></h3>
<p><a href="https://www.buzzfeednews.com/article/skbaer/blind-woman-sues-beyonce-website-accessibility">Beyonce</a> and <a href="https://www.fastcompany.com/90414147/dominos-pizza-dealt-scotus-blow-that-could-affect-ada">Domino’s Pizza</a> were both sued under the <a href="https://www.ada.gov/">Americans with Disabilities Act</a>, which contains provisions to force the companies involved to change their websites. Beyonce’s case is still in progress, but Domino’s both lost their suit and had their appeal tossed out. Both cases were about visually impaired people being unable to access their sites and complete purchases. Accessibility is often seen as a costly detour from the “real work” of building projects, but that has never and will never be true. You want users, and users of all stripes want to use your products.</p>
<p>The banks HSBC, Metro Bank, and Halifax made it hard for visually impaired users to access all of their services online. When HSBC was told they had made it difficult for a user with visual impairments to access bank statements, <a href="https://www.bbc.co.uk/news/business-43968736">they replied, “don’t worry, we’ll send you a video.”</a> The <a href="https://www.legislation.gov.uk/ukpga/2010/15/contents">Equality Act 2010</a> in the UK means that these users can sue.In addition to serving the far more important goal of providing people with disabilities equal access, embracing inclusive design from the outset would have saved these companies time while enhancing their trust among the public rather than putting it at risk. Fixing the content is usually much <a href="https://arstechnica.com/tech-policy/2019/10/accessibility-the-future-and-why-dominos-matters/">cheaper for the organization than fighting the matter in court</a>.</p>
<h3 id="section14">Advocate for accessibility and inclusivity in any way you can, be it big or small<a class="subhead-anchor" href="https://alistapart.com#section14">#section14</a></h3>
<p>Caption your videos, Instagram content, Facebook photos, Twitter photos, conference and meetup talks, etc<strong>.</strong> Make information needed to access your product or service available in multiple formats. Speak up against problems in your workplace; if an internal hiring tool is hard for you to use, it is hard for others. If one of your websites has errors from WCAG 2’s list, advocate for taking time to fix it. If the gender options available on forms are “man,” “woman,” and “other,” speak up yourself, tell your manager, question whether you need to collect gender information at all. Don’t stay silent.</p>
<h3 id="section15">Test your website with tools, devices, and real end users<a class="subhead-anchor" href="https://alistapart.com#section15">#section15</a></h3>
<p>Run tools like <a href="https://www.deque.com/axe/">axe</a>, <a href="https://chrome.google.com/webstore/detail/chromelens/idikgljglpfilbhaboonnpnnincjhjkd?hl=en">ChromeLens</a>, and <a href="https://developers.google.com/web/tools/lighthouse">Lighthouse</a> during your build processes. Do manual testing with the actual devices that are used by your end-users, and test with real users with access requirements. If you’re a team of one or a few, ensure that you run these tools from MVP to finished product—the errors that are the easiest to catch and fix will mostly be caught by automated tools, and they are a great start for learning more about accessibility. Websites such as <a href="https://a11yproject.com/resources/">The A11y Project compile resources</a>, and there are <a href="https://inclusive-components.design/">other websites</a>, Slack groups, Twitter accounts, and newsletters that are also incredibly helpful for answering any questions. The automated tools will give you the keywords to search for.</p>
<h2 id="section16">Working towards an accessible, inclusive internet<a class="subhead-anchor" href="https://alistapart.com#section16">#section16</a></h2>
<p>Web accessibility is not an optional extra. What inclusion looks like in practice will depend on your products, your users, and what you intend to achieve, but for it to be real and meaningful in any context, it cannot be an afterthought. Engineering that makes inclusion an afterthought is engineering that operates without morality and in doing so actively enacts harm. The fact that this kind of engineering is commonplace on the internet doesn’t make it OK. It just highlights that the way we have built the web is fundamentally broken. We can do better.</p>
<p>“Wokeness,” at least as conceived by those divorced from the black experience and <a href="https://en.wikipedia.org/wiki/African-American_Vernacular_English">AAVE</a>, isn’t a great concept. The way it is used in popular culture makes it sound as if being a good person is a switch you flip on and off; you’re woke or ’sleep. But wokeness is not the end state, it’s the beginning of a journey. All the tenets of intersectional feminism, web accessibility, and diversity and inclusion are inextricably tied up in making the web a better place, for all and by all. Access to the internet is essential. Staying woke, and acting on that wokeness, is what will lead us to a better internet for everyone.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">In this excerpt from Figure It Out, Stephen Anderson and Karl Fast take you on a deep dive into color.</div><div class="entry-content">"Designing Value," an excerpt from Jim Kalbach's book The Jobs To Be Done Playbook, gives advice on creating a jobs-driven roadmap and using job stories to solve specific design problems.</div><div class="entry-content">Voice-driven content challenges many of our approaches to usability testing. Preston So turns them into opportunities and advantages for the medium itself.</div><div class="entry-content">In this excerpt from Cross-Cultural Design, Senongo Akpem discusses the many facets of typography that must be considered when you are looking to reach a global audience.</div><div class="entry-content">In this excerpt from Writing is Designing, Michael J. Metts and Andy Welfle discuss the importance of writing with accessibility in mind.</div>]]></description>
      <link>https://alistapart.com/article/building-the-woke-web/</link>
      <guid>https://alistapart.com/article/building-the-woke-web/</guid>
      <pubDate>Thu, 11 Jun 2020 16:30:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Color Craft &#038; Counterpoint: A Designer&#8217;s Life with Color Vision Deficiency]]></title>
      <description><![CDATA[<div class="entry-content">
<p>So, what is it like to be color blind and also work in the web design and development industry? I’ll answer that question throughout this article, but it’s something that’s always factored into my thoughts, given my passion for design and now my career. I wonder if having “normal” vision would have made me a better artist growing up. Would it make me better at my job now? Would I have pursued a more design-oriented career, as opposed to one that’s more dev-focused? These are just some of the things that pop into my head.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>As to my job and my color vision, no, colorblindness doesn’t affect my work as much as you’d think. During design meetings, I can quickly point out areas where we need to reconsider our color palette. While reviewing layouts, I’m able to explain why we need to evaluate how—and if—we’re only conveying information with color. I like that I can bring a singular perspective to the table and a voice for others like me; I am able to offer insights that others don’t necessarily have.</p>
<p>When you can see a larger set of colors, it’s easy to gloss over those issues because they’re functionally invisible in the moment. If a design team doesn’t have a member who sees color differently, it’s important they find a way to test with actual users who do. There is no substitute for the real thing. </p>
<p>Between workarounds anyone can use when color-sensitive situations crop up, and knowing how to separate myth from actual, smart usability practices for vision differences (and which design tools to use)—I want to set the record straight on a few things about designing with color and designing for color accessibility.</p>
<h2 id="section2">What it means to be color blind<a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>The term <a href="https://www.aoa.org/patients-and-public/eye-and-vision-problems/glossary-of-eye-and-vision-conditions/color-deficiency"><em>color vision deficiency</em></a>,or CVD, more accurately reflects the type of impairment I have.</p>
<p>When someone hears that I’m color blind, most immediately think that I can’t see colors whatsoever—that my entire field of vision is in grayscale, that I’m truly color <em>blind</em>. The term is very misleading and confusing because most people living with CVD are able to see many colors. (There <em>are</em> people who have a type of CVD called “<a href="https://en.wikipedia.org/wiki/Monochromacy">monochromacy</a>,” which is complete color blindness. About 1 in 30,000 people are affected, and they see the world in shades of gray.)  </p>
<p>Red-green color blindness is the most culturally-familiar type, but CVD is a lot more interesting and varies far more in definition.</p>
<h2 id="section3">So what colors <em>can’t</em> you see?<a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h2>
<p>I have been asked this question more times than I can count. My answer is always the same: it’s practically impossible for me to say. For me personally, colors become harder to distinguish the less bold they are. I can attest with absolute certainty that the sky is blue, a stop sign is red, the grass is green, and Big Bird is yellow. I can <em>see</em> those colors because—whether by design or by mother nature—they’re bold. But start placing certain colors adjacent to each other, and it becomes more difficult for me. There are no colors that I <em>can’t</em> see, rather, certain colors become muddied and start blending together. It’s not the same for everyone; that’s just my version of CVD.</p>
<p>As light sensors go, <a href="https://www.bbc.com/future/article/20150727-what-are-the-limits-of-human-vision">humans don’t have the best eyes for color</a>. Truth be told, they’re subpar compared to most species. WE are dismally color blind—as a species. </p>
<p>On top of that, normal, “accurate” color vision varies from person to person; only minor anatomical differences determine whether your eyes are normal, “color blind,” or have extra (!) color vision powers. Let’s unpack all of that.</p>
<p>Without getting too technical, what I can tell you is that our retinas are responsible for our color vision. <a href="https://www.colour-blindness.com/general/how-it-works-science/">Retinas have two main types of cells</a>: rods and cones. Rods are primarily responsible for reading brightness/intensity levels, while cones are more specialized for detail and for picking up a particular range of light wavelengths. A person considered to have normal color vision has three types of cones, one each for bandwidths of short, medium, and long wavelengths of light. The bandwidth each cone can perceive is shaped like a bell curve and is unique to <em>that</em> cone inside <em>your</em> eye, and there are overlaps between cones. Cones also don’t actually correspond to specific colors, but because long wavelengths fall more toward the red part of the spectrum, medium wavelengths hover closer to green, and short wavelengths tend toward blue, you’ll hear them called red, green, and blue cones, due to sheer convenience (Fig. 1).</p>
<figure id="figure1" class="wp-block-image size-full"><a href="https://en.wikipedia.org/wiki/Color_vision"><img src="https://alistapart.com/wp-content/uploads/2020/06/light-spectrum-cone-wavelength-response-600x423-4.jpg?w=960" alt="Spectral diagram of three bell curves (one each for short-, medium-, and long-wavelength cones), indicating their typical ranges and peak response points." class="wp-image-7172396" data-recalc-dims="1" /></a>
<figcaption><br /><strong>Fig. 1.</strong> Normalized cone response spectra in humans for short (S), medium (M), and long (L) wavelengths. Notice the overlapping nature of the bell curves, and that the peak sensitivity for each cone doesn’t neatly match up with red, green, and blue.</figcaption></figure><p>Color vision deficiencies occur because one or more of these cones is missing or has limited sensitivity (such as a narrow range), or when color perception in the brain is influenced by various <a href="https://alistapart.com#colorperception">other phenomena</a>. This means that those colors in the spectrum effectively “drop out,” but since the light is still there, the brain translates it into <em>a</em> color based on peripheral data picked up by the other cones, combined with its brightness level.</p>
<p>Since color vision is based on how our eyes and brain perceive light, and since our eyes have different genetic sensitivities to light, we can say that “accurate” color vision is somewhat subjective. Even people with “accurate” color vision don’t see things exactly the same way. </p>
<p>Some people even have a fourth cone cell in their retinas; “<a href="https://en.wikipedia.org/wiki/Tetrachromacy">tetrachromats</a>” have enhanced color differentiation due to extra sensitivity between red and green. The extra cone actually <a href="https://www.ncbi.nlm.nih.gov/pmc/articles/PMC2781854/">came standard for most mammals in the past</a>, but ongoing studies have suggested that <a href="https://www.bbc.com/future/article/20140905-the-women-with-super-human-vision">12% of the world’s women</a> might still have this fourth type of cone.</p>
<p>There are some colors and wavelengths we can’t see because our eyes don’t have the right sensors, but for others, it’s due to anatomical make-up. The lens and cornea physically block very short wavelengths; it’s why we can’t see ultraviolet light directly, even though we have the sensor capability. For people with <a href="https://www.theguardian.com/science/2002/may/30/medicalscience.research">aphakia</a> (lack of a lens in one or both eyes, whether congenital or due to surgical removal), that’s not a problem; they see the color variations in near ultraviolet light naturally.</p>
<h2 id="section4">Inside look at living with CVDs<a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h2>
<p>I think each person who has a CVD has their own set of challenges. There are also a lot of commonly-experienced situations, social and professional obstacles, and forms of discrimination and bullying we’re expected to just quietly put up with. </p>
<p>Vision disabilities and color vision differences are often treated as quirky, entertaining phenomena on some mysterious map between normal vision and “blind.” People with CVDs encounter condescending remarks and dismissive treatment as part of daily life. It’s an invisible and misunderstood struggle that doesn’t have to be that way. I want to make a difference, and it fuels my desire to educate people on this topic.</p>
<h3 id="section5">Insults and passive-aggressive comments<a class="subhead-anchor" href="https://alistapart.com#section5">#section5</a></h3>
<p>I’ve heard my fair share of passive-aggressive comments about my career choice. Also about my passion for art and design. Because <em>how could I possibly be a designer if I can’t see colors?</em> </p>
<p>A question like that is condescending on two levels. One, it’s as if no one should be allowed to be an artist unless they can see colors accurately. And two, it shows a complete insularity or misconstrued awareness about color vision deficiencies.</p>
<p>Nowadays, I work primarily as a front-end developer, but early on in my career, I designed web layouts in Photoshop. I didn’t code anything. I didn’t even write HTML. I never had an issue with colors because I was typically starting with a client’s corporate branding guidelines, so I was able to take those colors and use color palette generators to help me build out the look of my designs. I was never called out for making poor color choices, so I felt like I was doing a good job. It wasn’t until I was having a conversation with my boss, a man I looked up to as a professional, when I dropped my guard and mentioned that I was color blind. He then proceeded to question my entire decision to pursue the career I love. For a new professional, it was a pretty rough and demoralizing encounter to sit through and try to process, to say the least. </p>
<h3 id="section6">Justifying my skill set<a class="subhead-anchor" href="https://alistapart.com#section6">#section6</a></h3>
<p>It feels as though I have had to justify my career decisions and my skill set on a regular basis over the years—as if CVD prevents me from being good at my job. By and large, it’s truthfully not something that comes up most of the time in my day-to-day work. </p>
<p>At this point, most coworkers only find out that I have a CVD if I talk about it. Sometimes I even get a kick out of seeing how many months can stretch out before a situation comes along where I can mention it. It’s become an increasingly minor issue over the years, what with updated software and web technologies I can put to use when needed.</p>
<h3 id="section7">Life via form factor (or winging it)<a class="subhead-anchor" href="https://alistapart.com#section7">#section7</a></h3>
<p>Think for a moment about ways that color is used to convey information in the world around you. One thing that comes to my mind would be traffic lights. Color is used to let drivers know how they should proceed. No additional information is provided in case a driver is color blind. Traffic lights also use two of the colors most commonly associated with color blindness: red and green. Thankfully, most traffic lights have a common form factor. The top light is red, the middle light is yellow, and the bottom light is green. Even if I couldn’t tell the color, as long as I can tell which light is lit, then I’m able to get the necessary information.</p>
<p>Unfortunately, not all designs are created equal; there may be no secondary or supplemental indicator to go by. When something is only conveyed with color, that’s a gap where information can get lost on a large group of people.</p>
<h3 id="section8">Everyday social interactions<a class="subhead-anchor" href="https://alistapart.com#section8">#section8</a></h3>
<p>Exchanging stories with others who grew up color blind sounds unfailingly familiar. Most of us have had similar experiences when it comes to people first finding out. As in part Q&amp;A, part dog and pony show.</p>
<p>We’re <em>constantly</em> asked, “What color is this?” <em>(points to a nearby object)</em> and “What color does this look like?” Then we watch as the person who asked us the question has their MIND BLOWN because we can’t see the correct color. Meanwhile, getting the color correct can sometimes be worse. First, there’s a look of confusion on the asker’s face. They can’t comprehend how we can both be color blind <em>and</em> see color at the same time, which leads to even more questions and “tests.” It turns what could have been a brief exchange into a lengthy and technical conversation, maybe at a bad time or inconvenient location.</p>
<p>What I ended up learning is that these encounters will never go away, since most people I come into contact with have no knowledge about color blindness. I can either get annoyed by getting asked so many questions, or I can use it as an opportunity to educate.</p>
<h3 id="section9">Getting passed over for jobs<a class="subhead-anchor" href="https://alistapart.com#section9">#section9</a></h3>
<p>The first time I was passed over for a job specifically due to my CVD was when I was a teenager. It was a part-time job after school, and I was told—point-blank—it was because I’m color blind. A position had opened up in the frame shop at a big-box crafts store I’d been working at for over a year. After having been told I was getting the position, my boss somehow found out I’m color blind, then informed me that I wasn’t qualified to work in the frames department for that very reason. That was it, no discussion. I had to watch the position go to one of my coworkers. </p>
<p>That may have been a minor blip on my teenage radar at the time, but little did I realize it was the first of many. Between the discrimination and frustration I dealt with at various jobs over the years, I eventually convinced myself to not tell new employers or coworkers about my color vision deficiency. I wasn’t going to lie about it if I got asked, but I wasn’t going to offer up that information unsolicited.</p>
<p>After working in the web industry for many years, I eventually transitioned to a new approach. At this point, I have successfully proven to myself that my color vision deficiency doesn’t negatively impact my job, and that bringing it up via the lens of accessibility makes it more of a natural thing I can discuss with coworkers so we can put it to constructive use on projects.</p>
<h2 id="section10">Inside look at how I do my job<a class="subhead-anchor" href="https://alistapart.com#section10">#section10</a></h2>
<h3 id="section11">Relying on tools for help<a class="subhead-anchor" href="https://alistapart.com#section11">#section11</a></h3>
<p>Being a professional front-end developer and designer with a CVD is easier than ever because there are so many tools and resources out there. Professionally, I have relied on color picker tools, websites that offer predefined color combinations, image editing software, and the mere fact that all colors can be represented by a hexadecimal value. </p>
<p>In front-end tasks, I’m able to modify my code editor to suit my needs, for instance. I can use light or dark mode and a wide variety of color themes. I often use high-contrast themes that have been thoughtfully designed for developers with color vision deficiencies.</p>
<p>Tools and resources I use regularly:</p>
<ul><li><strong>Trello —</strong> Trello has a nice item labelling feature that takes CVDs into consideration. Not only can users label cards based on color, they can also use stripes, zigzags, polka dots, squiggly lines, and other shapes.</li>
<li><strong>VSCode —</strong> Visual Studio Code is my preferred code editor. I’m able to customize the interface with pre-built themes, and I can further modify those themes if I need to. I’m currently using one called Vue Theme, which I feel works really well for me. I choose themes based on what feels like the appropriate color contrast for my specific color vision deficiency. I lean toward dark backgrounds with brighter, higher-contrasting text colors that stand out against the background color. Another one of my favorites is <a href="https://marketplace.visualstudio.com/items?itemName=sdras.night-owl">Sarah Drasner</a>’<a href="https://marketplace.visualstudio.com/items?itemName=sdras.night-owl">s Night Owl theme</a>.</li>
<li><strong>Dev Tools —</strong> Whether it’s Chrome, Firefox, or Safari, I am constantly in the browser’s dev tools. There’s an ever-increasing number of features in dev tools that I can use to get the color information I need. Something I find handy is being able to Shift + click on a color value to cycle through various color formats (3 digit and 6 digit hexadecimal, RGB, HSL, and color name).</li>
<li><strong>Color Pickers</strong> — I installed a color picker Chrome browser extension called <a href="https://chrome.google.com/webstore/detail/eye-dropper/hmdcmlfkchdmnmnmheododdhjedfccka?hl=en">Eye Dropper</a> to help me quickly grab colors from web pages. It allows me to sample colors from any web page, and provides me with the color in every format. This provides me with a secondary reassurance that the color I wrote in my CSS is truly being rendered. I wish I could trust the code as I see it in dev tools, but occasionally my eyes play tricks on me—I would swear that the color I’m seeing rendered on the screen isn’t the color value in dev tools. When I think that’s the issue, I can just grab the eye dropper and triple-check.</li>
<li><strong>Contrast Checker —</strong> I use the <a href="https://webaim.org/resources/contrastchecker/">WebAIM Contrast Checker</a> to make sure that the colors I’m using are in compliance with the guidelines.</li>
</ul><h2 id="section12">Accessibility and inclusion<a class="subhead-anchor" href="https://alistapart.com#section12">#section12</a></h2>
<p>Statistically, 1 out of every 12 men and 1 out of every 200 women have a color vision deficiency. Across the world, <a href="http://www.colourblindawareness.org/colour-blindness/">approximately 300 million people are color blind</a>. Those are significant numbers to factor in, especially if all those users are hampered by usability issues. Color alone can prevent them from completing interactions, receiving pertinent information, and from having the same experience as users with better color vision. That last fact alone is reason enough to pay attention to the concerns outlined here.</p>
<h3 id="section13">Color disabilities and the Web Content Accessibility Guidelines<a class="subhead-anchor" href="https://alistapart.com#section13">#section13</a></h3>
<p>The <a href="https://www.ada.gov/">ADA</a> doesn’t specifically call out color blindness; it simply refers to visual disabilities. However, the Web Content Accessibility Guidelines <a href="https://www.w3.org/TR/WCAG21/#use-of-color">(WCAG) does specifically mention color</a>. Compliance with the WCAG helps as a first step toward ensuring your site is usable by everyone, regardless of disabilities, but keep in mind that there could be additional factors at play with your site which may be “compliant” but still create difficulties for users.</p>
<h3 id="section14">Color contrast<a class="subhead-anchor" href="https://alistapart.com#section14">#section14</a></h3>
<p>For those of us who have a CVD, one of the more prevalent issues is a site’s color <em>contrast</em>; trouble with specific colors doesn’t necessarily mean we’ll have trouble with the site. </p>
<p>If a site doesn’t have the proper color contrast ratio (text color on top of background color), then the site’s information may be more difficult to see or understand. WebAIM, a non-profit organization, published reports in 2019 and 2020 outlining <a href="https://webaim.org/projects/million/">accessibility issues in the top one million home pages</a>. As of February 2020, 86.3% of home pages tested had insufficient contrast.</p>
<p>So, what does that mean? It means that the information on those sites is not being conveyed equally, to everyone. That’s <a href="https://majestic.com/reports/majestic-million">863,000 of the most influential and high-traffic sites</a> on the web delivering an unequal user experience to billions of users worldwide on a daily basis.</p>
<h3 id="section15">Data visualization<a class="subhead-anchor" href="https://alistapart.com#section15">#section15</a></h3>
<p>Color contrast is not the only issue when it comes to color blindness and accessibility. Data visualization is one area in particular that often relies heavily on color to convey information. It is also a prime example of what the WCAG mentions in their success criteria: </p>
<blockquote class="wp-block-quote is-style-default">
<p>Color is not used as the only visual means of conveying information, indicating an action, prompting a response, or distinguishing a visual element.</p>
<div><cite>– Web Content Accessibility Guidelines 2.1 – Success Criterion 1.4.1 Use of Color</cite></div></blockquote>
<p>I follow a few accounts on Twitter that bring attention to improper use of color in data visualizations. I would recommend getting started with these—they provide a lot of useful information and raise awareness surrounding issues that those of us with a CVD face:</p>
<ul><li><a href="https://twitter.com/colourblindorg">@colourblindorg</a></li>
<li><a href="https://twitter.com/WeAreColorblind">@wearecolorblind</a></li>
<li><a href="https://twitter.com/WeTheColorBlind">@WeTheColorBlind</a>.</li>
</ul><p>Thankfully, making charts, graphs, and other visual aids color accessible isn’t that difficult. There is no need to remove colors altogether. Just try to use colorblind-friendly color palettes and don’t use problematic color combinations. Make sure all the data in your charts is labeled appropriately so that your readers can get the information in multiple ways. <a href="https://ourworldindata.org/">Our World in Data</a>—a scientific online publication that focuses on large global problems such as poverty, disease, climate change, war, and inequality—has great examples of data visualizations of all types that I would consider to be colorblind-friendly.</p>
<p>Whenever possible, I try to provide feedback from the perspective of someone who has a CVD, but I don’t make recommendations for specific color changes; I leave the color choices to those who aren’t color blind. Instead, I describe which elements I find difficult to interpret, and why. I tell them which information is getting lost on someone like me. The hope is that my feedback informs other designers of the need to make charts, tables, graphs, and maps more inclusive.</p>
<h2 id="section16">Adding people with a CVD to your team<a class="subhead-anchor" href="https://alistapart.com#section16">#section16</a></h2>
<p>As far as those of us who do have a CVD and work in the web industry: we are just as skilled and knowledgeable about our professions as anyone else, and there are plenty of ways that we can contribute to the visual aspects of projects—<em>especially</em> regarding color. We have the ability to review designs and report back whether any information is getting lost due to poor color contrast. We can inform designers if the chosen color palette is problematic. We can be the test subjects for our fellow UX designers during their usability research.</p>
<p>There is also another point I’d like to get across here. There is a common misconception that a designer with a CVD doesn’t have the ability to do their job effectively. Hiring managers and other coworkers often make this assumption. Much to the contrary, people with CVDs have ways they work smart to work around their limitations. I mentioned earlier about the different tools I personally use to help me in my job. There are plenty of web industry professionals like me who use features in the tools at their disposal, getting the job done right, and so seamlessly that no one would guess they are color blind.</p>
<p>That brings me to a broader point—the importance of hiring people with disabilities. I won’t go into the many, many, <em>many</em> reasons why companies should do that. Rather, I’ll mention some of the benefits from a design perspective. </p>
<p>First and foremost, if you don’t have a disability, then how can you say conclusively that you know your product will work for those who do? </p>
<p>The answer is, you can’t. Not without proper testing. Sure, there are companies out there that can help designers and developers conduct usability tests. But how amazing would it be if you had team members who could provide you with that invaluable feedback throughout the duration of each project? Think about all the knowledge you’ve accumulated about your profession. Think about all of the wisdom you can teach others. Now think about all the knowledge and wisdom that could be passed on to you by teammates living with a disability. Together, you can make your products truly inclusive. Trying to do it separately will always produce and reinforce limitations.</p>
<h2 id="section17">Critical CVD tips for your projects<a class="subhead-anchor" href="https://alistapart.com#section17">#section17</a></h2>
<p>Color can enhance the message, but shouldn’t be the messenger. UX and UI designers have within their power the ability to take color blindness into consideration—or to ignore it. You can make sure information is conveyed to everyone, not just people who see color “normally.” That is a great responsibility, with real life-or-death repercussions at stake for many users.</p>
<p>For those of us in the web industry, there are specific action items I’d like you to take away from all this.</p>
<h3 id="section18">Design color palettes for “everyone”<a class="subhead-anchor" href="https://alistapart.com#section18">#section18</a></h3>
<p>Carefully plan your color palette—not for those who are color blind, but for <em>everyone</em>. Always keep in mind that ALL the information you provide in your product needs to be easy to recognize and easy to understand by anyone who touches it. We can get too familiar with what we’re doing and forget that information is delivered in multifaceted ways, so we need to be mindful of what’s specifically being conveyed by color. </p>
<p>I highly recommend Geri Coady’s book, <a href="https://abookapart.com/products/color-accessibility-workflows"><em>Color Accessibility Workflows</em></a>; it’s a fantastic resource. In it, she discusses color blindness, choosing appropriate color, compliance and testing, implementation, providing alternatives, and she includes some tips and tricks.</p>
<h3 id="section19">Don’t assume, and be careful what you ask <a class="subhead-anchor" href="https://alistapart.com#section19">#section19</a></h3>
<p>Do not assume which colors are difficult to see—actually do the research and testing. At minimum, please <a href="https://webaim.org/resources/contrastchecker/">check the color contrast in your layout</a>.</p>
<p>The reason I say that is because although the ADA doesn’t call out color blindness specifically, it does call out visual disabilities. In the U.S., it is illegal in the workplace (not to mention insulting and unwise) to ask people if they have a disability. In my book, that also applies to color blindness, and while it may not be illegal to ask in non-work contexts, it is definitely personally intrusive. </p>
<p>However, if people volunteer to help you with your testing and they offer up that information about themselves, that’s a different matter. It may also be a good idea to reach out to some companies that specialize in user testing with people with disabilities. </p>
<p>Companies such as <a href="https://www.levelaccess.com/">Level Access</a> help organizations incorporate accessibility into their daily workflows. They offer tailored training, auditing services, document remediation, and other services to help organizations achieve—and maintain—compliance with <a href="https://section508.gov">Section 508</a> and the WCAG.</p>
<h3 id="section20">Test with colorblind simulators AND colorblind users<a class="subhead-anchor" href="https://alistapart.com#section20">#section20</a></h3>
<p>Don’t rely on colorblind simulators alone. I could write an essay about this topic. Those simulators are not accurate enough to give you a proper understanding of color vision deficiencies.</p>
<h3 id="section21">Seek out first-hand perspectives <a class="subhead-anchor" href="https://alistapart.com#section21">#section21</a></h3>
<p>Actually speak to someone who has a color vision deficiency to get their perspective, and listen with an open mind. I can’t recommend this enough. There is no better way to get an understanding of what it’s like to live with a CVD than to hear about it first hand.</p>
<h3 id="section22">Stand up for coworkers and users<a class="subhead-anchor" href="https://alistapart.com#section22">#section22</a></h3>
<p>Don’t make light of color vision deficiencies. It’s difficult enough living with it, let alone being an artist with it or trying to make sense of information you literally can’t see.</p>
<h2 id="section23">Tools and further reading<a class="subhead-anchor" href="https://alistapart.com#section23">#section23</a></h2>
<h3 id="section24">Accounts on Twitter <a class="subhead-anchor" href="https://alistapart.com#section24">#section24</a></h3>
<ul><li><a href="https://twitter.com/colourblindorg">@colourblindorg</a></li>
<li><a href="https://twitter.com/WeAreColorblind">@wearecolorblind</a></li>
<li><a href="https://twitter.com/WeTheColorBlind">@WeTheColorBlind</a></li>
</ul><h3 id="section25">Usability and UX<a class="subhead-anchor" href="https://alistapart.com#section25">#section25</a></h3>
<ul><li><a href="https://uxmovement.com/buttons/the-myths-of-color-contrast-accessibility/"><em>The Myths of Color Contrast Accessibility</em></a> — UX Movement</li>
<li><a href="https://wearecolorblind.com/resources/collection/resources-for-designing-for-the-colorblind/"><em>Resources for Designing for the Colorblind</em></a> — We Are Colorblind</li>
<li><a href="https://webaim.org/projects/million/"><em>The WebAIM Million</em></a></li>
<li><a href="https://webaim.org/resources/contrastchecker/">WebAIM Contrast Checker</a></li>
</ul><h3 id="section26">Organizational resources<a class="subhead-anchor" href="https://alistapart.com#section26">#section26</a></h3>
<ul><li><a href="https://www.colour-blindness.com/general/how-it-works-science/">Color-Blindness.com</a> </li>
<li><a href="http://www.colourblindawareness.org/">ColourBlindAwareness.org</a></li>
<li><a href="https://ourworldindata.org/">OurWorldinData.org</a></li>
</ul><h3 id="section27">Color perception and the brain<a class="subhead-anchor" href="https://alistapart.com#section27">#section27</a></h3>
<ul><li><a href="https://en.wikipedia.org/wiki/Chromatic_adaptation">Chromatic adaptation</a></li>
<li><a href="https://en.wikipedia.org/wiki/Color_constancy">Color constancy</a> </li>
<li><a href="https://jeb.biologists.org/content/209/5/781">Nocturnal color vision</a> </li>
<li><a href="https://en.wikipedia.org/wiki/Spectral_color">Spectral color</a></li>
</ul><h2 id="section28">Continuing to make progress<a class="subhead-anchor" href="https://alistapart.com#section28">#section28</a></h2>
<p>Loving design is something that has always come naturally to me; I didn’t have to force myself down this path. Growing up, I didn’t know that I wanted the exact job that I have, but by the time I graduated high school in 2000, I knew that I wanted to combine my passions for art and computers. </p>
<p>I’m thankful to have been around long enough to have watched the web community evolve into what it is today. I’m thankful for all the tools that exist to help me do what I love in spite of my color vision deficiency. I’m thankful that color blindness is recognized by the WCAG, and that considerations are made for people living with color vision differences.</p>
<p>There is a lot of information out there, and I recommend that people go out and read as much as they can on the topic. If you’re on Twitter, then follow people who have a CVD, or the organizations that deal with it in various ways. There is so much knowledge that can be gained by doing some simple research and adding it into your workflow.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Building a more inclusive internet goes far beyond making our code more accessible. Olu offers a thoughtful approach to a more welcoming web.</div><div class="entry-content">In this excerpt from Figure It Out, Stephen Anderson and Karl Fast take you on a deep dive into color.</div><div class="entry-content">"Designing Value," an excerpt from Jim Kalbach's book The Jobs To Be Done Playbook, gives advice on creating a jobs-driven roadmap and using job stories to solve specific design problems.</div><div class="entry-content">Voice-driven content challenges many of our approaches to usability testing. Preston So turns them into opportunities and advantages for the medium itself.</div><div class="entry-content">In this excerpt from Cross-Cultural Design, Senongo Akpem discusses the many facets of typography that must be considered when you are looking to reach a global audience.</div>]]></description>
      <link>https://alistapart.com/article/a-designers-life-with-color-vision-deficiency/</link>
      <guid>https://alistapart.com/article/a-designers-life-with-color-vision-deficiency/</guid>
      <pubDate>Tue, 09 Jun 2020 17:31:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Figure It Out]]></title>
      <description><![CDATA[<div class="entry-content">
<p>Color is, without a doubt, the visual element most often misunderstood and misused.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>As mentioned earlier, when designing visual representations, color is often the first visual encoding that people use. It’s also quite limited to about a dozen, distinguishable colors. It’s a potent visual element, but one fraught with accessibility and perceptual problems. A general rule of thumb: <em>Save color for things you want to draw people’s attention to</em>. Start with grayscale representations. Add in color only later, where it might be really, really useful. That’s it. We can move along.</p>
<p>Except…</p>
<p>We need to dispel some popular beliefs about colors, beliefs that are often held up as truth, when, in fact, this is not the case. What’s presented in this short chapter is more foundational knowledge than tips for immediate application. But also, this understanding of color is—we found in retrospect—a powerful lens for understanding the concepts shared throughout this book. We see in our exploration of color this pattern: while many of the absolutes we cling to are social constructs (varying across cultures and over time), behind these changing constructs we also find some universal human constants.</p>
<h2 id="section2">How Many Colors Are in the Rainbow?<a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>Let’s begin by unpacking the statement above, suggesting that we only see about a dozen colors. Actually, the human eye can perceive many more colors, perhaps a million or so. Of this million, it’s estimated that each of us—individually—can distinguish somewhere between 130 to 300 colors.<sup>[1]</sup> But within a cultural group, we can only share about a dozen such colors. These limitations have little to do with personal visual acuity, but rather with language: a group’s ability to see and perceive a specific color is determined by language. Do we—as a society—share the same named color value associations?</p>
<p>We can talk about something being “<em>red</em>” and feel confident in what we all see. From both a developmental perspective and an anthropological perspective, red is the first color (after white and black) that most cultures are aware of. But if I describe something as <em>magenta</em>, do we have a shared agreement as to what that named concept refers to? Perhaps you see hot pink where I see a vibrant, purply-reddish color? Another example of this language-color dependency: the Russian language has a specific word for the color that we (English speakers) perceive as light blue.</p>
<p>To put this shared vocabulary into perspective, let’s start with something that is constant and beyond our language: the visible spectrum of light that is a rainbow.</p>
<h2 id="section3">When Colors Are Constant<a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h2>
<p>Around the world, the meteorological phenomenon we describe as a rainbow is a constant thing. Light refracts across water droplets to create a spectrum visible to humans. What we see as colors are the wavelengths of light visible to the human eye (see <strong>Figure 8.1</strong>). On either end of this visible spectrum are ultraviolet and infrared waves, which while invisible to human eyes, we know they <em>are</em> visible—that is, seen—by cameras and some nonhuman creatures (cats can see certain infrared frequencies, for example). Beyond this visible spectrum, we have things like gamma rays, X-rays, and radio waves, which all make up the entire spectrum of white light from the sun.</p>
<figure id="figure1" class="wp-block-image size-large"><img src="https://alistapart.com/wp-content/uploads/2020/05/08.01.jpg?w=960" alt="A diagram showing the spectrum of light" class="wp-image-7172366" data-recalc-dims="1" /><figcaption><strong>Figure 8.1</strong> The visible light spectrum is a small part of the broader electromagnetic spectrum. Starting from this perspective helps us recognize the subjectivity of what is “seen” and how this might vary with different creatures and devices.</figcaption></figure><p>But let’s stay focused on the portion of this light spectrum that is visible to humans, the part that allows us to see. Within this spectrum, the rainbow possesses millions of color combinations, as there are no clearly defined boundaries between the colors.</p>
<p>Why then, should diverse cultures over thousands of years arrive at the same set of color language definitions? Are colors an absolute thing? Not exactly.</p>
<h2 id="section4">The Subjectivity of Color Identification<a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h2>
<p>Consider “ROYGBIV,” which is the acronym we all learned to name the colors of the rainbow. How did we conclude, at least in Western cultures, that a rainbow has seven colors? Why not five, or six, or eleven? We have Sir Isaac Newton to thank for this.</p>
<p>These seven colors—red, orange, yellow, green, blue, indigo, and violet—were not the result of any serious scientific inquiry. Rather, Newton was fond of the number seven. Just as there are seven musical notes in a scale, Newton believed that colors should follow a similar pattern. He might have connected this with seven days in the week or the seven known planets (at the time) in our universe. In other words, ROYGBIV was an arbitrary choice based on mystical superstition.</p>
<p>Understanding how we arrived at these seven colors sheds light on the subjective nature of color identification. This may also explain a bit about the challenge that so many people have with indigo—that odd color that sits somewhere between blue and violet—as a separate color!</p>
<p>But here is where we have to be careful, as we are stepping into a decades old debate: Do the number of basic color terms and the location of color category boundaries vary across languages? Or might there be a universal pattern to the color naming systems of all cultures?</p>
<p>This Wikipedia entry sums up the debate rather nicely:</p>
<blockquote class="wp-block-quote quote">
<p>There are two formal sides to the color debate, the universalist and the relativist. The universalist side claims that the biology of all human beings is all the same, so the development of color terminology has absolute universal constraints. The relativist side claims that the variability of color terms cross-linguistically (from language to language) points to more culture-specific phenomena. Because color exhibits both biological and linguistic aspects, it has become a deeply studied domain that addresses the relationship between language and thought. <sup>[2]</sup></p>
</blockquote>
<h2 id="section5">An Argument for Relative Linguistics<a class="subhead-anchor" href="https://alistapart.com#section5">#section5</a></h2>
<p>We can characterize what Newton did as imposing an arbitrary number of colors upon the color spectrum. And we might conclude the same thing has happened throughout history as different people groups formed words to describe the world around them.</p>
<p>Indeed, various studies of diverse cultures reveal that “although the physiological basis of color vision is essentially the same for all humans with normal trichromatic color vision, there is considerable diversity in the way that different languages segment the continuum of visible colors.”<sup>[3]</sup> In other words, the rainbow has no natural boundaries; how we slice it up into colors is a subjective thing that varies across different cultures and time. (See <strong>Figure 8.2</strong> for an illustration of this concept.) From one research paper, we learned that “some languages have been reported to use as few as two terms to describe all visible colors (Rosch Heider, 1972). Others have been reported to use between three and eleven (Berlin &amp; Kay, 1969), while some (e.g., Russian; Davies and Corbett, 1997) may have twelve.”<sup>[4]</sup></p>
<p>Specific examples in support of this argument:</p>
<ul><li> In Russian culture, there is no generic concept of blue. Rather, Russian makes an obligatory distinction between lighter blues (<em>goluboy</em>) and darker blues (<em>siniy</em>).</li>
<li>The Japanese language (before the modern period) had just one word, <em>Ao</em>, for both blue and green. It wouldn’t be until the year 1,000 that the word <em>midori</em> would be introduced to distinguish a greenish shade of blue</li>
<li>The Himba tribe from Namibia recognizes five basic colors.</li>
<li>The Berinmo of Papua New Guinea has also reached a different conclusion as to the number of colors they recognize. While they draw no distinction between blue and green, they do “draw a distinction within what English speakers would consider yellow, with the word <em>nol</em> on one side and <em>wor</em> on the other.”</li>
</ul><p>From this, we might conclude that the colors of the rainbow do seem to be arbitrary and dependent upon language. (Connect this with earlier points we made about thoughts and cognition as layers upon layers of prior associations.)</p>
<figure id="figure2" class="wp-block-image size-large"><img src="https://alistapart.com/wp-content/uploads/2020/05/08.02.jpg?w=960" alt="A webcomic from XKCD, reading 'This chart shows the dominant color names over the three fully-saturated faces of the RGB cube (colors where one of the RGB values is zero)" class="wp-image-7172367" /><figcaption><strong>Figure 8.2</strong> This comic from Randall Munroe of xkcd nicely illustrates the subjectivity of the shared color language for English speakers.[5]</figcaption></figure><p>But surely, you may be thinking, color identification isn’t entirely subjective? Here’s where the research gets interesting: despite these regional differences, a fascinating and consistent pattern begins to emerge.</p>
<h2 id="section6">An Argument for the Universal<a class="subhead-anchor" href="https://alistapart.com#section6">#section6</a></h2>
<p>In the late 1960s, after studying color terms across many different languages, researchers Berlin and Kay introduced the idea that there were eleven possible basic color categories: white, black, red, green, yellow, blue, brown, purple, pink, orange, and gray. They argued a universalist theory: that color cognition is <em>an innate, physiological process rather than a cultural one.</em></p>
<p>While their research has been challenged on different grounds, what has since followed is some agreement that for all noted language differences, there is a fixed order in which color names arise. The ways in which color language evolves across cultures suggest maybe there is a universal pattern governing the direction of patterns in the evolution of colors. All cultures start with the ability to distinguish dark things from light things. This is followed by the recognition of red. After that, it might be the addition of yellow or green. And blue always seems to come last. Not every language follows the exact same path, but they adhere to this same general pattern.</p>
<p>While the broader debate is not necessarily concluded, the general consensus seems to be that “in color, relativism appears to overlay a universalist foundation.”</p>
<h2 id="section7">Why All the Fuss over Color?<a class="subhead-anchor" href="https://alistapart.com#section7">#section7</a></h2>
<p>While this is certainly fascinating, how is this useful? We include this as a mirror to challenge assumptions. If we turn a critical eye to the commonly accepted color wheel, this was likely influenced by Newton’s original color wheel sketch. But is this the “right” way to think about colors? <em>Primary colors combine to make secondary colors, which in turn allow us to describe tertiary colors.</em> We learn this from an early age and accept this way of thinking about color as absolute. But this is just one frame. This is just <em>a way</em> of thinking about visible light. And this singular perspective has limitations, especially when used in medical, scientific, and engineering visualizations. Research papers such as “Rainbow Color Map (Still) Considered Harmful”<sup>[6]</sup> question the value of the rainbow color spectrum in data visualization applications. The point is simple: there are other ways we might think about color. We can look at alternatives such as perceptually ordered color spectrums, an <em>isoluminant</em> color map, or simply use representations of color that aren’t derived from a wheel. Tools such as ColorBrewer 2.0<sup>[7]</sup> or the NASA Ames Color Tool<sup>[8]</sup> are incredibly useful for choosing a palette more suitable for visualizing data.</p>
<p>Since this book is concerned with how human creatures understand information, and because we so often use color to clarify, we felt it worth calling out that color and color recognition are not necessarily universal things, but are dependent on cognition, language, and biology. Understanding this allows us to challenge common assumptions about what is “true” about color and perception.</p>
<p>Which leads us to…</p>
<h2 id="section8">Color, Cultures, and Universal Associations<a class="subhead-anchor" href="https://alistapart.com#section8">#section8</a></h2>
<p>Red means stop. Green means go. These concepts are universal, right? Not so fast. Across cultures, colors do not necessarily convey the same concept. And where we may have the same ability to identify a color, the associated meaning is just that—a learned association. Concluding that red means passion, vitality, or energy, because blood and fire are red things is <em>not</em> a universal idea. Neither is associating green with growth, just because nature involves so much green. (In some Chinese cultures, green can be associated with death.) At this point, please throw away those blog posts and posters about colors to choose for different cultures. While we’re keen to seek out human universals, color has proven to be something that does not have consistent meaning across cultures, or even within a culture group. Rather, the concepts we associate with particular colors are highly contextual and local, not just to a particular culture, but sometimes to smaller social groups. The meanings we point to—blue as a safe, corporate color, for example—are highly generalized assumptions, highly contextual, and mostly learned associations.</p>
<h2 id="section9">The Color Purple<a class="subhead-anchor" href="https://alistapart.com#section9">#section9</a></h2>
<p>Let’s take purple, as an example. For many centuries, purple dye was expensive and rare. Procuring purple dye was labor intensive and required collecting a secretion from sea snails. Historian David Jacoby remarked that “twelve thousand snails of Murex brandaris yield no more than 1.4 g of pure dye, enough to colour only the trim of a single garment.”<sup>[9]</sup> As a result of this laborious process, the high cost of producing purple clothing made this color a status symbol among kings, queens, and other rulers. If you could afford to wear purple, you were quite wealthy. The conceptual association then is one of scarcity (in this case of a particular dye), signaling something to be valued above other things. While we may still see the lingering effects of this history (the Purple Heart is among the highest honors awarded for U.S. military service), the constraint of purple as a scarce color is no longer true. As such, this color is able to take on new meanings.</p>
<h2 id="section10">“Pink Is for Girls, Blue Is for Boys”<a class="subhead-anchor" href="https://alistapart.com#section10">#section10</a></h2>
<p>To put this into perspective, let’s investigate the idea that “pink is for girls, blue is for boys.” From clothing choices to marketing toys to how we decorate bedrooms, most of us grow up believing there’s some inherent gender association built into the colors pink and blue. But, were we to travel back in time—just over 100 years—we’d find no such distinction. Or we might find the opposite association.</p>
<p>According to University of Maryland historian Jo B. Paoletti, author of <em>Pink and Blue: Telling the Girls from the Boys in America</em>, pink and blue weren’t always gender-specific colors. For centuries, young children mostly wore a functional white dress, and then in the early 20th century, things began to change. Consider this quote, pulled from the June 1918 issue of Earnshaw’s Infants’ Department, a trade publication:</p>
<blockquote class="wp-block-quote quote">
<p>The generally accepted rule is pink for the boys, and blue for the girls. The reason is that pink, being a more decided and stronger color, is more suitable for the boy, while blue, which is more delicate and dainty, is prettier for the girl.</p>
</blockquote>
<p>A Smithsonian review of Paoletti’s book,<sup>[10]</sup> goes on to add:</p>
<blockquote class="wp-block-quote">
<p>Other sources said blue was flattering for blonds, pink for brunettes; or blue was for blue-eyed babies, pink for brown-eyed babies, according to Paoletti.</p>
<p>In 1927, <em>Time</em> magazine printed a chart showing sex-appropriate colors for girls and boys according to leading U.S. stores. In Boston, Filene’s told parents to dress boys in pink. So did Best &amp; Co. in New York City, Halle’s in Cleveland, and Marshall Field in Chicago.</p>
</blockquote>
<p>By the 1940s, this association had flipped. Manufacturers had settled on pink for girls and blue for boys (see <strong>Figure 8.3</strong> as an example of this association). Baby Boomers were raised with wearing the two colors. The point of this narrative? Color associations are learned things and can change over time. Even something as seemingly strong as the pink/blue binary was a manufactured association. To be clear, this doesn’t mean a color association is any less powerful in the moment, at a particular point in history, but these color associations do not represent any universal truths.</p>
<figure id="figure3" class="wp-block-image size-large"><img src="https://alistapart.com/wp-content/uploads/2020/05/08.03a.jpg?w=960" alt="A box of 'It's a boy!' baby announcement candy cigars in blue" class="wp-image-7172368" /><br /><img src="https://alistapart.com/wp-content/uploads/2020/05/08.03b.jpg?w=960" alt="A box of 'It's a girl!' baby announcement candy cigars in pink" class="wp-image-7172369" data-recalc-dims="1" /><figcaption><strong>Figure 8.3</strong> – The “blue is for boys and pink is for girls” concept was a manufactured one, originating in the first half of the 20th century.</figcaption></figure><p>Accordingly, it’s good to be wary of generalizations such as “blue is a safe, corporate color.” In the case of corporate associations, one generation’s “safe” may—depending on the media and actions—signal stuffy, inauthentic, or distrustful to the next generation. It all depends on the learned associations embraced—for a time—by a particular culture.</p>
<h2 id="section11">Not All Colors Are Created Equal<a class="subhead-anchor" href="https://alistapart.com#section11">#section11</a></h2>
<p>We tend to treat our color palettes like interchangeable parts. Just pick a color. Or pick some colors we all find pleasing. Consider how many of us use the default color palettes built into software tools like Excel or PowerPoint. We usually choose a pleasing color palette, with the sentiment being “as long as you can distinguish one color from another, it’s okay, right?”</p>
<p>Not exactly. Not all colors are created equal. In terms of visual perception, some colors jump out at you while others recede into the background (see <strong>Figure 8.4</strong>). This is because of variances in hue and saturation.</p>
<figure id="figure4" class="wp-block-image size-large"><img src="https://alistapart.com/wp-content/uploads/2020/05/08.04.jpg?w=960" alt="A series of four charts, each with an increasing number of colors" class="wp-image-7172370" data-recalc-dims="1" /><figcaption><strong>Figure 8.4</strong> The range of colors perceived by humans is uneven.<br />
(Equiluminant colors from the NASA Ames Color Tool)</figcaption></figure><p>A very bright color is going to draw more visual attention than a more desaturated color. This makes sense if we consider how things farther away from us tend to be hazier and desaturated. If something in the distance is noticed, it’s likely because it’s moving or contrasts with the surroundings.</p>
<p>This same disparity applies to color hues. We tend to look at color charts like this one and assume that the extreme ends of red, green, and blue are on equal footing.</p>
<figure id="figure5" class="wp-block-image size-large"><img src="https://alistapart.com/wp-content/uploads/2020/05/ill08.01a.jpg?w=960" alt="Two gradients, one going from black to red, one going from black to gray" class="wp-image-7172372" data-recalc-dims="1" /></figure><figure id="figure6" class="wp-block-image size-large"><img src="https://alistapart.com/wp-content/uploads/2020/05/ill08.01b.jpg?w=960" alt="Two gradients, one going from black to green, one going from black to gray" class="wp-image-7172373" data-recalc-dims="1" /></figure><figure id="figure7" class="wp-block-image size-large"><img src="https://alistapart.com/wp-content/uploads/2020/05/ill08.01c.jpg?w=960" alt="Two gradients, one going from black to blue, one going from black to gray" class="wp-image-7172374" data-recalc-dims="1" /></figure><p>However, because of the wavelengths of these colors and how our eyes perceive color, we see green as brighter than red, which itself is brighter than blue.</p>
<h2 id="section12">How Is This Knowledge Useful?<a class="subhead-anchor" href="https://alistapart.com#section12">#section12</a></h2>
<p>While it’s nice to think that precise color values are interchangeable (setting aside any cultural associations), your perception doesn’t work that way. In the same way that certain frequencies on the radio come in clearer than others, certain colors do the same. You need to account for, or at least consider, the unevenness of color perception.</p>
<p>In the example in <strong>Figure 8.5</strong>, you see the same eight-segment pie chart. The example on the right uses all high-saturation colors while the example on the left mixes high- and low- saturation colors.</p>
<figure id="figure8" class="wp-block-image size-large"><img src="https://alistapart.com/wp-content/uploads/2020/05/08.05.jpg?w=960" alt="Two equal pie charts with differing levels of saturation in the colors" class="wp-image-7172371" /><figcaption><strong>Figure 8.5</strong> Two pie charts showing identical information. The chart on the left uses colors of mixed saturation, meaning some colors will naturally stand out more than others, making this an uneven representation.</figcaption></figure><p>Functionally, these both communicate the same thing. But consider how you <em>perceive</em> each. With the example on the right, use of high saturation is consistent; no color should be more prominent than another. But when you mix high and low saturation, as with the example on the left, the higher saturation colors tend to “pop” more—drawing you to these segments. While this chart is more aesthetically pleasing (as it uses half as many colors), it’s also a bit misleading—notice how your eye is drawn to the orange segment in the upper right. The lesson? Assuming the goal is objectivity and truthfulness, you’d want to avoid mixing saturations and hues that are unevenly perceived. If the goal were the opposite, to draw attention away from or toward a particular bit of data, you could manipulate perception by adjusting saturation and hue (not that this is being recommended!). This ability to direct attention by using bolder colors is something that everyone should be aware of and intentional about.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">"Designing Value," an excerpt from Jim Kalbach's book The Jobs To Be Done Playbook, gives advice on creating a jobs-driven roadmap and using job stories to solve specific design problems.</div><div class="entry-content">Voice-driven content challenges many of our approaches to usability testing. Preston So turns them into opportunities and advantages for the medium itself.</div><div class="entry-content">In this excerpt from Cross-Cultural Design, Senongo Akpem discusses the many facets of typography that must be considered when you are looking to reach a global audience.</div><div class="entry-content">In this excerpt from Writing is Designing, Michael J. Metts and Andy Welfle discuss the importance of writing with accessibility in mind.</div><div class="entry-content">In this excerpt from Expressive Designs Systems, Yesenia Perez-Cruz goes deep on what it takes to create design systems that enables intentional, meaningful variation.</div>]]></description>
      <link>https://alistapart.com/article/figure-it-out/</link>
      <guid>https://alistapart.com/article/figure-it-out/</guid>
      <pubDate>Thu, 21 May 2020 16:30:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Jobs To Be Done]]></title>
      <description><![CDATA[<div class="entry-content">
<p>In this chapter, you’ll learn about these plays:</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<ul><li>How to create a jobs-driven roadmap</li>
<li>Using job stories to solve specific design problems</li>
<li>How to architect the structure of a solution</li>
<li>Testing assumptions directed by JTBD</li>
</ul><p>A software company I once worked for held what were called “hackweeks” once a quarter. This was a time for developers to work on “whatever they wanted,” as it was framed. Give engineers time to play around with technology, and they’re bound to find the next innovation, or so the theory went.</p>
<p>Hackweek was a big deal for us. Dozens of people organized it, and every developer in the company stopped work to contribute to the effort. It was costly, but we were committed to hackweek. After all, new software offerings come from new development, right?</p>
<p>Here’s how it went: small teams formed to cobble together starter projects representing the use of some new technology. At the end of the week, a panel judged the dozens of concepts that emerged, and the winning “solutions” were rewarded.</p>
<p>But in our case, hackweek was like shooting a shotgun in the wrong direction while blindfolded and hoping to hit the target. The result was inevitably a collection of concepts looking for a problem to solve. It was innovation theater at its best.</p>
<p>To be fair, not all hackathons are bad. Some organizations coordinate hackathons with strategic imperatives or with customer needs. And sure, it’s also good to flex creative muscles and practice collaboration across teams. But given their cost and imprecision, hackathons are often largely ineffective in producing usable concepts.</p>
<p>The problem is not a lack of ideas—companies are usually swimming in them. Like ours, many organizations have a Darwinistic outlook on innovation: generate more and more ideas, and the best will surely rise to the top. Said another way, when looking for a needle in a haystack, the best approach is rarely to add more hay.</p>
<p>The problem is knowing which ideas to pursue. The goal of innovation activities shouldn’t be to collect as many ideas as possible, but instead to get to the right ideas—the ones that matter most to the people you serve.</p>
<p>But more than that, the real challenge is in overcoming the natural forces in organizations that keep good ideas down. Chief among these is uncertainty, a leading deterrent to innovation. New ideas are a gamble for risk-averse managers, even if well-expressed in a high-fidelity prototype.</p>
<p>JTBD provides a way to increase your chances of success by first identifying the right problem to solve. Then JTBD gives you decision-making criteria for moving forward: bet on solutions that address unmet needs to create profitable differentiation.</p>
<p>Focus first on getting the main job done for the individual and fulfilling their needs in relation to the job. From this perspective, hackathons and other idea-generating efforts can be framed by JTBD as both inputs and outputs in terms of how concepts are evaluated.</p>
<p>After understanding the job landscape and defining the value you’re going after, you can continue using JTBD thinking to align teams around the design of your solution. Create a roadmap based on your JTBD landscape to set a common direction. Then use job stories to get everyone on the same page and tie local design efforts to the big picture and to architect the solution structure. JTBD can also guide the experiments you conduct to test your team’s assumptions.</p>
<h2 id="section2">Create a Development Roadmap<a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>At its highest level, a roadmap is a sequence of development events—the relative chronological order in which features and capabilities will be built. Roadmaps serve as a central point of reference for teams to align their efforts. They show the path forward without defining individual tasks.</p>
<p>In the age of Agile and Lean efforts, roadmaps have gotten a bad reputation. People are quick to point out—and rightfully so—that long-term plans inevitably fail: priorities change, unforeseen challenges arise, and timelines slip. The solution, they might argue, is to have no long-term plans and to work on short initiatives with the flexibility to change as needed.</p>
<p>But while providing decision-making power to local development teams makes sense, overall alignment is still needed. An alternative way of viewing roadmaps is to see them not as a definitive project plan, but as a vision of how you’ll create an offering that customers will value. Roadmaps are not unchanging predictions of future activity, but a way to provide transparency for the sequence of steps your team will take to design solutions.</p>
<p>The information in a roadmap helps the entire organization get aligned, not just developers. It’s a strategic communication tool reflecting intention and direction. More importantly, road mapping isn’t just about the artifact: it’s about getting a common understanding of where you’re headed. In this sense, the roadmap occupies the space between the vision and detailed project planning.</p>
<p>JTBD can help create roadmaps that focus on the value that the organization intends to create and deliver for customers. The trick is to get the right problem to solve. Use the insights from your JTBD investigation to formulate roadmaps that are grounded in real customer need.</p>
<h3 id="section3">Mapping the Road Ahead<a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h3>
<p>For a concrete approach to road mapping, I recommend the book <em>Product Roadmaps Relaunched</em> by C. Todd Lombardo, Bruce McCarthy, Evan Ryan, and Michael Conners.<sup>[1]</sup> In it, the authors clearly articulate the steps to creating meaningful product roadmaps.</p>
<p>JTBD plays a key role in aligning to customer needs, as the authors write: “We recommend starting with the chunks of value you intend to deliver that will build up over time to accomplish your visions. Often this is a set of high-level customer needs, problems, or jobs to be done.”</p>
<p>Their approach breaks down the four key elements of a good product roadmap:</p>
<ul><li><strong>Product vision:</strong> The vision outlines how your customers will benefit from your offering. How will the job performer benefit from the solution? What will getting the job done look like after the solution is in place?</li>
<li><strong>Business objectives:</strong> A roadmap must be aligned with the organization’s strategy and objectives. The goals of the business are important for measuring progress.</li>
<li><strong>Timefames:</strong> Rather than committing to specific dates, good roadmaps sequence work and set broad timelines for completion.</li>
<li><strong>Themes:</strong> These are the key problems that customers face when completing a job, or clusters of needs that align to the overall solution to be created. JTBD helps frame the themes of your roadmap in particular.</li>
</ul><p>Figure 5.1 shows an example from their book of a basic roadmap overview for a fictional company, The Wombatter Hose, illustrating these main components. Note the disclaimer, as well, indicating that the roadmap is subject to change.</p>
<figure id="figure1" class="wp-block-image size-large"><img src="https://alistapart.com/wp-content/uploads/2020/05/fig-5.1-wombatter-hose.jpg?fit=672%2C1024&amp;w=960" alt="" class="wp-image-7172352" data-recalc-dims="1" /><figcaption>Figure 5.1: An example of the main components of a roadmap from the book <cite>Product Roadmaps Relaunched</cite>.<sup>2</sup></figcaption></figure><p>Putting it all together, the process for creating a JTBD-driven roadmap can be broken down into four phases.</p>
<p><strong>Step 1: Define the solution direction.</strong></p>
<p>Define the various elements of your overall product strategy to get agreement on how you’ll be using them. In addition to your solution vision, also define the following together with the team:</p>
<ul><li><strong>Mission:</strong> What are your business intentions? The mission is about what your organization wants to ultimately achieve.</li>
<li><strong>Values:</strong> What are your beliefs and ideals? What is the philosophy of your organization and solution? Values define the philosophy of the team and what it believes.</li>
<li><strong>Business objectives:</strong> What are the specific goals your offerings will accomplish for the organization? Frame these in terms of outcomes, not outputs.</li>
</ul><p><strong>Step 2: Determine customer needs to pursue.</strong></p>
<p>Next, decide on the customer needs to pursue. Here, the authors of <em>Product Roadmaps Relaunched</em> stress the importance of grounding the roadmap in actual customer need. JTBD is central to this step. They write:</p>
<blockquote class="wp-block-quote">
<p>“Identifying customer needs is the most important aspect of your roadmapping process. Roadmaps should be about expressing those customer needs. Therefore, most items on your roadmap will derive from a job the customer needs to accomplish or a problem the customer must solve.”</p>
</blockquote>
<p>As outlined in Chapter 2, “Core Concepts of JTBD,” needs are hierarchical—from high-level aspirations to main jobs and sub-jobs to micro-jobs. Figure out the top-level jobs to explore and then drill down into the specific themes to target.</p>
<p>The “value themes,” as they are called, might come right from the job map. Locate the areas of highest underserved needs and use those stages as the categories of your roadmap themes. Or you can cluster needs to form themes that don’t necessarily follow the chronology of the job map. The important point is to ground the division of the roadmap in real-world observations of the customer’s job to be done and align the timeline to it.</p>
<p><strong>Step 3: Set a timeline.</strong></p>
<p>Next, create a sequence of value themes that your team will work toward. Timelines can be absolute, relative, or a mix of both. Absolute timelines with specific dates carry the risk of changing, which, in turn, can cause confusion or missed expectations.</p>
<p>Relative timelines give more flexibility but still provide insight into what’s coming and why. There are various terms to use, but the timeline is often broken into three phases for near-term, mid-term, and long-term. Examples include “now, later, future” or “going, next, later” or something similar. Find what works best for you.</p>
<p><strong>Step 4: Align development effort to the roadmap.</strong></p>
<p>Finally, conceptualize specific solutions to design and create. Use job stories to tie the overall project intent to customer needs, outlined in the next section. Then conceptualize solutions around getting the entire job done or the parts of it determined to be most strategically relevant to your business.</p>
<p>After a roadmap is created, you may then need detailed project plans to track progress. A simple Kanban board can serve that purpose in many cases. Or, for more complex software development efforts, tracking software may be needed. In Agile efforts, epic planning and then sprint planning come after you have an overall roadmap.</p>
<p>Tying the overall plan to customer needs gives the design and development teams the feeling that they are building something that matters to customers. Staying focused on customer needs helps avoid building things your customers don’t want. The nature of a job stays the same, even as features may shift. Grounding the roadmap in JTBD ensures that both its longevity and ability to absorb will change.</p>
<h3 id="section4">Learn More About This Play<a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h3>
<p>Lombardo, C. Todd, Bruce McCarthy, Evan Ryan, and Michael Conners.<sup>[3]</sup><em>Product Roadmaps Relaunched.</em> Sebastopol, CA:O’Reilly, 2018.</p>
<blockquote class="wp-block-quote">
<p>This book distills a wealth of practical information into a compact guide on roadmapping. The authors go to great lengths to provide numerous examples and stories from real-world cases. They use a realistic, modern approach for creating a roadmap that is driven, in part, by JTBD.</p>
</blockquote>
<h2 id="section5">Align Teams to Job Stories<a class="subhead-anchor" href="https://alistapart.com#section5">#section5</a></h2>
<p>Agile development enables teams and organizations to work in a flexible way. The approach started in software development, but has spread to other domains, including government and the military. The principles of Agile development can apply to just about any field.</p>
<p>A key part of Agile is to break down efforts into individual units of work. <em>User stories</em> are short descriptions of features and functionality written from the perspective of the end user. Teams can focus on only a small part of the whole and make progress in a controlled way.</p>
<p>User stories are commonly written in a three-part format. The first element indicates a user’s role in the system. The second points to a capability that enables the person to get a task done. The last part often describes a benefit or reason for using the capability.</p>
<p>Although specific styles can vary, a typical user story resembles something like the following:</p>
<blockquote class="wp-block-quote">
<p>As a &lt;role&gt; I can &lt;capability&gt;, so that &lt;benefit&gt;</p>
</blockquote>
<p>Examples of use stories in this format include:</p>
<ul><li>As a system admin, I can specify files or folders to back up based on file size, date created, and date modified.</li>
<li>As a user, I can indicate folders not to back up so that my drive isn’t filled up with things I don’t need to be saved.</li>
<li>As a user, I want to update the name of a document so that I can categorize it.</li>
</ul><p>For any given system, there may be hundreds of user stories. Some can be quite granular, such as describing a single button and why a user would click it. Stories are then organized into a backlog or repository of functionality to be built. Teams break off logical groups of user stories in sprints or two- to four-week cycles of work.</p>
<h3 id="section6">Job Stories<a class="subhead-anchor" href="https://alistapart.com#section6">#section6</a></h3>
<p>Although user stories are good for breaking down work, they typically fail to connect the solution being built with user needs. They lack an indication of <em>why</em> someone would behave in a certain way and what they need to get a job done. In fact, often user stories are derived from the capability being built, not from observing actual behavior.</p>
<p><em>Job stories</em> are an alternative to user stories. They follow the tradition of breaking down efforts into smaller pieces, but through the JTBD lens. The technique was first pioneered by the product development team at Intercom, a leading marketing communications solution. They wanted to avoid leading designers with a preconceived solution, as well as tying development to the company vision and strategy.</p>
<p>Paul Adams, an Intercom product manager, wrote about job stories for the first time, saying: “We frame every design problem in a Job, focusing on the triggering event or situation, the motivation and goal, and the intended outcome.”<sup>[4]</sup></p>
<p>As a result, their job story format also has three parts. But instead of focusing on a generic role, like a “user” or an “admin,” job stories begin with a highlight on the situation and context, not the individual:</p>
<blockquote class="wp-block-quote">
<p>When [situation], I want to [motivation], so I can [expected outcome].</p>
</blockquote>
<p>Examples of job stories include:</p>
<ul><li>When an important new customer signs up, I want to be notified so that I can start a conversation with that person.</li>
<li>When I visit someone’s profile page, I want to see how many posts they have in each topic so that I have an understanding of where they have the most knowledge.</li>
<li>When I have used the application multiple times, I get nudged to contribute so that I am encouraged to participate.</li>
</ul><p>JTBD author and leader Alan Klement has done the most work refining the job story format.<sup>[5]</sup> He believes that adding more information about the circumstances shows causality better. Focusing on the context shifts attention from a persona to the situation. Klement advises that you avoid writing vague situations, but instead be as specific as possible.</p>
<p>For instance, consider these three possible situations for the first element of job stories:</p>
<ul><li>When I’m hungry…</li>
<li>When I’m lost…</li>
<li>When I want to check my email…</li>
</ul><p>Instead, Klement recommends describing the circumstances in rich detail:</p>
<ul><li>When I’m hungry, running late to get somewhere, not sure when I’m going to eat again, and worried that I’ll soon be tired and irritable from hunger…</li>
<li>When I’m lost in a city that I’ve never been to, don’t know the local language, and am worried that I’ll be wasting my time in places I don’t want to be in…</li>
<li>When I want to check my email, but don’t want anyone around me to know I’m checking my email because they’ll think I’m being rude…</li>
</ul><p>Each of these example situations provides more context for designing an appropriate solution.</p>
<h3 id="section7">Working with Job Stories<a class="subhead-anchor" href="https://alistapart.com#section7">#section7</a></h3>
<p>Job stories are modular, giving designers and developers the flexibility to solve problems in alternative ways. Job stories are grounded in real-world insight, and they are more powerful than user stories in guiding solutions. But creating job stories is more free-form than other JTBD techniques. Still, there are patterns that you can follow. Using the elements from Chapter 2, I suggest the following structure for job stories:</p>
<blockquote class="wp-block-quote">
<p><em>When I [circumstance + job stage/step], I want to [micro-job], so I can [need].</em></p>
</blockquote>
<p>Examples:</p>
<ul><li>When I am one of the top posters while updating my social media feeds daily, I want it to show on my profile so that I can increase recognition as an expert on the subject.</li>
<li>When I run out of materials needed while completing an art project, I want to find alternative materials so that I can maximize the number of uses of my current supplies.</li>
<li>When preparing for my commute and running late, I want to know the current weather along my journey so that I can minimize the chance of arriving wet.</li>
</ul><p>Consider the last example. The first element combines information about the circumstances (<em>running late</em>) of getting the main job done (<em>commute to work</em>) within a stage of the process (<em>prepare for commute</em>).</p>
<p>The second element points to an even smaller step or micro-job (<em>check forecast</em>). It should be formulated without reference to specific technology, but should be specific enough for designers and developers to create a specific capability.</p>
<p>Finally, the last element can be taken right from your list of needs. In this case, the job performer (<em>commuter</em>) wants to avoid showing up to the office wet (<em>minimize the chance of arriving at work wet</em>). You can leverage the elements your JTBD landscape already uncovered in research directly in the formulation of the job story statements.</p>
<p>In researching this book, I’ve come across various alternative approaches to formulating job stories. Andrea Hill, a prominent advocate of JTBD on social media, suggests a slightly different approach. She sees the middle element pointing directly to a feature or solution of some kind, thus explicitly crossing from the problem space into the solution space. Her basic format is as follows:</p>
<p><em>When I [circumstance], I want to [solution capability], so I can [need].</em></p>
<p>A job story for the previous example of commuting to work might then look like this:</p>
<blockquote class="wp-block-quote">
<p><em>When I’m preparing to commute to work, I want to have weather forecast notifications pushed to my phone, so I can minimize the chance of arriving wet.</em></p>
</blockquote>
<p>Steph Troeph, research and JTBD instructor in the UK, approaches job stories in yet another way. She thinks of them with this formula:</p>
<p><em>When I [circumstance], I want to [job], so that [benefit a solution offers].</em></p>
<p>Regardless of your interpretation, the key is to find a consistent structure and stick with it. The form you end up with needs to be appropriate to your team and your situation.</p>
<h3 id="section8">Jobs Stories in Action<a class="subhead-anchor" href="https://alistapart.com#section8">#section8</a></h3>
<p>Ultimately, job stories tie a local design and development effort to a broader JTBD framework. Because the format of job stories includes contextual details, they are portable. In other words, a job story should make sense without having to know the larger JTBD landscape or job map. As a result, job stories have a more “plug-and-play” versatility that is often required for Agile designs and development teams.</p>
<p>For instance, Agile planners can manage a backlog of job stories much in the same way that they would manage user stories. If a given sprint gets slowed down or changes direction, stories not addressed can be carried over to the next sprint. Having a smaller, self-contained description of the smaller job to be done has advantages during the design and development phases.</p>
<p>But to be clear: I have found that job stories typically <em>do not</em> replace user stories for development completely. Instead, job stories guide and frame the conceptualization of a solution rather than track implementation. They serve best as a design tool to create or determine concept direction and design. Developers and engineers will likely still need user stories to measure the burndown rate and overall progress.</p>
<p>Your job map provides an overall orientation to your JTBD landscape and allows you to zero in on a specific area for design and development. A roadmap gives you a high-level sequence of development with the rationale for planning activities. Job stories are more specific and guide the local design and development of features and capabilities.</p>
<p>Follow these steps to create job stories based on your JTBD research:</p>
<p><strong>Step 1: Understand job stages and circumstances.</strong></p>
<p>Base the relevant jobs and circumstances on previous interviews and observations. For each area of development in your solution, consider the steps in the main job. Then drill down and list the smaller and smaller steps as micro-jobs, using the rules of formulating JTBD. Also identify the circumstances that apply to that part of the main job in particular.</p>
<p>Depending on the depth of your prior research and how well you and your team understand the job, you may not need to do more research to create and validate job stories. It’s never a bad idea to speak with people again and drill down on specific problems and objectives they have. During additional interviews, ask “how?” until you get more granular in understanding of subgoals and objectives.</p>
<p><strong>Step 2: Formulate job stories.</strong></p>
<p>As a team, write job stories that are specific to your design and development effort. Decide on a consistent format for the job stories and stick to it.</p>
<p>Strive to come up with unique, mutually exclusive stories that target specific jobs and circumstances. Avoid redundancy. For instance, in the previous example, you probably don’t need separate stories for commuting by train versus commuting by car. Develop the job stories that matter the most and focus on a limited set. You may end up with anywhere from three to eight job stories per project or sprint.</p>
<p><strong>Step 3: Solve for the job stories.</strong></p>
<p>Make job stories visible and transparent to the entire team to solve for the job stories. For instance, post a relevant list of job stories in a brainstorming session for everyone to see. Or list job stories at the beginning of a design critique so that the team has context for making comments. Use JTBD to guide design and development decisions.</p>
<p>It’s also possible to then use the job stories to review the appropriateness of your solutions. First, the design team can use the job stories relevant to a project as heuristics. They should constantly ask if their designs are meeting the user’s goals set out in the job stories.</p>
<p>Then you can test solutions with users against the job stories. Show users your solutions (e.g., as a mock-up or prototype) and ask them how well each addresses the job stories. This can be done in an interview-style fashion or with a survey. The job stories ultimately become a measure for success of the designs before anything is built.</p>
<p>Job stories let you take a step back and look at the context of the job while designing a product or service. In this respect, job stories fill an important gap between the observations of customers and solution development, connecting insights into customer needs to individual features and development efforts.</p>
<h3 id="section9">Related Approaches: Needs Statements<a class="subhead-anchor" href="https://alistapart.com#section9">#section9</a></h3>
<p>Design thinking is a broad framework for creative problem solving. It is rooted in human-centered methods that seek to develop deep empathy for people and then to devise solutions that meet their needs. In design thinking, it is important to define the problem to solve before generating options for solutions.</p>
<p>One technique to encapsulate insights from research is to generate <em>need statements</em>, greatly resembling job stories in form. But these statements differ from “needs,” as defined in Chapter 2, in that need statements in design thinking are not specifically limited to the outcomes of a getting a main job done, and they can be aspirational in nature.</p>
<p>Need statements in design thinking also tend to be much more focused on a persona or an individual rather than the circumstances. For instance, writing for the Norman Nielsen Group, Sarah Gibbons refers to need statements representing a point-of-view for the user of a system:<sup>[6]</sup> “A user need statement is an actionable problem statement used to summarize who a particular user is, the user’s need, and why the need is important to that user.”</p>
<p>Like job stories, need statements have three components: a user, a need, and a goal. The <em>user</em> corresponds to a goal-based persona based on research (as outlined in Chapter 4, “Defining Value”). A <em>need</em> is expressed independent of a feature or technology. The <em>goal</em> is the result of meeting the need. Gibbons provides an example:</p>
<blockquote class="wp-block-quote">
<p>Alieda, a multitasking, tech-savvy mother of two, needs to quickly and confidently compare options without leaving her comfort zone in order to spend more time doing the things that really matter.</p>
</blockquote>
<p>Note that the insight at the end of this statement, “doing the things that really matter,” is very broad and hard to measure. Job stories, on the other hand, favor a more specific context and outcome. For instance, rewriting the above example through the lens of job stories might yield something like the following:</p>
<blockquote class="wp-block-quote">
<p>When I’m multitasking and in a rush, I need a familiar way to quickly and confidently compare options so that I can minimize the time spent on finding a solution.</p>
</blockquote>
<p>Like need statements in design thinking, job stories also avoid the mention of features or technology. Yet, they are much more specific to a given job and its context. While both a need statement from design thinking and a job story can feed into the creative generation of solutions, job stories will provide more direct guidance without prescribing a solution.</p>
<p>But the definition of a <em>need</em> in design thinking can vary greatly. For instance, IBM’s Enterprise Design Thinking approach also includes guidelines for generating statements.<sup>[7]</sup> Not surprisingly, there are three parts: a user, a need, and a benefit. Here’s an example from the IBM site:</p>
<blockquote class="wp-block-quote">
<p>A developer needs a way to make sense of minimal design so that they can prototype faster.</p>
</blockquote>
<p>This example is much more specific than Gibbon’s approach, yet still avoids mentioning a specific solution. There are no aspirational elements, such as “pursuing lifelong dreams,” sometimes found elsewhere in design thinking. IBM’s approach to need statements is closer to the job story approach, but is also light on describing the circumstances of use.</p>
<p>In some sense, the differences between job stories—even with the variations in format—and need statements points to a key distinction between JTBD and design thinking. The former focuses much more on the circumstances than the person’s state of mind or psychology. Where design thinking seeks to gain empathy for the individual as a starting point, JTBD seeks to understand the circumstances of accomplishing an objective before factoring in emotional and personal aspects.</p>
<h3 id="section10">Learn More About This Play<a class="subhead-anchor" href="https://alistapart.com#section10">#section10</a></h3>
<p>Klement, Alan. “Replacing the User Story with the Job Story.” <em>JTBD.info</em> (2013); “5 Tips for Writing a Job Story,” <em>JTBD.info</em> (2013); “Designing Features Using Job Stories,” <em>Inside Intercom</em> (2015).</p>
<blockquote class="wp-block-quote">
<p>Klement has done the most extensive work to develop the job story technique. These three articles outline the basis for creating them. The technique has evolved slightly, but Klement points clearly to how he’s updated his approach. Klement and others have posted widely about their use for development efforts, but start with these resources.</p>
</blockquote>
<p>van de Keuken, Maxim. “Using Job Stories and Jobs-to-be-Done in Software Requirements Engineering.” Thesis, Utrecht University, 2017.</p>
<blockquote class="wp-block-quote">
<p>This thesis project offers a detailed investigation of how job stories are applied to date. After illustrating the history of job stories, Van de Keuken presents the results of his original research variations in application of job stories as seen in practice. This work contributes greatly to making job stories a more formal part of software requirements engineering.</p>
</blockquote>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Voice-driven content challenges many of our approaches to usability testing. Preston So turns them into opportunities and advantages for the medium itself.</div><div class="entry-content">In this excerpt from Cross-Cultural Design, Senongo Akpem discusses the many facets of typography that must be considered when you are looking to reach a global audience.</div><div class="entry-content">In this excerpt from Writing is Designing, Michael J. Metts and Andy Welfle discuss the importance of writing with accessibility in mind.</div><div class="entry-content">In this excerpt from Expressive Designs Systems, Yesenia Perez-Cruz goes deep on what it takes to create design systems that enables intentional, meaningful variation.</div><div class="entry-content">To boost performance responsibly, Aaron Gustafson puts a spin on classic best practices, experiments with media caching strategies, and shares smart Cache API tricks.</div>]]></description>
      <link>https://alistapart.com/article/jobs-to-be-done/</link>
      <guid>https://alistapart.com/article/jobs-to-be-done/</guid>
      <pubDate>Thu, 07 May 2020 16:30:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Usability Testing for Voice Content]]></title>
      <description><![CDATA[<div class="entry-content">
<p>It’s an important time to be in voice design. Many of us are turning to voice assistants in these times, whether for comfort, recreation, or staying informed. As the interest in interfaces driven by voice continues to reach new heights around the world, so too will users’ expectations and the best practices that guide their design.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>Voice interfaces (also known as voice user interfaces or VUIs) have been reinventing how we approach, evaluate, and interact with user interfaces. The impact of conscious efforts to reduce close contact between people will continue to increase users’ <a href="https://alistapart.com/article/do-androids-dream-in-free-verse/">expectations for the availability of a voice component</a> on all devices, whether that entails a microphone icon indicating voice-enabled search or a full-fledged voice assistant waiting patiently in the wings for an invocation.</p>
<p>But voice interfaces present inherent challenges and surprises. In this relatively new realm of design, the intrinsic twists and turns in spoken language can make things difficult for even the most carefully considered voice interfaces. After all, spoken language is littered with <em>fillers</em> (in the <a href="https://en.wikipedia.org/wiki/Filler_(linguistics)">linguistic sense of utterances like <em>hmm</em> and <em>um</em></a>), hesitations and pauses, and other interruptions and speech disfluencies that present puzzling problems for designers and implementers alike.</p>
<p>Once you’ve built a voice interface that introduces information or permits transactions in a rich way for spoken language users, the easy part is done. Nonetheless, voice interfaces also surface unique challenges when it comes to usability testing and robust evaluation of your end result. But there are advantages, too, especially when it comes to accessibility and cross-channel content strategy. The fact that voice-driven content lies on the opposite extreme of the spectrum from the traditional website confers it an additional benefit: it’s an effective way to analyze and stress-test just how channel-agnostic your content truly is.</p>
<h2 id="section2">The quandary of voice usability<a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>Several years ago, I led a talented team at <a href="https://www.acquia.com/resources/acquia-labs">Acquia Labs</a> to design and build a voice interface for <a href="https://digitalservices.georgia.gov/">Digital Services Georgia</a> called <a href="https://www.acquia.com/blog/ask-georgiagov-alexa-skill-citizens-georgia-acquia-labs/12/10/2017/3312516">Ask GeorgiaGov</a>, which allowed citizens of the state of Georgia to access content about key civic tasks, like registering to vote, renewing a driver’s license, and filing complaints against businesses. Based on copy drawn directly from the frequently asked questions section of the <a href="https://georgia.gov/">Georgia.gov website</a>, it was the first Amazon Alexa interface integrated with the <a href="https://www.drupal.com">Drupal</a> content management system ever built for public consumption. Built by my former colleague <a href="https://www.drupal.org/u/hampercm">Chris Hamper</a>, it also offered a host of impressive features, like allowing users to request the phone number of individual government agencies for each query on a topic.</p>
<p>Designing and building web experiences for the public sector is a uniquely challenging endeavor due to requirements surrounding accessibility and frequent budgetary challenges. Out of necessity, governments need to be exacting and methodical not only in how they engage their citizens and spend money on projects but also how they incorporate new technologies into the mix. For most government entities, voice is a completely different world, with many potential pitfalls.</p>
<p>At the outset of the project, the <a href="https://digitalservices.georgia.gov/our-team">Digital Services Georgia team</a>, led by <a href="https://twitter.com/nikofthehill/">Nikhil Deshpande</a>, expressed their most important need: a single content model across all their content irrespective of delivery channel, as they only had resources to maintain a single rendition of each content item. Despite this editorial challenge, Georgia saw Alexa as an exciting opportunity to open new doors to accessible solutions for differently abled citizens. And finally, because there were relatively few examples of voice usability testing at the time, we knew we would have to learn on the fly and experiment to find the right solution.</p>
<p>Eventually, we discovered that all the traditional approaches to usability testing that we’d executed for other projects were ill-suited to the unique problems of <em>voice usability</em>. And this was only the beginning of our problems.</p>
<h3 id="section3">How voice interfaces improve accessibility outcomes<a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h3>
<p>Any discussion of voice usability must consider some of the most experienced voice interface users: people who use assistive devices. After all, accessibility has long been a bastion of web experiences, but it has only recently become <a href="https://hbr.org/2019/05/using-voice-interfaces-to-make-products-more-inclusive">a focus of those implementing voice interfaces</a>. In a world where refreshable Braille displays and screen readers prize the rendering of web-based content into synthesized speech above all, the voice interface seems like an anomaly. But in fact, the <a href="https://upsidelab.io/blog/alexa-for-accessibility/">exciting potential of Amazon Alexa</a> for differently abled citizens represented one of the primary motivations for Georgia’s interest in making their content available through a voice assistant.</p>
<p><a href="https://uxdesign.cc/tips-for-accessibility-in-conversational-interfaces-8e11c58b31f6">Questions surrounding accessibility with voice</a> have surfaced in recent years due to the perceived user experience benefits that voice interfaces can offer over more established assistive devices. Because screen readers make no exceptions when they recite the contents of a page, they can occasionally present superfluous information and force the user to wait longer than they’re willing. In addition, with an effective content schema, it can often be the case that voice interfaces facilitate pointed interactions with content at a more granular level than the page itself.</p>
<p>Though it can be difficult to convince even the most forward-looking clients of accessibility’s value, Georgia has been not only a trailblazer but also a committed proponent of content accessibility beyond the web. The state was among the first jurisdictions to offer a text-to-speech (TTS) phone hotline that read web pages aloud. After all, state governments must serve <em>all</em> citizens equally—no ifs, ands, or buts. And while these are still early days, I can see voice assistants becoming new conduits, and perhaps more efficient channels, by which differently abled users can access the content they need.</p>
<h3 id="section4">Managing content destined for discrete channels<a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h3>
<p>Whereas voice can improve accessibility of content, it’s seldom the case that web and voice are the only channels through which we must expose information. For this reason, one piece of advice I often give to content strategists and architects at organizations interested in pursuing voice-driven content is to <a href="https://alistapart.com/article/conversations-with-robots/">never think of voice content in isolation</a>. Siloing it is the same misguided approach that has led to mobile applications and other discrete experiences delivering orphaned or outdated content to a user expecting that all content on the website should be up-to-date and accessible through other channels as well.</p>
<p>After all, we’ve trained ourselves for many years to think of content in the web-only context rather than across channels. Our closely held assumptions about links, file downloads, images, and other web-based marginalia and miscellany are all aspects of web content that translate poorly to the conversational context—and particularly the voice context. Increasingly, we all need to concern ourselves with an <a href="https://preston.so/writing/building-usable-conversations-the-story-of-ask-georgiagov"><em>omnichannel content strategy</em></a> that straddles all those channels in existence today and others that will doubtlessly surface over the horizon.</p>
<p>With the advantages of structured content in Drupal 7, Georgia.gov already had a content model amenable to interlocution in the form of <em>frequently asked questions</em> (FAQs). While <a href="https://alistapart.com/article/the-faq-as-advice-column/">question-and-answer formats are convenient for voice assistants</a> because queries for content tend to come in the form of questions, the returned responses likewise need to be as voice-optimized as possible.</p>
<p>For Georgia.gov, the need to preserve a single rendition of all content across all channels led us to perform a <a href="https://preston.so/writing/building-usable-conversations-the-story-of-ask-georgiagov"><em>conversational content audit</em></a>, in which we read aloud all of the FAQ pages, putting ourselves in the shoes of a voice user, and identified key differences between how a user would interpret the written form and how they would parse the spoken form of that same content. After some discussion with the editorial team at Georgia, we opted to limit calls to action (e.g., “Read more”), links lacking clear context in surrounding text, and other situations confusing to voice users who cannot visualize the content they are listening to.</p>
<p>Here’s a table containing examples of how we converted certain text on FAQ pages to counterparts more appropriate for voice. Reading each sentence aloud, one by one, helped us identify cases where users might scratch their heads and say “Huh?” in a voice context.</p>
<figure id="figure1"><table><thead><tr><th scope="col">Before</th>
<th scope="col">After</th>
</tr></thead><tbody><tr><td data-title="Before">Learn how to <span class="c1">change your name on your Social Security card</span>.</td>
<td data-title="After">The Social Security Administration can help you <span class="c1">change your name on your Social Security card</span>.</td>
</tr><tr><td data-title="Before">You can receive payments through either a debit card or direct deposit. <span class="c1">Learn more about payments.</span></td>
<td data-title="After">You can <span class="c1">receive payments</span> through either a debit card or direct deposit.</td>
</tr><tr><td class="c2" data-title="Before">Read more about this.</td>
<td data-title="After">In Georgia, the <span class="c1">Family Support Registry</span> typically pulls payments directly from your paycheck. However, you can send your own payments online through your bank account, your credit card, or Western Union. You may also send your payments by mail to the address provided in your court order.</td>
</tr></tbody></table></figure><p>In areas like content strategy and content governance, content audits have long been key to understanding the full picture of your content, but it doesn’t end there. Successful content audits can run the gamut from automated checks for orphaned content or overly wordy articles to more qualitative analyses of how content adheres to a specific brand voice or certain design standards. For a content strategy truly prepared for <a href="https://preston.so/writing/the-channel-explosion-off-screens-and-out-the-window">channels both here and still to come</a>, a holistic understanding of how users will interact with your content in a variety of situations is a baseline requirement today.</p>
<h2 id="section5">Other conversational interfaces have it easier<a class="subhead-anchor" href="https://alistapart.com#section5">#section5</a></h2>
<p>Spoken language is inherently hard. Even the most gifted orators can have trouble with it. It’s littered with mistakes, starts and stops, interruptions, hesitations, and a vertiginous range of other uniquely human transgressions. The written word, because it’s committed instantly to a mostly permanent record, is tame, staid, and carefully considered in comparison.</p>
<p>When we talk about conversational interfaces, we need to draw a clear distinction between the range of user experiences that traffic in <em>written language</em> rather than <em>spoken language</em>. As we know from <a href="https://alistapart.com/article/conversational-design/#section3">the relative solidity of written language and literature</a> versus the comparative transience of spoken language and oral traditions, in many ways the two couldn’t be more different from one another. The implications for designers are significant because spoken language, from the user’s perspective, lacks a graphical equivalent to which those scratching their head can readily refer. We’re dealing with the spoken word and <a href="https://preston.so/writing/affordance-and-wayfinding-in-voice-interface-design"><em>aural</em> affordances</a>, not pixels, written help text, or visual affordances.</p>
<h3 id="section6">Why written conversational interfaces are easier to evaluate<a class="subhead-anchor" href="https://alistapart.com#section6">#section6</a></h3>
<p>One of the privileges that chatbots and textbots enjoy over voice interfaces is the fact that by design, they can’t hide the previous steps users have taken. Any conversational interface user working in the written medium has access to their previous history of interactions, which can stretch back days, weeks, or months: the so-called <em>backscroll</em>. A flight passenger communicating with an airline through Facebook Messenger, for example, knows that they can merely scroll up in the chat history to confirm that they’ve already provided the company with their e-ticket number or frequent flyer account information.</p>
<p>This has outsize implications for information architecture and <a href="https://preston.so/writing/affordance-and-wayfinding-in-voice-interface-design">conversational <em>wayfinding</em></a>. Since chatbot users can consult their own written record, it’s much harder for things to go completely awry when they make a move they didn’t intend. Recollection is much more difficult when you have to remember what you said a few minutes ago off the top of your head rather than scrolling up to the information you provided a few hours or weeks ago. An effective chatbot interface may, for example, enable a user to jump back to a much earlier, specific place in a conversation’s history.An effective chatbot interface may, for example, enable a user to jump back to a much earlier, specific place in a conversation’s history. Voice interfaces that live perpetually in the moment have no such luxury.</p>
<h3 id="section7">Eye tracking only works for visual components<a class="subhead-anchor" href="https://alistapart.com#section7">#section7</a></h3>
<p>In many cases, those who work with chatbots and messaging bots (especially those leveraging text messages or other messaging services like Facebook Messenger, Slack, or WhatsApp) have the unique privilege of benefiting from a <em>visual</em> component. Some conversational interfaces now insert other elements into the conversational flow between a machine and a person, such as <a href="https://tripetto.com/blog/why-conversational-forms-still-matter/">embedded conversational forms</a> (like <a href="https://space10-community.github.io/conversational-form/landingpage/">SPACE10’s Conversational Form</a>) that allow users to enter rich input or select from a range of possible responses.</p>
<p>The success of eye tracking in more traditional usability testing scenarios highlights its appropriateness for visual interfaces such as websites, mobile applications, and others. However, from the standpoint of evaluating voice interfaces that are entirely aural, eye tracking serves only the limited (but academically still interesting) purpose of assessing where the test subject is looking while speaking with an invisible interlocutor—not whether they are able to use the interface successfully. Indeed, eye tracking is only a viable option for voice interfaces that have some visual component, like the Amazon Echo Show.</p>
<h3 id="section8">Think-aloud and concurrent probing interrupt the conversational flow<a class="subhead-anchor" href="https://alistapart.com#section8">#section8</a></h3>
<p>A well-worn approach for usability testing is <em>think-aloud</em>, which allows for users working with interfaces to present their frequently qualitative impressions of interfaces verbally while interacting with the user experience in question. Paired with eye tracking, think-aloud adds considerable dimension to a usability test for visual interfaces such as websites and web applications, as well as other visually or physically oriented devices.</p>
<p>Another is <em>concurrent probing</em> (CP). Probing involves the use of questions to gather insights about the interface from users, and <a href="https://www.usability.gov/how-to-and-tools/methods/running-usability-tests.html">Usability.gov describes two types</a>: <em>concurrent</em>, in which the researcher asks questions during interactions, and <em>retrospective</em>, in which questions only come once the interaction is complete.</p>
<p>Conversational interfaces that utilize written language rather than spoken language can still be well-suited to think-aloud and concurrent probing approaches, especially for the components in the interface that require manual input, like conversational forms and other traditional UI elements interspersed throughout the conversation itself.</p>
<p>But for voice interfaces, think-aloud and concurrent probing are highly questionable approaches and can catalyze a variety of unintended consequences, including accidental invocations of trigger words (such as Alexa mishearing “selected” as “Alexa”) and introduction of bad data (such as speech transcription registering both the voice interface and test subject). After all, in a hypothetical think-aloud or CP test of a voice interface, the user would be responsible for conversing with the chatbot while simultaneously offering up their impressions to the evaluator overseeing the test.</p>
<h2 id="section9">Voice usability tests with retrospective probing<a class="subhead-anchor" href="https://alistapart.com#section9">#section9</a></h2>
<p><em>Retrospective probing</em> (RP), a lesser-known approach for usability testing, is seldom seen in web usability testing due to its chief weakness: the fact that we have awful memories and rarely remember what occurred mere moments earlier with anything that approaches total accuracy. (This might explain why the backscroll has joined the pantheon of rigid recordkeeping currently occupied by cuneiform, the printing press, and other means of concretizing information.)</p>
<p>For users of voice assistants lacking scrollable chat histories, retrospective probing introduces the potential for subjects to include false recollections in their assessments or to misinterpret the conclusion of their conversations. That said, retrospective probing permits the participant to take some time to form their impressions of an interface rather than dole out incremental tidbits in a stream of consciousness, as would more likely occur in concurrent probing.</p>
<h3 id="section10">What makes voice usability tests unique<a class="subhead-anchor" href="https://alistapart.com#section10">#section10</a></h3>
<p>Voice usability tests have several unique characteristics that distinguish them from web usability tests or other conversational usability tests, but some of the same principles unify both visual interfaces and their aural counterparts. As always, “test early, test often” is a mantra that applies here, as the earlier you can begin testing, the more robust your results will be. Having an individual to administer a test and another to transcribe results or watch for signs of trouble is also an effective best practice in settings beyond just voice usability.</p>
<p>Interference from poor soundproofing or external disruptions can derail a voice usability test even before it begins. Many large organizations will have soundproof rooms or recording studios available for voice usability researchers. For the vast majority of others, a mostly silent room will suffice, though absolute silence is optimal. In addition, many subjects, even those well-versed in web usability tests, may be unaccustomed to voice usability tests in which long periods of silence are the norm to establish a baseline for data.</p>
<h3 id="section11">How we used retrospective probing to test Ask GeorgiaGov<a class="subhead-anchor" href="https://alistapart.com#section11">#section11</a></h3>
<p>For Ask GeorgiaGov, we used the retrospective probing approach almost exclusively to gather a range of insights about how our users were interacting with voice-driven content. We endeavored to evaluate interactions with the interface early and diachronically. In the process, we asked each of our subjects to complete two distinct tasks that would require them to traverse the entirety of the interface by asking questions (conducting a search), drilling down into further questions, and requesting the phone number for a related agency. Though this would be a significant ask of any user working with a visual interface, the unidirectional focus of voice interface flows, by contrast, reduced the likelihood of lengthy accidental detours.</p>
<p>Here are a couple of example scenarios:</p>
<figure id="figure2" class="quote"><blockquote>
<p>You have a business license in Georgia, but you’re not sure if you have to register on an annual basis. Talk with Alexa to find out the information you need. At the end, ask for a phone number for more information.</p>
<p>You’ve just moved to Georgia and you know you need to transfer your driver’s license, but you’re not sure what to do. Talk with Alexa to find out the information you need. At the end, ask for a phone number for more information.</p>
</blockquote>
</figure><p>We also peppered users with questions after the test concluded to learn about their impressions through retrospective probing:</p>
<ul><li>“On a scale of 1–5, based on the scenario, was the information you received helpful? Why or why not?”</li>
<li>“On a scale of 1–5, based on the scenario, was the content presented clear and easy to follow? Why or why not?”</li>
<li>“What’s the answer to the question that you were tasked with asking?”</li>
</ul><p>Because state governments also routinely deal with citizen questions having to do with potentially traumatic issues such as divorce and sexual harassment, we also offered the choice for participants to opt out of certain categories of tasks.</p>
<p>While this testing procedure yielded compelling results that indicated our voice interface was performing at the level it needed to despite its experimental nature, we also ran into considerable challenges during the usability testing process. Restoring Amazon Alexa to its initial state and troubleshooting issues on the fly proved difficult during the initial stages of the implementation, when bugs were still common.</p>
<p>In the end, we found that many of the same lessons that apply to more storied examples of usability testing were also relevant to Ask GeorgiaGov: the importance of testing early and testing often, the need for faithful yet efficient transcription, and the surprising staying power of bugs when integrating disparate technologies. Despite Ask GeorgiaGov’s many similarities to other interface implementations in terms of technical debt and the role of usability testing, we were overjoyed to hear from real Georgians whose engagement with their state government could not be more different from before.</p>
<h2 id="section12">Conclusion<a class="subhead-anchor" href="https://alistapart.com#section12">#section12</a></h2>
<p>Many of us may be building interfaces for voice content to experiment with newfangled channels, or to build for differently-abled people and people newer to the web. Now, they are necessities for many others, especially as social distancing practices continue to take hold worldwide. Nonetheless, it’s crucial to keep in mind that voice should be only one component of a channel-agnostic strategy equipped for content ripped away from its usual contexts. Building usable voice-driven content experiences can teach us a great deal about how we should envisage our milieu of content and its future in the first place.</p>
<p>Gone are the days when we could write a page in HTML and call it a day; content now needs to be rendered through synthesized speech, augmented reality overlays, digital signage, and other environments where users will never even touch a personal computer. By focusing on structured content first and foremost with an eye toward moving past our web-based biases in developing our content for voice and others, we can better ensure the effectiveness of our content on any device and in any form factor.</p>
<p>Eight months after we finished building Ask GeorgiaGov in 2017, we conducted a retrospective to inspect the logs amassed over the past year. The results were striking. Vehicle registration, driver’s licenses, and the state sales tax comprised the most commonly searched topics. 79.2% of all interactions were successful, an achievement for one of the first content-driven Alexa skills in production, and 71.2% of all interactions led to the issuance of a phone number that users could call for further information.</p>
<p>But deep in the logs we implemented for the Georgia team’s convenience, we found a number of perplexing 404 Not Found errors related to a search term that kept being recorded over and over again as “Lawson’s.” After some digging and consulting the native Georgians in the room, we discovered that one of our dear users with a particularly strong drawl was repeatedly pronouncing “license” in her native dialect to no avail.</p>
<p>As this anecdote highlights, just as no user experience can be truly perfect for everyone, voice content is an environment where imperfections can highlight considerations we missed in developing cross-channel content. And just as we have much to learn when it comes to the new shapes content can take as it jumps off the screen and out the window, it seems our voice interfaces still have a ways to go before they take over the world too.</p>
<p><em>Special thanks to</em> <a href="https://twitter.com/nikofthehill/"><em>Nikhil Deshpande</em></a> <em>for his feedback during the writing process.</em></p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">In this excerpt from Cross-Cultural Design, Senongo Akpem discusses the many facets of typography that must be considered when you are looking to reach a global audience.</div><div class="entry-content">In this excerpt from Writing is Designing, Michael J. Metts and Andy Welfle discuss the importance of writing with accessibility in mind.</div><div class="entry-content">In this excerpt from Expressive Designs Systems, Yesenia Perez-Cruz goes deep on what it takes to create design systems that enables intentional, meaningful variation.</div><div class="entry-content">To boost performance responsibly, Aaron Gustafson puts a spin on classic best practices, experiments with media caching strategies, and shares smart Cache API tricks.</div><div class="entry-content">Jeremy Wagner shows us how to get and keep third-party JavaScript under control through clean-up sprints and eternal vigilance.</div>]]></description>
      <link>https://alistapart.com/article/usability-testing-for-voice-content/</link>
      <guid>https://alistapart.com/article/usability-testing-for-voice-content/</guid>
      <pubDate>Thu, 09 Apr 2020 16:00:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Cross-Cultural Design]]></title>
      <description><![CDATA[<div class="entry-content">
<p>When I first traveled to Japan as an exchange student in 2001, I lived in northern Kyoto, a block from the Kitayama subway station.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>My first time using the train to get to my university was almost a disaster, even though it was only two subway stops away. I thought I had everything I needed to successfully make the trip. I double- and triple-checked that I had the correct change in one pocket and a computer printout of where I was supposed to go in the other. I was able to make it down into the station, but then I just stood at a ticket machine, dumbfounded, looking at all the flashing lights, buttons, and maps above my head (<strong>Fig 5.1</strong>). Everything was so impenetrable. I was overwhelmed by the architecture, the sounds, the signs, and the language.</p>
<figure id="figure1" class="wp-block-image size-large"><img src="https://alistapart.com/wp-content/uploads/2020/02/5.1-Kyoto-Subway-ticket-machines_v02.jpg?w=960" alt="Photo of two subway ticket machines with complex maps above them" class="wp-image-7172286" /><figcaption>Fig 5.1: Kyoto subway ticket machines—with many line maps and bilingual station names—can seem complicated, especially to newcomers.</figcaption></figure><p>My eyes craved something familiar—and there it was. The ticket machine had a small button that said <em>English</em>! I pushed it but became even more lost: the instructions were poorly translated, and anyway, they explained a system that I couldn’t use in the first place.</p>
<p>Guess what saved me? Two little old Japanese ladies. As they bought tickets, I casually looked over their shoulders to see how they were using the machines. First, they looked up at the map to find their desired destination. Then, they noted the fare written next to the station. Finally, they put some money into the machine, pushed the button that lit up with their correct fare, and out popped the tickets! Wow! I tried it myself after they left. And after a few tense moments, I got my ticket and headed through the gates to the train platform.</p>
<p>I pride myself on being a <em>third-culture</em> <em>kid</em>, meaning I was raised in a culture other than the country named on my passport. But even with a cultural upbringing in both Nigeria and the US, it was one of the first times I ever had to guess my way through a task with no previous reference points. And I did it!</p>
<p>Unfortunately, the same guesswork happens online a million times a day. People visit sites that offer them no cultural mental models or visual framework to fall back on, and they end up stumbling through links and pages. Effective visual systems can help eliminate that guesswork and uncertainty by creating layered sets of cues in the design and interface. Let’s look at a few core parts of these design systems and tease out how we can make them more culturally responsive and multifaceted.</p>
<h2 id="section2">Typography<a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>If you work on the web, you deal with typography all the time. This isn’t a book about typography—others have written far more eloquently and technically on the subject. What I <em>would</em> like to do, however, is examine some of the ways culture and identity influence our perception of type and what typographic choices designers can make to help create rich cross-cultural experiences.</p>
<h3 id="section3">Stereotypography<a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h3>
<p>I came across the word <em>stereotypography</em> a few years ago. Being African, I’m well aware of the way my continent is portrayed in Western media—a dirt-poor, rural monoculture with little in the way of technology, education, or urbanization. In the West, one of the most recognizable graphic markers for things African, tribal, or uncivilized (and no, they are not the same thing) is the typeface Neuland. Rob Giampietro calls it “the New Black Face,” a clever play on words. In an essay, he asks an important question:</p>
<blockquote class="wp-block-quote">
<p>How did [Neuland and Lithos] come to signify Africans and African-Americans, regardless of how a designer uses them, and regardless of the purpose for which their creators originally intended them? (<a href="http://bkaprt.com/ccd/05-01/">http://bkaprt.com/ccd/05-01/</a>)</p>
</blockquote>
<p>From its release in 1923 and continued use through the 1940s in African-American-focused advertising, Neuland has carried heavy connotations and stereotypes of cheapness, ugliness, tribalism, and roughness. You see this even today. Neuland is used in posters for movies like <em>Tarzan</em>, <em>Jurassic Park</em>, and <em>Jumanji—</em>movies that are about jungles, wildness, and scary beasts lurking in the bush, all Western symbolism for the continent of Africa. Even MyFonts’ download page for Neuland (<strong>Fig 5.2</strong>) includes tags for “Africa,” “jungle fever,” and “primitive”—tags unconnected to anything else in the product besides that racist history.</p>
<figure id="figure2" class="wp-block-image size-large"><img src="https://alistapart.com/wp-content/uploads/2020/02/5.2-myfonts-neuland.jpg?w=960" alt="" class="wp-image-7172287" /><figcaption>Fig 5.2: On MyFonts, the Neuland typeface is tagged with “Africa”, “jungle fever”, and “primitive”, perpetuating an old and irrelevant typographic stereotype (<a href="http://bkaprt.com/ccd/05-02/">http://bkaprt.com/ccd/05-02/</a>).</figcaption></figure><p>Don’t make, use, or sell fonts this way. Here are some tips on how to avoid stereotypography when defining your digital experiences:</p>
<ul><li><strong>Be immediately suspicious of any typeface that “looks like” a culture or country.</strong> For example, so-called “wonton” or “chop-suey” fonts, whose visual style is thought to express “Asianness” or to suggest Chinese calligraphy, have long appeared on food cartons, signs, campaign websites, and even Abercrombie &amp; Fitch T-shirts with racist caricatures of Asians (<a href="http://bkaprt.com/ccd/05-03/">http://bkaprt.com/ccd/05-03/</a>). Monotype’s website, where you can buy a version called Mandarin Regular (US$35), cringingly describes the typeface’s story as “an interpretation of artistically drawn Asian brush calligraphy” (<strong>Fig 5.3</strong>). Whether or not you immediately know its history, run away from any typeface that purports to represent an entire culture.</li>
</ul><figure id="figure3" class="wp-block-image size-large"><img src="https://alistapart.com/wp-content/uploads/2020/02/5.3-fonts-dot-com-mandarin-page.png?w=960" alt="A font called &quot;Mandarin&quot; with a stereotypical Asian aesthetic" class="wp-image-7172288" /><figcaption>Fig 5.3: Fonts.com sells a typeface called Mandarin Regular with the following description: “The stylized Asian atmosphere is not created only by the forms of the figures but also by the very name of the typeface. A mandarin was a high official of the ancient Chinese empire” (http://bkaprt.com/ccd/05-04/).</figcaption></figure><ul><li><strong>Support type designers who are from the culture you are designing for.</strong> This might seem like it’s a difficult task, but the internet is a big place. I have found that, for clients who are sensitive to cultural issues, the inclusion of type designers’ names and backgrounds can be a powerful differentiator, even making its way into their branding packages as a point of pride.</li>
</ul><h3 id="section4">The world wide webfont<a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h3>
<p>Another common design tool you should consider is webfonts—fonts specifically designed for use on websites and apps. One of the main selling points of webfonts is that instead of putting text in images, clients can use live text on their sites, which is better for SEO and accessibility. They are simple to implement these days, a matter of adding a line of code or checking a box on a templating engine. The easiest way to get them on your site is by using a service like Google Fonts, Fontstand, or Adobe Fonts.</p>
<p>Or is it? That assumes those services are actually available to your users.</p>
<p>Google Fonts (and every other service using Google’s Developer API) is blocked in mainland China, which means that any of those nice free fonts you chose would simply not load (<a href="http://bkaprt.com/ccd/05-05/">http://bkaprt.com/ccd/05-05/</a>). You can work around this, but it also helps to have a fallback font—that’s what they’re for.</p>
<p>When you’re building your design system, why not take a few extra steps to define some webfonts that are visible in places with content blocks? Justfont is one of the first services focused on offering a wide range of Chinese webfonts (<a href="http://bkaprt.com/ccd/05-06/">http://bkaprt.com/ccd/05-06/</a>). They have both free and paid tiers of service, similar to Western font services. After setting up an account, you can grab whatever CSS and <code>font-family</code> information you need.</p>
<h3>Multiple script systems</h3>
<p>When your design work requires more than one script—for instance, a Korean typeface and a Latin typeface—your choices get much more difficult. Designs that incorporate more than one are called multiple script systems (<em>multiscript systems</em> for short). Combining them is an interesting design challenge, one that requires extra typographic sensitivity. Luckily, your multiscript choices will rarely appear on the same page together; you will usually be choosing fonts that work across the brand, not that work well next to one another visually.</p>
<p>Let’s take a look at an example of effective multiscript use. SurveyMonkey, an online survey and questionnaire tool, has their site localized into a variety of different languages (<strong>Fig 5.4</strong>). Take note of the headers, the structure of the text in the menu and buttons, and how both fonts feel like part of the same brand.</p>
<figure id="figure4" class="wp-block-image size-large"><img src="https://alistapart.com/wp-content/uploads/2020/02/5.4-SurveyMonkey-Korean-take-a-tour-page.png?w=960" alt="A SurveyMonkey page in Korean with a simple aesthetic" class="wp-image-7172290 c1" /><img src="https://alistapart.com/wp-content/uploads/2020/02/5.4-SurveyMonkey-English-take-a-tour-page.png?w=960" alt="A SurveyMonkey page in English with a simple and similar aesthetic" class="wp-image-7172289 c2" /><figcaption>Fig 5.4: Compare the typographic choices in the Korean (<a href="http://bkaprt.com/ccd/05-07/">http://bkaprt.com/ccd/05-07/</a>) and US English (<a href="http://bkaprt.com/ccd/05-08/">http://bkaprt.com/ccd/05-08/</a>) versions of SurveyMonkey’s Take a Tour page. Do the header type and spacing retain the spirit of the brand while still accounting for typographic needs?</figcaption></figure><p>Some tips as you attempt to choose multiscript fonts for your project:</p>
<ul><li><strong>Inspect the overall weight and contrast level of the scripts.</strong> Take the time to examine how weight and contrast are used in the scripts you’re using. Find weights and sizes that give you a similar feel and give the page the right balance, regardless of the script.</li>
<li><strong>Keep an eye on awkward script features.</strong> Character x-heights, descenders, ascenders, and spacing can throw off the overall brand effect. For instance, Japanese characters are always positioned within a grid with all characters designed to fit in squares of equal height and width. Standard Japanese typefaces also contain Latin characters, called <em>romaji</em>. Those Latin characters will, by default, be kerned according to that same grid pattern, often leaving their spacing awkward and ill-formed. Take the extra time to find a typeface that doesn’t have features that are awkward to work with.</li>
<li><strong>Don’t automatically choose scripts based on superficial similarity.</strong> Initial impressions don’t always mean a typeface is the right one for your project. In an interview in the book <em>Bi-Scriptual</em>, Jeongmin Kwon, a typeface designer based in France, offers an example (<a href="http://bkaprt.com/ccd/05-09/">http://bkaprt.com/ccd/05-09/</a>). Nanum Myeongjo, a contemporary Hangul typeface, might at first glance look really similar to a seventeenth-century Latin old-style typeface—for instance, they both have angled serifs. However, Nanum Myeongjo was designed in 2008 with refined, modern strokes, whereas old-style typefaces were originally created centuries ago and echo handwritten letterforms (<a href="http://bkaprt.com/ccd/05-10/">http://bkaprt.com/ccd/05-10/</a>). Looking at the Google Fonts page for Nanum Myeongjo, though, none of that is clear (<strong>Fig 5.5</strong>). The page automatically generates a Latin <em>Nn</em> glyph in the top left of the page, instead of a more representative Hangul character sample. If I based my multiscript font choices on my initial reactions to that page, my pairings wouldn’t accurately capture the history and design of each typeface.</li>
</ul><figure id="figure5" class="wp-block-image size-large"><img src="https://alistapart.com/wp-content/uploads/2020/02/5.5-Nanum-Myeongjo-Google-Font.png?w=960" alt="A font with a large sample character in Latin text rather than a more representative Hangul character" class="wp-image-7172291" /><figcaption>Fig 5.5: The Google Fonts page for Nanum Myeongjo shows a Latin character sample in the top left, rather than a more representative character sample.</figcaption></figure><h3 id="section5">Visual density<a class="subhead-anchor" href="https://alistapart.com#section5">#section5</a></h3>
<p>CSS can help you control visual density—how much text, image, and other content there is relative to the negative space on your page. As you read on, keep cultural variables in mind: different cultures value different levels of visual density.</p>
<p>Let’s compare what are commonly called <em>CJK</em> (Chinese, Japanese, Korean) alphabets and <em>Latin</em> (English, French, Italian, etc.) alphabets. CJK alphabets have more complex characters, with shapes that are generally squarer than Latin letterforms. The glyphs also tend to be more detailed than Latin ones, resulting in a higher visual density.</p>
<p>Your instinct might be to create custom type sizes and line heights for each of your localized pages. That is a perfectly acceptable option, and if you are a typophile, it may drive you crazy <em>not</em> to do it. But I’m here to tell you that­ when adding CJK languages to a design system, you can update it to account for their visual density without ripping out a lot of your original CSS:</p>
<ol><li>Choose a font size that is slightly larger for CJK characters, because of their density.</li>
<li>Choose a line height that gives you ample vertical space between each line of text (referred to as <code>line-height</code> in CSS).</li>
<li>Look at your Latin text in the same sizes and see if it still works.</li>
<li>Tweak them together to find a size that works well with both scripts.</li>
</ol><p>The 2017 site for Typojanchi, the Korean Typography Biennale, follows this methodology (<strong>Fig 5.6</strong>). Both the English and Korean texts have a <code>font-size</code> of <code>1.25em</code>, and a <code>line-height</code> of <code>1.5</code>. The result? The English text takes up more space vertically, and the block of Korean text is visually denser, but both are readable and sit comfortably within the overall page design. It is useful to compare translated websites like this to see how CSS styling can be standardized across Latin and CJK pages.</p>
<figure id="figure6" class="wp-block-image size-large"><img src="https://alistapart.com/wp-content/uploads/2020/02/5.6-Typojanchi-English-page.png?w=960" alt="A basic layout with English text" class="wp-image-7172296 c1" data-recalc-dims="1" /><img src="https://alistapart.com/wp-content/uploads/2020/02/5.6-Typojanchi-Korean-page.png?w=960" alt="A basic layout with Korean text" class="wp-image-7172297 c2" data-recalc-dims="1" /><figcaption>Fig 5.6: The 2017 site for Typojanchi, the Korean Typography Biennale, shows differing visual density in action. It is useful to compare translated websites like this to see how CSS styling can be standardized across Latin and CJK pages (http://bkaprt.com/ccd/05-11/).</figcaption></figure><h3 id="section6">Text expansion factors<a class="subhead-anchor" href="https://alistapart.com#section6">#section6</a></h3>
<p>Expansion factors calculate how long strings of text will be in different languages. They use either a decimal (1.8) or a percentage (180%) to calculate the length of a text string in English versus a different language. Of course, letter-spacing depends on the actual word or phrase, but think of them as a very rough way to anticipate space for text when it gets translated.</p>
<p>Using expansion factors is best when planning for microcopy, calls to action, and menus, rather than long-form content like articles or blog posts that can freely expand down the page. The Salesforce Lightning Design System offers a detailed expansion-factor table to help designers roughly calculate space requirements for other languages in a UI (<strong>Fig 5.7</strong>).</p>
<figure id="figure7" class="wp-block-image size-large"><img src="https://alistapart.com/wp-content/uploads/2020/02/5.7-expansion-factor-table.png?w=960" alt="A chart showing how a different piece of content lays out in different languages" class="wp-image-7172292" data-recalc-dims="1" /><figcaption>Fig 5.7: This expansion-factor table from Salesforce lets designers and developers estimate the amount of text that will exist in different languages. Though dependent on the actual words, such calculations can give you a benchmark to design with content in mind (<a href="http://bkaprt.com/ccd/05-12/">http://bkaprt.com/ccd/05-12/</a>).</figcaption></figure><p>But wait! Like everything in cross-cultural design, nothing is ever that simple. Japanese, for example, has three scripts: <em>Kanji</em>, for characters of Chinese origin, <em>hiragana</em>, for words and sounds that are not represented in <em>kanji</em>, and <em>katakana</em>, for words borrowed from other languages.</p>
<p>The follow button is a core part of the Twitter experience. It has six characters in English (“Follow”) and four in Japanese (<a>フォロー</a>), but the Japanese version is twenty percent longer because it is in katakana, and those characters take up more space than kanji (<strong>Fig 5.8</strong>). Expansion tables can struggle to accommodate the complex diversity of human scripts and languages, so don’t look to them as a one-stop or infallible solution.</p>
<figure id="figure8" class="wp-block-image size-large"><img src="https://alistapart.com/wp-content/uploads/2020/02/5.8-Twitter-Follow-Button-in-Japanese.png?w=960" alt="The Twitter UI in Japanese" class="wp-image-7172294" /><img src="https://alistapart.com/wp-content/uploads/2020/02/5.8-Twitter-Follow-Button-in-English.png?w=960" alt="The Twitter UI in English" class="wp-image-7172293" /><figcaption>Fig 5.8: On Twitter, expansion is clearly visible: the English “Follow” button text comes in at about 47 pixels wide, while the Japanese text comes in at 60 pixels wide.</figcaption></figure><p>Here are a few things you can do keep expansion factors in mind as you design:</p>
<ul><li><strong>Generate dummy text in different languages for your design comps.</strong> Of course, you should make sure your text doesn’t contain any unintentional swearwords or improper language, but tools like Foreign Ipsum area good place to start getting your head around expansion factors (<a href="http://bkaprt.com/ccd/05-13/">http://bkaprt.com/ccd/05-13/</a>).</li>
<li><strong>Leave extra space around buttons, menu items, and other microcopy.</strong> As well as being general good practice in responsive design, this allows you to account for how text in your target languages expands.</li>
<li><strong>Make sure your components are expandable.</strong> Stay away from assigning a fixed width to your UI elements unless it’s unavoidable.</li>
<li><strong>Let longer text strings wrap to a second line.</strong> Just ensure that text is aligned correctly and is easy to scan.</li>
</ul><div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">In this excerpt from Writing is Designing, Michael J. Metts and Andy Welfle discuss the importance of writing with accessibility in mind.</div><div class="entry-content">In this excerpt from Expressive Designs Systems, Yesenia Perez-Cruz goes deep on what it takes to create design systems that enables intentional, meaningful variation.</div><div class="entry-content">To boost performance responsibly, Aaron Gustafson puts a spin on classic best practices, experiments with media caching strategies, and shares smart Cache API tricks.</div><div class="entry-content">Jeremy Wagner shows us how to get and keep third-party JavaScript under control through clean-up sprints and eternal vigilance.</div><div class="entry-content">Learn the three storytelling pillars of vulnerable and transparent content to forge deeper connections with your users.</div>]]></description>
      <link>https://alistapart.com/article/cross-cultural-design/</link>
      <guid>https://alistapart.com/article/cross-cultural-design/</guid>
      <pubDate>Thu, 27 Feb 2020 16:30:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[Standards for Writing Accessibly]]></title>
      <description><![CDATA[<div class="entry-content">
<p>Writing to meet WCAG2 standards can be a challenge, but it’s worthwhile. Albert Einstein, the archetypical genius and physicist, once said, “Any fool can make things bigger, more complex, and more violent. It takes a touch of genius—and a lot of courage—to move in the opposite direction.”</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>Hopefully, this entire book will help you better write for accessibility. So far, you’ve learned:</p>
<ul><li>Why clarity is important</li>
<li>How to structure messages for error states and stress cases</li>
<li>How to test the effectiveness of the words you write</li>
</ul><p>All that should help your writing be better for screen readers, give additional context to users who may need it, and be easier to parse.</p>
<p>But there are a few specific points that you may not otherwise think about, even after reading these pages.</p>
<h2 id="section2">Writing for Screen Readers<a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>People with little or no sight interact with apps and websites in a much different way than sighted people do. Screen readers parse the elements on the screen (to the best of their abilities) and read it back to the user. And along the way, there are many ways this could go wrong. As the interface writer, your role is perhaps most important in giving screen reader users the best context.</p>
<p>Here are a few things to keep in mind about screen readers:</p>
<ul><li>The average reading time for sighted readers is two to five words per second. Screen-reader users can comprehend text being read at an average of 35 syllables per second, which is significantly faster. Don’t be afraid to sacrifice brevity for clarity, especially when extra context is needed or useful.</li>
<li>People want to be able to skim long blocks of text, regardless of sight or audio, so it’s extremely important to structure your longform writing with headers, short paragraphs, and other content design best practices.</li>
</ul><h2 id="section3">Write Chronologically, Not Spatially <a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h2>
<p>Writing chronologically is about describing the order of things, rather than where they appear spatially in the interface. There are so many good reasons to do this (devices and browsers will render interfaces differently), but screen readers show you the most valuable reason. You’ll often be faced with writing tooltips or onboarding elements that say something like, “Click the OK button below to continue.” Or “See the instructions above to save your document.”</p>
<p>Screen readers will do their job and read those instructions aloud to someone who can’t see the spatial relationships between words and objects. While many times, they can cope with that, they shouldn’t have to. Consider screen reader users in your language. Embrace the universal experience shared by humans and rely on their intrinsic understanding of the <em>top is first, bottom is last</em> paradigm. Write chronologically, as in Figure 5.5.</p>
<figure id="figure1" class="wp-block-image size-large"><img src="https://alistapart.com/wp-content/uploads/2020/01/fig1.jpg?w=960" alt="" class="wp-image-7172224" data-recalc-dims="1" /><figcaption>FIGURE 5.5 Password hint microcopy below the password field won’t help someone using a screen reader who hasn’t made it there yet.</figcaption></figure><p>Rather than saying:</p>
<ul><li>Click the OK button below to continue.</li>
<li>(A button that scrolls you to the top of a page): Go to top.</li>
</ul><p>Instead, say:</p>
<ul><li>Next, select OK to continue.</li>
<li>Go to beginning.</li>
</ul><h2 id="section4">Write Left to Right, Top to Bottom<a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h2>
<p>While you don’t want to convey spatial meaning in your writing, you still want to keep that spatial order in mind.</p>
<p>Have you ever purchased a service or a product, only to find out later that there were conditions you didn’t know about before you paid for it? Maybe you didn’t realize batteries weren’t included in that gadget, or that signing up for that social network, you were implicitly agreeing to provide data to third-party advertisers.</p>
<p>People who use screen readers face this all the time.</p>
<p>Most screen readers will parse information from left to write, from top to bottom.<sup>1</sup> Think about a few things when reviewing the order and placement of your words. Is there information critical to performing an action, or making a decision, that appears after (to the right or below) an action item, like in Figure 5.5? If so, consider moving it up in the interface.</p>
<p>Instead, if there’s information critical to an action (rules around setting a password, for example, or accepting terms of service before proceeding), place it <em>before</em> the text field or action button. Even if it’s hidden in a tooltip or info button, it should be presented before a user arrives at a decision point.</p>
<h2 id="section5">Don’t Use Colors and Icons Alone <a class="subhead-anchor" href="https://alistapart.com#section5">#section5</a></h2>
<p>If you are a sighted American user of digital products, there’s a pretty good chance that if you see a message in red, you’ll interpret it as a warning message or think something’s wrong. And if you see a message in green, you’ll likely associate that with success. But while colors aid in conveying meaning to this type of user, they don’t necessarily mean the same thing to those from other cultures.</p>
<p>For example, although red might indicate excitement, or danger in the U.S. (broadly speaking), in other cultures it means something entirely different:</p>
<ul><li>In China, it represents good luck.</li>
<li>In some former-Soviet, eastern European countries it’s the color strongly associated with Communism.</li>
<li>In India, it represents purity.</li>
</ul><p>Yellow, which we in the U.S. often use to mean “caution” (because we’re borrowing a mental model from traffic lights), might convey another meaning for people in other cultures:</p>
<ul><li>In Latin America, yellow is associated with death.</li>
<li>In Eastern and Asian cultures, it’s a royal color—sacred and often imperial.</li>
</ul><p>And what about users with color-blindness or low to no vision? And what about screen readers? Intrinsic meaning from the interface color means nothing for them. Be sure to add words that bear context so that if you heard the message being read aloud, you would understand what was being said, as in Figure 5.6.</p>
<figure id="figure2" class="wp-block-image size-large"><img src="https://alistapart.com/wp-content/uploads/2020/01/fig2.jpg?w=960" alt="" class="wp-image-7172225" /><figcaption>FIGURE 5.6 While a simple in-app message warning a user to save their work before proceeding is more effective, visually, if it is red and has a warning icon, as seen on the left, you should provide more context when possible. The example on the right explicitly says that a user won’t be able to proceed to the next step before saving their work.</figcaption></figure><h2 id="section6">Describe the Action, Not the Behavior<a class="subhead-anchor" href="https://alistapart.com#section6">#section6</a></h2>
<p>Touch-first interfaces have been steadily growing and replacing keyboard/mouse interfaces for years, so no longer are users “clicking” a link or a button. But they’re not necessarily “tapping” it either, especially if they’re using a voice interface or an adaptive device.</p>
<p>Instead of microcopy that includes behavioral actions like:</p>
<ul><li>Click</li>
<li>Tap</li>
<li>Press</li>
<li>See</li>
</ul><p>Try device-agnostic words that describe the action, irrespective of the interface, like:</p>
<ul><li>Choose</li>
<li>Select</li>
<li>View</li>
</ul><p>There are plenty of exceptions to this rule. If your interface requires a certain action to execute a particular function, and you need to teach the user how their gesture affects the interface (“Pinch to zoom out,” for example), then of course you need to describe the behavior. But generally, the copy you’re writing will be simpler and more consistent if you stick with the action in the context of the interface itself.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">In this excerpt from Expressive Designs Systems, Yesenia Perez-Cruz goes deep on what it takes to create design systems that enables intentional, meaningful variation.</div><div class="entry-content">To boost performance responsibly, Aaron Gustafson puts a spin on classic best practices, experiments with media caching strategies, and shares smart Cache API tricks.</div><div class="entry-content">Jeremy Wagner shows us how to get and keep third-party JavaScript under control through clean-up sprints and eternal vigilance.</div><div class="entry-content">Learn the three storytelling pillars of vulnerable and transparent content to forge deeper connections with your users.</div><div class="entry-content">Even if you’re not looking for a job, Jessica Ivins shares a great way to jump start your résumé and portfolio right now.</div>]]></description>
      <link>https://alistapart.com/article/standards-for-writing-accessibly/</link>
      <guid>https://alistapart.com/article/standards-for-writing-accessibly/</guid>
      <pubDate>Thu, 23 Jan 2020 16:20:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[Making Room for Variation]]></title>
      <description><![CDATA[<div class="entry-content">
<p>Making a brand feel unified, cohesive, and harmonious while also leaving room for experimentation is a tough balancing act. It’s one of the most challenging aspects of a design system.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>Graphic designer and Pentagram partner Paula Scher faced this challenge with the visual identity for the Public Theater in New York. As she explained in a talk at Beyond Tellerrand:</p>
<figure id="figure1" class="quote"><blockquote>
<p>I began to realize that if you made everything the same, it was boring after the first year. If you changed it individually for each play, the theater lost recognizability. The thing to do, which I totally got for the first time after working there at this point for 17 years, is what they needed to have were seasons.</p>
<p>You could take the typography and the color system for the summer festival, the Shakespeare in the Park Festival, and you could begin to translate it into posters by flopping the colors, but using some of the same motifs, and you could create entire seasons out of the graphics. That would become its own standards manual where I have about six different people making these all year (<a href="http://bkaprt.com/eds/04-01/">http://bkaprt.com/eds/04-01/</a>).</p>
</blockquote>
</figure><p>Scher’s strategy was to retain the Public Theater’s visual language every year, but to vary some of its elements (<strong>Fig 4.1–2</strong>). Colors would be swapped. Text would skew in different directions. New visual motifs would be introduced. The result is that each season coheres in its own way, but so does the identity of the Public Theater as a whole.</p>
<figure id="figure2" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/12/4.1-Public-Theater-2014.png?w=960" alt="Sixteen Public Theater posters in black, white, and yellow, with slanted wood type letterforms and high-contrast images of people." class="wp-image-7172171" /><figcaption><strong>Fig 4.1</strong>: The posters for the 2014/15 season featured the wood type style the Public Theater is known for, but the typography was skewed. The color palette was restrained to yellow, black, and white, which led to a dynamic look when coupled with the skewed type (http://bkaprt.com/eds/04-02/).</figcaption></figure><figure id="figure3" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/12/4.2-Public-Theater-2018.png?w=960" alt="Twelve Public Theater posters using black, white, and pastel colors with wood type letterforms and softer images of people." class="wp-image-7172172" /><figcaption><strong>Fig 4.2</strong>: For the 2018 season, the wood type letterforms were extended on a field of gradated color. The grayscale cut-out photos we saw in the 2014/15 season persisted, but this time in lower contrast to fit better with the softer color tones (http://bkaprt.com/eds/04-03/).</figcaption></figure><p>Even the most robust or thoroughly planned systems will need to account for variation at some point. As soon as you release a design system, people will ask you how to deviate from it, and you’ll want to be armed with persuasive answers. In this chapter, I’m going to talk about what variation means for a design system, how to know when you need it, and how to manage it in a scalable way.</p>
<h2 id="section2">What Is Variation?<a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>We’ve spent most of this book talking about the importance of unity, cohesion, and harmony in a design system. So why are we talking about variation? Isn’t that at odds with all of the goals we’ve set until now?</p>
<p>Variation is a deviation from established patterns, and it can exist at every level of the system. At the component level, for instance, a team may discover that they need a component to behave in a slightly different way; maybe this particular component needs to appear without a photo, for example. At a design-language level, you may have a team that has a different audience, so they want to adjust their brand identity to serve that audience better. You can even have variation at the level of design principles: if a team is working on a product that is functionally different from your core product, they may need to adjust their principles to suit that context.</p>
<p>There are three kinds of deviations that come up in a design system:</p>
<ul><li><strong>Unintentional divergence</strong> typically happens when designers can’t find the information they’re looking for. They may not know that a certain solution exists within a system, so they create their own style. Clear, easy-to-find documentation and usage guidelines can help your team avoid unintentional variation.</li>
<li><strong>Intentional but unnecessary divergence</strong> usually results from designers not wanting to feel constrained by the system, or believing they have a better solution. Making sure your team knows how to push back on and contribute to the system can help mitigate this kind of variation.</li>
<li><strong>Intentional, meaningful divergence</strong> is the goal of an expressive design system. In this case, the divergence is meaningful because it solves a very specific user problem that no existing pattern solves.</li>
</ul><p>We want to enable intentional, meaningful variation. To do this, we need to understand the needs and contexts for variation.</p>
<h2 id="section3">Contexts for Variation <a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h2>
<p>Every variation we add makes our design system more complicated. Therefore, we need to take care to find the right moments for variation. Three big contextual changes are served by variation: brand, audience, and environment.</p>
<h3 id="section4">Brand<a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h3>
<p>If you’re creating a system for multiple brands, each with its own brand language, then your system needs to support variations to reflect those brands.</p>
<p>The key here is to find the common core elements and then set some criteria for how you should deviate. When we were creating the design system for our websites at Vox Media, we constantly debated which elements should feel more expressive. Should a footer be standardized, or should we allow for tons of customization? We went back to our core goals: our users were ultimately visiting our websites to consume editorial content. So the variations should be in service of the content, writing style, and tone of voice for each brand.</p>
<p>The newsletter modules across Vox Media brands were an example of unnecessary variation. They were consistent in functionality and layout, but had variations in type, color, and visual treatments like borders (<strong>Fig 4.3</strong>). There was quite a bit of custom design within a very small area: Curbed’s newsletter component had a skewed background, for example, while Eater’s had a background image. Because these modules were so consistent in their user goals, we decided to unify their design and create less variation (<strong>Fig 4.4</strong>).</p>
<figure id="figure4" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/12/4.3a-Curbed-Old-Newsletter.png?w=960" alt="" class="wp-image-7172173 c1" data-recalc-dims="1" /><img src="https://alistapart.com/wp-content/uploads/2019/12/4.3b-Vox-Old-Newsletter-.png?w=960" alt="" class="wp-image-7172174 c2" data-recalc-dims="1" /><img src="https://alistapart.com/wp-content/uploads/2019/12/4.3c-Eater-Old-Newsletter.png?w=960" alt="" class="wp-image-7172175 c2" data-recalc-dims="1" /><figcaption class="c3"><strong>Fig 4.3</strong>: Older versions of Vox Media’s newsletter modules contained lots of unnecessary visual variation.</figcaption></figure><figure id="figure5" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/12/4.4-Curbed-New-Newsletter.png?w=960" alt="Three examples of newsletter modules, showing the same colors, fonts, and spacing." class="wp-image-7172176" /><figcaption>Fig 4.4: The new, unified newsletter modules.</figcaption></figure><p>The unified design cleaned up some technical debt. In the previous design, each newsletter module had CSS overrides to achieve distinct styling. Some modules even had overrides on the primary button color so it would work better with the background color. Little CSS overrides like this add up over time. Whenever we released a new change, we’d have to manually update the spots containing CSS overrides.</p>
<p>The streamlined design also placed a more appropriate emphasis on the newsletter module. While important, this module isn’t the star of the page. It doesn’t need loud backgrounds or fancy shapes to command attention, especially since it’s placed around article content. Variation in this module wasn’t necessary for expressing the brands.</p>
<p>On the other hand, consider the variation in Vox Media’s global header components. When we were redesigning the <cite>Verge</cite>, its editorial teams were vocal about wanting more latitude to art-direct the page, guide attention toward big features, and showcase custom illustrations. We addressed this by creating a masthead component (<strong>Fig 4.5</strong>) that sits on top of the global header on homepages. It contains a logo, tagline, date, and customizable background image. Though at the time this was a one-off component, we felt that the variation was valuable because it would strengthen the <cite>Verge</cite>’s brand voice.</p>
<figure id="figure6" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/12/4.5a-Verge-Masthead-Pink.jpeg?w=960" alt="Example of the Verge’s masthead component with magenta and blue abstractions." class="wp-image-7172177" /><img src="https://alistapart.com/wp-content/uploads/2019/12/4.5b-Verge-Masthead-Orange-City.jpeg?w=960" alt="Example of the Verge’s masthead component with a city skyline in orange tones." class="wp-image-7172178" /><img src="https://alistapart.com/wp-content/uploads/2019/12/4.5c-Verge-Masthead-BlackWhite.png?w=960" alt="Example of the Verge’s masthead component in pixelated black and white." class="wp-image-7172179" /><figcaption><strong>Fig 4.5:</strong> Examples of the <cite>Verge</cite>‘s masthead component</figcaption></figure><p>The <cite>Verge</cite> team commissions or makes original art that changes throughout the day. The most exciting part is that they can use the masthead and a one-up hero when they drop a big feature and use these flexible components to art-direct the page (<strong>Fig 4.6</strong>). Soon after launch, the <cite>Verge</cite> masthead even got a Twitter fan account (@VergeTaglines) that tweets every time the image changes.</p>
<figure id="figure7" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/12/4.6b-Verge-Homepage-Feature-Yellow.png?w=960" alt="Comparison of the Verge’s homepage, changing based on the masthead design and hero photography." class="wp-image-7172181 c4" data-recalc-dims="1" /><img src="https://alistapart.com/wp-content/uploads/2019/12/4.6a-Verge-Homepage-Feature-Black.png?w=960" alt="Comparison of the Verge’s homepage, changing based on the masthead design and hero photography." class="wp-image-7172180 c4" data-recalc-dims="1" /><figcaption class="c3"><strong>Fig 4.6:</strong> The <cite>Verge</cite> uses two generic components, the masthead and one-up hero, to art-direct its homepages.</figcaption></figure><p>Though this component was built specifically for the <cite>Verge</cite>, it soon gained broader application with other brands that share Vox’s publishing platform, Chorus. The McElroy Family website, for example, needed to convey its sense of humor and Appalachian roots; the masthead component shines with an original illustration featuring an adorable squirrel (<strong>Fig 4.7</strong>).</p>
<figure id="figure8" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/12/4.7-McElroy-Masthead.png?w=960" alt="The masthead component for the McElroy Family, showing a blue navigation bar and a pastel illustration of a forest." class="wp-image-7172182" /><figcaption><strong>Fig 4.7:</strong> The McElroy Family site uses the same masthead component as the <em>Verge</em> to display a custom illustration.</figcaption></figure><figure id="figure9" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/12/4.8-Chicago-Sun-Times-Masthead.png?w=960" alt="The masthead component for the Chicago Sun-Times, showing a white background, stark black text, and a red Subscribe button." class="wp-image-7172183" /><figcaption><strong>Fig 4.8:</strong> The same masthead component on the <em>Chicago Sun-Times</em> site.</figcaption></figure><p>The <cite>Chicago Sun-Times</cite>—another Chorus platform site—is very different in content, tone, and audience from The McElroy Family, but the masthead component is just as valuable in conveying the tone of the organization’s high-quality investigative journalism and breaking news coverage (<strong>Fig 4.8</strong>).</p>
<p>Why did the masthead variation work well while the newsletter variation didn’t? The variations on the newsletter design were purely visual. When we created them, we didn’t have a strategy for how variation should work; instead, we were looking for any opportunity to make the brands feel distinct. The masthead variation, by contrast, tied directly into the brand strategy. Even though it began as a one-off for the <cite>Verge</cite>, it was flexible and purposeful enough to migrate to other brands.</p>
<h3 id="section5">Audience<a class="subhead-anchor" href="https://alistapart.com#section5">#section5</a></h3>
<p>The next contextual variation comes from audience. If your products serve different audiences who all need different things, then your system may need to adapt to fit those needs.</p>
<p>A good example of this is Airbnb’s listing pages. In addition to their standard listings, they also have Airbnb Plus—one-of-a-kind, high quality rentals at higher price points. Audiences booking a Plus listing are probably looking for exceptional quality and attention to detail.</p>
<p>Both Airbnb’s standard listing page and Plus listing page are immediately recognizable as belonging to the same family because they use many consistent elements (<strong>Fig 4.9</strong>). They both use Airbnb’s custom font, Cereal. They both highlight photography. They both use many of the same components, like the date picker. The iconography is the same.</p>
<figure id="figure10" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/12/4.10-Airbnb-Standard-Listing.png?w=960" alt="Screenshot of AirBnB's standard listing" class="wp-image-7172185 c5" /><img src="https://alistapart.com/wp-content/uploads/2019/12/4.9-Airbnb-Plus-Listing.png?w=960" alt="Screenshot of AirBnB's Plus listing" class="wp-image-7172184 c5" /><figcaption><strong>Fig 4.9:</strong> The same brand elements in Airbnb’s standard listings (above) are used in their Plus listings (below), but with variations that make the listing styles distinct.</figcaption></figure><p>However, some of the design choices convey a different attitude. Airbnb Plus uses larger typography, airier vertical space, and a lighter weight of Cereal. It has a more understated color palette, with a deeper color on the call to action. These choices make Airbnb Plus feel like a more premium experience. You can see they’ve adjusted the density, weight, and scale levers to achieve a more elegant and sophisticated aesthetic.</p>
<p>The standard listing page, on the other hand, is more functional, with the booking module front and center. The Plus design pulls the density and weight levers in a lighter, airier direction. The standard listing page has less size contrast between elements, making it feel more functional.</p>
<p>Because they use the same core building blocks—the same typography, iconography, and components—both experiences feel like Airbnb. However, the variations in spacing, typographic weights, and color help distinguish the standard listing from the premium listing.</p>
<h3 id="section6">Environment<a class="subhead-anchor" href="https://alistapart.com#section6">#section6</a></h3>
<p>I’ve mainly been talking about adding variation to a system to allow for a range of content tones, but you may also need your system to scale based on environmental contexts. “Environment” in this context asks: Where will your products be used? Will that have an impact on the experience? Environments are the various constraints and pressures that surround and inform an experience. That can include lighting, ambient noise, passive or active engagement, expected focus level, or devices.</p>
<p>Shopify’s Polaris design system initially grew out of Shopify’s Store Management product. When the Shopify Retail team kicked off a project to design the next generation <em>point-of-sale</em> (POS) system, they realized that the patterns in Polaris didn’t exactly fit their needs. The POS system needed to work well in a retail space, often under bright lighting. The app needed to be used at arm’s length, twenty-four to thirty-six inches away from the merchant. And unlike the core admin, where the primary interaction is between the merchant and the UI, merchants using the POS system needed to prioritize their interactions with their customers instead of the UI. The Retail team wanted merchants to achieve an “eyes-closed” level of mastery over the UI so they could maintain eye contact with their customers.</p>
<p>The Retail team decided that the existing color palette, which only worked on a light background, would not be clear enough under the bright lights of a retail shop. The type scale was also too small to be used at arm’s length. And in order for merchants to use the POS system without breaking eye contact with customers, the buttons and other UI elements would need to be much larger.</p>
<p>The Retail team recognized that the current design system didn’t support a variety of environmental scenarios. But after talking with the Polaris team, they realized that other teams would benefit from the solutions they created. The Warehouse team, for example, was also developing an app that needed to be used at arm’s length under bright lights. This work inspired the Polaris team to create a dark mode for the system (<strong>Fig 4.10</strong>).</p>
<figure id="figure11" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/12/making-room-for-variation-fig10.png?w=960" alt="Comparison of light and dark modes for navigation menus in the Polaris design system." class="wp-image-7172188" /><figcaption><strong>Fig 4.10:</strong> Polaris light mode (left) and dark mode (right).</figcaption></figure><p>This feedback loop between product team and design system team is a great example of how to build the right variation into your system. Build your system around helping your users navigate your product more clearly and serving content needs and you’ll unlock scalable expression.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">To boost performance responsibly, Aaron Gustafson puts a spin on classic best practices, experiments with media caching strategies, and shares smart Cache API tricks.</div><div class="entry-content">Jeremy Wagner shows us how to get and keep third-party JavaScript under control through clean-up sprints and eternal vigilance.</div><div class="entry-content">Learn the three storytelling pillars of vulnerable and transparent content to forge deeper connections with your users.</div><div class="entry-content">Even if you’re not looking for a job, Jessica Ivins shares a great way to jump start your résumé and portfolio right now.</div><div class="entry-content">The tech world has a major diversity problem. accessible developers may be an unexpected part of the solution.</div>]]></description>
      <link>https://alistapart.com/article/making-room-for-variation/</link>
      <guid>https://alistapart.com/article/making-room-for-variation/</guid>
      <pubDate>Thu, 12 Dec 2019 15:30:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[Request with Intent: Caching Strategies in the Age of PWAs]]></title>
      <description><![CDATA[<div class="entry-content">
<p>Once upon a time, we relied on browsers to handle caching for us; as developers in those days, we had very little control. But then came <a href="https://alistapart.com/article/yes-that-web-project-should-be-a-pwa/">Progressive Web Apps</a> (PWAs), <a href="https://developer.mozilla.org/docs/Web/API/Service_Worker_API">Service Workers</a>, and the <a href="https://developer.mozilla.org/docs/Web/API/Cache">Cache API</a>—and suddenly we have expansive power over what gets put in the cache and how it gets put there. We can now cache everything we want to… and therein lies a potential problem.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>Media files—especially images—make up <a href="https://httparchive.org/reports/page-weight">the bulk of average page weight</a> these days, and <a href="https://httparchive.org/reports/page-weight#bytesImg">it’s getting worse</a>. In order to improve performance, it’s tempting to cache as much of this content as possible, but should we? In most cases, no. Even with all this newfangled technology at our fingertips, great performance still hinges on a simple rule: <a href="https://alistapart.com/article/the-best-request-is-no-request-revisited">request only what you need and make each request as small as possible</a>.</p>
<p>To provide the best possible experience for our users without abusing their network connection or their hard drive, it’s time to put a spin on some classic best practices, experiment with media caching strategies, and play around with a few Cache API tricks that Service Workers have hidden up their sleeves.</p>
<h2 id="section2">Best intentions<a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>All those lessons we learned optimizing web pages for dial-up became super-useful again when mobile took off, and they continue to be applicable in the work we do for a global audience today. Unreliable or high latency network connections are still the norm in many parts of the world, reminding us that it’s never safe to assume a technical baseline lifts evenly or in sync with its corresponding cutting edge. And that’s the thing about performance best practices: history has borne out that approaches that are good for performance now will continue being good for performance in the future.</p>
<p>Before the advent of Service Workers, we could provide <a href="https://developer.yahoo.com/performance/rules.html#expires">some instructions to browsers</a> with respect to how long they should cache a particular resource, but that was about it. Documents and assets downloaded to a user’s machine would be dropped into a directory on their hard drive. When the browser assembled a request for a particular document or asset, it would peek in the cache first to see if it already had what it needed to possibly avoid hitting the network.</p>
<p>We have considerably more control over network requests and the cache these days, but that doesn’t excuse us from being thoughtful about the resources on our web pages.</p>
<h3 id="section3">Request only what you need<a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h3>
<p>As I mentioned, the web today is lousy with media. Images and videos have become a dominant means of communication. They may convert well when it comes to sales and marketing, but they are hardly performant when it comes to download and rendering speed. With this in mind, each and every image (and video, etc.) should have to fight for its place on the page. </p>
<p>A few years back, a recipe of mine was included in a newspaper story on cooking with spirits (alcohol, not ghosts). I don’t subscribe to the print version of that paper, so when the article came out I went to the site to take a look at how it turned out. During a recent redesign, the site had decided to load all articles into a nearly full-screen modal viewbox layered on top of their homepage. This meant requesting the article required requests for all of the assets associated with the article page <em>plus</em> all the contents and assets for the homepage. Oh, and the homepage had video ads—plural. And, yes, they auto-played.</p>
<p>I popped open DevTools and discovered the page had blown past 15 MB in page weight. Tim Kadlec had recently launched <a href="https://whatdoesmysitecost.com/">What Does My Site Cost?</a>, so I decided to check out the damage. Turns out that the actual cost to view that page for the average US-based user was more than the cost of the print version of that day’s newspaper. That’s just messed up.</p>
<p>Sure, I could blame the folks who built the site for doing their readers such a disservice, but the reality is that none of us go to work with the goal of worsening our users’ experiences. This could happen to any of us. We could spend days scrutinizing the performance of a page only to have some committee decide to set that carefully crafted page atop a Times Square of auto-playing video ads. Imagine how much worse things would be if we were stacking two abysmally-performing pages on top of each other!</p>
<p>Media can be great for drawing attention when competition is high (e.g., on the homepage of a newspaper), but when you want readers to focus on a single task (e.g., reading the actual article), its value can drop from important to “nice to have.” Yes, studies have shown that images excel at drawing eyeballs, but once a visitor is on the article page, <a href="https://theoutline.com/post/2485/not-every-article-needs-a-picture">no one cares</a>; we’re just making it take longer to download and more expensive to access. The situation only gets worse as we shove more media into the page. </p>
<p>We must do everything in our power to reduce the weight of our pages, so avoid requests for things that don’t add value. For starters, if you’re writing an article about a data breach, resist the urge to include <a href="https://www.istockphoto.com/jp/en/photo/hacker-attacking-internet-gm540848970-96658127">that ridiculous stock photo</a> of some random dude in a hoodie typing on a computer in a very dark room.</p>
<h3 id="section4">Request the smallest file you can<a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h3>
<p>Now that we’ve taken stock of what we <em>do</em> need to include, we must ask ourselves a critical question: How can we deliver it in the fastest way possible? This can be as simple as <a href="https://vimeo.com/290141511">choosing the most appropriate image format</a> for the content presented (and optimizing the heck out of it) or as complex as recreating assets entirely (for example, if switching from raster to vector imagery would be more efficient).</p>
<h4 id="section5">Offer alternate formats<a class="subhead-anchor" href="https://alistapart.com#section5">#section5</a></h4>
<p>When it comes to image formats, we don’t have to choose between performance and reach anymore. We can provide multiple options and let <em>the browser</em> decide which one to use, based on what it can handle.</p>
<p>You can accomplish this by offering multiple <code>sources</code> within a <code>picture</code> or <code>video</code> element. Start by creating multiple formats of the media asset. For example, with WebP and JPG, it’s likely that the WebP will have a smaller file size than the JPG (but check to make sure). With those alternate sources, you can drop them into a <code>picture</code> like this:</p>
<figure id="figure1"><pre id="snippet1"><code class="language-markup">&lt;picture&gt;
  &lt;source srcset="my.webp" type="image/webp"&gt;
  &lt;img src="my.jpg" alt="Descriptive text about the picture."&gt;
&lt;/picture&gt;</code></pre></figure><p>Browsers that recognize the <code>picture</code> element will check the <code>source</code> element before making a decision about which image to request. If the browser supports the MIME type “image/webp,” it will kick off a request for the WebP format image. If not (or if the browser doesn’t recognize <code>picture</code>), it will request the JPG. </p>
<p>The nice thing about this approach is that you’re serving the smallest image possible to the user without having to resort to any sort of JavaScript hackery.</p>
<p>You can take the same approach with video files:</p>
<figure id="figure2"><pre id="snippet2"><code class="language-markup">&lt;video controls&gt;
  &lt;source src="my.webm" type="video/webm"&gt;
  &lt;source src="my.mp4" type="video/mp4"&gt;
  &lt;p&gt;Your browser doesn’t support native video playback,
    but you can &lt;a href="my.mp4" download&gt;download&lt;/a&gt;
    this video instead.&lt;/p&gt;
&lt;/video&gt;</code></pre></figure><p>Browsers that support WebM will request the first <code>source</code>, whereas browsers that don’t—but do understand MP4 videos—will request the second one. Browsers that don’t support the <code>video</code> element will fall back to the paragraph about downloading the file.</p>
<p>The order of your <code>source</code> elements matters. <a href="https://html.spec.whatwg.org/multipage/media.html#concept-media-load-algorithm">Browsers will choose the first <em>usable</em> <code>source</code></a>, so if you specify an optimized alternative format <em>after</em> a more widely compatible one, the alternative format may never get picked up.  </p>
<p>Depending on your situation, you might consider bypassing this markup-based approach and handle things on the server instead. For example, if a JPG is being requested and the browser supports WebP (which is indicated in the <code>Accept</code> header), there’s nothing stopping you from replying with a WebP version of the resource. In fact, some CDN services—<a href="https://cloudinary.com">Cloudinary</a>, for instance—come with this sort of functionality right out of the box.</p>
<h4 id="section6">Offer different sizes<a class="subhead-anchor" href="https://alistapart.com#section6">#section6</a></h4>
<p>Formats aside, you may want to deliver alternate image sizes optimized for the current size of the browser’s viewport. After all, there’s no point loading an image that’s 3–4 times larger than the screen rendering it; that’s just wasting bandwidth. This is where <a href="https://alistapart.com/article/responsive-images-in-practice/">responsive images</a> come in.</p>
<p>Here’s an example:</p>
<figure id="figure3"><pre id="snippet3"><code class="language-markup">&lt;img src="medium.jpg"
  srcset="small.jpg 256w,
    medium.jpg 512w,
    large.jpg 1024w"
  sizes="(min-width: 30em) 30em, 100vw"
  alt="Descriptive text about the picture."&gt;</code></pre></figure><p>There’s a lot going on in this super-charged <code>img</code> element, so I’ll break it down:</p>
<ul><li>This <code>img</code> offers three size options for a given JPG: 256 px wide (<code>small.jpg</code>), 512 px wide (<code>medium.jpg</code>), and 1024 px wide (<code>large.jpg</code>). These are provided in the <code>srcset</code> attribute with corresponding <a href="https://cloudfour.com/thinks/responsive-images-101-part-4-srcset-width-descriptors/">width descriptors</a>.</li>
<li>The <code>src</code> defines a default image source, which acts as a fallback for browsers that don’t support <code>srcset</code>. Your choice for the default image will likely depend on the context and general usage patterns. Often I’d recommend the smallest image be the default, but if the majority of your traffic is on older desktop browsers, you might want to go with the medium-sized image.</li>
<li>The <code>sizes</code> attribute is a <a href="https://www.w3.org/TR/CSS2/cascade.html#preshint">presentational hint</a> that informs the browser how the image will be rendered in different scenarios (its <a href="https://24ways.org/2018/jank-free-image-loads/">extrinsic size</a>) once CSS has been applied. This particular example says that the image will be the full width of the viewport (<code>100vw</code>) until the viewport reaches 30 em in width (<code>min-width: 30em</code>), at which point the image will be 30 em wide. You can make the <code>sizes</code> value as complicated or as simple as you want; omitting it causes browsers to use the default value of <code>100vw</code>.</li>
</ul><p>You can even combine this approach with <a href="https://alistapart.com/article/responsive-images-in-practice/#snippet13">alternate formats and crops within a single <code>picture</code></a>. ?</p>
<p>All of this is to say that you have a number of tools at your disposal for delivering fast-loading media, so use them!</p>
<h2 id="section7">Defer requests (when possible)<a class="subhead-anchor" href="https://alistapart.com#section7">#section7</a></h2>
<p>Years ago, Internet Explorer 11 introduced a new attribute that enabled developers to de-prioritize specific <code>img</code> elements to speed up page rendering: <code>lazyload</code>. That attribute never went anywhere, standards-wise, but it was a solid attempt to defer image loading until images are in view (or close to it) without having to involve JavaScript.</p>
<p>There have been countless JavaScript-based implementations of lazy loading images since then, but recently Google also took a stab at a more declarative approach, using a different attribute: <a href="https://web.dev/native-lazy-loading"><code>loading</code></a>.</p>
<p>The <code>loading</code> attribute supports three values (“auto,” “lazy,” and “eager”) to define how a resource should be brought in. For our purposes, the “lazy” value is the most interesting because it defers loading the resource until it reaches a <a href="https://web.dev/native-lazy-loading#load-in-distance-threshold">calculated distance</a> from the viewport.</p>
<p>Adding that into the mix…</p>
<figure id="figure4"><pre id="snippet4"><code class="language-markup">&lt;img src="medium.jpg"
  srcset="small.jpg 256w,
    medium.jpg 512w,
    large.jpg 1024w"
  sizes="(min-width: 30em) 30em, 100vw"
  loading="lazy"
  alt="Descriptive text about the picture."&gt;</code></pre></figure><p>This attribute offers a bit of a performance boost in Chromium-based browsers. Hopefully it will become a standard and get picked up by other browsers in the future, but in the meantime there’s no harm in including it because browsers that don’t understand the attribute will simply ignore it.</p>
<p>This approach complements a media prioritization strategy really well, but before I get to that, I want to take a closer look at Service Workers.</p>
<h2 id="section8">Manipulate requests in a Service Worker<a class="subhead-anchor" href="https://alistapart.com#section8">#section8</a></h2>
<p>Service Workers are a special type of <a href="https://developer.mozilla.org/docs/Web/API/Web_Workers_API/Using_web_workers">Web Worker</a> with the ability to intercept, modify, and respond to all network requests via the <a href="https://developer.mozilla.org/docs/Web/API/Fetch_API">Fetch API</a>. They also have access to the <a href="https://developer.mozilla.org/docs/Web/API/Cache">Cache API</a>, as well as other asynchronous client-side data stores like <a href="https://developer.mozilla.org/docs/Web/API/IndexedDB_API">IndexedDB</a> for resource storage.</p>
<p>When a Service Worker is installed, you can hook into that event and prime the cache with resources you want to use later. Many folks use this opportunity to squirrel away copies of global assets, including styles, scripts, logos, and the like, but you can also use it to cache images for use when network requests fail.</p>
<h3 id="section9">Keep a fallback image in your back pocket<a class="subhead-anchor" href="https://alistapart.com#section9">#section9</a></h3>
<p>Assuming you want to use a fallback in more than one networking recipe, you can set up a named function that will respond with that resource:</p>
<figure id="figure5"><pre id="snippet5"><code class="language-javascript">function respondWithFallbackImage() {
  return caches.match( "/i/fallbacks/offline.svg" );
}</code></pre></figure><p>Then, within a <a href="https://developer.mozilla.org/en-US/docs/Web/API/FetchEvent"><code>fetch</code> event handler</a>, you can use that function to provide that fallback image when requests for images fail at the network:</p>
<figure id="figure6"><pre id="snippet6"><code class="language-javascript">self.addEventListener( "fetch", event =&gt; {
  const request = event.request;
  if ( request.headers.get("Accept").includes("image") ) {
    event.respondWith(
      return fetch( request, { mode: 'no-cors' } )
        .then( response =&gt; {
          return response;
        })
        .catch(
          respondWithFallbackImage
        );
    );
  }
});</code></pre></figure><p>When the network is available, users get the expected behavior:</p>
<figure id="figure7" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/11/fig1.png?w=960" alt="Screenshot of a component showing a series of user profile images of users who have liked something" class="wp-image-7172145" /><figcaption>Social media avatars are rendered as expected when the network is available.</figcaption></figure><p>But when the network is interrupted, images will be swapped automatically for a fallback, and the user experience is still acceptable:</p>
<figure id="figure8" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/11/fig2-1.png?w=960" alt="Screenshot showing a series of identical generic user images in place of the individual ones which have not loaded" class="wp-image-7172144" /><figcaption>A generic fallback avatar is rendered when the network is unavailable.</figcaption></figure><p>On the surface, this approach may not seem all that helpful in terms of performance since you’ve essentially added an additional image download into the mix. With this system in place, however, some pretty amazing opportunities open up to you.</p>
<h3 id="section10">Respect a user’s choice to save data<a class="subhead-anchor" href="https://alistapart.com#section10">#section10</a></h3>
<p>Some users reduce their data consumption by entering a “lite” mode or turning on a “data saver” feature. When this happens, browsers will often send a <a href="https://developer.mozilla.org/docs/Web/HTTP/Headers/Save-Data"><code>Save-Data</code> header</a> with their network requests. </p>
<p>Within your Service Worker, you can look for this header and adjust your responses accordingly. First, you look for the header:</p>
<figure id="figure9"><pre id="snippet7"><code class="language-javascript">let save_data = false;
if ( 'connection' in navigator ) {
  save_data = navigator.connection.saveData;
}</code></pre></figure><p>Then, within your <code>fetch</code> handler for images, you might choose to preemptively respond with the fallback image instead of going to the network at all:</p>
<figure id="figure10"><pre id="snippet8"><code class="language-javascript">self.addEventListener( "fetch", event =&gt; {
  const request = event.request;
  if ( request.headers.get("Accept").includes("image") ) {
    event.respondWith(
      if ( save_data ) {
        return respondWithFallbackImage();
      }
      // code you saw previously
    );
  }
});</code></pre></figure><p>You could even take this a step further and tune <code>respondWithFallbackImage()</code> to provide alternate images based on what the original request was for. To do that you’d define several fallbacks globally in the Service Worker:</p>
<figure id="figure11"><pre id="snippet9"><code class="language-javascript">const fallback_avatar = "/i/fallbacks/avatar.svg",
      fallback_image = "/i/fallbacks/image.svg";</code></pre></figure><p>Both of those files should then be cached during the Service Worker install event:</p>
<figure id="figure12"><pre id="snippet10"><code class="language-javascript">return cache.addAll( [
  fallback_avatar,
  fallback_image
]);</code></pre></figure><p>Finally, within <code>respondWithFallbackImage()</code> you could serve up the appropriate image based on the URL being fetched. In my site, the avatars are pulled from <a href="https://webmention.io">Webmention.io</a>, so I test for that.</p>
<figure id="figure13"><pre id="snippet11"><code class="language-javascript">function respondWithFallbackImage( url ) {
  const image = avatars.test( /webmention\.io/ ) ? fallback_avatar
                                                 : fallback_image;
  return caches.match( image );
}</code></pre></figure><p>With that change, I’ll need to update the <code>fetch</code> handler to pass in <code>request.url</code> as an argument to <code>respondWithFallbackImage()</code>. Once that’s done, when the network gets interrupted I end up seeing something like this:</p>
<figure id="figure14" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/11/fig3.png?w=960" alt="Screenshot showing a blog comment with a generic user profile image and image placeholder where the network could not load the actual images" class="wp-image-7172143" /><figcaption>A webmention that contains both an avatar and an embedded image will render with two different fallbacks when the Save-Data header is present.</figcaption></figure><p>Next, we need to establish some general guidelines for handling media assets—based on the situation, of course.</p>
<h3 id="section11">The caching strategy: prioritize certain media<a class="subhead-anchor" href="https://alistapart.com#section11">#section11</a></h3>
<p>In my experience, media—especially images—on the web tend to fall into three categories of necessity. At one end of the spectrum are elements that don’t add meaningful value. At the other end of the spectrum are critical assets that <em>do</em> add value, such as charts and graphs that are essential to understanding the surrounding content. Somewhere in the middle are what I would call “nice-to-have” media. They <em>do</em> add value to the core experience of a page but are not critical to understanding the content.</p>
<p>If you consider your media with this division in mind, you can establish some general guidelines for handling each, based on the situation. In other words, a caching strategy.</p>
<figure id="figure15"><table><caption>Media loading strategy, broken down by how critical an asset is to understanding an interface</caption>
<thead><tr><th scope="col">Media category</th>
<th scope="col">Fast connection</th>
<th scope="col"><code>Save-Data</code></th>
<th scope="col">Slow connection</th>
<th scope="col">No network</th>
</tr></thead><tbody><tr><td data-title="Media category"><strong>Critical</strong></td>
<td colspan="3" data-title="Fast connection, Save-Data, Slow Connection">Load media</td>
<td data-title="No network">Replace with placeholder</td>
</tr><tr><td data-title="Media category"><strong>Nice-to-have</strong></td>
<td data-title="Fast connection">Load media</td>
<td colspan="3" data-title="Save-Data, Slow connection, No network">Replace with placeholder</td>
</tr><tr><td data-title="Media category"><strong>Non-critical</strong></td>
<td colspan="4" data-title="Fast connection, Save-Data, Slow connection, No network">Remove from content entirely</td>
</tr></tbody></table></figure><p>When it comes to disambiguating the critical from the nice-to-have, it’s helpful to have those resources organized into separate directories (or similar). That way we can add some logic into the Service Worker that can help it decide which is which. For example, on my own personal site, critical images are either self-hosted or come from the website for <a href="https://adaptivewebdesign.info">my book</a>. Knowing that, I can write regular expressions that match those domains:</p>
<figure id="figure16"><pre id="snippet12"><code class="language-javascript">const high_priority = [
    /aaron\-gustafson\.com/,
    /adaptivewebdesign\.info/
  ];</code></pre></figure><p>With that <code>high_priority</code> variable defined, I can create a function that will let me know if a given image request (for example) is a high priority request or not:</p>
<figure id="figure17"><pre id="snippet13"><code class="language-javascript">function isHighPriority( url ) {
  // how many high priority links are we dealing with?
  let i = high_priority.length;
  // loop through each
  while ( i-- ) {
    // does the request URL match this regular expression?
    if ( high_priority[i].test( url ) ) {
      // yes, it’s a high priority request
      return true;
    }
  }
  // no matches, not high priority
  return false;
}</code></pre></figure><p>Adding support for prioritizing media requests only requires adding a new conditional into the <code>fetch</code> event handler, like we did with <code>Save-Data</code>. Your specific recipe for network and cache handling will likely differ, but here was <a href="https://github.com/aarongustafson/aaron-gustafson.com/blob/master/_javascript/serviceworker/fetch.js#L162-L219">how I chose to mix in this logic within image requests</a>:</p>
<figure id="figure18"><pre id="snippet14"><code class="language-javascript">// Check the cache first
  // Return the cached image if we have one
  // If the image is not in the cache, continue
// Is this image high priority?
if ( isHighPriority( url ) ) {
  // Fetch the image
    // If the fetch succeeds, save a copy in the cache
    // If not, respond with an "offline" placeholder
// Not high priority
} else {
  // Should I save data?
  if ( save_data ) {
    // Respond with a "saving data" placeholder
  // Not saving data
  } else {
    // Fetch the image
      // If the fetch succeeds, save a copy in the cache
      // If not, respond with an "offline" placeholder
  }
}</code></pre></figure><p>We can apply this prioritized approach to many kinds of assets. We could even use it to control which pages are served cache-first vs. network-first.</p>
<h2 id="section12">Keep the cache tidy<a class="subhead-anchor" href="https://alistapart.com#section12">#section12</a></h2>
<p>The  ability to control which resources are cached to disk is a huge opportunity, but it also carries with it an equally huge responsibility not to abuse it.</p>
<p>Every caching strategy is likely to differ, at least a little bit. If we’re publishing a book online, for instance, it might make sense to cache all of the chapters, images, etc. for offline viewing. There’s a fixed amount of content and—assuming there aren’t a ton of heavy images and videos—users will benefit from not having to download each chapter separately.</p>
<p>On a news site, however, caching every article and photo will quickly fill up our users’ hard drives. If a site offers an indeterminate number of pages and assets, it’s <em>critical</em> to have a caching strategy that puts hard limits on how many resources we’re caching to disk. </p>
<p>One way to do this is to create several different blocks associated with caching different forms of content. The more ephemeral content caches can have strict limits around how many items can be stored. Sure, we’ll still be bound to the storage limits of the device, but do we really want our website to take up 2 GB of someone’s hard drive?</p>
<p>Here’s an example, again from my own site:</p>
<figure id="figure19"><pre id="snippet15"><code class="language-javascript">const sw_caches = {
  static: {
    name: `${version}static`
  },
  images: {
    name: `${version}images`,
    limit: 75
  },
  pages: {
    name: `${version}pages`,
    limit: 5
  },
  other: {
    name: `${version}other`,
    limit: 50
  }
}</code></pre></figure><p>Here I’ve defined several caches, each with a <code>name</code> used for addressing it in the Cache API and a <code>version</code> prefix. The <code>version</code> is defined elsewhere in the Service Worker, and allows me to purge all caches at once if necessary.</p>
<p>With the exception of the <code>static</code> cache, which is used for static assets, every cache has a <code>limit</code> to the number of items that may be stored. I only cache the most recent 5 pages someone has visited, for instance. Images are limited to the most recent 75, and so on. This is an approach that <a href="https://adactio.com/">Jeremy Keith</a> outlines in his fantastic book <a href="https://abookapart.com/products/going-offline"><em>Going Offline</em></a> (which you should really read if you haven’t already—<a href="https://alistapart.com/article/going-offline/">here’s a sample</a>).</p>
<p>With these cache definitions in place, I can clean up my caches periodically and prune the oldest items. Here’s Jeremy’s recommended code for this approach:</p>
<figure id="figure20"><pre id="snippet16"><code class="language-javascript">function trimCache(cacheName, maxItems) {
  // Open the cache
  caches.open(cacheName)
  .then( cache =&gt; {
    // Get the keys and count them
    cache.keys()
    .then(keys =&gt; {
      // Do we have more than we should?
      if (keys.length &gt; maxItems) {
        // Delete the oldest item and run trim again
        cache.delete(keys[0])
        .then( () =&gt; {
          trimCache(cacheName, maxItems)
        });
      }
    });
  });
}</code></pre></figure><p>We can trigger this code to run whenever a new page loads. By running it in the Service Worker, it runs in a separate thread and won’t drag down the site’s responsiveness. We trigger it by posting a message (using <code>postMessage()</code>) to the Service Worker from the main JavaScript thread:</p>
<figure id="figure21"><pre id="snippet17"><code class="language-javascript">// First check to see if you have an active service worker
if ( navigator.serviceWorker.controller ) {
  // Then add an event listener
  window.addEventListener( "load", function(){
    // Tell the service worker to clean up
    navigator.serviceWorker.controller.postMessage( "clean up" );
  });
}</code></pre></figure><p>The final step in wiring it all up is setting up the Service Worker to receive the message:</p>
<figure id="figure22"><pre id="snippet18"><code class="language-javascript">addEventListener("message", messageEvent =&gt; {
  if (messageEvent.data == "clean up") {
    // loop though the caches
    for ( let key in sw_caches ) {
      // if the cache has a limit
      if ( sw_caches[key].limit !== undefined ) {
        // trim it to that limit
        trimCache( sw_caches[key].name, sw_caches[key].limit );
      }
    }
  }
});</code></pre></figure><p>Here, the Service Worker listens for inbound messages and responds to the “clean up” request by running <code>trimCache()</code> on each of the cache buckets with a defined <code>limit</code>.</p>
<p>This approach is by no means elegant, but it works. It would be far better to make decisions about purging cached responses based on how frequently each item is accessed and/or how much room it takes up on disk. (Removing cached items based purely on when they were cached isn’t nearly as useful.) Sadly, we don’t have that level of detail when it comes to inspecting the caches…yet. I’m actually working to address this limitation in the Cache API right now.</p>
<h2 id="section13">Your users always come first<a class="subhead-anchor" href="https://alistapart.com#section13">#section13</a></h2>
<p>The technologies underlying Progressive Web Apps are continuing to mature, but even if you aren’t interested in turning your site into a PWA, there’s so much you can do today to improve your users’ experiences when it comes to media. And, as with every other form of inclusive design, it starts with centering on your users who are most at risk of having an awful experience.</p>
<p>Draw distinctions between critical, nice-to-have, and superfluous media. Remove the cruft, then optimize the bejeezus out of each remaining asset. Serve your media in multiple formats and sizes, prioritizing the smallest versions first to make the most of high latency and slow connections. If your users say they want to save data, respect that and have a fallback plan in place. Cache wisely and with the utmost respect for your users’ disk space. And, finally, audit your caching strategies regularly—especially when it comes to large media files.Follow these guidelines, and every one of your users—from folks rocking a <a href="https://www.jio.com/en-in/jiophone2">JioPhone</a> on a rural mobile network in India to people on a high-end gaming laptop wired to a 10 Gbps fiber line in Silicon Valley—will thank you.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Jeremy Wagner shows us how to get and keep third-party JavaScript under control through clean-up sprints and eternal vigilance.</div><div class="entry-content">Learn the three storytelling pillars of vulnerable and transparent content to forge deeper connections with your users.</div><div class="entry-content">Even if you’re not looking for a job, Jessica Ivins shares a great way to jump start your résumé and portfolio right now.</div><div class="entry-content">The tech world has a major diversity problem. accessible developers may be an unexpected part of the solution.</div><div class="entry-content">You’ve “moved fast and broken things.” Here’s some helpful advice from Jeremy Wagner to fix them responsibly.</div>]]></description>
      <link>https://alistapart.com/article/request-with-intent-caching-strategies-in-the-age-of-pwas/</link>
      <guid>https://alistapart.com/article/request-with-intent-caching-strategies-in-the-age-of-pwas/</guid>
      <pubDate>Thu, 21 Nov 2019 15:30:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[Responsible JavaScript: Part III]]></title>
      <description><![CDATA[<div class="entry-content">
<p>You’ve done everything you thought was possible to address your website’s JavaScript problem. You <a href="https://alistapart.com/article/responsible-javascript-part-1/">relied on the web platform where you could</a>. You <a href="https://alistapart.com/article/responsible-javascript-part-2/#section9">sidestepped Babel</a> and <a href="https://alistapart.com/article/responsible-javascript-part-2/#section7">found smaller framework alternatives</a>. You whittled your application code down to its most streamlined form possible. Yet, things are just not fast enough. When websites fail to perform the way we as designers and developers expect them to, we inevitably turn on ourselves:</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p class="c1"><em>“What are we failing to do?” “What can we do with the code we have written?” “Which parts of our architecture are failing us?”</em></p>
<p>These are valid inquiries, as a fair share of performance woes <em>do</em> originate from our own code. Yet, assigning blame solely to ourselves blinds us to the unvarnished truth that a sizable onslaught of our performance problems comes from the outside.</p>
<h2 id="section2">When the third wheel crashes the party<a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>Convenience always has a price, and <a href="https://httparchive.org/reports/state-of-javascript#bytesJs">the web is wracked by our collective preference for it</a>.  JavaScript, in particular, is employed in a way that suggests a rapidly increasing tendency to outsource whatever it is that We (the first party) don’t want to do. At times, this is a necessary decision; it makes perfect financial and operational sense in many situations.</p>
<p>But make no mistake, <a href="https://www.thirdpartyweb.today/">third-party JavaScript is <em>never</em> cheap</a>. It’s a devil’s bargain where vendors seduce you with solutions to your problem, yet conveniently fail to remind you that you have little to no control over the side effects that solution introduces. If a third-party provider adds features to their product, <em>you</em> bear the brunt. If they change their infrastructure, <em>you</em> will feel the effects of it. Those who use your site <em>will</em> become frustrated, and they aren’t going to bother grappling with an intolerable user experience. You can mitigate some of the symptoms of third parties, but you can’t cure the ailment unless you remove the solutions altogether—and that’s not always practical or possible.</p>
<p>In this installment of <em>Responsible JavaScript</em>, we’ll take a <em>slightly</em> less technical approach than in the <a href="https://alistapart.com/article/responsible-javascript-part-2/">previous installment</a>. We are going to talk more about the human side of third parties. Then, we’ll go down some of the technical avenues for how you might go about tackling the problem.</p>
<h2 id="section3">Hindered by convenience<a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h2>
<p>When we talk about the sorry state of the web today, <a href="https://infrequently.org/2018/09/the-developer-experience-bait-and-switch/">some of us are quick to point out the role of <em>developer convenience</em></a> in contributing to the problem. While I share the view that developer convenience has a tendency to harm the user experience, they’re not the only kind of convenience that can turn a website into a sluggish, janky mess.</p>
<p><em>Operational conveniences</em> can become precursors to a very thorny sort of technical debt. These conveniences are what we reach for when we can’t solve a pervasive problem on our own. They represent third-party solutions that address problems in the absence of architectural flexibility and/or adequate development resources.</p>
<p>Whenever an inconvenience arises, <em>that</em> is the time to have the discussion around how to tackle it in a way that’s comprehensive. So let’s talk about what it looks like to tackle that sort of scenario from a more human angle.</p>
<h2 id="section4">The problem is pain<a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h2>
<p>The reason third parties come into play in the first place is pain. When a decision maker in an organization has felt enough pain around a certain problem, they’re going to do a <em>very human thing</em>, which is to find the fastest way to make that pain <em>go away</em>.</p>
<p>Markets will always find ways to address these pain points, even if the way they do so isn’t sustainable or even remotely helpful. Web accessibility overlays—third-party scripts that purport to automatically fix accessibility issues—are among the worst offenders. First, you fork over your money for <a href="https://blog.tenon.io/web-accessibility-overlays-dont-work/">a fix that doesn’t <em>fix</em> anything</a>. Then you pay a wholly different sort of price when that “fix” harms the usability of your website. This is not a screed to discredit the usefulness of the tools some third-party vendors provide, but to illustrate how the adoption of third-party solutions happens, even those that are objectively awful</p>
<figure id="figure1" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/11/fig-1.png?fit=960%2C561&amp;w=960" alt="A depiction of a long task in a flame chart from the performance panel in Chrome DevTools." class="wp-image-7172133" data-recalc-dims="1" /><figcaption>A Chrome performance trace of a <a href="https://developer.mozilla.org/en-US/docs/Web/API/Long_Tasks_API#Long_task">long task</a> kicked off by a third party’s web accessibility overlay script. The task occupies the main thread for roughly 600 ms on a 2017 <a href="https://en.wikipedia.org/wiki/MacBook_(2015%E2%80%932019)">Retina MacBook</a>.</figcaption></figure><p>So when a vendor rolls up and promises to solve the very painful problem we’re having, there’s a good chance someone is going to nibble. If that someone is high enough in the hierarchy, they’ll exert downward pressure on others to buy in—if not circumvent them entirely in the decision-making process. Conversely, adoption of a third-party solution can also occur when those in the trenches are under pressure and lack sufficient resources to create the necessary features themselves.</p>
<p>Whatever the catalyst, it pays to gather your colleagues and collectively form a plan for navigating and mitigating the problems you’re facing.</p>
<h2 id="section5">Create a mitigation plan<a class="subhead-anchor" href="https://alistapart.com#section5">#section5</a></h2>
<p>Once people in an organization have latched onto a third-party solution, however ill-advised, the difficulty you’ll encounter in forcing a course change will depend on how urgent a need that solution serves. In fact, you shouldn’t try to convince proponents of the solution that their decision was wrong. Such efforts almost always backfire and can make people feel attacked and more resistant to what you’re telling them. Even worse, those efforts could create acrimony where people stop listening to each other completely, and <em>that</em> is a breeding ground for far worse problems to develop.</p>
<p>Grouse and commiserate amongst your peers if you must—as I myself have often done—but put your grievances aside and <a href="https://csswizardry.com/2018/05/identifying-auditing-discussing-third-parties/#discussing">come up with a mitigation plan</a> to guide your colleagues toward better outcomes. The nooks and crannies of your specific approach will depend on the third parties themselves and the structure of the organization, but the bones of it could look like the following series of questions.</p>
<h3 id="section6">What problem does this solution address?<a class="subhead-anchor" href="https://alistapart.com#section6">#section6</a></h3>
<p>There’s a reason why a third-party solution was selected, and this question will help you suss out whether the rationale for its adoption is sound. Remember, there are times decisions are made when all the necessary people are not in the room. You might be in a position where you have to react to the aftermath of that decision, but the answer to this question will lead you to a natural follow-up.</p>
<h3 id="section7">How long do we intend to use the solution?<a class="subhead-anchor" href="https://alistapart.com#section7">#section7</a></h3>
<p>This question will help you identify the solution’s shelf life. Was it introduced as a bandage, with the intent to remove it once the underlying problem has been addressed, such as in the case of an accessibility overlay? Or is the need more long-term, such as the data provided by an A/B testing suite? The other possibility is that the solution can never be effectively removed because it serves a crucial purpose, as in the case of analytics scripts. <a href="https://alistapart.com/article/the-foundation-of-technical-leadership/#section3">It’s like throwing a mattress in a swimming pool</a>: it’s easy to throw in, but nigh impossible to drag back out.</p>
<p>In any case, you can’t know if a third-party script is here to stay if you don’t ask. Indeed, if you find out the solution is temporary, you can form a plan to eventually remove it from your site once the underlying problem it addresses has been resolved.</p>
<h3 id="section8">Who’s the point of contact if issues arise?<a class="subhead-anchor" href="https://alistapart.com#section8">#section8</a></h3>
<p>When a third-party solution is put into place, someone <em>must</em> be the point of contact for when—not <em>if</em>—issues arise.</p>
<p>I’ve seen what happens (far too often) when a third-party script gets out of control. For example, when a tag manager or an A/B testing framework’s JavaScript grows slowly and insidiously because marketers aren’t cleaning out old tags or completed A/B tests. It’s for precisely these reasons that responsibility needs to be attached to a specific person in your organization for third-party solutions currently in use on your site. What that responsibility entails will differ in every situation, but could include:</p>
<ul><li>periodic monitoring of the third-party script’s footprint;</li>
<li>maintenance to ensure the third-party script doesn’t grow out of control;</li>
<li>occasional meetings to discuss the future of that vendor’s relationship with your organization;</li>
<li>identification of overlaps of functionality between multiple third parties, and if potential redundancies can be removed;</li>
<li>and ongoing research, especially to identify speedier alternatives that may act as better replacements for slow third-party scripts.</li>
</ul><p>The idea of responsibility in this context should never be an onerous, draconian obligation you yoke your teammates with, but rather an exercise in encouraging mindfulness in your colleagues. Because without mindfulness, a third-party script’s ill effects on your website <em>will</em> be overlooked until it becomes a grumbling ogre in the room that can no longer be ignored. Assigning responsibility for third parties can help to prevent that from happening.</p>
<h2 id="section9">Ensuring responsible usage of third-party solutions<a class="subhead-anchor" href="https://alistapart.com#section9">#section9</a></h2>
<p>If you can put together a mitigation plan and get everyone on board, the work of ensuring the responsible use of third-party solutions can begin. Luckily for you, the actual technical work will be easier than trying to wrangle people. So if you’ve made it this far, all it will take to get results is time and persistence.</p>
<h3 id="section10">Load only what’s necessary<a class="subhead-anchor" href="https://alistapart.com#section10">#section10</a></h3>
<p>It may seem obvious, but load only what’s necessary. Judging by the amount of unused first-party JavaScript I see loaded—let alone <em>third-party</em> JavaScript—it’s clearly a problem. It’s like trying to clean your house by stuffing clutter into the closets. Regardless of whether they’re actually needed, it’s not uncommon for third-party scripts to be loaded on every single page, so refer to your point of contact to figure out which pages need which third-party scripts.</p>
<p>As an example, one of my past clients used a popular third-party tool across multiple brand sites to get a list of retailers for a given product. It demonstrated clear value, but that script only needed to be on a site’s product detail page. In reality, it was frequently loaded on <em>every</em> page. Culling this script from pages where it didn’t belong significantly boosted performance for non-product pages, which ostensibly reduced the friction on the conversion path.</p>
<p>Figuring out which pages need which third-party scripts requires you to do some decidedly untechnical work. You’ll actually have to get up from your desk and talk to the person who has been assigned responsibility for the third-party solution you’re grappling with. This is very difficult work for me, but it’s rewarding when good-faith collaboration happens, <em>and</em> good outcomes are realized as a result.</p>
<h3 id="section11">Self-host your third-party scripts<a class="subhead-anchor" href="https://alistapart.com#section11">#section11</a></h3>
<p>This advice isn’t a secret by any stretch. <a href="https://alistapart.com/article/responsible-javascript-part-2/#section6">I even touched on it</a> in the previous installment of this series, but it needs to be shouted from the rooftops at every opportunity: you should <a href="https://csswizardry.com/2019/05/self-host-your-static-assets/">self-host as many third-party resources</a> as possible. Whether this is feasible depends on the third-party script in question.</p>
<p>Is it some framework you’re grabbing from <a href="https://developers.google.com/speed/libraries">Google’s hosted libraries</a>, <a href="https://cdnjs.com/">cdnjs</a>, or other similar provider? Self-host that sucker <em>right now</em>.</p>
<p><a href="https://medium.com/caspertechteam/we-shaved-1-7-seconds-off-casper-com-by-self-hosting-optimizely-2704bcbff8ec">Casper found a way to self-host their Optimizely script</a> and significantly reduced their start render time for their trouble. It really drives home the point that a major detriment of third-party resources is the fact that their mere existence on other servers is one of the worst performance bottlenecks we encounter.</p>
<p>If you’re looking to self-host an analytics solution or a similar sort of script, there’s a higher level of difficulty to contend with to self-host it. You may find that some third-party scripts simply can’t be self-hosted, but that doesn’t mean it isn’t worth the trouble to find out. If you find that self-hosting isn’t an option for a third-party script, don’t fret. There are other mitigations you can try.</p>
<h3 id="section12">Mask latency of cross-origin connections<a class="subhead-anchor" href="https://alistapart.com#section12">#section12</a></h3>
<p>If you can’t self-host your third-party scripts, the next best thing is to preconnect to servers that host them. WebPageTest’s Connection View does a fantastic job of showing you which servers your site gathers resources from, as well as the latency involved in establishing connections to them.</p>
<figure id="figure2" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/11/fig2.png?w=960" alt="A screenshot of WebPageTest's connection view, which visualizes the latency involved with all the servers that serve content for a given page in a waterfall chart." class="wp-image-7172134" data-recalc-dims="1" /><figcaption>WebPageTest’s Connection View shows all the different servers a page requests resources from during load.</figcaption></figure><p><a href="https://web.dev/uses-rel-preconnect">Preconnections</a> are effective because they establish connections to third-party servers before the browser would otherwise discover them in due course. Parsing HTML takes time, and parsers are often blocked by stylesheets and other scripts. Wherever you can’t self-host third-party scripts, preconnections make perfect sense.</p>
<h3 id="section13">Maybe don’t preload third-party scripts<a class="subhead-anchor" href="https://alistapart.com#section13">#section13</a></h3>
<p><a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Preloading_content">Preloading resources</a> is one of those things that sounds fantastic at first—until you consider <a href="https://andydavies.me/blog/2019/02/12/preloading-fonts-and-the-puzzle-of-priorities/">its potential to backfire</a>, as <a href="https://andydavies.me/">Andy Davies</a> points out. If you’re unfamiliar with preloading, it’s similar to preconnecting but goes a step further by instructing the browser to fetch a particular resource far sooner than it ordinarily would.</p>
<p>The drawback of preloading is that while it’s great for ensuring a resource gets loaded as soon as possible, it changes the discovery order of that resource. Whenever we do this, we’re implicitly saying that other resources are less important—including resources crucial to rendering or even core functionality.</p>
<p>It’s probably a safe bet that most of your third-party code is not as crucial to the functionality of your site as your own code. That said, if you <em>must</em> preload a third-party resource, ensure you’re only doing so for third-party scripts that are critical to page rendering.</p>
<p>If you do find yourself in a position where your site’s initial rendering depends on a third-party script, refer to your mitigation plan to see what you can do to eliminate or ameliorate your dependence on it. Depending on a third party for core functionality is never a good position to be in, as you’re relinquishing a lot of control to others who might not have your best interests in mind.</p>
<h3 id="section14">Lazy load non-essential third-party scripts<a class="subhead-anchor" href="https://alistapart.com#section14">#section14</a></h3>
<p><a href="https://alistapart.com/article/the-best-request-is-no-request-revisited/">The best request is no request</a>. If you have a third-party script that doesn’t need to be loaded right away, consider lazy loading it with an <a href="https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API">Intersection Observer</a>. Here’s what it might look like to <a href="https://codepen.io/malchata/pen/JjjGOGZ">lazy load a Facebook Like button</a> when it’s scrolled into the viewport:</p>
<pre id="snippet1" class="wp-block-code language-javascript"><code class="language-javascript">
let loadedFbScript = false;
const intersectionListener = new IntersectionObserver(entries =&gt; {
  entries.forEach(entry =&gt; {
    if ((entry.isIntersecting || entry.intersectionRatio) &amp;&amp; !loadedFbScript) {
      const scriptEl = document.createElement("script");
      scriptEl.defer = true;
      scriptEl.crossOrigin = "anonymous";
      scriptEl.src = "https://connect.facebook.net/en_US/sdk.js#xfbml=1&amp;version=v3.0";
      scriptEl.onload = () =&gt; {
        loadedFbScript = true;
      };
      document.body.append(scriptEl);
    }
  });
});
intersectionListener.observe(document.querySelector(".fb-like"));
</code>
</pre>
<p>In the above snippet, we first set a variable to track whether we’ve loaded the Facebook SDK JavaScript. After that, an <code>IntersectionListener</code> is created that checks whether the observed element is in the viewport, and whether the Facebook SDK has been loaded. If the SDK JavaScript hasn’t been loaded, a reference to it is injected into the DOM, which will kick off a request for it.</p>
<p>You’re not going to be able to lazy load every third-party script. Some of them simply need to do their work at page load time, or otherwise can’t be deferred. Regardless, do the detective work to see if it’s possible to lazy load at least some of your third-party JavaScript.</p>
<p>One of the common concerns I hear from coworkers when I suggest lazy loading third-party scripts is how it can delay whatever interactions the third party provides. That’s a reasonable concern, because when you lazy load anything, a noticeable delay may occur as the resource loads. You can get around this to some extent with <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Link_prefetching_FAQ">resource prefetching</a>. This is different than preloading, which we discussed earlier. Prefetching consumes a comparable amount of data, yes, but prefetched resources are given lower priority and are less likely to contend for bandwidth with critical resources.</p>
<h2 id="section15">Staying on top of the problem<a class="subhead-anchor" href="https://alistapart.com#section15">#section15</a></h2>
<p>Keeping an eye on your third-party JavaScript requires mindfulness bordering on hypervigilance. When you recognize poor performance for the technical debt that it truly is, you’ll naturally slip into a frame of mind where you’ll recognize and address it as you would any other kind of technical debt.</p>
<p>Staying on top of third parties <em>is</em> refactoring—a sort that requires you to periodically perform tasks such as cleaning up tag managers and A/B tests, consolidating third-party solutions, eliminating any that are no longer needed, and applying the coding techniques discussed above. Moreover, you’ll need to work with your team to address this technical debt on a cyclical basis. This kind of work can’t be automated, so yes, you’ll need to knuckle down and have face-to-face, synchronous conversations with actual people.</p>
<p>If you’re already in the habit of scheduling “cleanup sprints” on some interval, then <em>that</em> is the time and space for you to address performance-related technical debt, regardless of whether it involves third- or first-party code. There’s a time for feature development, but that time should not comprise the whole of your working hours. Development shops that focus only on feature development are destined to be wholly consumed by the technical debt that will inevitably result.</p>
<p>So it will come to pass that in the fourth and final installment of this series we’ll discuss what it means to do the hard work of using JavaScript responsibly in the context of process. Therein, we’ll explore what it takes to unite your organization under the banner of making your website faster and more accessible, and therefore more usable for everyone, everywhere.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Learn the three storytelling pillars of vulnerable and transparent content to forge deeper connections with your users.</div><div class="entry-content">Even if you’re not looking for a job, Jessica Ivins shares a great way to jump start your résumé and portfolio right now.</div><div class="entry-content">The tech world has a major diversity problem. accessible developers may be an unexpected part of the solution.</div><div class="entry-content">You’ve “moved fast and broken things.” Here’s some helpful advice from Jeremy Wagner to fix them responsibly.</div><div class="entry-content">A key aspect of being a manager is helping your reports succeed. Lara Hogan shares how in this excerpt from Resilient Management.</div>]]></description>
      <link>https://alistapart.com/article/responsible-javascript-part-3/</link>
      <guid>https://alistapart.com/article/responsible-javascript-part-3/</guid>
      <pubDate>Thu, 14 Nov 2019 15:30:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[The Untapped Power of Vulnerability &#038; Transparency in Content Strategy]]></title>
      <description><![CDATA[<div class="entry-content">
<p>In marketing, transparency and vulnerability are unjustly stigmatized. The words conjure illusions of being frightened, imperfect, and powerless. And for companies that shove carefully curated personas in front of users, little is more terrifying than losing control of how people perceive the brand.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>Let’s shatter this illusioned stigma. <em>Authentic vulnerability and transparency are strengths masquerading as weaknesses</em>. And companies too scared to embrace both traits in their content forfeit bona fide user-brand connections for often shallow, misleading engagement tactics that create fleeting relationships.</p>
<p>Transparency and vulnerability are closely entwined concepts, but each one engages users in a unique way. Transparency is how much information you share, while vulnerability is the truth and meaning behind your actions and words. Combining these ideas is the trick to creating empowering and meaningful content. You can’t tell true stories of vulnerability without transparency, and to be authentically transparent you must be vulnerable.</p>
<p>To be vulnerable, your brand and its content must be brave, genuine, humble, and open, all of which are traits that promote long-term customer loyalty. And if you’re transparent with users about who you are and about your business practices, you’re courting <a href="https://www.labelinsight.com/Transparency-ROI-Study">94 percent of consumers</a> who say they’re more loyal to brands that offer complete openness and <a href="https://martechtoday.com/report-customers-are-more-loyal-to-companies-that-are-transparent-on-social-media-223053">89 percent of people</a> who say they give transparent companies a second chance after a bad experience.</p>
<p>For many companies, being completely honest and open with their customers—or employees, in some cases—only happens in a crisis. Unfortunately for those businesses, using vulnerability and transparency only as a crisis management strategy diminishes how sincere they appear and can <a href="https://hbr.org/2018/01/sorry-is-not-enough">reduce customer satisfaction</a>.</p>
<p>Unlocking the potential of being transparent and vulnerable with users isn’t a one-off tactic or quick-fix emergency response tool—it’s a commitment to intimate storytelling that embraces a user’s emotional and psychological needs, which builds a meaningful connection between the storyteller and the audience.</p>
<h2 id="section2">The three storytelling pillars of vulnerable and transparent content<a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>In her book, <cite>Braving the Wilderness</cite>, sociologist Brené Brown explains that vulnerability connects us at an emotional level. She says that when we recognize someone is being vulnerable, we invest in their story and begin to develop an emotional bond. This interwoven connection encourages us to experience the storyteller’s joy and pain, and then creates a sense of community and common purpose among the person being vulnerable and the people who acknowledge that vulnerability.</p>
<p>Three pillars in a company’s lifecycle embrace this bond and provide an outline for telling stories worthy of a user’s emotional investment. The pillars are:</p>
<ul><li>the origins of a company, product, idea, or situation;</li>
<li>intimate narratives about customers’ life experiences;</li>
<li>and insights about product success and failure.</li>
</ul><h3 id="section3">Origin stories<a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h3>
<p>An origin story spins a transparent tale about how a company, product, service, or idea is created. It is often told by a founder, CEO, or industry innovator. This pillar is usually used as an authentic way to provide crisis management or as a method to change how users feel about a topic, product, or your brand.</p>
<h3 id="section4">Customers’ life experiences<a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h3>
<p>While vulnerable origin stories do an excellent job of making users trust your brand, telling a customer’s personal life story is arguably the most effective way to use vulnerability to entwine a brand with someone’s personal identity.</p>
<p>Unlike an origin story, the customer experiences pillar is focused on being transparent about who your customers are, what they’ve experienced, and how those journeys align with values that matter to your brand. Through this lens, you’ll empower your customers to tell emotional, meaningful stories that make users feel vulnerable in a positive way. In this situation, your brand is often a storytelling platform where users share their story with the brand and fellow customers.</p>
<h3 id="section5">Product and service insights<a class="subhead-anchor" href="https://alistapart.com#section5">#section5</a></h3>
<p>Origin stories make your brand trustworthy in a crisis, and customers’ personal stories help users feel an intimate connection with your brand’s persona and mission. The last pillar, product and service insights, combines the psychological principles that make origin and customer stories successful. The outcome is a vulnerable narrative that rallies users’ excitement about, and emotional investment in, what a company sells or the goals it hopes to achieve.</p>
<h2 id="section6">Vulnerability, transparency, and the customer journey<a class="subhead-anchor" href="https://alistapart.com#section6">#section6</a></h2>
<p>The three storytelling pillars are crucial to embracing transparency and vulnerability in your content strategy because they let you target users at specific points in their journey. By embedding the pillars in each stage of the customer’s journey, you teach users about who you are, what matters to you, and why they should care.</p>
<p>For our purposes, let’s define the user journey as:</p>
<ul><li>awareness;</li>
<li>interest;</li>
<li>consideration;</li>
<li>conversion;</li>
<li>and retention.</li>
</ul><h3 id="section7">Awareness<a class="subhead-anchor" href="https://alistapart.com#section7">#section7</a></h3>
<p>People give each other <a href="https://www.forbes.com/sites/serenitygibbons/2018/06/19/you-have-7-seconds-to-make-a-first-impression-heres-how-to-succeed/#5e47a32856c2">seven seconds</a> to make a good first impression. We’re not so generous with brands and websites. After discovering your content, users determine if it’s trustworthy within <a href="https://www.psychologicalscience.org/observer/how-many-seconds-to-a-first-impression">one-tenth of a second</a>.</p>
<p>Page design and aesthetics are often <a href="https://conversionxl.com/blog/first-impressions-matter-the-importance-of-great-visual-design/">the determining factors in these split-second choices</a>, but the information users discover after that decision shapes their long-term opinions about your brand. This snap judgement is why transparency and vulnerability are crucial within awareness content.</p>
<p>When you only get one chance to make a positive first impression with your audience, what content is going to be more memorable?</p>
<p>Typical marketing “fluff” about how your brand was built on a shared vision and commitment to unyielding customer satisfaction and quality products? Or an upfront, authentic, and honest story about the trials and tribulations you went through to get where you are now?</p>
<p>Buffer, a social media management company that helped pioneer <a href="https://en.wikipedia.org/wiki/Radical_transparency">the <em>radical transparency</em> movement</a>, chose the latter option. The outcome created awareness content that leaves a positive lasting impression of the brand.</p>
<p>In 2016, Joel Gascoigne, cofounder and CEO of Buffer, used an origin story to discuss the mistakes he and his company made that resulted in laying off 10 employees.</p>
<p>In the blog post “<a href="https://open.buffer.com/layoffs-and-moving-forward/">Tough News: We’ve Made 10 Layoffs. How We Got Here, the Financial Details and How We’re Moving Forward</a>,” Gascoigne wrote about Buffer’s over-aggressive growth choices, lack of accountability, misplaced trust in its financial model, explicit risk appetite, and overenthusiastic hiring. He also discussed what he learned from the experience, the changes Buffer made based on these lessons, the consequences of those changes, and next steps for the brand.</p>
<p>Gascoigne writes about each subject with radical honesty and authenticity. Throughout the article, he’s personable and relatable; his tone and voice make it obvious he’s more concerned about the lives he’s irrevocably affected than the public image of his company floundering. Because Gascoigne is so transparent and vulnerable in the blog post, it’s easy to become invested in the narrative he’s telling. The result is an article that feels more like a deep, meaningful conversation over coffee instead of a carefully curated, PR-approved response.</p>
<p>Yes, Buffer used this origin story to confront a PR crisis, but they did so in a way that encouraged users to trust the brand. Buffer chose to show up and be seen when they had no control over the outcome. And because Gascoigne used vulnerability and transparency to share the company’s collective pain, the company reaped positive press coverage and support on social media—further improving brand awareness, user engagement, and customer loyalty.</p>
<p>However, awareness content isn’t always brand focused. Sometimes, smart awareness content uses storytelling to teach users and shape their worldviews. The <a href="https://www.3m.com/3M/en_US/state-of-science-index-survey/about-2019-survey/">2019 <cite>State of Science Index</cite></a> is an excellent example.</p>
<p>The annual <cite>State of Science Index</cite> evaluates how the global public perceives science. The 2019 report shows that 87 percent of people acknowledge that science is necessary to solve the world’s problems, but 33 percent are skeptical of science and believe that scientists cause as many problems as they solve. Furthermore, 57 percent of respondents are skeptical of science because of scientists’ conflicting opinions about topics they don’t understand.</p>
<p>3M, the multinational science conglomerate that publishes the report, says the solution for this anti-science mindset is to promote intimate storytelling among scientists and layfolk.</p>
<p>3M creates an origin story with its awareness content by focusing on the ins and outs of scientific research. The company is open and straightforward with its data and intentions, eliminating any second guesses users might have about the content they’re digesting.</p>
<p>The company kicked off this strategy on three fronts, and each storytelling medium interweaves the benefits of vulnerability and transparency by encouraging researchers to tell stories that lead with how their findings benefit humanity. Every story 3M tells focuses on breaking through barriers the average person faces when they encounter science and encouraging scientists to be vulnerable and authentic with how they share their research.</p>
<p>First, 3M began a podcast series known as <a href="https://www.3m.com/3M/en_US/state-of-science-index-survey/science-champion-podcasts/"><cite>Science Champions</cite></a>. In the podcast, 3M Chief Science Advocate Jayshree Seth interviews scientists and educators about the global perception of science and how science and scientists affect our lives. The show is currently in its second season and discusses a range of topics in science, technology, engineering, and math.</p>
<p>Second, the company worked with science educators, journalist Katie Couric, actor Alan Alda, and former NASA astronaut Scott Kelly to develop the free <a href="https://multimedia.3m.com/mws/media/1667242O/sosi-3-13-toolkit-pdf.pdf"><cite>Scientists as Storytellers Guide</cite></a>. The ebook helps STEM researchers improve how and why they communicate their work with other people—with a special emphasis on being empathetic with non-scientists. The guide breaks down how to develop communications skills, overcome common storytelling challenges, and learn to make science more accessible, understandable, and engaging for others.</p>
<p>Last, 3M created a film series called <a href="https://www.3m.com/3M/en_US/state-of-science-index-survey/insights/beyond-the-beaker/"><cite>Beyond the Beaker</cite></a> that explores the day-to-day lives of 3M scientists. In the short videos, scientists give the viewer a glimpse into their hobbies and home life. The series showcases how scientists have diverse backgrounds, hobbies, goals, and dreams.</p>
<p>Unlike Buffer, which benefits directly from its awareness content, 3M’s three content mediums are designed to create a long-term strategy that changes how people understand and perceive science, by spreading awareness through third parties. It’s too early to conclude that the strategy will be successful, but it’s off to a good start. <cite>Science Champions</cite> often tops “best of” podcast lists for science lovers, and the <cite>Scientists as Storytellers Guide</cite> is a popular resource among public universities.</p>
<h3 id="section8">Interest<a class="subhead-anchor" href="https://alistapart.com#section8">#section8</a></h3>
<p>How do you court new users when word-of-mouth and organic search dominate how people discover new brands? Target their interests.</p>
<p>Now, you can be like the hundreds of other brands that create a “10 best things” list and hope people stumble onto your content organically and like what they see. Or, you can use content to engage with people who are passionate about your industry and have genuine, open discussions about the topics that matter to you both.</p>
<p>The latter option is a perfect fit for the product and service insights pillar, and the customers’ life experiences pillar.</p>
<p>To succeed in these pillars you must balance discussing the users’ passions and how your brand plays into that topic against appearing disingenuous or becoming too self-promotional.</p>
<p>Nonprofits have an easier time walking this taut line because people are less judgemental when engaging with NGOs, but it’s rare for a for-profit company to achieve this balance. SpaceX and Thinx are among the few brands that are able to walk this tightrope.</p>
<p>Thinx, a women’s clothing brand that sells period-proof underwear, uses its blog to generate awareness, interest, and consideration content via the customers’ life experiences pillar. The blog, aptly named <a href="https://www.shethinx.com/pages/thinx-periodical/"><cite>Periodical</cite></a>, relies on transparency and vulnerability as a cornerstone to engage users about reproductive and mental health.</p>
<p>Toni Brannagan, Thinx’s content editor, says the brand embraces transparency and vulnerability by sharing diverse ideas and personal experiences from customers and experts alike, not shying away from sensitive subjects and never misleading users about Thinx or the subjects <cite>Periodical</cite> discusses.</p>
<p>As a company focused on women’s healthcare, the product Thinx sells is political by nature and entangles the brand with themes of shame, cultural differences, and personal empowerment. Thinx’s strategy is to tackle these subjects head-on by having vulnerable conversations in its branding, social media ads, and <cite>Periodical</cite> content.</p>
<p>“Vulnerability and transparency play a role because you can’t share authentic diverse ideas and experiences about those things—shame, cultural differences, and empowerment—without it,” Brannagan says.</p>
<p>A significant portion of Thinx’s website traffic is organic, which means <cite>Periodical</cite>’s interest-driven content may be a user’s first touchpoint with the brand.</p>
<p>“We’ve seen that our most successful organic content is educational, well-researched articles, and also product-focused blogs that answer the questions about our underwear, in a way that’s a little more casual than what’s on our product pages,” Brannagan says. “In contrast, our personal essays and ‘more opinionated’ content performs better on social media and email.”</p>
<p>Thanks in part to the blog’s authenticity and open discussions about hard-hitting topics, readers who find the brand through organic search drive the most direct conversions.</p>
<p>Conversations with users interested in the industry or topic your company is involved in don’t always have to come from the company itself. Sometimes a single person can drive authentic, open conversations and create endearing user loyalty and engagement.</p>
<p>For a company that relies on venture capital investments, NASA funding, and public opinion for its financial future, crossing the line between being too self-promotional and isolating users could spell doom. But SpaceX has never shied away from difficult or vulnerable conversations. Instead, the company’s founder, Elon Musk, embraces engaging with users interests in public forums like Twitter and press conferences.</p>
<figure id="figure1" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/08/vulnerability-marketing-fig1.png?w=960" alt="Twitter thread showing an exchange between Elon Musk and a user" class="wp-image-7172044" data-recalc-dims="1" /></figure><p>Musk’s tweets about SpaceX are unwaveringly authentic and transparent. He often tweets about his thoughts, concerns, and the challenges his companies face. Plus, Musk frequently engages with his Twitter followers and provides candid answers to questions many CEOs avoid discussing. This authenticity has earned him a <a href="https://thewire.in/tech/the-new-institution-called-elon-musk">cult-like following</a>.</p>
<figure id="figure2" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/08/vulnerability-marketing-fig2.png?w=960" alt="Elon Musk gives an honest, if not flattering, response on Twitter to a user" class="wp-image-7172045" data-recalc-dims="1" /></figure><p>Musk and SpaceX create conversations that target people’s interests and use vulnerability to equally embrace failure and success. Both the company and its founder give the public and investors an unflinching story of space exploration.</p>
<p>And despite laying off 10 percent of its workforce in January of 2019, SpaceX is flourishing. In May 2019, its <a href="https://www.cnbc.com/2019/05/31/spacex-valuation-33point3-billion-after-starlink-satellites-fundraising.html">valuation had risen to $33.3 billion</a> and reported <a href="https://www.cnbc.com/2019/05/20/spacex-revenue-2-billion-from-rockets-last-year-jefferies-estimate.html">annual revenue exceeded $2 billion</a>. It also earned global media coverage from launching Musk’s Tesla Roadster into space, recently completed a test flight of its Crew Dragon space vehicle, and cemented multiple new payload contracts.</p>
<p>By engaging with users on social media and through standard storytelling mediums, Thinx and SpaceX bolster customer loyalty and brand engagement.</p>
<h3 id="section9">Consideration<a class="subhead-anchor" href="https://alistapart.com#section9">#section9</a></h3>
<p>Modern consumers argue that ignorance is not bliss. When users are considering converting with a brand, <a href="https://sproutsocial.com/insights/guides/2018-bgr-transparency/">86 percent of consumers say transparency is a deciding factor</a>. Transparency remains crucial even after they convert, with 85 percent of users saying they’ll support a transparent brand during a PR crisis.</p>
<p>Your brand must be open, clear, and honest with users; there is no longer another viable option.</p>
<p>So how do you remain transparent while trying to sell someone a product? One solution employed by REI and Everlane is to be openly accountable to your brand and your users via the origin stories and product insights pillars.</p>
<p>REI, a national outdoor equipment retailer, created a <a href="https://www.rei.com/stewardship/outdoor-industry-collaboration">stewardship program</a> that behaves as a multifaceted origin story. The program’s content highlights the company’s history and manufacturing policies, and it lets users dive into the nitty-gritty details about its factories, partnerships, product production methods, manufacturing ethics, and carbon footprint.</p>
<figure id="figure3" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/08/vulnerability-marketing-fig3.png?w=960" alt="Screenshot of the Collaborating for Good website" class="wp-image-7172046" /></figure><p>REI also employs a classic <a href="https://www.portent.com/blog/seo/content-hubs-seo-strategy.htm">content hub strategy</a> to let customers find the program and explore its relevant information. From a single landing page, users can easily find the program through the website’s global navigation and then navigate to every tangential topic the program encompasses.</p>
<p>REI also publishes an annual stewardship report, where users can learn intimate details about how the company makes and spends its money.</p>
<figure id="figure4" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/08/vulnerability-marketing-fig4.png?w=960" alt="Screenshot of REI's stewardship report" class="wp-image-7172047" /></figure><p>Everlane, a clothing company, is equally transparent about its supply chain. The company promotes an insider’s look into its global factories via product insights stories. These glimpses tell the personal narratives of factory employees and owners, and provide insights into the products manufactured and the materials used. Everlane also <a href="https://www.everlane.com/supply-chain">published details</a> of how they comply with the California Transparency in Supply Chains Act to guarantee ethical working conditions throughout its supply chain, including refusing to partner with human traffickers.</p>
<figure id="figure5" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/08/vulnerability-marketing-fig5.png?w=960" alt="Screenshot of Everlane's page about the factory in Lima" class="wp-image-7172048" /></figure><p>The crucial quality that Everlane and REI share is they publicize their transparency and encourage users to explore the shared information. On each website, users can easily find information about the company’s transparency endeavors via the global navigation, social media campaigns, and product pages.</p>
<p>The consumer response to transparent brands like REI and Everlane is overwhelmingly positive. <a href="https://www.environmentalleader.com/2018/12/study-shows-consumers-are-willing-to-pay-a-premium-for-supply-chain-transparency/">Customers are willing to pay price premiums for the additional transparency</a>, which gives them comfort by knowing they’re purchasing ethical products.</p>
<p>REI’s ownership model has further propelled the success of its transparency by using it to create unwavering customer engagement and loyalty. As a co-op where customers can “own” part of the company for a one-time $20 membership fee, REI is beholden to its members, many of which pay close attention to its supply chain and the brands REI partners with.</p>
<p>After a deadly school shooting in Parkland, Florida, REI members urged the company to refuse to carry CamelBak products because the brand’s parent company manufactures assault-style weapons. Members argued the partnership violated REI’s supply chain ethics. <a href="https://www.chicagotribune.com/business/ct-biz-rei-vista-outdoor-20180302-story.html">REI listened and halted orders with CamelBak</a>. Members rejoiced and REI earned a significant amount of positive press coverage.</p>
<h3 id="section10">Conversion<a class="subhead-anchor" href="https://alistapart.com#section10">#section10</a></h3>
<p>Imagine you’ve started incorporating transparency throughout your company, and promote the results to users. Your brand also begins engaging users by telling vulnerable, meaningful stories via the three pillars. You’re seeing great engagement metrics and customer feedback from these efforts, but not much else. So, how do you get your newly invested users to convert?</p>
<p>Provide users with a full-circle experience.</p>
<p>If you combine the three storytelling pillars with blatant transparency and actively promote your efforts, users often transition from the consideration stage into the conversion state. Best of all, when users convert with a company that already earned their trust on an emotional level, <a href="https://link.springer.com/article/10.1057/palgrave.bm.2550080">they’re more likely to remain loyal to the brand</a> and emotionally invested in its future.</p>
<p>The crucial step in combining the three pillars is consistency. Your brand’s stories must always be authentic and your content must always be transparent. The outdoor clothing brand Patagonia is among the most popular and successful companies to maintain this consistency and excel with this strategy.</p>
<p>Patagonia is arguably the most vocal and aggressive clothing retailer when it comes to environmental stewardship and ethical manufacturing.</p>
<p>In some cases, the company tells users <em>not to buy its clothing</em> because rampant consumerism harms the environment too much, which they care about more than profits. This level of radical transparency and vulnerability skyrocketed the company’s popularity among environmentally-conscious consumers.</p>
<p>In 2011, Patagonia took out a <a href="https://www.patagonia.com/blog/2011/11/dont-buy-this-jacket-black-friday-and-the-new-york-times/">full-page Black Friday ad in the New York Times</a> with the headline “Don’t Buy This Jacket.” In the ad, Patagonia talks about the environmental toll manufacturing clothes requires.</p>
<p>“Consider the R2 Jacket shown, one of our best sellers. To make it required 135 liters of water, enough to meet the daily needs (three glasses a day) of 45 people. Its journey from its origin as 60 percent recycled polyester to our Reno warehouse generated nearly 20 pounds of carbon dioxide, 24 times the weight of the finished product. This jacket left behind, on its way to Reno, two-thirds [of] its weight in waste.”</p>
<p>The ad encourages users to not buy any new Patagonia clothing if their old, ratty clothes can be repaired. To help, Patagonia launched a supplementary subdomain to its e-commerce website to support its Common Thread Initiative, which eventually got rebranded as the <a href="https://wornwear.patagonia.com/">Worn Wear program</a>.</p>
<p>Patatgonia’s Worn Wear subdomain gets users to engage with the company about causes each party cares about. Through Worn Wear, Patagonia will repair your old gear for free. If you’d rather have new gear, you can instead sell the worn out clothing to Patagonia, and they’ll repair it and then resell the product at a discount. This interaction encourages loyalty and repeat brand-user engagement.</p>
<p>In addition, the navigation on Patagonia’s main website practically begs users to learn about the brand’s non-profit initiatives and its commitment to ethical manufacturing.</p>
<figure id="figure6" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/08/vulnerability-marketing-fig6.png?w=960" alt="Screenshot of Patagonia's page on environmental responsibility" class="wp-image-7172049" /></figure><p>Today, <a href="https://crm.org/articles/patagonias-customer-base-and-the-rise-of-an-environmental-ethos">Patagonia is among the most respected, profitable, and trusted consumer brands</a> in the United States.</p>
<h3 id="section11">Retention<a class="subhead-anchor" href="https://alistapart.com#section11">#section11</a></h3>
<p>Content strategy expands through nearly every aspect of the marketing stack, including ad campaigns, which take a more controlled approach to vulnerability and transparency. To target users in the retention stage and keep them invested in your brand, your goal is to create content using the customers’ life experiences pillar to amplify the emotional bond and brand loyalty that vulnerability creates.</p>
<p>Always took this approach and ended up with one of its most successful social media campaigns.</p>
<figure id="figure7" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/08/vulnerability-marketing-fig7.png?w=960" alt="An Always ad portraying a determined girl holding a baseball" class="wp-image-7172050" data-recalc-dims="1" /></figure><p>In June 2014, Always launched its #LikeAGirl campaign to empower adolescent and teenage girls by transforming the phrase “like a girl” from a slur into a meaningful and positive statement.</p>
<p>The campaign is centered on a video in which Always tasked children, teenagers, and adults to behave “like a girl” by running, punching, and throwing while mimicking their perception of how a girl performs the activity. Young girls performed the tasks wholeheartedly and with gusto, while boys and adults performed overly feminine and vain characterizations. The director then challenged the person on their portrayal, breaking down what doing things “like a girl” truly means. The video ends with a powerful, heart-swelling statement:</p>
<figure id="figure8" class="quote"><blockquote>
<p>“If somebody else says that running like a girl, or kicking like a girl, or shooting like a girl is something you shouldn’t be doing, that’s their problem. Because if you’re still scoring, and you’re still getting to the ball in time, and you’re still being first…you’re doing it right. It doesn’t matter what they say.”</p>
</blockquote>
</figure><p>This customer story campaign put the vulnerability girls feel during puberty front and center so the topic would resonate with users and give the brand a powerful, relevant, and purposeful role in this connection, <a href="https://instituteforpr.org/wp-content/uploads/Always-LikeAGirl-Turning-an-Insult-into-a-Confidence-Movement.pdf">according to an Institute for Public Relations campaign analysis</a>.</p>
<p>Consequently, the #LikeAGirl campaign was a rousing success and blew past the KPIs Always established. Initially, Always determined an “impactful launch” for the video meant 2 million video views and 250 million media impressions, the analysis states.</p>
<p>Five years later, the campaign video has more than 66.9 million views and 42,700 comments on YouTube, with more than 85 percent of users reacting positively. Here are a few additional highlights the analysis document points out:</p>
<ul><li>Eighty-one percent of women ages 16–24 support Always in creating a movement to reclaim “like a girl” as a positive and inspiring statement.</li>
<li>More than 1 million people shared the video.</li>
<li>Thirteen percent of users created user-generated content about the campaign.</li>
<li>The #LikeAGirl program achieved 4.5 billion global impressions.</li>
<li>The campaign received 290 million social impressions, with 133,000 social mentions, and it caused a 195.3 percent increase in the brand’s Twitter followers.</li>
</ul><p>Among the reasons the #LikeAGirl content was so successful is that it aligned with Brené Brown’s concept that experiencing vulnerability creates a connection centered on powerful, shared emotions. Always then amplified the campaign’s effectiveness by using those emotions to encourage specific user behavior on social media.</p>
<h2 id="section12">How do you know if you’re making vulnerable content?<a class="subhead-anchor" href="https://alistapart.com#section12">#section12</a></h2>
<p>Designing a vulnerability-focused content strategy campaign begins by determining what kind of story you want to tell, why you want to tell it, why that story matters, and how that story helps you or your users achieve a goal.</p>
<p>When you’re brainstorming topics, the most important factor is that you need to care about the stories you’re telling. These tales need to be meaningful because if you’re weaving a narrative that isn’t important to you, it shows. And ultimately, why do you expect your users to care about a subject if you don’t?</p>
<p>Let’s say you’re developing a content campaign for a nonprofit, and you want to use your brand’s emotional identity to connect with users. You have a handful of possible narratives but you’re not sure which one will best unlock the benefits of vulnerability. In a Medium post about <a href="https://medium.com/@caylavidmar/your-story-matters-3-powerful-brands-that-do-vulnerability-right-a3360694ffa7">telling vulnerable stories</a>, Cayla Vidmar presents a list of seven self-reflective questions that can reveal what narrative to choose and why.</p>
<p>If you can answer each of Vidmar’s questions, you’re on your way to creating a great story that can connect with users on a level unrivaled by other methods. Here’s what you should ask yourself:</p>
<ul><li>What meaning is there in my story?</li>
<li>Can my story help others?</li>
<li>How can it help others?</li>
<li>Am I willing to struggle and be vulnerable in that struggle (even with strangers)?</li>
<li>How has my story shaped my worldview (what has it made me believe)?</li>
<li>What good have I learned from my story?</li>
<li>If other people discovered this good from their story, would it change their lives?</li>
</ul><p>While you’re creating narratives within the three pillars, refer back to Vidmar’s list to maintain the proper balance between vulnerability and transparency.</p>
<h2 id="section13">What’s next?<a class="subhead-anchor" href="https://alistapart.com#section13">#section13</a></h2>
<p>You now know that vulnerability and transparency are an endless fountain of strength, not a weakness. Vulnerable content won’t make you or your brand look weak. Your customers won’t flee at the sight of imperfection. Being human and treating your users like humans isn’t a liability.</p>
<p>It’s time for your brand to embrace its untapped potential. Choose to be vulnerable, have the courage to tell meaningful stories about what matters most to your company and your customers, and overcome the fear of controlling how users will react to your content.</p>
<p><strong>Origin story</strong></p>
<p>Every origin story has six chapters:</p>
<ul><li>the discovery of a problem or opportunity;</li>
<li>what caused this problem or opportunity;</li>
<li>the consequences of this discovery;</li>
<li>the solution to these consequences;</li>
<li>lessons learned during the process;</li>
<li>and next steps.</li>
</ul><p><strong>Customers’ life experiences</strong></p>
<p>Every customer journey narrative has six chapters:</p>
<ul><li>plot background to frame the customer’s experiences;</li>
<li>the customer’s journey;</li>
<li>how the brand plays into that journey (if applicable);</li>
<li>how the customer’s experiences changed them;</li>
<li>what the customer learned from this journey;</li>
<li>and how other people can use this information to improve their lives.</li>
</ul><p><strong>Product and service insights</strong></p>
<p>Narratives about product and service insights have seven chapters:</p>
<ul><li>an overview of the product/service;</li>
<li>how that product/service affects users;</li>
<li>why the product/service is important to the brand’s mission or to users;</li>
<li>what about this product/service failed or succeeded;</li>
<li>why did that success or failure happen;</li>
<li>what lessons did this scenario create;</li>
<li>and how are the brand and its users moving forward.</li>
</ul><p>You have the tools and knowledge necessary to be transparent, create vulnerable content, and succeed. And we need to tell vulnerable stories because sharing our experiences and embracing our common connections matters. So go ahead, put yourself out into the open, and see how your customers respond.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Even if you’re not looking for a job, Jessica Ivins shares a great way to jump start your résumé and portfolio right now.</div><div class="entry-content">The tech world has a major diversity problem. accessible developers may be an unexpected part of the solution.</div><div class="entry-content">You’ve “moved fast and broken things.” Here’s some helpful advice from Jeremy Wagner to fix them responsibly.</div><div class="entry-content">A key aspect of being a manager is helping your reports succeed. Lara Hogan shares how in this excerpt from Resilient Management.</div><div class="entry-content">Suddenly, I realized that the people next to me might be severely impacted by my work. I was having a quick lunch in the airport...</div>]]></description>
      <link>https://alistapart.com/article/the-untapped-power-of-vulnerability-transparency-in-content-strategy/</link>
      <guid>https://alistapart.com/article/the-untapped-power-of-vulnerability-transparency-in-content-strategy/</guid>
      <pubDate>Thu, 22 Aug 2019 15:30:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[An Essential Tool for Capturing Your Career Accomplishments]]></title>
      <description><![CDATA[<div class="entry-content">
<p>Imagine you’re ready to apply for your next job. Like most busy professionals, you probably haven’t updated your résumé or your portfolio since you looked for your current job. </p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>Now you need to update both, and you can’t remember what work you’ve done over the past few years. (In fact, you can barely remember what you’ve done over the past few months!)</p>
<p>So you scramble to update your résumé with new content. Then you spend all weekend scraping together a new portfolio using screenshots of whatever work evidence you can find on your laptop. You submit the résumé and portfolio with your application, hoping you didn’t forget to include any major career milestones you achieved over the last few years. </p>
<p>This is the process most of us use to approach our job search. We wait until we’re ready to find a job, panic at our lack of résumé and portfolio, and pull together a “good enough” version of each for the job application. (Trust me, I’ve done this many times myself.)</p>
<p>This is a stressful and ineffective way to approach a job search. There’s a much better approach you can take—and you can start working on it now, even if you’re not on the job market.</p>
<h2 id="section2"><strong>The Career Management Document</strong><a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>A Career Management Document (CMD) is a comprehensive collection of your résumé and portfolio content. It’s a document you update regularly, over time, with all the work you’ve done. </p>
<p>When you’re ready to apply for your next job, you’ll have all the résumé and portfolio pieces available in your CMD. All you need to do is assemble those pieces into résumé and portfolio documents, then send the documents off with your job application.</p>
<p>I update my CMD about once a week. I start by reviewing evidence of my recent work. I review Slack messages, Basecamp posts, emails, and any other current work-related content. I write my accomplishments in the format of résumé bullets, using the <a href="https://www.manager-tools.com/2005/10/your-resume-stinks">framework of responsibilities and accomplishments from this Manager Tools podcast</a>. Then I add those bullets to the CMD. </p>
<p>Here are some examples from my CMD:</p>
<ul><li>Coached a student on writing a stronger portfolio story to showcase their advanced UX skills, resulting in the student getting a job interview.</li>
<li>Facilitated an end-of-study analysis in under 90 minutes to help the team synthesize user research data from 12 participants.</li>
<li>Led a remote retrospective with teams in two offices, developed actionable takeaways, and ended on time despite a delayed start.</li>
</ul><p>My CMD has several hundred résumé bullets, and it continues to grow. I organize content by year and by project. Within each project are responsibilities and accomplishments.</p>
<p>I add any content to the CMD that might go into my résumé someday. I include everything I can think of, even if it seems insignificant or trivial at the time. </p>
<p>For example, I sometimes help with social media marketing at Center Centre, the UX design school where I’m a faculty member. I include it in my CMD. I don’t plan to pursue social media marketing as a career, but it may be relevant to a future job. Who knows—I may apply to work for an organization that makes social media marketing software someday. In that case, my social media experience could be relevant.</p>
<h2 id="section3"><strong>Include portfolio artifacts with your CMD</strong><a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h2>
<p>In addition to capturing bullets for my résumé, I capture content for my portfolio. Each week, I gather screenshots of my work, photos of me working with the team, and any other artifacts I can find. I store them in an organized system I can reference later. </p>
<p>I also take brief notes about the work I did and store them with the artifacts. That way, if I look back at these materials a year from now, I’ll have notes about what I did during the project, reminding me of the details.</p>
<p>For example, after I facilitated a user research analysis session late last year, I captured evidence of it for my portfolio. I included photos of the whiteboard where I recorded public notes during the session. I also captured brief notes about who attended the session, the date, and when it took place during the project. </p>
<p>You can use whatever tools you’d like to gather evidence of your work. I use Google Docs for the résumé portion of my CMD. I use Dropbox to store my portfolio artifacts. I create Dropbox folders with dates and project names that correspond to the contents of my CMD.</p>
<figure id="figure1" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/08/cmd-screenshot-1.jpg" alt="" class="wp-image-7171743" /><figcaption><br />
Résumé content from my CMD. I wrote about coaching a student on crafting a presentation for her job interview. The highlighted areas are where I left comments reminding me of the details of the work. Note that some of the résumé bullets seem redundant, which is OK. When I create my next résumé, I’ll choose the most appropriate bullets.</figcaption></figure><figure id="figure2" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/08/cmd-screenshot-2.jpg" alt="" class="wp-image-7171744" /><figcaption><br />
I took notes on a whiteboard while coaching the student. I stored a photo of the whiteboard in Dropbox in a folder named with the date of the work and a description of what I did.</figcaption></figure><p>The key is to collect the evidence regularly and store it in an accessible, organized way that works for you. To know if you’re storing work evidence effectively, ask yourself, “Will I understand this CMD content a year from now based on how I’m capturing and storing it today?” If the answer is “yes,” you’re in good shape.</p>
<h2 id="section4"><strong>Update your CMD regularly</strong><a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h2>
<p>For the CMD to work when you need it, it needs to be comprehensive and up-to-date. As I mentioned before, I update my CMD once a week. I schedule thirty minutes on my calendar each week so I remember to do it. </p>
<p>Sometimes I have a busy week, and I can’t spend thirty minutes on my CMD. So I spend whatever amount of time I have. Some weeks, I only spend ten minutes. Ten minutes per week is better than zero minutes per week. </p>
<p>Occasionally, I don’t get a chance to update it because my week is so hectic. That’s OK because I’ll probably get to it the following week. </p>
<p>I recommend updating your CMD once a week and not once a month or once a quarter. If you wait even a month, you’ll have trouble remembering what you did three and a half weeks ago. Even worse, if you schedule a CMD update once a month and then miss it, you won’t get to it until the next month. That means you have to think back and remember two months of work, which is hard to do. </p>
<p>Updating your CMD every week, while the work is fresh in your mind, gets the best results.</p>
<h2 id="section5"><strong>The CMD benefits you in additional ways</strong><a class="subhead-anchor" href="https://alistapart.com#section5">#section5</a></h2>
<p>The CMD can help you prepare for your job search beyond your résumé and your portfolio. </p>
<p>You can use it to prepare for a job interview. Since you’re capturing work evidence from each stage of the process in your CMD, you can use that evidence to remember what you did throughout a project. Then, you can craft a story about your role on that project. </p>
<p>Hiring managers love to hear stories about your work during job interviews. For instance, if you’re a designer, they want to know the journey you took during your design process, from the start of a project to the end. A detailed CMD will help you remember this process so you can share it in an interview. </p>
<p>I’ve even used my CMD to write blog posts. I’ve been blogging regularly for the past two years, and I often refer to my CMD to remember work experience I had that’s relevant to what I’m writing. When I wrote the article “<a href="https://uxdesign.cc/how-to-tell-compelling-stories-during-a-ux-job-interview-ef5350ff83e7">How to Tell Compelling Stories During a UX Job Interview</a>,” I used my CMD to remember interview preparation exercises I did with students. </p>
<p>The CMD can also help you track work accomplishments for your quarterly or annual performance reviews. Additionally, you can use it to write job ads when hiring for related roles on your team.</p>
<p>Lastly, I find it rewarding to peruse my CMD now and then, especially when I look back at work I did over a year ago. The CMD serves as a record of all my professional accomplishments. This record helps me appreciate my professional growth because I see how far my skills have come over time.</p>
<h2 id="section6"><strong>Learn more about the CMD from Manager Tools</strong><a class="subhead-anchor" href="https://alistapart.com#section6">#section6</a></h2>
<p>At Center Centre, we originally learned about the Career Management Document through the <a href="https://www.manager-tools.com/">Manager Tools podcast series</a>.</p>
<p>Manager Tools’ podcasts explain how to use a CMD for your résumé. We expanded their approach to include portfolio work as well. I recommend listening to their podcasts about creating and maintaining your CMD:</p>
<ul><li><a href="https://www.manager-tools.com/2010/06/systematic-career-documentation-part-1-hall-fame-guidance">Systematic Career Documentation (Part 1)</a></li>
<li><a href="https://www.manager-tools.com/2010/06/systematic-career-documentation-part-2-hall-fame-guidance">Systematic Career Documentation (Part 2)</a></li>
</ul><h2 id="section7"><strong>Prepare for your next job search now</strong><a class="subhead-anchor" href="https://alistapart.com#section7">#section7</a></h2>
<p>We tell our students at Center Centre that preparing for your next job search is a process that starts early. It’s like saving for retirement—the sooner you start saving money, the more likely you are to be prepared when the time comes. </p>
<p>Similarly, collecting résumé and portfolio content ahead of time will prepare you to find your next job whenever you’re ready to do so. It also prepares you for a sudden job termination like an unexpected layoff. If you lose your job without warning, you’ll likely be under a lot of stress to find a new position. Having a CMD ready will relieve the additional stress of building a résumé and portfolio from scratch. </p>
<p>If you don’t have a CMD yet, now is a great time to start one. Schedule 30 minutes this week to begin crafting your repository of work accomplishments. You’ll be glad you did when you seek your next job.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">The tech world has a major diversity problem. accessible developers may be an unexpected part of the solution.</div><div class="entry-content">You’ve “moved fast and broken things.” Here’s some helpful advice from Jeremy Wagner to fix them responsibly.</div><div class="entry-content">A key aspect of being a manager is helping your reports succeed. Lara Hogan shares how in this excerpt from Resilient Management.</div><div class="entry-content">Suddenly, I realized that the people next to me might be severely impacted by my work. I was having a quick lunch in the airport...</div><div class="entry-content">Retraining narrow assumptions about users' gender identities is a step toward greater safety, privacy, and validation for everyone.</div>]]></description>
      <link>https://alistapart.com/article/the-career-management-document/</link>
      <guid>https://alistapart.com/article/the-career-management-document/</guid>
      <pubDate>Thu, 08 Aug 2019 01:08:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Getting to the Heart of Digital Accessibility]]></title>
      <description><![CDATA[<div class="entry-content">
<p>Quick! Think of the word “developer” or “coder” — what’s the first thing that comes to mind? Maybe a whiteish male in his twenties living in a busy metropolis, wearing a nerdy t-shirt and hoodie? Someone a bit like Mark Zuckerberg? Or maybe a younger Bill Gates or Sergey Brin? Any of the dudes from the HBO series <em>Silicon Valley</em>, perhaps? Certainly no one like me.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>By tech standards, I’m old. I’m also female <em>and</em> a mother. I live in a midwestern town you’ve never heard of and will never visit — a town where the cows vastly outnumber the people. My hair color is (almost) natural and is no longer part of the ROYGBIV collection, so I have no perceived conference street cred. I own about a thousand geeky T-shirts, but never actually wear them in public, opting for more “girly” attire (or so was pointed out by a male colleague). On the surface, I look more suited to taking notes at a PTA meeting than writing code. I’m a bit of an outsider. A tech misfit.</p>
<p>So when my 11-year-old daughter finished her recent coding camp and excitedly declared, “Now I’m a real developer, Mom, just like you!” there was the usual parent pride, but also a small piece of me that cringed. Because, as much as I support the STEM fields, and want the next generation of girls to be coding wizard-unicorn-ninjas, I really don’t want my own daughter to be a developer. The rationale behind this bold (and maybe controversial) statement comes from a place of protection. The tech world we live in today is far from perfect. I’ve endured my share of misogyny, self-doubt, and sexual harassment. Why wouldn’t I want to protect her from all of that?</p>
<h2 id="section1">The (diversity) elephant in the (computer) room<a class="subhead-anchor" href="https://alistapart.com#section1">#section1</a></h2>
<p>You’ve heard this story before: there is not enough diversity in tech. This puzzling trend seems to continue year after year, even though numerous studies show that by including more people from underrepresented communities, a company can increase its <a href="https://www.fastcompany.com/40515712/want-a-more-innovative-company-simple-hire-a-more-diverse-workforce">innovation</a>, <a href="https://devskiller.com/diversity-in-tech/">employee retention</a>, and <a href="https://www.forbes.com/sites/annapowers/2018/06/27/a-study-finds-that-diverse-companies-produce-19-more-revenue/">bottom line</a>. Even with the recent push and supposed support for diversity and inclusivity from many Fortune 500 companies, women and female-identifying people still only hold <a href="https://smallbiztrends.com/2018/03/women-in-technology-statistics.html">20% of all top tech jobs</a>.</p>
<p>The data from FY 2018 shows that the number of women in technical roles at three of the top tech giants was <a href="https://www.adobe.com/diversity/data.html">24% for Adobe</a>, <a href="https://diversity.google/annual-report/">26% for Google</a>, and <a href="https://newsroom.fb.com/news/2018/07/diversity-report/">22% for Facebook</a>. While these numbers show that there is still not enough representation for women, these numbers do reflect a slight increase from the previous year (FY 2017: Adobe 22%, Google 25%, Facebook 15%). But even with this upward trend of hiring women in tech roles, the marginal growth rate has not caught up with the real world. The tech workforce is seriously out of touch with reality if, in 2019, a demographic (women) that represents more than half the global population is still considered a minority.</p>
<p>Sometimes this lack of diversity at the top level is blamed on a “pipeline” issue. The logic being: “If there are not enough girls who learn to code, then there will not be enough women who can code.” However, programs aimed at <a href="https://girlswhocode.com/">teaching girls how to code</a> have skyrocketed in the past few years. Girls now make up about <a href="https://csedu.gallup.com/home.aspx">half of the enrollment</a> in high-school coding classes and are scoring almost identically to their male classmates on standardized math and science tests, yet, young women make up only <a href="https://ngcproject.org/statistics">18% of all Computer Science degrees</a>. I have to wonder if this steep drop in interest has more to do with lack of representation in the tech sphere, than with girls and young women simply not being “smart enough” or “not interested” in working with code? At the very least, the lack of representation certainly doesn’t help.</p>
<p>Of course, the diversity picture becomes even more abysmal when you consider other underrepresented groups such as people of color, people from the LGBTQ community, and people with disabilities. And while I really don’t like glossing over these deeper diversity issues in tech, because they are abundant and are much more grotesque failings than the male/female ratio, I also don’t feel qualified to speak about these issues. I encourage you to look to and value the voices of others who can speak with higher authority on these deeper diversity issues, such as <a href="https://twitter.com/ireaderinokun">Ire Aderinokun</a>, <a href="https://twitter.com/TaelurAlexis">Taelur Alexis</a>, <a href="https://twitter.com/Imani_Barbarin">Imani Barbarin</a>, <a href="https://twitter.com/techgirl1908">Angie Jones</a>, <a href="https://twitter.com/sugaroverflow">Fatima Khalid</a>, <a href="https://twitter.com/TatianaTMac">Tatiana Mac</a>, <a href="https://twitter.com/sonniesedge">Charlie Owen</a>, <a href="https://twitter.com/cherryrae">Cherry Rae</a>, and so many others. And for those readers who are new to the topic of diversity in tech, watch Tatiana Mac’s recent conference talk <a href="https://youtu.be/nQq_gZiZ-jg">How Privilege Defines Performance</a> — it’s well worth the 35 minutes of your life.</p>
<h2 id="section2">The four stages in the digital accessibility journey<a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>However you look at it, the numbers don’t lie. There are some pretty significant diversity issues in tech. So how do we fix this issue before the next wave of young developers join the tech workforce? Simple: teach developers to write accessible code.</p>
<p>This may seem like a joke to some and stretch to others, but hear me out. When we talk about accessible code, what we are really talking about at its core is inclusiveness. The actual process of writing accessible code involves rules and standards, tests and tools; but inclusive development is more abstract than that. It’s a shift in thinking. And when we rethink our approach to development, we go beyond just the base level of simple code functionality. We instead think, <em>how</em> is this code consumed? How can we make it even more intelligible and easier for people to use? Inclusive development means making something valuable, not just accessible, to as many people as we can.</p>
<p>That line of thinking is a bit abstract, so let’s go through an example. Let’s say you are tasked with updating the color contrast between the text on a webpage or app and the background. What happens at each stage in the accessibility journey?</p>
<p><strong>Stage 1: Awareness</strong> — You are brand new to digital accessibility and are still trying to understand what it is and how you can implement changes in your daily workflow. You may be aware that there is a set of <a href="https://www.w3.org/WAI/WCAG21/quickref/">digital accessibility guidelines</a> that other developers follow, but you are a bit hazy on what it all means in a practical sense.</p>
<p><strong>Stage 2: Knowledge</strong> — You know a bit more about digital accessibility and feel comfortable using a few testing tools, so you run an automated accessibility test on your website and it flags a possible issue with the color contrast. Based on your awareness of the guidelines, you know the <a href="https://contrastchecker.com/">color contrast ratio</a> between the text and the background needs to be a certain number and that you need a tool to test this.</p>
<p><strong>Stage 3: Practice</strong> — Feeling more confident in your knowledge of digital accessibility rules and best practices, you use a <a href="https://developer.paciellogroup.com/resources/contrastanalyser/">tool to measure the color contrast ratio</a> between the text and the background. Then based on the output of the tool, you modify the hex code to meet the color contrast ratio guidelines and retest to confirm you have met the accessibility requirements for this issue.</p>
<p><strong>Stage 4: Understanding</strong> — You understand that the accessibility guidelines and tools are created with people in mind, and that code is secondary to all of that. One is the means, and the other is the end. In the color contrast example, you understand that people with low-vision or colorblindness need these color contrast changes in order to actually <em>see</em> the words on your web page.</p>
<p>This is a bit of an oversimplification of the process. But I hope you get the gist — that there are different stages of digital accessibility knowledge and understanding. True beginners may not be to even stage one, but I am finding that group rarer and rarer these days. The word about digital accessibility seems to be out! Which is great; but that’s only the first hurdle. What I’m seeing now is that a lot of people stop at <em>Stage 2: Knowledge</em> or <em>Stage 3: Practice</em> — where you are aware of the digital accessibility guidelines, have some testing tools in your back pocket, and know how to fix some of the issues reported, but haven’t quite connected the dots to the humans they impact.</p>
<p>From the standpoint of getting daily stuff done, stages two and three are okay stopping points. But what happens when the things you need to do are too complex for a quick fix, or you have no buy-in from your peers or management? I feel that once we get to <em>Stage 4: Understanding</em>, and really get <em>why</em> these kinds of changes are needed, people will be more motivated to make those changes regardless of the challenges involved. When you arrive at stage four, you have gone beyond knowing the basic rules, testing, and coding. You recognize that digital accessibility is not just a “nice to have” but a “must have” and it becomes about quality of life for <em>real</em> people. This is digital inclusion. This is something you can’t unsee, you can’t unlearn, and you can’t ignore.</p>
<h2 id="section3">Making digital accessibility a priority — not a requirement<a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h2>
<p>In my role as an accessibility trainer, I like to kick-off each session with the question: “What are you hoping to learn today about digital accessibility?” I ask this question to establish a rapport with the audience and to understand where everyone is in their accessibility journey, but I am also evaluating the level of company and individual buy-in too. There is nothing worse than showing up to teach a group that does not care to be taught. If I hear the words “I am only here because I have to be” — I know it will be an uphill battle to get them anywhere close to <em>Stage 4: Understanding</em>, so I mentally regroup and aim for another stage.</p>
<p>In my experience, when companies and their leaders say “Digital accessibility is a requirement,” nine times out of ten there is a motivating factor behind this sweeping declaration (for example, impending litigation, or at least the fear of it). When changes are framed as mandatory and packaged as directives from on high with little additional context, people can be resistant and will find excuses to fight or challenge the declaration, and any change can become an uphill battle. Calling something “mandatory” only speaks to <em>Stage 1: Awareness</em>.</p>
<p>By swapping out one word from the original declaration and saying “Digital accessibility is a priority,” companies and their leaders have reframed the conversation with their employees. When changes are framed as “working towards a solution” and discussed openly and collaboratively, people feel like they are part of the process and are more open to embracing change. In the long run, embracing change becomes part of a company’s culture and leads to innovation (and, yes, inclusion) on all levels. Calling something a priority speaks to <em>Stage 4: Understanding</em>.</p>
<p>Some of the excuses I often hear from clients for not prioritizing accessibility is that it is too difficult, too costly, and/or too time consuming — but is that really the case? In the same accessibility training, I lead an exercise where we look at a website with an accessibility testing tool and review any issues that came up. With the group’s help we plot out the “impact to user” versus the “remediation effort” on the part of the team. From group to group, while the plots are slightly different, one commonality is that close to 80% of the errors plotted fall into the quadrant of “simple to fix” for the team, but they also fall under “high impact” to the user. Based on this empirical data, I won’t buy the argument from clients who say that accessibility is too difficult and costly and time consuming anymore. It comes down to whether it’s a priority — for each individual and for the company as a whole.</p>
<h2 id="section4">What will your coding legacy be?<a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h2>
<p>The <a href="https://en.wikipedia.org/wiki/Infinite_monkey_theorem"><em>infinite monkey theorem</em></a> states that a monkey hitting keys at random on a typewriter for an infinite amount of time will eventually type any given text, such as the complete works of William Shakespeare. So by that same logic, a programmer hitting keys at random on a computer for an infinite amount of time will almost surely produce a website that is accessible. But where is the thought process? Where is the human element? While all the things we’ve already talked about — awareness, education, and prioritization of accessibility are important steps in making the digital world more inclusive to all — without <em>intent,</em> we are just going to keep randomly tapping away at our computers, repeating the same mistakes over and over again. The intent behind the code has to be part of the process, otherwise accessibility is just another task that has no meaning.</p>
<p>Maybe I’m naive, but I’d like to think we’ve come to a point in our society where we want our work lives to have meaning. And that we don’t want to just hear about the positive change that is happening, but want to be part of the change. Digital accessibility is a place where this can happen! Not only does understanding and writing purpose-driven code help people with disabilities in the short-run, I believe strongly that is key to solving the overarching diversity issue in tech in the long-run. Developers who reach <em>Stage 4: Understanding</em>, and who prioritize accessible code because they understand it’s fundamentally about <em>people</em>, will also be the ones who help create and cultivate an inclusive environment where people from more diverse backgrounds are also prioritized and accepted in the tech world.</p>
<p>Because when you strip away all the styles, all the mark-up, all the cool features from a website or app — what’s left? People. And honestly, the more I learn about digital accessibility, the more I realize it’s not about the code at all. Digital accessibility is rooted in the user; and, while I (<a href="https://a11yproject.com/follow/">and countless others</a>) can certainly teach you how to write accessible code, and build you tools, patterns, and libraries to use, I realize we can’t teach you to care. That is a choice you have to make yourself. So think for a moment — what are you leaving the next generation of developers with all that inaccessible code you haven’t given much thought to? Is it the coding legacy you really want to leave? I challenge you to do better for my daughter, her peers, and for the countless others who are not fully represented in the tech community today.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">You’ve “moved fast and broken things.” Here’s some helpful advice from Jeremy Wagner to fix them responsibly.</div><div class="entry-content">A key aspect of being a manager is helping your reports succeed. Lara Hogan shares how in this excerpt from Resilient Management.</div><div class="entry-content">Suddenly, I realized that the people next to me might be severely impacted by my work. I was having a quick lunch in the airport...</div><div class="entry-content">Retraining narrow assumptions about users' gender identities is a step toward greater safety, privacy, and validation for everyone.</div><div class="entry-content">In this excerpt from Everyday Information Architecture, Lisa Maria Martin introduces the structural audit.</div>]]></description>
      <link>https://alistapart.com/article/getting-to-the-heart-of-digital-accessibility/</link>
      <guid>https://alistapart.com/article/getting-to-the-heart-of-digital-accessibility/</guid>
      <pubDate>Thu, 01 Aug 2019 01:08:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Responsible JavaScript: Part II]]></title>
      <description><![CDATA[<div class="entry-content">
<p>You and the rest of the dev team lobbied enthusiastically for a total re-architecture of the company’s aging website. Your pleas were heard by management—even up to the C-suite—who gave the green light. Elated, you and the team started working with the design, copy, and IA teams. Before long, you were banging out new code.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>It started out innocently enough with an <code>npm install</code> here and an <code>npm install</code> there. Before you knew it, though, you were installing production dependencies like an undergrad doing keg stands without a care for the morning after.</p>
<p>Then you launched.</p>
<p>Unlike the aftermath of most copious boozings, the agony didn’t start the morning after. <em>Oh</em>, no. It came months later in the ghastly form of low-grade nausea and headache of product owners and middle management wondering why conversions and revenue were both down since the launch. It then hit a fever pitch when the CTO came back from a weekend at the cabin and wondered why the site loaded so slowly on their phone—if it indeed ever loaded at all.</p>
<p>Everyone was happy. Now <em>no</em> one is happy. Welcome to your first JavaScript hangover.</p>
<h2 id="section1">It’s not your fault<a class="subhead-anchor" href="https://alistapart.com#section1">#section1</a></h2>
<p>When you’re grappling with a vicious hangover, “I told you so” would be a well-deserved, if fight-provoking, rebuke—assuming you could even fight in so sorry a state.</p>
<p>When it comes to JavaScript hangovers, there’s plenty of blame to dole out. Pointing fingers is a waste of time, though. The landscape of the web today demands that we iterate faster than our competitors. This kind of pressure means we’re likely to take advantage of any means available to be as productive as possible. <em>That</em> means we’re more likely—but not necessarily doomed—to build apps with more overhead, and possibly use patterns that can hurt performance and accessibility.</p>
<p>Web development isn’t easy. It’s a long slog we rarely get right on the first try. The best part of working on the web, however, is that we don’t <em>have</em> to get it perfect at the start. We can make improvements after the fact, and that’s just what the second installment of <a href="https://alistapart.com/article/responsible-javascript-part-1/">this series</a> is here for. Perfection is a long ways off. For now, let’s take the edge off of that JavaScript hangover by improving your site’s, er, <em>scriptuation</em> in the short term.</p>
<h2 id="section2">Round up the usual suspects<a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>It might seem rote, but it’s worth going through the list of basic optimizations. It’s not uncommon for large development teams—particularly those that work across many repositories or don’t use optimized boilerplate—to overlook them.</p>
<h3 id="section3">Shake those trees<a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h3>
<p>First, make sure your toolchain is configured to perform <a href="https://developer.mozilla.org/en-US/docs/Glossary/Tree_shaking"><em>tree shaking</em></a>. If tree shaking is new to you, I wrote <a href="https://developers.google.com/web/fundamentals/performance/optimizing-javascript/tree-shaking/">a guide on it last year</a> you can consult. The short of it is that tree shaking is a process in which unused exports in your codebase don’t get packaged up in your production bundles.</p>
<p>Tree shaking is available out of the box with modern bundlers such as <a href="https://webpack.js.org/">webpack</a>, <a href="https://rollupjs.org/">Rollup</a>, or <a href="https://parceljs.org/">Parcel</a>. <a href="https://gruntjs.com/">Grunt</a> or <a href="https://gulpjs.com/">gulp</a>—which are not <em>bundlers</em>, but rather <em>task runners</em>—won’t do this for you. A task runner doesn’t build a <a href="https://webpack.js.org/concepts/dependency-graph/">dependency graph</a> like a bundler does. Rather, they perform discrete tasks on the files you feed to them with any number of plugins. Task runners <em>can</em> be extended with plugins to use bundlers to process JavaScript. If extending task runners in this way is problematic for you, you’ll likely need to manually audit and remove unused code.</p>
<p>For tree shaking to be effective, the following must be true:</p>
<ol><li>Your app logic and the packages you install in your project must be authored as <a href="https://ponyfoo.com/articles/es6-modules-in-depth">ES6 modules</a>. Tree shaking <a href="https://en.wikipedia.org/wiki/CommonJS">CommonJS</a> modules isn’t practically possible.</li>
<li>Your bundler must <em>not</em> transform ES6 modules into another module format at build time. If this happens in a toolchain that uses Babel, <a href="https://babeljs.io/docs/en/babel-preset-env">@babel/preset-env configuration</a> must specify <a href="https://babeljs.io/docs/en/babel-preset-env#modules"><code>modules: false</code></a> to prevent ES6 code from being converted to CommonJS.</li>
</ol><p>On the off chance tree shaking isn’t occurring during your build, getting it to work may help. Of course, its effectiveness varies on a case-by-case basis. It also depends on whether the modules you import introduce <a href="https://en.wikipedia.org/wiki/Side_effect_(computer_science)">side effects</a>, which may influence a bundler’s ability to shake unused exports.</p>
<h3 id="section4">Split that code<a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h3>
<p>Chances are good that you’re employing some form of <a href="https://developers.google.com/web/fundamentals/performance/optimizing-javascript/code-splitting/">code splitting</a>, but it’s worth re-evaluating how you’re doing it. No matter <em>how</em> you’re splitting code, there are two questions that are always worth asking yourself:</p>
<ol><li>Are you <a href="https://developers.google.com/web/fundamentals/performance/optimizing-javascript/code-splitting/#removing_duplicate_code">deduplicating common code</a> between <a href="https://webpack.js.org/concepts/entry-points/">entry points</a>?</li>
<li>Are you lazy loading all the functionality you reasonably can with <a href="https://developers.google.com/web/updates/2017/11/dynamic-import">dynamic <code>import()</code></a>?</li>
</ol><p>These are important because reducing redundant code is essential to performance. Lazy loading functionality also improves performance by lowering the initial JavaScript footprint on a given page. On the redundancy front, using an analysis tool such as <a href="https://github.com/samccone/bundle-buddy">Bundle Buddy</a> can help you find out if you have a problem.</p>
<figure id="figure1" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/06/figure-6-2x.png?w=435" alt="The Bundle Buddy utility demonstrating how much code is shared between bundles of JavaScript." class="wp-image-7171674" /><figcaption>Bundle Buddy can examine your webpack compilation statistics and determine how much code is shared between your bundles.</figcaption></figure><p>Where lazy loading is concerned, it can be a bit difficult to know where to start looking for opportunities. When I look for opportunities in existing projects, I’ll search for user interaction points throughout the codebase, such as click and keyboard events, and similar candidates. Any code that requires a user interaction to run is a potentially good candidate for dynamic <code>import()</code>.</p>
<p>Of course, loading scripts on demand brings the possibility that interactivity could be noticeably delayed, as the script necessary for the interaction must be downloaded first. If data usage is not a concern, consider using the <a href="https://www.w3.org/TR/resource-hints/#prefetch"><code>rel=prefetch</code> resource hint</a> to load such scripts at a low priority that won’t contend for bandwidth against critical resources. <a href="https://caniuse.com/#feat=link-rel-prefetch">Support for<code>rel=prefetch</code></a> is good, but nothing will break if it’s unsupported, as such browsers will ignore markup they doesn’t understand.</p>
<h3 id="section5">Externalize third-party hosted code<a class="subhead-anchor" href="https://alistapart.com#section5">#section5</a></h3>
<p>Ideally, you should self-host as many of your site’s dependencies as possible. If for some reason you <em>must</em> load dependencies from a third party, <a href="https://webpack.js.org/configuration/externals/">mark them as externals</a> in your bundler’s configuration. Failing to do so could mean your website’s visitors will download both locally hosted code <em>and</em> the same code from a third party.</p>
<p>Let’s look at a hypothetical situation where this could hurt you: say that your site loads Lodash from a public CDN. You’ve also installed Lodash in your project for local development. However, if you fail to mark Lodash as external, your production code will end up loading a third party copy of it <em>in addition</em> to the bundled, locally hosted copy.</p>
<p>This may <em>seem</em> like common knowledge if you know your way around bundlers, but I’ve seen it get overlooked. It’s worth your time to check twice.</p>
<p>If you aren’t convinced to self-host your third-party dependencies, then consider adding <a href="https://css-tricks.com/prefetching-preloading-prebrowsing/#article-header-id-0"><code>dns-prefetch</code></a>, <a href="https://css-tricks.com/prefetching-preloading-prebrowsing/#article-header-id-1"><code>preconnect</code></a>, or possibly even <a href="https://www.smashingmagazine.com/2016/02/preload-what-is-it-good-for/"><code>preload</code></a> hints for them. Doing so can lower your site’s <a href="https://developers.google.com/web/tools/lighthouse/audits/time-to-interactive">Time to Interactive</a> and—if JavaScript is critical to rendering content—your site’s <a href="https://sites.google.com/a/webpagetest.org/docs/using-webpagetest/metrics/speed-index">Speed Index</a>.</p>
<h2 id="section6">Smaller alternatives for less overhead<a class="subhead-anchor" href="https://alistapart.com#section6">#section6</a></h2>
<p><a href="https://nodejs.org/en/knowledge/getting-started/what-is-node-core-verus-userland/">Userland JavaScript</a> is like an obscenely massive candy store, and we as developers are awed by the sheer amount of open source offerings. Frameworks and libraries allow us to extend our applications to quickly do all sorts of stuff that would otherwise take loads of time and effort.</p>
<p>While I personally prefer to aggressively minimize the use of client-side frameworks and libraries in my projects, their value is compelling. Yet, we <em>do</em> have a responsibility to be a bit hawkish when it comes to what we install. When we’ve already built and shipped something that depends on a slew of installed code to run, we’ve accepted a baseline cost that only the maintainers of that code can practically address. Right?</p>
<p>Maybe, but then again, maybe not. It depends on the dependencies we use. For instance, React is extremely popular, but <a href="https://preactjs.com/">Preact</a> is an <a href="https://bundlephobia.com/result?p=preact@8.4.2">ultra-small</a> alternative that largely shares the same API and retains compatibility with many React add-ons. <a href="https://moment.github.io/luxon/">Luxon</a> and <a href="https://date-fns.org/">date-fns</a> are much more compact alternatives to <a href="https://momentjs.com/">moment.js</a>, which is <a href="https://bundlephobia.com/result?p=moment">not exactly tiny</a>.</p>
<p>Libraries such as <a href="https://lodash.com/">Lodash</a> offer many useful methods. Yet, some of them are easily replaceable with native ES6. <a href="https://lodash.com/docs/4.17.11#compact">Lodash’s <code>compact</code> method</a>, for example, is replaceable with the <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter"><code>filter</code> array method</a>. <a href="https://github.com/you-dont-need/You-Dont-Need-Lodash-Underscore#_chunk">Many more can be replaced</a> without much effort, and without the need for pulling in a giant utility library.</p>
<p>Whatever your preferred tools are, the idea is the same: do some research to see if there are smaller alternatives, or if native language features can do the trick. You may be surprised at how little effort it may take you to seriously reduce your app’s overhead.</p>
<h2 id="section7">Differentially serve your scripts<a class="subhead-anchor" href="https://alistapart.com#section7">#section7</a></h2>
<p>There’s a good chance you’re using Babel in your toolchain to transform your ES6 source into code that can run on older browsers. Does this mean we’re doomed to serve giant bundles even to browsers that don’t need them, until the older browsers disappear altogether? <a href="https://philipwalton.com/articles/deploying-es2015-code-in-production-today/">Of course not</a>! Differential serving helps us get around this by generating two different builds of your ES6 source:</p>
<ul><li>Bundle one, which contains all the transforms and polyfills required for your site to work on older browsers. You’re probably already serving this bundle right now.</li>
<li>Bundle two, which contains <em>little to none</em> of the transforms and polyfills because it targets modern browsers. This is the bundle you’re probably not serving—at least not <em>yet</em>.</li>
</ul><p>Achieving this is a bit involved. <a href="https://calendar.perfplanet.com/2018/doing-differential-serving-in-2019/">I’ve written a guide on one way you can do it</a>, so there’s no need for a deep dive here. The long and short of it is that you can modify your build configuration to generate an additional but smaller version of your site’s JavaScript code, and serve it only to modern browsers. The best part is that these are savings you can achieve without sacrificing any features or functionality you already offer. Depending on your application code, the savings could be quite significant.</p>
<figure id="figure2" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/06/diff-serving-bundles.jpg?w=960" alt="" class="wp-image-7171677" /><figcaption>A webpack-bundle-analyzer analysis of a project’s legacy bundle (left) versus one for a modern bundle (right). <a href="https://alistapart.com/wp-content/uploads/2019/06/diff-serving-bundles.jpg" rel="noopener noreferrer" target="_blank">View full-sized image</a>.</figcaption></figure><p>The <a href="https://developers.google.com/web/fundamentals/primers/modules#browser">simplest pattern</a> for serving these bundles to their respective platforms is brief. It also works a treat in modern browsers:</p>
<pre id="snippet1" class="wp-block-code language-html"><code class="language-html">&lt;!-- Modern browsers load this file: --&gt;
&lt;script type="module" src="/js/app.mjs"&gt;&lt;/script&gt;
&lt;!-- Legacy browsers load this file: --&gt;
&lt;script defer nomodule src="/js/app.js"&gt;&lt;/script&gt;</code></pre>
<p>Unfortunately, there’s a caveat with this pattern: legacy browsers like IE 11—and even relatively modern ones such as Edge versions 15 through 18—will download <em>both</em> bundles. If this is an acceptable trade-off for you, then worry no further.</p>
<p>On the other hand, you’ll need a workaround if you’re concerned about <a href="https://gist.github.com/jakub-g/5fc11af85a061ca29cc84892f1059fec">the performance implications of older browsers downloading both sets of bundles</a>. Here’s one potential solution that uses script injection (instead of the <code>script</code> tags above) to avoid double downloads on affected browsers:</p>
<pre id="snippet2" class="wp-block-code language-javascript"><code class="language-javascript">var scriptEl = document.createElement("script");
if ("noModule" in scriptEl) {
  // Set up modern script
  scriptEl.src = "/js/app.mjs";
  scriptEl.type = "module";
} else {
  // Set up legacy script
  scriptEl.src = "/js/app.js";
  scriptEl.defer = true; // type="module" defers by default, so set it here.
}
// Inject!
document.body.appendChild(scriptEl);</code></pre>
<p>This script infers that if a browser supports <a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#attr-nomodule">the <code>nomodule</code> attribute</a> in the script element, it understands <code>type="module"</code>. This ensures that legacy browsers only get legacy scripts and modern browsers only get modern ones. Be warned, though, that dynamically injected scripts load asynchronously by default, so set the <code><a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#attr-async">async</a></code> attribute to <code>false</code> if dependency order is crucial.</p>
<h2 id="section8">Transpile less<a class="subhead-anchor" href="https://alistapart.com#section8">#section8</a></h2>
<p class="c1">I’m not here to trash Babel. It’s indispensable, but lordy, it adds a <em>lot</em> of extra stuff without your ever knowing. It pays to peek under the hood to see what it’s up to. Some minor changes in your coding habits can have a positive impact on what Babel spits out.</p>
<figure id="figure3" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/06/twete.png?w=306" alt="" class="wp-image-7171676" /><figcaption><a href="https://twitter.com/_developit/status/1110229993999777793">https://twitter.com/_developit/status/1110229993999777793</a></figcaption></figure><p>To wit: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions/Default_parameters">default parameters</a> are a <em>very</em> handy ES6 feature you probably already use:</p>
<pre id="snippet3" class="wp-block-code language-javascript"><code class="language-javascript">function logger(message, level = "log") {
  console[level](message);
}</code></pre>
<p>The thing to pay attention to here is the <code>level</code> parameter, which has a default of “log.” This means if we want to invoke <code>console.log</code> with this wrapper function, we don’t need to specify <code>level</code>. Great, right? Except when Babel transforms this function, the output looks like this:</p>
<pre id="snippet4" class="wp-block-code language-javascript"><code class="language-javascript">function logger(message) {
  var level = arguments.length &gt; 1 &amp;&amp; arguments[1] !== undefined ? arguments[1] : "log";
  console[level](message);
}</code></pre>
<p>This is an example of how, despite our best intentions, developer conveniences can backfire. What was a handful of bytes in our source has now been transformed into <em>much</em> larger in our production code. Uglification can’t do much about it either, as arguments can’t be reduced. Oh, and if you think <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions/rest_parameters">rest parameters</a> might be a worthy antidote, Babel’s transforms for them are even bulkier:</p>
<pre id="snippet5" class="wp-block-code language-javascript"><code class="language-javascript">// Source
function logger(...args) {
  const [level, message] = args;
  console[level](message);
}
// Babel output
function logger() {
  for (var _len = arguments.length, args = new Array(_len), _key = 0; _key &lt; _len; _key++) {
    args[_key] = arguments[_key];
  }
  const level = args[0],
        message = args[1];
  console[level](message);
}</code></pre>
<p>Worse yet, Babel transforms this code even for projects with a <a href="https://babeljs.io/docs/en/babel-preset-env">@babel/preset-env</a> configuration <a href="https://babeljs.io/docs/en/babel-preset-env#targetsesmodules">targeting modern browsers</a>, meaning the modern bundles in your differentially served JavaScript will be affected too! You <em>could</em> use <a href="https://babeljs.io/docs/en/babel-preset-env#loose">loose transforms</a> to soften the blow—and that’s a fine idea, as they’re often quite a bit smaller than their more spec-compliant counterparts—<a href="http://2ality.com/2015/12/babel6-loose-mode.html">but enabling loose transforms can cause issues if you remove Babel from your build pipeline later on</a>.</p>
<p>Regardless of whether you decide to enable loose transforms, here’s one way to cut the cruft of transpiled default parameters:</p>
<pre id="snippet6" class="wp-block-code language-javascript">
<code class="language-javascript"><code class="language-javascript">// Babel won't touch this
function logger(message, level) {
  console[level || "log"](message);
}</code></code></pre>
<p>Of course, default parameters aren’t the <em>only</em> feature to be wary of. For example, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Spread_syntax">spread syntax</a> gets transformed, as do <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions/Arrow_functions">arrow functions</a> and a whole host of <a href="https://babeljs.io/repl/#?babili=false&amp;browsers=%3E%200.25%25%2C%20ie%20%3E%2010%2C%20Firefox%20ESR%2C%20not%20dead&amp;build=&amp;builtIns=false&amp;spec=false&amp;loose=false&amp;code_lz=MYGwhgzhAECyYDsCuAzMwAuSBOBTb0A3gFDTTAD2CEG2SmFBAFALaKrpZ7YA05FSBLQCeASiKky0DAAsAlhAB0bZGkw580ALzQVHddwDcksrIWLKgkdv5Xsw42QC-xF8VCQYAYTAFcADwxcBAATGHhVTg0CEjJKalp6DEZoVgoQ3BA-YVxfPkoQRj5FEt8AcwhxWKkIJAAHfCYSxXLKxykTaXklFnTMm16MkHbTbsUc3xsJ7BGu8wKUnQWZyRcySTw6sDkhVOWqzrMlZZtl9pc3eJpoNBY5EGEfAh0EXAB3aCemACIfFntvnxvgAmAAMoOBgOg3wAMoJJrAFBg4LgMGAQCA5MAod8ACoUYQUNE4gBSYC2CG-okMQA&amp;debug=false&amp;forceAllTransforms=false&amp;shippedProposals=false&amp;circleciRepo=&amp;evaluate=true&amp;fileSize=true&amp;timeTravel=false&amp;sourceType=module&amp;lineWrap=true&amp;presets=env&amp;prettier=false&amp;targets=&amp;version=7.4.5&amp;externalPlugins=">other stuff</a>.</p>
<p>If you don’t want to avoid these features altogether, you have a couple ways of reducing their impact:</p>
<ol><li>If you’re authoring a library, consider using <a href="https://babeljs.io/docs/en/babel-runtime">@babel/runtime</a> in concert with <a href="https://babeljs.io/docs/en/babel-plugin-transform-runtime">@babel/plugin-transform-runtime</a> to deduplicate the helper functions Babel puts into your code.</li>
<li>For polyfilled features in apps, you can include them selectively with <a href="https://babeljs.io/docs/en/babel-polyfill">@babel/polyfill</a> via <a href="https://babeljs.io/docs/en/babel-preset-env#usebuiltins">@babel/preset-env’s useBuiltIns: "usage"</a> option.</li>
</ol><p>This is solely my opinion, but I believe the best choice is to avoid transpilation altogether in bundles generated for modern browsers. That’s not always possible, especially if you use <a href="https://reactjs.org/docs/introducing-jsx.html">JSX</a>, which must be transformed for <em>all</em> browsers, or if you’re using bleeding edge language features that aren’t widely supported. In the latter case, it might be worth asking if those features are really necessary to deliver a good user experience (they rarely are). If you arrive at the conclusion that Babel must be a part of your toolchain, then it’s worth peeking under the hood from time to time to catch suboptimal stuff Babel might be doing that you can improve on.</p>
<h2 id="section9">Improvement is not a race<a class="subhead-anchor" href="https://alistapart.com#section9">#section9</a></h2>
<p>As you massage your temples wondering when this horrid JavaScript hangover is going to lift, understand that it’s precisely when we rush to get something out there as fast as we possibly can that the user experience can suffer. As the web development community obsesses on iterating faster in the name of competition, it’s worth your time to <a href="https://en.wikipedia.org/wiki/Thinking,_Fast_and_Slow"><em>slow down a little bit</em></a>. You’ll find that by doing so, you may not be iterating as fast as your competitors, but <em>your product</em> will be <em>faster</em> than theirs.</p>
<p>As you take these suggestions and apply them to your codebase, know that progress doesn’t spontaneously happen overnight. Web development is a job. The truly impactful work is done when we’re thoughtful and dedicated to the craft for the long haul. Focus on steady improvements. Measure, test, repeat, and your site’s user experience will improve, and you’ll get faster bit by bit over time.</p>
<p><em>Special thanks to</em> <a href="https://twitter.com/_developit"><em>Jason Miller</em></a> <em>for tech editing this piece. Jason is the creator and one of the many maintainers of</em> <a href="https://preactjs.com/"><em>Preact</em></a><em>, a vastly smaller alternative to React with the same API. If you use Preact,</em> <a href="https://opencollective.com/preact"><em>please consider supporting Preact through Open Collective</em></a><em>.</em></p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">A key aspect of being a manager is helping your reports succeed. Lara Hogan shares how in this excerpt from Resilient Management.</div><div class="entry-content">Suddenly, I realized that the people next to me might be severely impacted by my work. I was having a quick lunch in the airport...</div><div class="entry-content">Retraining narrow assumptions about users' gender identities is a step toward greater safety, privacy, and validation for everyone.</div><div class="entry-content">In this excerpt from Everyday Information Architecture, Lisa Maria Martin introduces the structural audit.</div><div class="entry-content">Our own @zeldman paints the complicated catch-22 that our free, democratized web has with our money-making capitalist roots. As creators, how do we untangle this web? #LetsFixThis</div>]]></description>
      <link>https://alistapart.com/article/responsible-javascript-part-2/</link>
      <guid>https://alistapart.com/article/responsible-javascript-part-2/</guid>
      <pubDate>Thu, 13 Jun 2019 01:06:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Resilient Management, An Excerpt]]></title>
      <description><![CDATA[<div class="entry-content">
<p>In <a href="https://en.wikipedia.org/wiki/Tuckman's_stages_of_group_development">Tuckman’s Stages of Group Development</a>, the Storming stage happens as a group begins to figure out how to work together. Previously, each person had been doing their own thing as individuals, so necessarily a few things need to be ironed out: how to collaborate, how to hit goals, how to determine priorities. Of <em>course</em> there may be some friction here!</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>But even if your team doesn’t noticeably demonstrate this kind of internal Storming as they begin to gel, there might be some outside factors at play in your work environment that create friction. During times of team scaling and organizational change—the water we in the web industry are often swimming in—managers are responsible for things like strategy-setting, aligning their team’s work to company objectives, and unblocking the team as they ship their work.</p>
<p>In addition to these business-context responsibilities, managers need to be able to help their teammates navigate this storm by helping them grow in their roles and support the team’s overall progress. If you and your teammates don’t adapt and evolve in your roles, it’s unlikely that your team will move out of the Storming stage and into the Norming stage of team dynamics.</p>
<p>To spur this course-correction and growth in your teammates, you’ll end up wearing four different hats:</p>
<ul><li><strong>Mentoring:</strong> lending advice and helping to problem solve based on your own experience.</li>
<li><strong>Coaching:</strong> asking open questions to help your teammate reflect and introspect, rather than sharing your own opinions or quickly problem solving.</li>
<li><strong>Sponsoring:</strong> finding opportunities for your teammate to level up, take on new leadership roles, and get promoted.</li>
<li><strong>Delivering feedback:</strong> observing behavior that is or isn’t aligned to what the team needs to be doing and sharing those observations, along with praise or suggestions.</li>
</ul><p>Let’s dive in to how to choose, and when to use, each of these skills as you grow your teammates, and then talk about what it looks like when teammates support the overarching direction of the team.</p>
<h2 id="section1">Mentoring<a class="subhead-anchor" href="https://alistapart.com#section1">#section1</a></h2>
<p>When I talk to managers, I find that the vast majority have their mentor hats on ninety percent of the time when they’re working with their teammates. It’s natural!</p>
<p>In mentoring mode, we’re doling out advice, sharing our perspective, and helping someone else problem solve based on that information. Our personal experiences are often what we can talk most confidently about! For this reason, mentorship mode can feel really good and effective for the mentor. Having that mentor hat on can help the other person overcome a roadblock or know which next steps to take, while avoiding drastic errors that they wouldn’t have seen coming otherwise.</p>
<p>As a mentor, it’s your responsibility to give advice that’s current and sensitive to the changing dialog happening in our industry. Advice that might work for one person (“Be louder in meetings!” or “Ask your boss for a raise!”) may undermine someone else, because members of underrepresented groups are unconsciously assessed and treated differently. For example, <a href="https://hbr.org/2018/05/the-different-words-we-use-to-describe-male-and-female-leaders">research has shown</a> that “when women are collaborative and communal, they are not perceived as competent—but when they emphasize their competence, they’re seen as cold and unlikable, in a classic ‘double bind’”.</p>
<p>If you are not a member of a marginalized group, and you have a mentee who <em>is</em>, please be a responsible mentor! Try to be aware of the way members of underrepresented groups are perceived, and the unconscious bias that might be at play in your mentee’s work environment. When you have your mentor hat on, do lots of gut checking to make sure that your advice is going to be helpful in practice for your mentee.</p>
<p>Mentoring is ideal when the mentee is new to their role or to the organization; they need to learn the ropes from someone who has firsthand experience. It’s also ideal when your teammate is working on a problem and has tried out a few different approaches, but still feels stumped; this is why practices like pair coding can help folks learn new things.</p>
<p>As mentors, we want our mentees to reach beyond us, because our mentees’ success is ultimately <em>our</em> success. Mentorship relationships evolve over time, because each party is growing. Imaginative, innovative ideas often come from people who have never seen a particular challenge before, so if your mentee comes up with a creative solution on their own that you wouldn’t have thought of, be excited for them—don’t just focus on the ways that <em>you’ve</em> done it or seen it done before.</p>
<p>Managers often default to mentoring mode because it feels like the fastest way to solve a problem, but it falls short in helping your teammate connect their <em>own</em> dots. For that, we’ll look to coaching.</p>
<h2 id="section2">Coaching<a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h2>
<p>In mentoring mode, you’re focused on both the problem and the solution. You’ll share what you as the mentor would do or have done in this situation. This means you’re more focused on yourself, and less on the person who is sitting in front of you.</p>
<p>In coaching mode—an extremely powerful but often underutilized mode—you’re doing two primary things:</p>
<ol><li><strong>Asking open questions</strong> to help the other person explore more of the shape of the topic, rather than staying at the surface level.</li>
<li><strong>Reflecting</strong>, which is like holding up a mirror for the other person and describing what you see or hear, or asking them to reflect for themselves.</li>
</ol><p>These two tools will help you become your teammate’s fiercest champion.</p>
<h3 id="section3">Open Questions<a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h3>
<p>“Closed” questions can only be answered with <em>yes</em> or <em>no</em>. Open questions often start with <em>who</em>, <em>what</em>, <em>when</em>, <em>where</em>, <em>why</em>, and <em>how</em>. But the best open questions are about the problem, not the solution. Questions that start with <em>why</em> tend to make the other person feel judged, and questions that start with <em>how</em> tend to go into problem solving mode—both of which we want to avoid while in coaching mode.</p>
<p>However, <em>what</em> questions can be authentically curious! When someone comes to you with a challenge, try asking questions like:</p>
<ul><li>What’s most important to you about it?</li>
<li>What’s holding you back?</li>
<li>What does success look like?</li>
</ul><p>Let’s say my teammate comes to me and says they’re ready for a promotion. Open questions could help this teammate explore what this promotion means and demonstrate to me what introspection they’ve already done around it. Rather than telling them what I think is necessary for them to be promoted, I could instead open up this conversation by asking them:</p>
<ul><li>What would you be able to do in the new level that you can’t do in your current one?</li>
<li>What skills are required in the new level? What are some ways that you’ve honed those skills?</li>
<li>Who are the people already at that level that you want to emulate? What about them do you want to emulate?</li>
</ul><p>Their answers would give me a place to start coaching. These questions might push my teammate to think more deeply about what this promotion means, rather than allowing them to stay surface level and believe that a promotion is about checking off a lot of boxes on a list. Their answers might also open <em>my</em> eyes to things that I hadn’t seen before, like a piece of work that my teammate had accomplished that made a huge impact. But most important, going into coaching mode would start a two-way conversation with this teammate, which would help make an otherwise tricky conversation feel more like a shared exploration.</p>
<p>Open questions, asked from a place of genuine curiosity, help people feel seen and heard. However, if the way you ask your questions comes across as judgy or like you’ve already made some assumptions, then your questions aren’t truly open (and your teammate can smell this on you!). Practice your intonation to make sure your open questions are <em>actually</em> curious and open.</p>
<p>By the way, forming lots of open questions (instead of problem solving questions, or giving advice) is tremendously hard for most people. Don’t worry if you don’t get the hang of it at first; it takes a lot of practice and intention over time to default to coaching mode rather than mentoring mode. I promise, it’s worth it.</p>
<h3 id="section4">Reflections<a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h3>
<p>Just like open questions, reflections help the other person feel seen and heard, and to explore the topic more deeply.</p>
<p>It’s almost comical how rarely we get the sense that the person we’re talking to is actively listening to us, or focusing entirely on helping us connect our own dots. Help your teammates reflect by repeating back to them what you hear them say, as in:</p>
<ul><li>“What I’m hearing you say is that you’re frustrated with how this project is going. Is that right?”</li>
<li>“What I know to be true about you is how deeply you care about your teammates’ feelings.”</li>
</ul><p>In each of these examples, you are holding up a metaphorical mirror to your teammate, and helping them look into it. You can coach them to reflect, too:</p>
<ul><li>“How does this new architecture project map to your goals?”</li>
<li>“Let’s reflect on where you were this time last year and how far you’ve come.”</li>
</ul><p>Occasionally, you might get a reflection wrong; this gives the other person an opportunity to realize something new about their topic, like the words they’re choosing aren’t quite right, or there’s another underlying issue that should be explored. So don’t be worried about giving a bad reflection; reflecting back what you’re hearing will still help your teammate.</p>
<p>The act of reflecting can help the other person do a gut check to make sure they’re approaching their topic holistically. Sometimes the act of reflection forces (encourages?) the other person to do some really hard work: <em>introspection</em>. Introspection creates an opportunity for them to realize new aspects of the problem, options they can choose from, or deeper meanings that hadn’t occurred to them before—which often ends up being a nice shortcut to the right solution. Or, even better, the right problem statement.</p>
<p>When you have your coaching hat on, you don’t need to have all the answers, or even fully understand the problem that your teammate is wrestling with; you’re just there as a mirror and as a question-asker, to help prompt the other person to think deeply and come to some new, interesting conclusions. Frankly, it may not feel all that effective when you’re in coaching mode, but I promise, coaching can generate <em>way more growth</em> for that other person than just giving them advice or sharing your perspective.</p>
<p>Choose coaching when you’re looking to help someone (especially an emerging leader) hone their strategic thinking skills, grow their leadership aptitude, and craft their own path forward. Coaching mode is all about helping your teammate develop their own brain wrinkles, rather than telling them how you would do something. The introspection and creativity it inspires create deeper and longer-lasting growth.</p>
<h2 id="section5">Sponsoring<a class="subhead-anchor" href="https://alistapart.com#section5">#section5</a></h2>
<p>While you wear the mentoring and coaching hats around your teammates, the sponsor hat is more often worn when they’re <em>not</em> around, like when you’re in a 1:1 with your manager, a sprint planning meeting, or another environment where someone’s work might be recognized. You might hear about an upcoming project to acquire a new audience and recommend that a budding user researcher take it on, or you’ll suggest to an All Hands meeting organizer that a junior designer should give a talk about a new pattern they’ve introduced to the style guide.</p>
<p>Sponsorship is all about feeling <em>on the hook</em> for getting someone to the next level. As someone’s sponsor, you’ll put their name in the ring for opportunities that will get them the experience and visibility necessary to grow in their role and at the organization. You will put your personal reputation on the line on behalf of the person you’re sponsoring, to help get them visible and developmental assignments. It’s a powerful tool, and the one most effective at helping someone get to the next level (way more so than mentoring or coaching!).</p>
<p>The Center for Talent Innovation routinely <a href="https://www.talentinnovation.org/_private/assets/TheSponsorDividend_KeyFindingsCombined-CTI.pdf">measures the career benefits of sponsorship</a> (PDF). Their studies have found that when someone has a sponsor, they are way more likely to have access to career-launching work. They’re also more likely to take actions that lead to even <em>more</em> growth and opportunities, like asking their manager for a stretch assignment or a raise.</p>
<p>When you’re in sponsorship mode, think about the different opportunities you have to offer up someone’s name. This might look like:</p>
<ul><li>giving visible/public recognition (company “shout outs,” having them present a project demo, thanking them in a launch email, giving someone’s manager feedback about their good work);</li>
<li>assigning stretch tasks and projects that are <em>just beyond</em> their current skill set, to help them grow and have supporting evidence for a future promotion; or</li>
<li>opening the door for them to write blog posts, give company or conference talks, or contribute open-source work.</li>
</ul><p>Remember that members of underrepresented groups are typically <a href="https://hbr.org/2010/08/women-are-over-mentored-but-un">over-mentored, but under-sponsored</a>. These individuals get <em>lots</em> of advice (often unsolicited), coffee outings, and offers to teach them new skills. But it’s much rarer for them to see support that looks like sponsorship.</p>
<p>This isn’t because sponsors intentionally ignore marginalized folks, but because of <em>in-group bias</em>. Because of how our brains (and social networks) work, the people we’re closest to tend to look mostly like us—and we draw from that same pool when we nominate people for projects, for promotions, and for hires. Until I started learning about bias in the workplace, most of the people I sponsored were white, cisgender women, like myself. Since then, I’ve actively worked to sponsor people of color and nonbinary people. It takes effort and intention to combat our default behaviors—but I know you can do it!</p>
<p>Take a look at the daily communications you participate in: your work chat logs, the conversations you have with others, the process for figuring out who should fix a bug or work on a new project, and the processes for making your teams’ work visible (like an architecture review, code review, launch calendar, etc.). You’ll be surprised how many moments there are to sponsor someone throughout an average day. Please put in the time and intention to ensure that you’re sponsoring members of underrepresented groups, too.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Suddenly, I realized that the people next to me might be severely impacted by my work. I was having a quick lunch in the airport...</div><div class="entry-content">Retraining narrow assumptions about users' gender identities is a step toward greater safety, privacy, and validation for everyone.</div><div class="entry-content">In this excerpt from Everyday Information Architecture, Lisa Maria Martin introduces the structural audit.</div><div class="entry-content">Our own @zeldman paints the complicated catch-22 that our free, democratized web has with our money-making capitalist roots. As creators, how do we untangle this web? #LetsFixThis</div><div class="entry-content">A month of experiencing a temporary disability changed @fcorradini’s perspective on how to take more care when conducting accessibility testing. He shares the impact.</div>]]></description>
      <link>https://alistapart.com/article/resilient-management-excerpt/</link>
      <guid>https://alistapart.com/article/resilient-management-excerpt/</guid>
      <pubDate>Thu, 06 Jun 2019 01:06:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Daily Ethical Design]]></title>
      <description><![CDATA[<div class="entry-content">
<p>Suddenly, I realized that the people next to me might be severely impacted by my work.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>I was having a quick lunch in the airport. A group of flight attendants sat down at the table next to me and started to prepare for their flight. For a while now, our design team had been working on futuristic concepts for the operations control center of these flight attendants’ airline, pushing ourselves to come up with innovative solutions enabled by the newest technologies. As the control center deals with all activities around flying planes, our concepts touched upon everything and everyone within the airline.</p>
<p>How was I to know what the impact of my work would be on the lives of these flight attendants? And what about the lives of all the other people working at the airline?</p>
<p>Ideally, we would have talked to all the types of employees in the company and tested our concepts with them. But, of course, there was no budget (or time) allocated to do so, not to mention we faced the hurdle of convincing (internal) stakeholders of the need.</p>
<p>Not for the first time, I felt frustrated: practical, real-world constraints prevented me from assessing the impact and quality of my work. They prevented me from properly conducting <em>ethical design</em>.</p>
<h2 id="section1">What is ethical design?<a class="subhead-anchor" href="https://alistapart.com#section1">#section1</a></h2>
<p>Right, good question. A very comprehensive definition of ethical design can be found at <a href="https://www.encyclopedia.com/science/encyclopedias-almanacs-transcripts-and-maps/design-ethics">Encyclopedia.com</a>:</p>
<figure id="figure1" class="quote"><blockquote>
<p>Design ethics concerns moral behavior and responsible choices in the practice of design. It guides how designers work with clients, colleagues, and the end users of products, how they conduct the design process, how they determine the features of products, and how they assess the ethical significance or moral worth of the products that result from the activity of designing.</p>
</blockquote>
</figure><p>In other words, ethical design is about the “goodness”—in terms of benefit to individuals, society, and the world—of how we collaborate, how we practice our work, and what we create. There’s never a black-and-white answer for whether design is good or bad, yet there are a number of areas for designers to focus on when considering ethics.</p>
<h3 id="section2">Usability<a class="subhead-anchor" href="https://alistapart.com#section2">#section2</a></h3>
<p>Nowadays usability has conquered a spot as a basic requirement for each interface; unusable products are considered design failures. And rightly so; we have a moral obligation as designers to create products that are intuitive, safe, and free from possibly life-threatening errors. We were all reminded of usability’s importance by last year’s <a href="https://www.nngroup.com/articles/error-prevention/">accidental nuclear strike warning</a> in Hawaii. What if, instead of a false-positive, the operator had broadcasted a false-negative?</p>
<h3 id="section3">Accessibility<a class="subhead-anchor" href="https://alistapart.com#section3">#section3</a></h3>
<p>Like usability, inclusive design has become a standard item in the requirement list of many designers and companies. (I will never forget that time someone tried to use our website with a screen reader—and got absolutely stuck at the cookie message.) Accessible design benefits all, as it attempts to cover as many needs and capabilities as possible. Yet for each design project, there are still a lot of tricky questions to answer. Who gets to benefit from our solutions? Who is (un)intentionally left out? Who falls outside the “target customer segment”?</p>
<h3 id="section4">Privacy<a class="subhead-anchor" href="https://alistapart.com#section4">#section4</a></h3>
<p>Another day, another Facebook privacy scandal. As we’re progressing into the Data Age, the topic of privacy has become almost synonymous with design ethics. There’s a reason why more and more people use <a href="https://duckduckgo.com/traffic">DuckDuckGo</a> as an alternative search engine to Google. Corporations have access to an abundance of personal information about consumers, and as designers we have the privilege—and responsibility—of using this information to shape products and services. We have to consider how much information is strictly necessary and how much people are willing to give up in exchange for services. And how can we make people aware of the potential risks <a href="https://link.springer.com/article/10.1007/s10603-018-9399-7">without overloading them</a>?</p>
<h3 id="section5">User involvement<a class="subhead-anchor" href="https://alistapart.com#section5">#section5</a></h3>
<p>Overlapping largely with privacy, this focus area is about how we deal with our users and what we do with the data that we collect from them. IDEO has recently published <a href="https://lbodre.ideo.com/"><cite>The Little Book of Design Research Ethics</cite></a>, which provides a comprehensive overview of the core principles and guidelines we should follow when conducting design research.</p>
<h3 id="section6">Persuasion<a class="subhead-anchor" href="https://alistapart.com#section6">#section6</a></h3>
<p>Ethics related to persuasion is about to what extent we may influence the behavior and thoughts of our users. It doesn’t take much to bring acceptable, “white hat” persuasion into gray or even dark territories. Conversion optimization, for example, can easily turn into “How do we squeeze out more revenue from our customers by <a href="https://www.fastcompany.com/90306916/were-all-being-manipulated-by-a-b-testing-all-the-time">turning their unconsciousness against them</a>?” Prime examples include Netflix, which convinces us to watch, watch, and watch even more, and Booking.com, which barrages our senses with urgency and social pressure.</p>
<h3 id="section7">Focus<a class="subhead-anchor" href="https://alistapart.com#section7">#section7</a></h3>
<p>The current digital landscape is addictive, distracting, and competing for attention. Designing for focus is about responsibly handling people’s most valuable resource: time. Our challenge is to limit everything that disrupts our users’ attention, lower the addictiveness of products, and create <a href="https://calmtech.com/">calmness</a>. The Center for Humane Technology has started a useful list of <a href="http://humanetech.com/resources">resources</a> for this purpose.</p>
<h3 id="section8">Sustainability<a class="subhead-anchor" href="https://alistapart.com#section8">#section8</a></h3>
<p>What’s the impact of our work on the world’s environment, resources, and climate? Instead of continuously adding new features in the unrelenting scrum treadmill, how could we design for fewer? We’re in the position to create responsible digital solutions that enable sustainable consumer behavior and prevent overconsumption. For example, apps such as <a href="https://www.optimiam.com/">Optimiam</a> and <a href="https://www.optimiam.com/">Too Good To Go</a> allow people to order leftover food that would normally be thrashed. Or consider <a href="https://www.mutum.com/">Mutum</a> and <a href="https://www.peerby.com/one">Peerby</a>, whose peer-to-peer platforms promote the sharing and reuse of owned products.</p>
<h3 id="section9">Society<a class="subhead-anchor" href="https://alistapart.com#section9">#section9</a></h3>
<p>The <a href="https://ledger.humanetech.com/">Ledger of Harms</a> of the Center for Human Technology is a work-in-progress collection of the negative impacts that digital technology has on society, including topics such as relationships, mental health, and democracy. Designers who are mindful of society consider the impact of their work on the global economy, communities, politics, and health.</p>
<figure id="figure2"><img class="alignnone size-full wp-image-7171643" src="https://alistapart.com/wp-content/uploads/2019/05/daily-ethical-design-fig1.png" alt="Focus areas of ethical design: user involvement, persuasion, focus, sustainability, society, usability, accessibility, privacy" width="1189" height="841" /><figcaption>The focus areas of design ethics. That’s a lot to consider!</figcaption><h2 id="section10">Ethics as an inconvenience<a class="subhead-anchor" href="https://alistapart.com#section10">#section10</a></h2>
<p>Ideally, in every design project, we should assess the potential impact in all of the above-mentioned areas and take steps to prevent harm. Yet there are many legitimate, understandable reasons why we often neglect to do so. It’s easy to <em>have</em> moral principles, yet in the real world, with the constraints that our daily life imposes upon us, it’s seldom easy to <em>act</em> according to those principles.</p>
<p>We might simply say it’s inconvenient at the moment. That there’s a lack of time or budget to consider all the ethical implications of our work. That there are many more pressing concerns that have priority right now. We might genuinely believe it’s just a small issue, something to consider later, perhaps. Mostly, we are simply <em>unaware</em> of the possible consequences of our work.</p>
<p>And then there’s the sheer complexity of it all: it’s simply too much to simultaneously focus on. When short on time, or in the heat of approaching deadlines and impatient stakeholders, how do you incorporate all of design ethics’ focus areas?</p>
<p>Where do you even start?</p>
<h2 id="section11">Ethics as a structural practice<a class="subhead-anchor" href="https://alistapart.com#section11">#section11</a></h2>
<p>For these reasons, I believe we need to elevate design ethics to a more practical level. We need to find ways to make ethics not an afterthought, not something to be considered separately, but rather something that’s so ingrained in our process that not doing it means <em>not</em> doing design at all.</p>
<p>The only way to overcome the “inconvenience” of acting ethically is to practice <em>daily</em> ethical design: ethics structurally integrated in our daily work, processes, and tools as designers. No longer will we have to rely on the exceptions among us; those extremely principled who are brave enough to stand up against the system no matter what kind of pressure is put upon them. Because the system will be on our side.</p>
<p>By applying ethics daily and structurally in our design process, we’ll be able to identify and neutralize in a very early stage the potential for mistakes and misuse. We’ll increase the quality of our design and our practices simply because we’ll think things through more thoroughly, in a more conscious and structured manner.</p>
<p>But perhaps most important is that we’ll establish a new standard for design. A standard that we can sell to our clients as the way design should be done, with ethical design processes and deliverables already included. A standard that can be taught to design students so that the newest generation of designers doesn’t know any better than to apply ethics, always.</p>
<figure id="figure3"><img class="alignnone size-full wp-image-7171644" src="https://alistapart.com/wp-content/uploads/2019/05/daily-ethical-design-fig2.png" alt="Daily ethical design - Ethics integrated structurally in our daily practice as designers, overcomes the inconvenience of acting ethically, prevents misuse and mistakes, adds automatically to the quality of our work, and will establish a higher standard for design." width="1189" height="841" /><figcaption>The advantages of daily ethical design</figcaption></figure><h2 id="section12">How to practice daily ethical design?<a class="subhead-anchor" href="https://alistapart.com#section12">#section12</a></h2>
<p>At this point we’ve arrived at the question of <em>how</em> we can structurally integrate ethics into our design process. How do we make sure that our daily design decisions will result in a product that’s usable and accessible; protects people’s privacy, agency, and focus; and benefits both society and nature?</p>
<p>I want to share with you some best practices that I’ve identified so far, and how I’ve tried to apply them during a recent project at Mirabeau. The goal of the project was to build a web application that provides a shaver manufacturer’s factory workers insight into the real-time availability of production materials.</p>
<h3 id="section13">Connect to your organization’s mission and values<a class="subhead-anchor" href="https://alistapart.com#section13">#section13</a></h3>
<p>By connecting our designs to the mission and values of the companies we work for, we can structurally use our design skills in a <a href="http://strategicdesignbook.com/">strategic manner</a>, for moral purposes. We can challenge the company to truly live up to its promises and support it in carrying out its mission. This does, however, require you to be aware of the company’s values, and to compare these to your personal values.</p>
<p>As I had worked with our example client before, I knew it was a company that takes care of its employees and has a strong focus on creating a better world. During the kick-off phase, we used a strategy pyramid to structure the client’s mission and values, and to agree upon success factors for the project. We translated the company’s customer-facing brand guidelines to employee-focused design principles that maintained the essence of the organization.</p>
<h3 id="section14">Keep track of your assumptions<a class="subhead-anchor" href="https://alistapart.com#section14">#section14</a></h3>
<p>Throughout our entire design process, we make assumptions for each decision that we take. By structurally keeping track of these assumptions, you’ll never forget about the limitations of your design and where the potential risks lie in terms of (harmful) impact on users, the project, the company, and society.</p>
<p>In our example project, we listed our assumptions about user goals, content, and functionalities for each page of the application. If we were not fully sure about the value for end users, or the accuracy of a user goal, we marked it as a <em>value assumption</em>. When we were unsure if data could be made available, we marked this as a <em>data (feasibility) assumption</em>. If we were not sure whether a feature would add to the manufacturer’s business, we marked it as a <em>scope assumption</em>. Every week, we tested our assumptions with end users and business stakeholders through user tests and sprint demos. Each design iteration led to new questions and assumptions to be tested the next week.</p>
<h3 id="section15">Aim to be proven wrong<a class="subhead-anchor" href="https://alistapart.com#section15">#section15</a></h3>
<p>While our assumptions are the <em>known</em> unknowns, there are always <em>unknown</em> unknowns that we aren’t aware of but could be a huge risk for the quality and impact of our work. The only way we can identify these is by applying the scientific principle of <a href="https://en.wikipedia.org/wiki/Falsifiability"><em>falsifiability</em></a>: seeking actively to be proven <em>wrong</em>. Only outsiders can point out to us what we miss as an individual or as a team.</p>
<p>In our weekly user tests, we included factory workers and stakeholders with different disciplines, from different departments, and working in different contexts, to identify the edge cases that could break our concept. On one occasion, this made us reconsider the entirety of our concept. Still, we could have done better: although scalability to other factories was an important success factor, we were unable to gather input from those other factories during the project. We felt our only option was to mention this as a risk (“limit to scalability”).</p>
<h3 id="section16">Use the power of checklists<a class="subhead-anchor" href="https://alistapart.com#section16">#section16</a></h3>
<p>Let’s face it: <a href="https://medium.com/ux-power-tools/50-things-you-probably-forgot-to-design-7a288b0ef914">we forget things</a>. (Without scrolling up the page, can you name all the focus areas of design ethics?) This is where checklists help us out: they provide knowledge in the world, so that we don’t have to process it in our easily overwhelmed memory. Simple yet powerful, a checklist is an essential tool to practice daily ethical design.</p>
<p>In our example project, we used checklists to maintain an overview of questions and assumptions to user test, checking whether we included our design principles properly, and assessing whether we complied to the client’s values, design principles, and the agreed-upon success factors. In hindsight, we could also have taken a moment during the concept phase to go through the list of focus areas for design ethics, as well as have taken a more structural approach to check accessibility guidelines.</p>
<h2 id="section17">The main challenge for daily ethical design<a class="subhead-anchor" href="https://alistapart.com#section17">#section17</a></h2>
<p>Most ethics focus areas are quite tangible, where design decisions have immediate, often visible effects. While certainly challenging in their own right, they’re relatively easy to integrate in our daily practice, especially for experienced designers.</p>
<p><em>Society</em> and the <em>environment</em>, however, are more intangible topics; the effects of our work in these areas are distant and uncertain. I’m sure that when Airbnb was first conceived, the founders did not consider the magnitude of its <a href="https://www.bbc.com/news/business-45083954">disruptive impact</a> on the housing market. The same goes for Instagram, as its role in <a href="https://www.gq.com/story/fast-fashion-streetwear-brands-of-instagram">creating demand for fast fashion</a> must have been hard to foresee.</p>
<p>Hard, but not impossible. So how do we overcome this challenge and make the impact that we have on society and the environment more immediate, more <em>daily</em>?</p>
<h3 id="section18">Conduct Dark Reality sessions<a class="subhead-anchor" href="https://alistapart.com#section18">#section18</a></h3>
<p>The ancient Greek philosopher Socrates used a series of questions to gradually uncover the invalidity of people’s beliefs. In a very similar way, we can uncover the assumptions and potential disastrous consequences of our concepts in a ‘Dark Reality’ session, a form of <a href="https://uxplanet.org/can-speculative-design-make-ux-better-design-trend-4-4-ce8d13148e5d">speculative design</a> that focuses on stress-testing a concept with challenging questions.</p>
<p>We have to ask ourselves—or even better, somebody outside our team has to ask <em>us</em>— questions such as, “What is the lifespan of your product? What if the user base will be in the millions? What are the long-term effects on economy, society, and the environment? Who benefits from your design? Who loses? Who is excluded? And perhaps most importantly, how could your design be misused? (For more of these questions, Alan Cooper provided a great list in his <a href="https://docs.google.com/document/d/1iuFmd2keeOOnSwQaHAcMgUyG-cIHfFVd8_yO72KCtF0/edit#">keynote</a> at Interaction 18.)</p>
<p>The back-and-forth Q&amp;A of the Dark Reality session will help us consider and identify our concept’s weaknesses and potential consequences. As it is a team effort, it will spark discussion and uncover differences in team members’ ethical values. Moreover, the session will result in a list of questions and assumptions that can be tested with potential users and subject matter experts. In the project for the airline control center, it resulted in more consideration for the human role in automatization and how digital interfaces can continue to support human capabilities (instead of replacing them), and reflection on the role of airports in future society.</p>
<p>The dark reality session is best conducted during the convergent parts of the <a href="https://www.designcouncil.org.uk/news-opinion/design-process-what-double-diamond">double diamond</a>, as these are the design phases in which we narrow down to realistic ideas. It’s vital to have a questioner from outside the team with strong interviewing skills and who doesn’t easily accept an answer as sufficient. There are helpful tools available to help structure the session, such as the <a href="http://tarotcardsoftech.artefactgroup.com/">Tarot Cards of Tech</a> and these <a href="https://www.ethicsfordesigners.com/tools">ethical tools</a>.</p>
<h2 id="section19">Take a step back to go forward<a class="subhead-anchor" href="https://alistapart.com#section19">#section19</a></h2>
<p>As designers, we’re optimists by nature. We see the world as a set of problems that we can solve systematically and creatively if only we try hard enough. We intend well. However, merely having the <em>intention</em> to do good is not going to be enough. Our mindset comes with the pitfall of (dis)missing potential disastrous consequences, especially under pressure of daily constraints. That’s why we need to regularly, systematically take a step back and consider the future impact of our work. My hope is that the practical, structural mindset to ethics introduced in this article will help us agree on a higher standard for design.</p>
</figure><div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Retraining narrow assumptions about users' gender identities is a step toward greater safety, privacy, and validation for everyone.</div><div class="entry-content">In this excerpt from Everyday Information Architecture, Lisa Maria Martin introduces the structural audit.</div><div class="entry-content">Our own @zeldman paints the complicated catch-22 that our free, democratized web has with our money-making capitalist roots. As creators, how do we untangle this web? #LetsFixThis</div><div class="entry-content">A month of experiencing a temporary disability changed @fcorradini’s perspective on how to take more care when conducting accessibility testing. He shares the impact.</div><div class="entry-content">Jeremy Wagner plots a course to avoid the unnecessary bloat and inaccessible patterns of current JavaScript trends.</div>]]></description>
      <link>https://alistapart.com/article/daily-ethical-design/</link>
      <guid>https://alistapart.com/article/daily-ethical-design/</guid>
      <pubDate>Thu, 30 May 2019 02:05:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Trans-inclusive Design]]></title>
      <description><![CDATA[<div class="entry-content">
<p>Late one night a few years ago, a panicked professor emailed me: “My transgender student’s legal name is showing on our online discussion board. How can I keep him from being outed to his classmates?” Short story: we couldn’t. The professor created an offline workaround with the student. Years later this problem persists not just in campus systems, but in many systems we use every day.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>To anyone who’d call that an unusual situation, it’s not. We are all already designing for trans users—<a href="https://ajph.aphapublications.org/doi/10.2105/AJPH.2016.303578">1 in 250 people</a> in the US identifies as transgender or gender non-binary (based on current estimates), and the <a href="https://pediatrics.aappublications.org/content/141/3/e20171683">number is rising</a>.</p>
<p>We are web professionals; we can do better than an offline workaround. The choices we make impact the online and offline experiences of real people who are trans, non-binary, or gender-variant—choices that can affirm or exclude, uplift or annoy, help or harm.</p>
<p>The rest of this article assumes you agree with the concept that trans people are human beings who deserve dignity, respect, and care. If you are seeking a <a href="https://transequality.org/about-transgender">primer on trans-related vocabulary and concepts</a>, please read up and come back later.</p>
<p>I’m going to cover issues touching on content, images, forms, databases, IA, privacy, and AI—just enough to get you thinking about the decisions you make every day and some specific ideas to get you started.</p>
<blockquote class="wp-block-quote">
<p><em>“Tried making a Bitmoji again, but I always get disillusioned immediately by their binary gender model from literally step 1 and end up not using it. I don’t feel represented.”</em></p>
<div><cite><em>Editorial note: All personal statements quoted in this article have been graciously shared with the express consent of the original authors.</em></cite></div></blockquote>
<h2 id="section1">How we can get things right<a class="subhead-anchor" href="#section1">#section1</a></h2>
<p>Gender is expansively misconstrued as some interchangeable term for anatomical features. Unlike the constellation of <a href="https://slate.com/technology/2018/11/sex-binary-gender-neither-exist.html">human biological forms</a> (our sex), <a href="https://thesocietypages.org/trot/2018/11/26/the-social-construction-of-gender-and-sex/">gender is culturally constructed</a> and varies depending on where you are in the world. It has its own diversity.</p>
<p>Asking for gender when it is not needed; limiting the gender options users can select; assuming things about users based on gender; or simply excluding folks from our designs are all ways we reify the man-woman gender binary in design decisions.</p>
<h2 id="section2">Names are fundamentally important<a class="subhead-anchor" href="#section2">#section2</a></h2>
<p>If we do nothing else, <a href="https://emmah.net/names.html">we must get names right</a>. Names are the difference between past and present, invalidation and affirmation, and sometimes safety and danger.</p>
<p>Yet, many of the systems we use and create don’t offer name flexibility.</p>
<p>Many programmers and designers have a few <a href="https://www.kalzumeus.com/2010/06/17/falsehoods-programmers-believe-about-names/">misconceptions about names</a>, such as assuming people have one moniker that they go by all the time, despite how common it is for names to change over a lifetime. People might update them after a change in marital status, family situation, or gender, or perhaps someone is known by a nickname, westernized name, or variation on a first name.</p>
<p>In most locales, <a href="https://medium.com/gender-2-0/but-why-don-t-you-change-your-name-edb29297a73f">legally changing names</a> is extremely difficult, extremely expensive, requires medical documentation, or is completely out of the question.</p>
<p>Changes to name <em>and</em>gender marker are even more complicated; they tend to be two separate, long-drawn-out processes. To make matters worse, <a href="https://www.lgbtmap.org/equality-maps">laws vary from state to state</a> within the U.S. and most only recognize two genders—man and woman—rather than allowing non-binary options.Not all trans people change their names, but for those who do, it’s a serious and significant decision that shouldn’t be sabotaged. We can design systems that protect the lives and privacy of our users, respect the fluid nature of personal identity, and act as an <a href="http://www.accessiblesociety.org/topics/technology/eleccurbcut.htm">electronic curb cut</a> that helps everyone in the process.</p>
<h3 id="section3">Deadnaming<a class="subhead-anchor" href="#section3">#section3</a></h3>
<p>One need only search Twitter for “deadname app” to get an idea of how apps can leave users in the lurch. Some of the most alarming examples involve apps and sites that facilitate real-life interactions (which already involve a measure of risk for everyone).</p>
<blockquote class="wp-block-quote">
<p>“Lyft made it completely impossible for me to change my name on its app even when it was legally changed. I reached out to their support multiple times and attempted to delete the account and start over with no result. I was completely dependent on this service for groceries, appointments, and work, and was emotionally exhausted every single time I needed a ride. I ended up redownloading Uber – even though there was a strike against the service – which I felt awful doing. But Uber allowed me to change my name without any hoops to jump through, so for the sake of my mental health, I had to.”</p>
</blockquote>
<p>Trans people are more likely to experience financial hardship, so using payment apps to ask for donations is often necessary. Some of these <a href="https://www.change.org/p/paypal-get-paypal-to-add-a-preferred-name-section">services may reveal private information</a> as a matter of course, leaving them exposed and potentially at risk.</p>
<p>There are also ramifications when linked services rely on our data sources for name information, instigating an unpredictable cascade effect with little or no recourse to prevent the sharing of sensitive details.</p>
<p>These are examples of deadnaming. <a href="https://www.healthline.com/health/transgender/deadnaming">Deadnaming</a> is what happens when someone’s previous or birth name is used, rather than the name the person uses now. Deadnaming is invalidating at the least, even as a faux pas, but can be psychologically devastating at the other extreme, even putting lives at risk.The experiences of trans, non-binary, or gender-variant folk can vary widely, and they live in <a href="https://www.ustranssurvey.org/reports">disparate conditions</a> throughout the world. Many are thriving and <a href="https://www.tdor.co/">creating new and joyful ways</a> to resist and undo gender norms, despite the <a href="https://www.advocate.com/commentary/2014/02/11/op-ed-why-are-narratives-around-transgender-people-always-so-negative">common negative narrative</a> around trans lives. Others can face hardship; trans people are more likely to be unstably housed, underemployed, underpaid, and targets of violence in and out of their homes, workplaces, and intimate relationships. The ramifications are amplified for people of color and those with disabilities, as well as those in precarious living/working situations and environments where exposure can put them in harm’s way.</p>
<h3 id="section4">Design for name changes<a class="subhead-anchor" href="#section4">#section4</a></h3>
<p><strong><em>Here</em></strong>’<strong><em>s what we can do:</em></strong></p>
<p><strong>Design for renaming.</strong> Emma Humphries’ <a href="http://adventuresinrenaming.net/2015/09/05/Design-for-Renaming/">talk on renaming</a> covers this nicely. <a href="https://www.fastcompany.com/90165071/how-tech-giants-design-for-transgender-users-or-dont">Airbnb</a> has developed policies and procedures for users who’ve transitioned, allowing users to keep their review histories intact with amended names and/or pronouns.</p>
<p><strong>Get rid of</strong> <a href="https://en.wikipedia.org/wiki/Facebook_real-name_policy_controversy"><strong>“real name” requirements</strong></a><strong>.</strong> Allow people to use names they go by rather than their legal first names.</p>
<p><strong>Clarify</strong> <a href="https://twitter.com/duckinator/status/545934151610675200"><strong>when you actually need</strong></a> <strong>a legal name</strong>, and only use that in conjunction with a display name field.</p>
<p><strong>Have a name change process</strong> that allows users to change their names without legal documentation. (It’s likely that you have procedures for marriage-related name changes already.)</p>
<p><strong>Ensure users can still change their display names</strong> when connecting with other data sources to populate users’ names.</p>
<p><strong>Don’t place onerous restrictions on changes.</strong> Once someone creates a username, web address, or profile URL, <a href="https://support.spotify.com/is/account_payment_help/account_help/change-my-username/">allow them to change it</a>.</p>
<p><strong>Draft a code of conduct</strong> if you’re part of an online community, and make sure to include policies around deadnaming. <a href="https://www.theverge.com/2018/11/27/18113344/twitter-trans-user-hateful-content-misgendering-deadnaming-ban">Twitter banned deadnaming</a> last year.</p>
<p><strong>Allow people to be forgotten.</strong> When people delete their accounts for whatever reason, help them make sure that their data is not lingering in your systems or in other places online.</p>
<h2 id="section5"><strong>Update the systems users don’t see, too</strong><a class="subhead-anchor" href="#section5">#section5</a></h2>
<p>Identity management systems can be a mess, and name changes can reveal the failures among those systems, including hidden systems that users don’t see.</p>
<p>One Twitter user’s health insurance company <a href="https://twitter.com/Foone/status/1118026782811152384">kept their ID number between jobs but changed their gender</a>. Another user updated their display name but got an <a href="https://twitter.com/JaceyChase/status/1105177162884280321">email confirmation addressed to their legal name</a>.</p>
<p>Hidden information can also undermine job opportunities:</p>
<blockquote class="wp-block-quote">
<p>“At a university as a student, I transitioned and changed my name and gender to be a woman. TWELVE YEARS later after being hired to work in the Libraries, the Libraries HR coordinator emailed me that I was listed as male still in the database. He changed it on my asking, but I have to wonder how long… was it a factor in my being turned down for jobs I applied to… who had seen that..?”</p>
</blockquote>
<p>Emma Humphries <a href="http://adventuresinrenaming.net/2015/09/05/Design-for-Renaming/">details the hidden systems</a> that can carry out-of-date information about users. Her tips for database design include:</p>
<ul><li>Don’t use emails as unique IDs.</li>
<li>Use an invariant user ID internally, and link the user’s current email and display name to it.</li>
</ul><h2 id="section6">Images<a class="subhead-anchor" href="#section6">#section6</a></h2>
<p>Visuals should allow room for representation and imagination rather than a narrow subset of the usual suspects: figures who appear to be straight, cisgender, able-bodied, and white/Caucasian.</p>
<p>What we can do is feature a variety of gender presentations, as well as not assume someone’s gender identity if they buy certain items.</p>
<p>Some companies, like <a href="https://www.wildfang.com/">Wildfang</a> and <a href="https://www.shethinx.com">Thinx</a>, offer a broad array of images representing different races, body sizes, and gender expressions on their websites and in their ads.</p>
<p>Many are also choosing not to hire models, <a href="https://www.bullockandjones.com/">allowing room for imagination</a> and versatility:</p>
<blockquote class="wp-block-quote">
<p>“I got a catalog for a ‘classic menswear company’ that features zero photos of any person of any gender. Now if only I could afford an $800 blazer…”</p>
</blockquote>
<p><strong><em>Here’s what we can do:</em></strong></p>
<p><strong>Actively recruit diverse groups of models for photos.</strong> And pay them!</p>
<p><strong>If you can’t shoot your own photos</strong>, Broadly has recently launched a <a href="https://broadly.vice.com/en_us/article/qvyq8p/transgender-non-binary-stock-photos-gender-spectrum-collection">trans-inclusive stock photo collection</a> free for wide use. <a href="https://getavataaars.com/">Avataaars</a> allows users to create an avatar without selecting a gender.</p>
<h2 id="section7">Information architecture<a class="subhead-anchor" href="#section7">#section7</a></h2>
<p>How we organize information is a political act and a non-neutral decision (<a href="https://www.journals.uchicago.edu/doi/abs/10.1086/669547">librarians have said this</a> for a while). This applies to gender-based classifications.</p>
<p>Many companies that sell consumer goods incorporate gender into their product design and marketing, no matter what. The product itself might be inherently gender-neutral (such as clothing, <a href="http://lettoysbetoys.org.uk/why-it-matters/">toys</a>, <a href="https://twitter.com/erinrwhite/status/1124058358091329537">bikes</a>, or even <a href="https://www.reddit.com/r/pointlesslygendered/comments/bi9imq/bros%C3%A9/">wine</a>), but these design and marketing decisions can directly impact the information architecture of websites.</p>
<p><strong><em>Here’s what we can do:</em></strong></p>
<p><strong>Evaluate why any menus, categories, or tags are based on gender</strong>, and how it can be done differently:</p>
<blockquote class="wp-block-quote">
<p>“Nike has a ‘gender neutral’ clothing category, yet it’s listed under ‘men’ and ‘women’ in the website architecture. ?”</p>
</blockquote>
<h2 id="section8">Forms<a class="subhead-anchor" href="#section8">#section8</a></h2>
<p>Forms, surveys, and other types of data gathering are surefire ways to include or exclude people. If you ask for information you don’t need or limit the options that people can select, you risk losing them as users.</p>
<p><strong><em>Here’s what we can do:</em></strong></p>
<p><strong>Critically evaluate</strong> <a href="http://juliepagano.com/blog/2015/06/12/on-forms-and-personal-information/"><strong>why you are asking for personal information</strong></a>, including gender. Will that information be used to help someone, or sell things to your advertisers?</p>
<blockquote class="wp-block-quote">
<p>“Why does the @CocaCola site make me select a gender just to make a purchase? Guess my family isn’t getting personalized Coke bottles for Christmas.”</p>
</blockquote>
<p><strong>If you are asking users for their gender</strong>, you’d better have a good reason and options that include everyone. A gender field should have <a href="https://uxdesign.cc/designing-forms-for-gender-diversity-and-inclusion-d8194cf1f51">more than two options</a>, or should ask for pronouns instead. When including more than binary options, actually record the selections in your databases <a href="https://journals.sagepub.com/doi/full/10.1177/1461444815621527">instead of reclassifying</a> answers as male/female/null, otherwise you risk losing trust when disingenuous design decisions become public.</p>
<p><strong>Honorifics</strong> are infrequently used these days, but it takes little work to add <a href="https://en.wikipedia.org/wiki/Gender-neutral_title">gender-inclusive titles</a> to a list. For English-language sites, “Mx.” can go alongside “Mr.” and “Ms.” without fuss. United Airlines <a href="https://www.msn.com/en-ph/autos/other/united-airlines-becomes-first-us-carrier-to-launch-non-binary-gender-booking-option/ar-BBV6nhz?li=AAxCjZq">debuted this option</a> earlier this year.</p>
<h2 id="section9">Content<a class="subhead-anchor" href="#section9">#section9</a></h2>
<p><strong><em>Here’s what we can do:</em></strong></p>
<p><strong>Avoid inappropriately gendered language.</strong> Your style guide should include <a href="https://en.wikipedia.org/wiki/Singular_they">singular “they”</a> instead of “he/she” or “s/he,” and exclude <a href="https://writingcenter.unc.edu/tips-and-tools/gender-inclusive-language/">frequently used words and phrases</a> that exclude trans folks. Resources such as this <a href="https://radicalcopyeditor.com/2017/08/31/transgender-style-guide/">transgender style guide</a> are a quick way to check your language and benchmark your own content guidelines.</p>
<p><strong>Check assumptions about gender and biology.</strong> Not everyone who can have a period, can get pregnant, or can breastfeed identifies as women or mothers—just as not everyone who identifies as women or mothers can have periods, can get pregnant, or can breastfeed. Thinx, a company that sells period underwear, has an inclusive tagline: “For people with periods.”</p>
<p><strong>Avoid reinforcing the binary.</strong> Groups of people aren’t “ladies and gentlemen” or “boys and girls.” They are folks, people, colleagues, “y’all,” or even “<a href="https://twitter.com/texaninnyc/status/954334612905394177">all y’all</a>.”</p>
<p><strong>Pronouns aren’t “preferred”</strong>—they’re just pronouns. Calling pronouns preferred suggests that they’re optional and are replacing a “true” pronoun.</p>
<p><strong>Avoid reinforcing stereotypes</strong> about trans people. Not all trans people are interested in medically transitioning, or in “<a href="https://en.wikipedia.org/wiki/Passing_(gender)">passing</a>.” They also aren’t fragile or in need of a savior. Gender is separate from sexual orientation. You can’t “tell” someone is trans.</p>
<h2 id="section10"><strong>Privacy, surveillance, and nefarious AI</strong><a class="subhead-anchor" href="#section10">#section10</a></h2>
<p>We’ve heard the story of algorithms <a href="https://www.forbes.com/sites/kashmirhill/2012/02/16/how-target-figured-out-a-teen-girl-was-pregnant-before-her-father-did/">identifying a pregnant teen</a> before her parents knew. What if an algorithm predicts or reveals information about your gender identity?</p>
<p><strong>Inferences.</strong> Users’ genders are assumed based on their purchase/browsing history.</p>
<p><strong>Recommendations.</strong> A user bought something before they transitioned and it shows up in “recommended because you bought X.”</p>
<p><strong>Predictions.</strong> Users’ genders are not only inferred but used to predict something else based on characteristics of that gender. Even if you don’t tell big websites what your gender is, they assume one for you based on your interests. That kind of reductive essentialism can harm people of all genders. One of this article’s peer readers summed this up:</p>
<blockquote class="wp-block-quote">
<p>“Gender markers are a poor proxy for tastes. I like dresses, cute flats, and Raspberry Pis.”</p>
</blockquote>
<p><strong>Flashbacks.</strong> “On this day” algorithms remind users of the past, sometimes for better (“I’ve come so far”) or for worse (“<a href="https://meyerweb.com/eric/thoughts/2014/12/24/inadvertent-algorithmic-cruelty/">don’t remind me</a>”).</p>
<h3 id="section11">AI-based discrimination<a class="subhead-anchor" href="#section11">#section11</a></h3>
<p>AI and surveillance software can also reinforce norms about what men’s and women’s bodies should look like, resulting in <a href="https://www.nytimes.com/2019/04/17/opinion/tsa-transgender.html?searchResultPosition=1">harrowing airline travel experiences</a> and creating <a href="https://modelviewculture.com/pieces/the-hidden-dangers-of-ai-for-queer-and-trans-people">AI-based discrimination</a> for trans people.</p>
<p>So, too, can <a href="https://www.theverge.com/2017/8/22/16180080/transgender-youtubers-ai-facial-recognition-dataset">trans folks’ public data be used for projects that they don’t consent to</a>. Just because we can use AI for something—like <a href="https://twitter.com/rosa/status/1119736583521853441?s=12">determining gender based on a face scan</a>—doesn’t mean we <em>should</em>.</p>
<p><strong><em>Here’s what we can do:</em></strong></p>
<p><strong>Read up and proactively mitigate bias.</strong><a href="https://www.dazeddigital.com/science-tech/article/43211/1/trans-algorithm-machine-learning-bias-discrimination-chelsea-manning-edit">AI and algorithmscan reflect developers’ biases</a> and perpetuate stereotypes about how people’s bodies should look. Use AI to <a href="https://qz.com/work/1577597/this-ai-voice-is-gender-neutral-unlike-siri-and-alexa/">challenge the gender binary</a>rather than reinforce it. Design for <a href="https://medium.com/greater-than-experience-design/privacy-by-design-7b1165d045e0">privacy first</a><strong><em>.</em></strong>Hire more types of people who represent different lived experiences.</p>
<h2 id="section12"><strong>Toward a gender-inclusive web</strong><a class="subhead-anchor" href="#section12">#section12</a></h2>
<p>The ideas I’ve offered here are only starting points. How you choose to create space for trans folks is going to be up to you. I don’t have all the solutions here, and there is no singular trans experience. Also, language, definitions, and concepts change <em>rapidly</em>.</p>
<p>We shouldn’t use any of these facts as excuses to keep us from trying.</p>
<p>When we start to think about design impact on trans folks, the ideas we bring into question can benefiteveryone. Our designs should go beyond including—they should affirm and validate. Ideally, they will also reflect organizational cultures that support diversity and inclusion.</p>
<p><strong><em>Here’s what we can do:</em></strong></p>
<p>Keep learning. Learn <a href="https://transequality.org/issues/resources/supporting-the-transgender-people-in-your-life-a-guide-to-being-a-good-ally">how to be a good ally</a>. Pay trans user research participants to help validate your design assumptions. Hire trans people on your team and don’t hang them out to dry or make them do all the hard work around inclusion and equity. Make it everyone’s job to build a more just web and world for everybody.</p>
<p><em>Editorial note: All personal statements quoted in this article have been graciously shared with the express consent of the original authors.</em></p>
<p><em>This article is stronger and wiser thanks to Mica McPheeters at</em> A List Apart <em>and the following peer readers. Thank you.</em></p>
<p>Jake Atchison<br />
Katherine Deibel, Ph.D.<br />
Justina F. Hall<br />
Austyn Higgs<br />
Emma Humphries<br />
Tara Robertson<br />
Levi R. Walter</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">In this excerpt from Everyday Information Architecture, Lisa Maria Martin introduces the structural audit.</div><div class="entry-content">Our own @zeldman paints the complicated catch-22 that our free, democratized web has with our money-making capitalist roots. As creators, how do we untangle this web? #LetsFixThis</div><div class="entry-content">A month of experiencing a temporary disability changed @fcorradini’s perspective on how to take more care when conducting accessibility testing. He shares the impact.</div><div class="entry-content">Jeremy Wagner plots a course to avoid the unnecessary bloat and inaccessible patterns of current JavaScript trends.</div><div class="entry-content">Technology can easily become a platform for hate, and we have an ethical responsibility to fix it. ALA's own Tatiana Mac discusses</div>]]></description>
      <link>https://alistapart.com/article/trans-inclusive-design/</link>
      <guid>https://alistapart.com/article/trans-inclusive-design/</guid>
      <pubDate>Thu, 09 May 2019 12:05:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[<![CDATA[ Everyday Information Architecture: Auditing for Structure ]]]]><![CDATA[>]]></title>
      <description><![CDATA[<div class="entry-content">
<p>Just as we need to understand our content before we can recategorize it, we need to understand the system before we try to rebuild it.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>Enter the structural audit: a review of the site focused solely on its menus, links, flows, and hierarchies. I know you thought we were done with audits back in Chapter 2, but hear me out! Structural audits have an important and singular purpose: to help us build a new sitemap.</p>
<p>This isn’t about recreating the <em>intended</em> sitemap—no, this is about experiencing the site the way users experience it. This audit is meant to track and record the structure of the site as it <em>really</em> works.</p>
<h2 id="section1">Setting up the template<a class="subhead-anchor" href="#section1">#section1</a></h2>
<p>First, we’re gonna need another spreadsheet. (Look, it is not <em>my</em> fault that spreadsheets are the perfect system for recording audit data. I don’t make the rules.)</p>
<p>Because this involves building a spreadsheet from scratch, I keep a “template” at the top of my audit files—rows that I can copy and paste into each new audit (Fig 4.1). It’s a color-coded outline key that helps me track my page hierarchy <em>and</em> my place in the auditing process. When auditing thousands of pages, it’s easy to get dizzyingly lost, particularly when coming back into the sheet after a break; the key helps me stay oriented, no matter how deep the rabbit hole.</p>
<div class="wp-block-image">
<figure id="figure1" class="aligncenter"><img src="https://alistapart.com/wp-content/uploads/2019/04/4.1-outline-key.png" alt="" class="wp-image-6000665" /><figcaption><strong>Fig 4.1:</strong> I use a color-coded outline key to record page hierarchy as I move through the audit. Wait, how many circles did Dante write about?</figcaption></figure></div>
<h3 id="section2">Color-coding<a class="subhead-anchor" href="#section2">#section2</a></h3>
<p>Color is the easiest, quickest way to convey page depth at a glance. The repetition of black text, white cells, and gray lines can have a numbing effect—too many rows of sameness, and your eyes glaze over. My coloring may result in a spreadsheet that looks like a twee box of macarons, but at least I know, instantly, where I am.</p>
<p>The exact colors don’t really matter, but I find that the familiar mental model of a rainbow helps with recognition—the cooler the row color, the deeper into the site I know I must be.</p>
<p>The nested rainbow of pages is great when you’re auditing neatly nested pages—but most websites color outside the lines (pun <em>extremely</em> intended) with their structure. I leave my orderly rainbow behind to capture duplicate pages, circular links, external navigation, and other inconsistencies like:</p>
<ul><li><strong>On-page navigation.</strong> A bright text color denotes pages that are accessible via links within page content—not through the navigation. These pages are critical to site structure but are easily overlooked. Not every page <em>needs</em> to be displayed in the navigation menus, of course—news articles are a perfect example—but sometimes this indicates publishing errors.</li>
<li><strong>External links.</strong> These are navigation links that go to pages outside the domain. They might be social media pages, or even sites held by the same company—but if the domain isn’t the one I’m auditing, I don’t need to follow it. I <em>do</em> need to note its existence in my spreadsheet, so I color the text as the red flag that it is. (As a <em>general</em> rule, I steer clients away from placing external links in navigation, in order to maintain a consistent experience. If there’s a need to send users offsite, I’ll suggest using a contextual, on-page link.)</li>
<li><strong>Files.</strong> This mostly refers to PDFs, but can include Word files, slide decks, or anything else that requires downloading. As with external links, I want to capture anything that might disrupt the in-site browsing experience. (My audits usually filter out PDFs, but for organizations that overuse them, I’ll audit them separately to show how much “website” content is locked inside.)</li>
<li><strong>Unknown hierarchy.</strong> Every once in a while, there’s a page that doesn’t seem to belong anywhere—maybe it’s missing from the menu, while its URL suggests it belongs in one section and its navigation scheme suggests another. These pages need to be discussed with their owners to determine whether the content needs to be considered in the new site.</li>
<li><strong>Crosslinks.</strong> These are navigation links for pages that canonically live in a different section of the site—in other words, they’re duplicates. This often happens in footer navigation, which may repeat the main navigation or surface links to deeper-but-important pages (like a Contact page or a privacy policy). I don’t want to record the same information about the page twice, but I do need to know where the crosslink is, so I can track different paths to the content. I color these cells gray so they don’t draw my attention.</li>
</ul><p>Note that coloring every row (and indenting, as you’ll see in a moment) can be a tedious process—unless you rely on Excel’s formatting brush. That tool applies all the right styles in just two quick clicks.</p>
<h3 id="section3">Outlines and page IDs<a class="subhead-anchor" href="#section3">#section3</a></h3>
<p>Color-coding is half of my template; the other half is the outline, which is how I keep track of the structure itself. (No big deal, just <em>the entire point of the spreadsheet</em>.)</p>
<p>Every page in the site gets assigned an ID. <em>You</em> are assigning this number; it doesn’t correspond to anything but your own perception of the navigation. This number does three things for you:</p>
<ol><li>It associates pages with their place in the site hierarchy. Decimals indicate levels, so the page ID can be decoded as the page’s place in the system.</li>
<li>It gives each page a unique identifier, so you can easily refer to a particular page—saying “2.4.1” is much clearer than “you know that one page in the fourth product category?”</li>
<li>You can keep using the ID in other contexts, like your sitemap. Then, later, when your team decides to wireframe pages 1.1.1 and 7.0, you’ll all be working from the same understanding.</li>
</ol><p>Let me be completely honest: things might get goofy sometimes with the decimal outline. There will come a day when you’ll find yourself casually typing out “1.2.1.2.1.1.1,” and at that moment, a fellow auditor somewhere in the universe will ring a tiny gong for you.</p>
<p>In addition to the IDs, I indent each level, which reinforces both the numbers and the colors. Each level down—each digit in the ID, each change in color—gets one indentation.</p>
<p>I identify top-level pages with a single number: 1.0, 2.0, 3.0, etc. The next page level in the first section would be 1.1, 1.2, 1.3, and so on. I mark the homepage as 0.0, which is mildly controversial—the homepage is technically a level above—but, look: I’ve got a lot of numbers to write, and I don’t need those numbers to tell me they’re under the homepage, so this is my system. Feel free to use the numbering system that work best for you.</p>
<h3 id="section4">Criteria and columns<a class="subhead-anchor" href="#section4">#section4</a></h3>
<p>So we’ve got some secret codes for tracking hierarchy and depth, but what about other structural criteria? What are our spreadsheet <em>columns</em> (Fig 4.2)? In addition to a column for Page ID, here’s what I cover:</p>
<ul><li><strong>URL.</strong> I don’t consistently fill out this column, because I already collected this data back in my automated audit. I include it every twenty entries or so (and on crosslinks or pages with unknown hierarchy) as another way of tracking progress, and as a direct link into the site itself.</li>
<li><strong>Menu label/link.</strong> I include this column only if I notice a lot of mismatches between links, labels, and page names. Perfect agreement isn’t required; but frequent, significant differences between the language that <em>leads</em> to a page and the language <em>on the page itself</em> may indicate inconsistencies in editorial approach or backend structures.</li>
<li><strong>Name/headline.</strong> Think of this as “what does the page owner call it?” It may be the H1, or an H2; it may match the link that brought you here, or the page title in the browser, or it may not.</li>
<li><strong>Page title.</strong> This is for the name of the page in the metadata. Again, I don’t use this in every audit—particularly if the site uses the same long, branded metadata title for every single page—but frequent mismatches can be useful to track.</li>
<li><strong>Section.</strong> While the template can indicate your level, it can’t tell you which area of the site you’re in—unless you write it down. (This may differ from the section data you applied to your automated audit, taken from the URL structure; here, you’re noting the section where the page appears.)</li>
<li><strong>Notes.</strong> Finally, I keep a column to note specific challenges, and to track patterns I’m seeing across multiple pages—things like “Different template, missing subnav” or “Only visible from previous page.” My only caution here is that if you’re planning to share this audit with another person, make sure your notes are—<em>ahem</em>—professional. Unless you enjoy anxiously combing through hundreds of entries to revise comments like “Wow haha nope” (not that I would know anything about that).</li>
</ul><figure id="figure2" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/04/4.2-audit-columns.png?w=960" alt="" class="wp-image-6000666" /><figcaption><strong>Fig 4.2:</strong> A semi-complete structural audit. This view shows a lot of second- and third-level pages, as well as pages accessed through on-page navigation.</figcaption></figure><p>Depending on your project needs, there may be other columns, too. If, in addition to using this spreadsheet for your new sitemap, you want to use it in migration planning or template mapping, you may want columns for new URLs, or template types. </p>
<p>You can get your own copy of my template as <a href="http://bkaprt.com/eia/04-01/">a downloadable Excel file</a>. Feel free to tweak it to suit your style and needs; I know I always do. As long as your spreadsheet helps you understand the hierarchy and structure of your website, you’re good to go.</p>
<h2 id="section5">Gathering data<a class="subhead-anchor" href="#section5">#section5</a></h2>
<p>Setting up the template is one thing—actually filling it out is, admittedly, another. So how do we go from a shiny, new, naive spreadsheet to a complete, jaded, seen-some-<em>stuff</em> spreadsheet? I always liked Erin Kissane’s description of the process, from <em>The Elements of Content Strategy</em>:</p>
<blockquote class="wp-block-quote">
<p>Big inventories involve a lot of black coffee, a few late nights, and a playlist of questionable but cheering music prominently featuring the soundtrack of object-collecting video game Katamari Damacy. It takes quite a while to exhaustively inventory a large site, but it’s the only way to really understand what you have to work with.</p>
</blockquote>
<p>We’re not talking about the same kind of exhaustive inventory she was describing (though I <em>am</em> recommending Katamari music). But even our less intensive approach is going to require your butt in a seat, your eyes on a screen, and a certain amount of patience and focus. You’re about to walk, with your fingers, through most of a website.</p>
<p>Start on the homepage. (We know that not all users start there, but we’ve got to have some kind of order to this process or we’ll never get through it.) Explore the main navigation before moving on to secondary navigation structures. Move left to right, top to bottom (assuming that is your language direction) over each page, looking for the links. You want to record every page you can reasonably access on the site, noting navigational and structural considerations as you go.</p>
<p>My advice as you work:</p>
<ul><li><strong>Use two monitors.</strong> I struggle immensely without two screens in this process, which involves constantly switching between spreadsheet and browser in rapid, tennis-match-like succession. If you don’t have access to multiple monitors, find whatever way is easiest for you to quickly flip between applications.</li>
<li><strong>Record what you see.</strong> I generally note all visible menu links at the same level, then exhaust one section at a time. Sometimes this means I have to adjust what I initially observed, or backtrack to pages I missed earlier. You might prefer to record all data across a level before going deeper, and that would work, too. Just be consistent to minimize missed links.</li>
<li><strong>Be alert to inconsistencies.</strong> On-page links, external links, and crosslinks can tell you a lot about the structure of the site, but they’re easy to overlook. Missed on-page links mean missed content; missed crosslinks mean duplicate work. (Note: the further you get into the site, the more you’ll start seeing crosslinks, given all the pages you’ve already recorded.)</li>
<li><strong>Stick to what’s structurally relevant.</strong> A single file that’s not part of a larger pattern of file use is not going to change your understanding of the structure. Neither is recording every single blog post, quarterly newsletter, or news story in the archive. For content that’s dynamic, repeatable, and plentiful, I use an <em>x</em> in the page ID to denote more of the same. For example, a news archive with a page ID of 2.8 might show just one entry beneath it as 2.8.x; I don’t need to record every page up to 2.8.791 to understand that there are 791 articles on the site (assuming I noted that fact in an earlier content review).</li>
<li><strong>Save</strong>. Save <em>frequently</em>. I cannot even begin to speak of the unfathomable heartbreak that is Microsoft Excel burning an unsaved audit to the ground.  </li>
</ul><p>Knowing which links to follow, which to record, and how best to untangle structural confusion—that improves with time and experience. Performing structural audits will not only teach you about your current site, but will help you develop fluency in systems thinking—a boon when it comes time to document the new site.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Our own @zeldman paints the complicated catch-22 that our free, democratized web has with our money-making capitalist roots. As creators, how do we untangle this web? #LetsFixThis</div><div class="entry-content">A month of experiencing a temporary disability changed @fcorradini’s perspective on how to take more care when conducting accessibility testing. He shares the impact.</div><div class="entry-content">Jeremy Wagner plots a course to avoid the unnecessary bloat and inaccessible patterns of current JavaScript trends.</div><div class="entry-content">Technology can easily become a platform for hate, and we have an ethical responsibility to fix it. ALA's own Tatiana Mac discusses</div><div class="entry-content">Screen readers are diverse and complex: front-end developer Melanie Richards breaks down how they access our content step-by-step.</div>]]></description>
      <link>https://alistapart.com/article/everyday-information-architecture-excerpt/</link>
      <guid>https://alistapart.com/article/everyday-information-architecture-excerpt/</guid>
      <pubDate>Thu, 18 Apr 2019 12:04:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[<![CDATA[ Nothing Fails Like Success ]]]]><![CDATA[>]]></title>
      <description><![CDATA[<div class="entry-content">
<p>A family buys a house they can’t afford. They can’t make their monthly mortgage payments, so they borrow money from the Mob. Now they’re in debt to the bank and the Mob, live in fear of losing their home, and must do whatever their creditors tell them to do.<br /></p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>Welcome to the internet, 2019.<br /></p>
<p>Buying something you can’t afford, and borrowing from organizations that don’t have your (or your customers’) best interest at heart, is the business plan of most internet startups. It’s why our digital services and social networks in 2019 are a <a href="https://en.wikipedia.org/wiki/Criticism_of_Facebook">garbage fire</a> of <a href="https://www.dailydot.com/layer8/fake-news-sites-list-facebook/">lies</a>, <a href="https://www.ajc.com/lifestyles/religion/teens-and-the-distorted-reality-social-media/XnWAduy5s1I3rUL1yH1ZZO/">distortions</a>, <a href="https://www.nytimes.com/2017/05/31/technology/twitter-facebook-google-europe-hate-speech.html">hate speech</a>, <a href="https://www.theguardian.com/media-network/media-network-blog/2014/may/13/internet-confirmation-bias">tribalism</a>, <a href="https://www.verywellhealth.com/social-medias-role-in-privacy-breaches-2317518">privacy violations</a>, <a href="https://en.wikipedia.org/wiki/Elizabeth_Holmes">snake oil</a>, <a href="https://www.businessinsider.com/doctors-warn-google-twitter-facebook-anti-vaxxers-2019-3">dangerous idiocy</a>, <a href="https://www.nytimes.com/2017/09/29/opinion/mark-zuckerberg-facebook.html">deflected responsibility</a>, and whole new categories of unpunished ethical breaches and crimes.<br /></p>
<p>From optimistically conceived origins and message statements about making the world a better place, too many websites and startups have become <a href="https://alistapart.com/article/canary-in-a-coal-mine-how-tech-provides-platforms-for-hate">the leading edge of bias and trauma</a>, especially for marginalized and at-risk groups.</p>
<h2 id="section1">Why (almost) everything sucks<a class="subhead-anchor" href="#section1">#section1</a></h2>
<p>Twitter, for instance, needs a lot of views for advertising to pay at the massive scale its investors demand. A lot of views means you can’t be too picky about what people share. If it’s misogynists or racists inspiring others who share their heinous beliefs to bring back the 1930s, hey, it’s measurable. If a powerful elected official’s out-of-control tweeting reduces churn and increases views, not only can you pay your investors, you can even take home a bonus. Maybe it can pay for that next meditation retreat.<br /></p>
<p>You can cloak this basic economic trade-off in fifty layers of bullshit—say you believe in freedom of speech, or that the antidote to bad speech is more speech—but the fact is, hate speech is profitable. It’s killing our society and our planet, but it’s profitable. And the remaining makers of Twitter—the ones whose consciences didn’t send them packing years ago—no longer have a choice. The guy from the Mob is on his way over, and the <a href="https://www.urbandictionary.com/define.php?term=vig">vig</a> is due.<br /></p>
<p>Not to single out Twitter, but this is clearly the root cause of its seeming indifference to the destruction hate speech is doing to society…and will ultimately do to the platform. (But by then Jack will be able to afford to <a href="https://www.vanityfair.com/news/2018/12/jack-dorsey-vipassana-debacle-why-people-hate-twitter">meditate</a> full-time.)<br /></p>
<p>Other companies do other evil things to pay their vig. When you owe the Mob, you have no choice. Like sell our data. Or lie about medical research.<br /></p>
<p>There <em>are</em> internet companies (like <a href="https://basecamp.com/">Basecamp</a>, or like <a href="https://automattic.com/">Automattic</a>, makers of <a href="https://wordpress.com/">WordPress.com</a>, where I work) that charge money for their products and services, and use that money to grow their business. I wish more internet companies could follow that model, but it’s hard to retrofit a legitimate business model to a product that started its life as free.<br /></p>
<p>And there are even some high-end news publications, such as <em>The New York Times</em>, <em>The</em> <em>Washington Post</em>, and <em>The Guardian</em>, that survive on a combination of advertising and flexible paywalls. But these options are not available to most digital publications and businesses.</p>
<h2 id="section2">Return with me to those <a href="http://johnstyn.com/">Halcyon</a> days…<a class="subhead-anchor" href="#section2">#section2</a></h2>
<p>Websites and internet startups used to be you and your friends making cool stuff for your other friends, and maybe building new friendships and even small communities in the process. (Even in 2019, that’s still how <em>some</em> websites and startups begin—as labors of love, fashioned by idealists in their spare time.)<br /></p>
<p>Because they are labors of love; because we’ve spent 25 years training people to believe that <a href="https://en.wikipedia.org/wiki/Information_wants_to_be_free">websites, and news, and apps, and services should be free</a>; because, when we begin a project, we can scarcely believe anyone will ever notice or care about it—for these reasons and more, the things we make digitally, especially on the web, are offered free of charge. We labor on, excited by positive feedback, and delighted to discover that, if we keep at it, our little community will grow.<br /></p>
<p>Most such labors of love disappear after a year or two, as the creators drift out of touch with each other, get “real” jobs, fall in love, start families, or simply lose interest due to lack of attention from the public or the frustrations of spending weekends and holidays grinding away at an underappreciated site or app while their non-internet friends spend those same hours either having fun or earning money.</p>
<h2 id="section3">Along came money<a class="subhead-anchor" href="#section3">#section3</a></h2>
<p>But <em>some</em> of these startup projects catch on. And when they do, a certain class of investor smells ROI. And the naive cofounders, who never expected their product or service to really get anywhere, can suddenly envision themselves rich and Zuckerberg-famous. Or maybe they like the idea of quitting their day job, believing in themselves, and <em>really going for it</em>. After all, that is an empowering and righteous vision.<br /></p>
<p>Maybe they believe that by taking the initial investment, they can do more good—that their product, if developed further, can actually help people. This is often the motivation behind agreeing to an initial investment deal, especially in categories like healthcare.<br /></p>
<p>Or maybe the founders are problem solvers. Existing products or services in a given category have a big weakness. The problem solvers are sure that their idea is better. With enough capital, and a slightly bigger team, they can show the world how to do it right. Most inventions that have moved humankind forward followed exactly this path. It should lead to a better world (and it sometimes does). It shouldn’t produce privacy breaches and fake medicine and election-influencing bots and all the other plagues of our emerging digital civilization. So why does it?</p>
<h2 id="section4">Content wants to be paid<a class="subhead-anchor" href="#section4">#section4</a></h2>
<p>Primarily it is because these businesses have no business model. They were made and given away free. Now investors come along who can pay the founders, buy them an office, give them the money to staff up, and even help with PR and advertising to help them grow faster.<br /></p>
<p>Now there are salaries and insurance and taxes and office space and travel and lecture tours and sales booths at SXSW, but there is still no charge for the product.<br /></p>
<p>And the investor seeks a big return.<br /></p>
<p>And when the initial investment is no longer enough to get the free-product company to scale to the big leagues, that’s when the really big investors come in with the really big bucks. And the company is suddenly famous overnight, and “everybody” is using the product, and it’s still free, and the investors are still expecting a giant payday.<br /></p>
<p>Like I said—a house you can’t afford, so you go into debt to the bank and the Mob.</p>
<h2 id="section5">The money trap<a class="subhead-anchor" href="#section5">#section5</a></h2>
<p>Here it would be easy to blame capitalism, or at least untrammeled, under-regulated capitalism, which has often been a source of human suffering—not that capitalism, properly regulated, can’t also be a force for innovation which <em>ameliorates</em> suffering. That’s the dilemma for our society, and where you come down on free markets versus governmental regulation of businesses should be an intellectual decision, but these days it is a label, and we hate our neighbors for coming down a few degrees to the left or right of us. But I digress and oversimplify, and this isn’t a complaint about late stage capitalism per se, although it may smell like one.<br /></p>
<p>No, the reason small companies created by idealists too frequently turn into consumer-defrauding forces for evil has to do with the amount of profit each new phase of investor expects to receive, and how quickly they expect to receive it, and the fact that the products and services are still free. And <a href="https://www.quora.com/Who-originally-suggested-that-if-youre-not-paying-for-the-product-you-are-the-product">you know what they say about free products</a>.<br /></p>
<h2 id="section6">Nothing fails like success<a class="subhead-anchor" href="#section6">#section6</a></h2>
<p>A friend who’s a serial entrepreneur has started maybe a dozen internet businesses over the span of his career. They’ve all met a need in the marketplace. As a consequence, they’ve all found customers, and they’ve all made a profit. Yet his investors are rarely happy.<br /></p>
<p>“Most of my startups have the decency to fail in the first year,” one investor told him. My friend’s business was taking in several million dollars a year and was slowly growing in staff and customers. It was profitable. Just not obscenely so.<br /></p>
<p>And internet investors don’t want a modest return on their investment. They want an obscene profit right away, or a brutal loss, which they can write off their taxes. Making them a hundred million for the ten million they lent you is good. Losing their ten million is also good—they pay a lower tax bill that way, or they use the loss to fold a company, or they make a profit on the furniture while writing off the business as a loss…whatever rich people can legally do under our tax system, which is quite a lot.<br /></p>
<p>What these folks don’t want is to lend you ten million dollars and get twelve million back.<br /></p>
<p>You and I might go, “Wow! I just made two million dollars just for being privileged enough to have money to lend somebody else.” And that’s why you and I will never have ten million dollars to lend anybody. Because we would be grateful for it. And we would see a free two million dollars as a life-changing gift from God. But investors don’t think this way.</p>
<h2 id="section7">We didn’t start the fire, but we roasted our weenies in it<a class="subhead-anchor" href="#section7">#section7</a></h2>
<p>As much as we pretend to be a religious nation, our society worships these investors and their profits, worships companies that turn these profits, worships above all the myth of overnight success, which we use to motivate the hundreds of thousands of workers who will work nights and weekends for the owners in hopes of cashing in when the stock goes big.<br /></p>
<p>Most times, even if the stock does go big, the owner has found a way to devalue it by the time it does. Owners have brilliant advisers they pay to figure out how to do those things. You and I don’t.</p>
<h2 id="section8">A Christmas memory<a class="subhead-anchor" href="#section8">#section8</a></h2>
<p>I remember visiting San Francisco years ago and scoring an invitation to Twitter’s Christmas party through a friend who worked there at the time. Twitter was, at the time, an app that worked via SMS and also via a website. Period.<br /></p>
<p>Some third-party companies, starting with my friends at <a href="https://iconfactory.com/">Iconfactory</a>, had built iPhone apps for people who wanted to navigate Twitter via their newfangled iPhones instead of the web. Twitter itself hadn’t publicly addressed mobile and might not even have been thinking about it.<br /></p>
<p>Although Twitter was transitioning from a fun cult thing—used by bloggers who attended <a href="https://www.sxsw.com/festivals/interactive/">SXSW Interactive</a> in 2007—to an emerging cultural phenomenon, it was still quite basic in its interface and limited in its abilities. Which was not a bad thing. There is art in constraint, value in doing one thing well. As an outsider, if I’d thought about it, I would have guessed that Twitter’s entire team consisted of no more than 10 or 12 wild-eyed, sleep-deprived true believers.<br /></p>
<p>Imagine my surprise, then, when I showed up at the Christmas party and discovered I’d be sharing dinner with hundreds of designers, developers, salespeople, and executives instead of the handful I’d naively anticipated meeting. (By now, of course, Twitter employs many thousands. It’s still not clear to an outsider why so many workers are needed.)<br /></p>
<p>But one thing is clear: somebody has to pay for it all.</p>
<h2 id="section9">Freemium isn’t free<a class="subhead-anchor" href="#section9">#section9</a></h2>
<p>Employees, let alone thousands of them, on inflated Silicon Valley engineer salaries, aren’t free. Health insurance and parking and meals and HR and travel and expense accounts and meetups and software and hardware and office space and amenities aren’t free. Paying for all that while striving to repay investors tenfold means making a buck any way you can.<br /></p>
<p>Since the product was born free and a paywall isn’t feasible, Twitter must rely on that old standby: advertising. Advertising may not generate enough revenue to keep your hometown newspaper (or most podcasts and content sites) in business, but at Twitter’s scale, it pays.<br /></p>
<p>It pays because Twitter has so many active users. And what keeps those users coming back? Too often, it’s the dopamine of relentless tribalism—folks whose political beliefs match and reinforce mine in a constant unwinnable war of words with folks whose beliefs differ.<br /></p>
<p>Of course, half the antagonists in a given brawl may be bots, paid for in secret by an organization that wants to make it appear that most citizens are against Net Neutrality, or that most Americans oppose even the most basic gun laws, or that our elected officials work for lizard people. The whole system is broken and dangerous, but it’s also addictive, and we can’t look away. From our naive belief that content wants to be free, and our inability to create businesses that pay for themselves, we are turning our era’s greatest inventions into engines of doom and despair.</p>
<h2 id="section10">Your turn<a class="subhead-anchor" href="#section10">#section10</a></h2>
<p>So here we are. Now what do we do about it?<br /></p>
<p>It’s too late for current internet businesses (victims of their own success) that are mortgaged to the hilt in investor gelt. But could the next generation of internet startups learn from older, stable companies like Basecamp, and design products that pay for themselves via customer income—products that profit slowly and sustainably, allowing them to scale up in a similarly slow, sustainable fashion?<br /></p>
<p>The self-payment model may not work for apps and sites that are designed as modest amusements or communities, but maybe those kinds of startups don’t need to make a buck—maybe they can simply be labors of love, like the websites we loved in the 1990s and early 2000s.<br /></p>
<p>Along those same lines, can the <a href="https://indieweb.org/">IndieWeb</a>, and products of IndieWeb thinking like <a href="https://micro.blog/">Micro.blog</a>, save us? Might they at least provide an alternative to the toxic aspects of our current social web, and restore the ownership of our data and content? And before you answer, <a href="https://indieweb.org/Getting_Started">RTFM</a>.<br /></p>
<p>On an individual and small collective basis, the IndieWeb already works. But does an IndieWeb approach scale to the general public? If it doesn’t scale <em>yet</em>, can we, who envision and design and build, create a new generation of tools that will help give birth to a flourishing, independent web? One that is as accessible to ordinary internet users as Twitter and Facebook and Instagram? <a href="https://en.wikipedia.org/wiki/Tantek_%C3%87elik">Tantek Çelik</a> thinks so, and he’s been right about the web for nearly 30 years. (For more about what Tantek thinks, <a href="http://5by5.tv/bigwebshow/186">listen to our conversation</a> in Episode № 186 of The Big Web Show.)<br />
Are these approaches mere whistling against a hurricane? Are most web and internet users content with how things are? What do <em>you</em> think? Share your thoughts on your personal website (dust yours off!) or (irony ahoy!) on your indie or mainstream social networks of choice using hashtag <strong>#LetsFixThis</strong>. I can’t wait to see what you have to say.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">A month of experiencing a temporary disability changed @fcorradini’s perspective on how to take more care when conducting accessibility testing. He shares the impact.</div><div class="entry-content">Jeremy Wagner plots a course to avoid the unnecessary bloat and inaccessible patterns of current JavaScript trends.</div><div class="entry-content">Technology can easily become a platform for hate, and we have an ethical responsibility to fix it. ALA's own Tatiana Mac discusses</div><div class="entry-content">Screen readers are diverse and complex: front-end developer Melanie Richards breaks down how they access our content step-by-step.</div><div class="entry-content">Brandon Gregory discusses designing for conversions, which allows products to reach their targets and serve the right people.</div>]]></description>
      <link>https://alistapart.com/article/nothing-fails-like-success/</link>
      <guid>https://alistapart.com/article/nothing-fails-like-success/</guid>
      <pubDate>Thu, 11 Apr 2019 09:04:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[Accessibility for Vestibular Disorders: How My Temporary Disability Changed My Perspective]]></title>
      <description><![CDATA[<p>Accessibility can be tricky. There are plenty of conditions to take into consideration, and many technical limitations and weird exceptions that make it quite hard to master for most designers and developers.</p>


<p>I never considered myself an accessibility <em>expert</em>, but I took great pride in making my projects Web Content Accessibility Guidelines (WCAG) compliant…ish. They would pass most automated tests, show perfectly in the accessibility tree, and work quite well with keyboard navigation. I would even try (and fail) to use a screen reader every now and then.</p>
<p>But life would give me a lesson I would probably never learn otherwise: last October, my <em>abled</em> life took a drastic change—I started to feel extremely dizzy, with a constant sensation of falling or spinning to the right. I was suffering from a bad case of vertigo caused by labyrinthitis that made it impossible to get <em>anything</em> done.</p>
<p>Vertigo can have a wide range of causes, the most common being a viral infection or tiny calcium crystal free floating in the inner ear, which is pretty much our body’s accelerometer. Any disruption in there sends the brain confusing signals about the body’s position, which causes really heavy nausea, dizziness, and headaches. If you’ve ever felt seasick, it’s quite a similar vibe. If not, think about that feeling when you just get off a rollercoaster…it’s like that, only <em>all day long</em>.</p>
<p>For most people, <a href="https://vestibular.org/understanding-vestibular-disorders/types-vestibular-disorders/benign-paroxysmal-positional-vertigo">vertigo is something they’ll suffer just once in a lifetime</a>, and it normally goes away in a week or two. Incidence is really high, with some estimates claiming that up to 40% of the population suffers vertigo at least once in their lifetime. Some people live all their lives with it (or with similar symptoms caused by a range of diseases and syndromes grouped under the umbrella term of <em>vestibular disorders</em>), with 4% of US adults reporting chronic problems with balance, and an additional 1.1% reporting chronic dizziness, <a href="https://www.asha.org/PRPSpecificTopic.aspx?folderid=8589942134&amp;section=Incidence_and_Prevalence">according to the American Speech-Language-Hearing Association</a>.</p>
<p>In my case, it was a little over a month. Here’s what I learned while going through it.</p>
<h2>Slants can trigger vestibular symptoms</h2>
<p>It all started as I was out for my daily jog. I felt slightly dizzy, then suddenly my vision got totally distorted. Everything appeared further away, like looking at a fun house’s distortion mirror. I stumbled back home and rested; at that moment I believed I might have over-exercised, and that hydration, food, and rest were all I needed. Time would prove me wrong.</p>
<p>What I later learned was that experiencing vertigo is a constant war between one of your inner ears telling the brain “everything is fine, we’re level and still” and the other ear shouting “oh my God, we’re falling, we’re falling!!!” Visual stimuli can act as an intermediary, supporting one ear’s message or the other’s. Vertigo can also work in the opposite way, with the dizziness interfering with your vision.</p>
<p>I quickly found that when symptoms peaked, staring at a distant object would ease the falling sensation <em>somewhat</em>.</p>
<p>In the same fashion, some visual stimuli would worsen it.</p>
<p>Vertical slants were a big offender in that sense. For instance, looking at a subtle vertical slant (the kind that you’d have to look at twice to make sure it’s not perfectly vertical) on a webpage would instantly trigger symptoms for me. Whether it was a page-long slant used to create some interest beside text or a tiny decoration to mark active tabs, looking at anything with slight slants would instantly send me into the rollercoaster.</p>
<p>Horizontal slants (whatever the degree) and harder vertical slants wouldn’t cause these issues.</p>
<p>My best guess is that slight vertical slants can look like forced perspective and therefore reinforce the falling-from-height sensation, so I would recommend avoiding vertical slants if you can, or make them super obvious. A slight slant looks like perspective, a harder one looks like a triangle.</p>
<h2>Target size matters (even on mouse-assisted devices)</h2>
<p>After a magnetic resonance imaging (MRI) scan, some tests to discard neurological conditions, and other treatments that proved ineffective, I was prescribed Cinnarizine.</p>
<p>Cinnarizine is a calcium channel blocker—to put it simply, it prevents the malfunctioning inner ear “accelerometer” from sending incorrect info to the brain.<br />
And it worked wonders. After ten days of being barely able to get out of bed, I was finally getting something closer to my normal life. I would still feel dizzy all the time, with some peaks throughout the day, but for the most part, it was much easier.</p>
<p>At this point, I was finally able to use the computer (but still unable to produce any code at all). To make the best of it, I set on a mission to self-experiment on accessibility for vestibular disorders. In testing, I found that one of the first things that struck me was that I would always miss targets (links and buttons).</p>
<p>I’m from the generation that grew up with desktop computers, so using a mouse is second nature. The pointer is pretty much an extension of my mind, as it is for many who use it regularly. But while Cinnarizine helped with the dizziness, it has a common side effect of negatively impacting coordination and fine motor skills (it is recommended not to drive or operate machinery while under treatment). It was not a surprise when I realized it would be much harder to get the pointer to do what I intended.</p>
<p>The common behavior would be: moving the pointer past the link I intended to click, clicking before reaching it at all, or having to try multiple times to click on smaller targets.</p>
<p><a href="https://www.w3.org/WAI/WCAG21/Understanding/target-size.html">Success Criterion 2.5.5 Target Size (Level AAA)</a> of the World Wide Web Consortium (W3C)’s WCAG recommends bigger target sizes so users can activate them easily. The obvious reason for this is that it’s harder to pinpoint targets on smaller screens with coarser inputs (i.e., touchscreens of mobile devices). A fairly common practice for developers is to set bigger target sizes for smaller viewport widths (assuming that control challenges are only touch-related), while neglecting the issue on big screens expected to be used with mouse input. I know I’m guilty of that myself.</p>
<p>Instead of targeting this behavior for just smaller screen sizes, there are plenty of reasons to create larger target sizes on <em>all</em> devices: it will benefit users with limited vision (when text is scaled up accordingly and colors are of sufficient contrast), users with mobility impairments such as hand tremors, and of course, users with difficulty with fine motor skills.</p>
<h2>Font size and spacing</h2>
<p>Even while “enjoying” the ease of symptoms provided by the treatment, reading <em>anything</em> still proved to be a challenge for the following three weeks.</p>
<p>I was completely unable to use mobile devices while suffering vertigo due to the smaller font sizes and spacing, so I was forced to use my desktop computer for everything.</p>
<p>I can say I was experiencing something similar to users with mild forms of dyslexia or attention disorders: whenever I got to a website that didn’t follow good font styling, I would find myself reading the same line over and over again.</p>
<p>This proves once again that accessibility is intersectional: when we improve things for a particular purpose it usually benefits users with other challenges as well. I used to believe recommendations on font styles were mostly intended for the nearsighted and those who have dyslexia. Turns out they are also critical for those with vertigo, and even for those with some cognitive differences. At the end of the day, everybody benefits from better readability.</p>
<p>Some actions you can take to improve readability are:</p>
<ul><li>Keep line height to at least 1.5 times the font size (i.e., <code>line-height: 1.5</code>).</li>
<li>Set the spacing between paragraphs to at least 2.0 times the font size. We can do this by adjusting the margins using relative units such as <code>em</code>.</li>
<li>Letter spacing should be at least 0.12 times the font size. We can adjust this by using the <code>letter-spacing</code> CSS property, perhaps setting it in a relative unit.</li>
<li>Make sure to have good contrast between text and its background.</li>
<li>Keep <code>font-weight</code> at a reasonable level for the given <code>font-family</code>. Some fonts have thin strokes that make them harder to read. When using thinner fonts, try to improve contrast and font size accordingly, even more than what WCAG would suggest.</li>
<li>Choose fonts that are easy to read. There has been a large and still inconclusive debate on which font styles are better for users, but one thing I can say for sure is that popular fonts (as in fonts that the user might be already familiar with) are generally the least challenging for users with reading issues.</li>
</ul><p><a href="https://www.w3.org/WAI/WCAG21/Understanding/text-spacing.html">WCAG recommendations on text are fairly clear</a> and fortunately are the most commonly implemented of recommendations, but even they can still fall short sometimes. So, better to follow <a href="http://adrianroselli.com/2015/03/typefaces-for-dyslexia.html#Tips">specific guides on accessible text</a> and your best judgement. <a href="https://www.smashingmagazine.com/2018/09/importance-manual-accessibility-testing/">Passing automated tests does not guarantee actual accessibility.</a></p>
<p>Another issue on which my experience with vertigo proved to be similar to that of people with dyslexia and attention disorders was how hard it was for me to keep my attention in just one place. In that sense…</p>
<h2>Animations are bad (and parallax is pure evil)</h2>
<p>Val Head has already covered <a href="https://alistapart.com/article/designing-safer-web-animation-for-motion-sensitivity">visually-triggered vestibular disorders</a> in an outstanding article, so I would recommend giving it a good read if you haven’t already.</p>
<p>To summarize, animations can trigger nausea, dizziness, and headaches in some users, so we should use them purposely and responsibly.</p>
<p>While most animations did not trigger my symptoms, parallax scrolling did. I’d never been a fan of parallax to begin with, as I found it confusing. And when you’re experiencing vertigo, the issues introduced by parallax scrolling compound.</p>
<p>Really, there are no words to describe just how bad a simple parallax effect, scrolljacking, or even <code>background-position: fixed</code> would make me feel. I would rather jump on one of those 20-G centrifuges astronauts use than look at a website with parallax scrolling.</p>
<p>Every time I encountered it, I would put the bucket beside me to good use and be forced to lie in bed for <em>hours</em> as I felt the room spinning around me, and no meds could get me out of it. It was <em>THAT</em> bad.</p>
<p>Though normal animations did not trigger a reaction as severe, they still posed a big problem. The extreme, conscious, focused effort it took to read would make it such that anything moving on the screen would instantly break my focus, and force me to start the paragraph all over. And I mean <em>anything</em>.</p>
<p>I would constantly find myself reading a website only to have the typical collapsing navigation bar on scroll distract me just enough that I’d totally lose count of where I was at. Autoplaying carousels were <em>so</em> annoying I would delete them using dev tools as soon as they showed up. Background videos would make me get out of the website desperately.</p>
<p>Over time I started using mouse selection as a pointer; a visual indication of what I’d already read so I could get back to it whenever something distracted me. Then I tried custom stylesheets to disable transforms and animations whenever possible, but that also meant many websites having critical elements not appear at all, as they were implemented to start off-screen or otherwise invisible, and show up on scroll.</p>
<p>Of course, deleting stuff via dev tools or using custom stylesheets is not something we can expect 99.99% of our users to even know about.</p>
<p>So if anything, consider reducing animations to a minimum. Provide users with controls to turn off non-essential animations (<a href="https://www.w3.org/WAI/WCAG21/Understanding/animation-from-interactions.html">WCAG 2.2.3 Animation from Interactions</a>) and to pause, stop, or hide them (<a href="https://www.w3.org/WAI/WCAG21/Understanding/pause-stop-hide.html">WCAG 2.2.2 Pause, Stop, Hide</a>). Implement animations and transitions in such a way that if the user disables them, critical elements still display.</p>
<p>And be extra careful with parallax: my recommendation is to, at the very least, try limiting its use to the header (“hero”) only, and be mindful of getting a smooth, realistic parallax experience. My vertigo self would have said, “<em>just don’t freaking use parallax. Never. EVER.</em>” But I guess that might be a hard idea to sell to stakeholders and designers.</p>
<p>Also consider learning how to use the <code>prefers-reduced-motion</code> feature query. This is a newer addition to the specs (it’s part of the <a href="https://drafts.csswg.org/mediaqueries-5/#descdef-media-prefers-reduced-motion">Media Queries Level 5 module</a> , which is at an early Editor’s Draft stage) that allows authors to apply selective styling depending on whether the user has requested the system to minimize the use of animations. <a href="https://caniuse.com/#search=prefers-reduced-motion">OS and browser support for it is still quite limited</a>, but the day will come when we will set any moving thing inside a query for when the user has <code>no-preference</code>, blocking animations from those who choose <code>reduce</code>.</p>
<p>After about a week of wrestling websites to provide a static experience, I remembered something that would prove to be my biggest ally while the vertigo lasted:</p>
<h2>Reader mode</h2>
<p>Some browsers include a “reader mode” that strips the content from any styling choices, isolates it from any distraction, and provides a perfect WCAG compliant layout for the text to maximize readability.</p>
<p>It is extremely helpful to provide a clear and consistent reading experience throughout multiple websites, especially for users with any kind of reading impairment.</p>
<p>I have to confess: before experiencing my vestibular disorder, I had never used Reader Mode (the formal name varies in browsers) or even checked if my projects were compatible with it. I didn’t even think it was such a useful feature, as a quick search for “reader mode” actually returned quite a few threads by users asking how to disable it or how to take the button for it out of Firefox’s address bar. (It seems some people are unwittingly activating it…perhaps the icon is not clear enough.)</p>
<p>Displaying the button to access Reader Mode is toggled by browser heuristics, which are based on the use (or not) of semantic tags in a page’s HTML. Unfortunately this meant not all websites provided such a “luxury.”</p>
<p>I really wish I wouldn’t have to say this in 2019…but please, <em>please</em> use semantic tags. Correct <a href="https://alistapart.com/article/conversational-semantics">conversational semantics</a> allow your website to be displayed in Reader Mode, and provide a better experience for users of screen readers. Again, accessibility is intersectional.</p>
<p>Reader Mode proved to be extremely useful while my vertigo lasted. But there was something even better:</p>
<h2>Dark color schemes</h2>
<p>By the fourth week, I started feeling mostly fine. I opened Visual Studio Code to <em>try</em> to get back to work. In doing so, it served me well to find one more revelation: a light-text-on-dark-background scheme was SO much easier for me to read. (Though I still was not able to return to work at this time.)</p>
<p>I was quite surprised, as I had always preferred light mode with dark-text-on-light-background for reading, and dark mode, with light-text-on-dark for coding. I didn’t know at the time that I was suffering from <em>photophobia</em> (which is a sensitivity to light), which was one of the reasons I found it hard to read on my desktop and to use my mobile device at all.</p>
<p>As far as I know, photophobia is not a common symptom of <em>vestibular disorders</em>, but there are many conditions that will trigger it, so it’s worth looking into for our projects’ accessibility.</p>
<p>CSS is also planning a media query to switch color schemes. Known as <code>prefers-color-scheme</code>, it allows applying styles based on the user’s stated preference for dark or light theming. It’s also part of the Media Queries Level 5 spec, and at the time of writing this article <a href="https://caniuse.com/#search=prefers-color-scheme">it’s only available in Safari Technology Preview</a>, with Mozilla planning to ship it in the upcoming Firefox 67. Luckily there’s a <a href="https://github.com/csstools/css-prefers-color-scheme/blob/HEAD/README-POSTCSS.md">PostCSS plugin</a> that allows us to use it in most modern browsers by turning <code>prefers-color-scheme</code> queries into <code>color-index</code> queries, which have much better support.</p>
<p>If PostCSS is not your cup of tea, or for whatever reason you cannot use that approach to automate switching color schemes to a user’s preference, try at least to provide a theming option in your app’s configuration. Theming has become extremely simple since the release of CSS Custom Properties, so implementing this sort of switch is relatively easy and will greatly benefit anyone experiencing photophobia.</p>
<h2>Moving on</h2>
<p>After a month and some days, the vertigo disappeared completely, and I was able to return to work without needing any meds or further treatment. It should stay that way, as for most people it’s a once-in-a-lifetime occurrence.</p>
<p>I went back to my <em>abled</em> life, but the experience changed my mindset for good.</p>
<p>As I said before, I always cared for making my projects compatible for people using keyboard navigation and screen readers. But I learned the hard way that there are plenty of “invisible conditions” that are just as important to take into consideration: vestibular disorders, <a href="https://alistapart.com/article/designing-for-cognitive-differences">cognitive differences</a>, dyslexia, and color blindness, just to name a few. I was totally neglecting those most of the time, barely addressing the issues in order to pass automated tests, which means I was unintentionally annoying some users by making websites inaccessible to them.</p>
<p>After my experience with vertigo, I’ve turned to an <a href="https://www.24a11y.com/2017/accessibility-first/">accessibility-first approach to design and development</a>. Now I ask myself, “am I leaving anyone behind with this decision?,” before dropping a single line of code. Accessibility should never be an afterthought.</p>
<p>Making sure my projects work from the start for those with difficulties also improves the experience for everyone else. Think about how improving text styles for users with dyslexia, vertigo, or visual problems improves readability for all users, or how being able to control animations or choose a color scheme can be critical for users with attention disorders and photophobia, respectively, while also a nice feature for everybody.</p>
<p>It also turned my workflow into a much smoother development experience, as addressing accessibility issues from the beginning can mean a slower start, but it’s also much easier and faster than trying to fix broken accessibility afterwards.</p>
<p>I hope that by sharing my personal experience with vertigo, I’ve illustrated how we can all design and develop a better web for everybody. Remember, <a href="https://uxmag.com/articles/we-re-just-temporarily-abled">we’re all just temporarily abled</a>.</p>
<footer class="entry-footer nocontent"><h1>About the Author</h1>
<div class="byline author vcard"><a class="photo" href="https://alistapart.com/author/facundocorradini"><img src="https://alistapart.com/d/_made/pix/authors/photos/Facundo-Corradini_120_120_c1.png" alt="Image of Facundo Corradini" /></a>
<h2>
Facundo Corradini is a front-end developer and CSS specialist from Mar del Plata, Argentina. He strives to make the web a little more accessible, device-agnostic, and performant each day. He's probably working on "just small fix" right now, as he's been doing for the last 15 years.</h2></div>

</footer>]]></description>
      <link>http://alistapart.com/article/accessibility-for-vestibular</link>
      <guid>http://alistapart.com/article/accessibility-for-vestibular</guid>
      <pubDate>Thu, 04 Apr 2019 01:04:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[<![CDATA[ Accessibility for Vestibular Disorders: How My Temporary Disability Changed My Perspective ]]]]><![CDATA[>]]></title>
      <description><![CDATA[<div class="entry-content">
<p>Accessibility can be tricky. There are plenty of conditions to take into consideration, and many technical limitations and weird exceptions that make it quite hard to master for most designers and developers.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>I never considered myself an accessibility <em>expert</em>, but I took great pride in making my projects Web Content Accessibility Guidelines (WCAG) compliant…ish. They would pass most automated tests, show perfectly in the accessibility tree, and work quite well with keyboard navigation. I would even try (and fail) to use a screen reader every now and then.</p>
<p>But life would give me a lesson I would probably never learn otherwise: last October, my <em>abled</em> life took a drastic change—I started to feel extremely dizzy, with a constant sensation of falling or spinning to the right. I was suffering from a bad case of vertigo caused by labyrinthitis that made it impossible to get <em>anything</em> done.</p>
<p>Vertigo can have a wide range of causes, the most common being a viral infection or tiny calcium crystal free floating in the inner ear, which is pretty much our body’s accelerometer. Any disruption in there sends the brain confusing signals about the body’s position, which causes really heavy nausea, dizziness, and headaches. If you’ve ever felt seasick, it’s quite a similar vibe. If not, think about that feeling when you just get off a rollercoaster…it’s like that, only <em>all day long</em>.</p>
<p>For most people, <a href="https://vestibular.org/understanding-vestibular-disorders/types-vestibular-disorders/benign-paroxysmal-positional-vertigo">vertigo is something they’ll suffer just once in a lifetime</a>, and it normally goes away in a week or two. Incidence is really high, with some estimates claiming that up to 40% of the population suffers vertigo at least once in their lifetime. Some people live all their lives with it (or with similar symptoms caused by a range of diseases and syndromes grouped under the umbrella term of <em>vestibular disorders</em>), with 4% of US adults reporting chronic problems with balance, and an additional 1.1% reporting chronic dizziness, <a href="https://www.asha.org/PRPSpecificTopic.aspx?folderid=8589942134&amp;section=Incidence_and_Prevalence">according to the American Speech-Language-Hearing Association</a>.</p>
<p>In my case, it was a little over a month. Here’s what I learned while going through it.</p>
<h2>Slants can trigger vestibular symptoms<a class="subhead-anchor" href="#section1">#section1</a></h2>
<p>It all started as I was out for my daily jog. I felt slightly dizzy, then suddenly my vision got totally distorted. Everything appeared further away, like looking at a fun house’s distortion mirror. I stumbled back home and rested; at that moment I believed I might have over-exercised, and that hydration, food, and rest were all I needed. Time would prove me wrong.</p>
<p>What I later learned was that experiencing vertigo is a constant war between one of your inner ears telling the brain “everything is fine, we’re level and still” and the other ear shouting “oh my God, we’re falling, we’re falling!!!” Visual stimuli can act as an intermediary, supporting one ear’s message or the other’s. Vertigo can also work in the opposite way, with the dizziness interfering with your vision.</p>
<p>I quickly found that when symptoms peaked, staring at a distant object would ease the falling sensation <em>somewhat</em>.</p>
<p>In the same fashion, some visual stimuli would worsen it.</p>
<p>Vertical slants were a big offender in that sense. For instance, looking at a subtle vertical slant (the kind that you’d have to look at twice to make sure it’s not perfectly vertical) on a webpage would instantly trigger symptoms for me. Whether it was a page-long slant used to create some interest beside text or a tiny decoration to mark active tabs, looking at anything with slight slants would instantly send me into the rollercoaster.</p>
<p>Horizontal slants (whatever the degree) and harder vertical slants wouldn’t cause these issues.</p>
<p>My best guess is that slight vertical slants can look like forced perspective and therefore reinforce the falling-from-height sensation, so I would recommend avoiding vertical slants if you can, or make them super obvious. A slight slant looks like perspective, a harder one looks like a triangle.</p>
<h2>Target size matters (even on mouse-assisted devices)<a class="subhead-anchor" href="#section2">#section2</a></h2>
<p>After a magnetic resonance imaging (MRI) scan, some tests to discard neurological conditions, and other treatments that proved ineffective, I was prescribed Cinnarizine.</p>
<p>Cinnarizine is a calcium channel blocker—to put it simply, it prevents the malfunctioning inner ear “accelerometer” from sending incorrect info to the brain. <br />
And it worked wonders. After ten days of being barely able to get out of bed, I was finally getting something closer to my normal life. I would still feel dizzy all the time, with some peaks throughout the day, but for the most part, it was much easier.</p>
<p>At this point, I was finally able to use the computer (but still unable to produce any code at all). To make the best of it, I set on a mission to self-experiment on accessibility for vestibular disorders. In testing, I found that one of the first things that struck me was that I would always miss targets (links and buttons).</p>
<p>I’m from the generation that grew up with desktop computers, so using a mouse is second nature. The pointer is pretty much an extension of my mind, as it is for many who use it regularly. But while Cinnarizine helped with the dizziness, it has a common side effect of negatively impacting coordination and fine motor skills (it is recommended not to drive or operate machinery while under treatment). It was not a surprise when I realized it would be much harder to get the pointer to do what I intended.</p>
<p>The common behavior would be: moving the pointer past the link I intended to click, clicking before reaching it at all, or having to try multiple times to click on smaller targets.</p>
<p><a href="https://www.w3.org/WAI/WCAG21/Understanding/target-size.html">Success Criterion 2.5.5 Target Size (Level AAA)</a> of the World Wide Web Consortium (W3C)’s WCAG recommends bigger target sizes so users can activate them easily. The obvious reason for this is that it’s harder to pinpoint targets on smaller screens with coarser inputs (i.e., touchscreens of mobile devices). A fairly common practice for developers is to set bigger target sizes for smaller viewport widths (assuming that control challenges are only touch-related), while neglecting the issue on big screens expected to be used with mouse input. I know I’m guilty of that myself.</p>
<p>Instead of targeting this behavior for just smaller screen sizes, there are plenty of reasons to create larger target sizes on <em>all</em> devices: it will benefit users with limited vision (when text is scaled up accordingly and colors are of sufficient contrast), users with mobility impairments such as hand tremors, and of course, users with difficulty with fine motor skills.</p>
<h2>Font size and spacing<a class="subhead-anchor" href="#section3">#section3</a></h2>
<p>Even while “enjoying” the ease of symptoms provided by the treatment, reading <em>anything</em> still proved to be a challenge for the following three weeks.</p>
<p>I was completely unable to use mobile devices while suffering vertigo due to the smaller font sizes and spacing, so I was forced to use my desktop computer for everything.</p>
<p>I can say I was experiencing something similar to users with mild forms of dyslexia or attention disorders: whenever I got to a website that didn’t follow good font styling, I would find myself reading the same line over and over again.</p>
<p>This proves once again that accessibility is intersectional: when we improve things for a particular purpose it usually benefits users with other challenges as well. I used to believe recommendations on font styles were mostly intended for the nearsighted and those who have dyslexia. Turns out they are also critical for those with vertigo, and even for those with some cognitive differences. At the end of the day, everybody benefits from better readability.</p>
<p>Some actions you can take to improve readability are:</p>
<ul><li>Keep line height to at least 1.5 times the font size (i.e., <code>line-height: 1.5</code>).</li>
<li>Set the spacing between paragraphs to at least 2.0 times the font size. We can do this by adjusting the margins using relative units such as <code>em</code>.</li>
<li>Letter spacing should be at least 0.12 times the font size. We can adjust this by using the <code>letter-spacing</code> CSS property, perhaps setting it in a relative unit.</li>
<li>Make sure to have good contrast between text and its background.</li>
<li>Keep <code>font-weight</code> at a reasonable level for the given <code>font-family</code>. Some fonts have thin strokes that make them harder to read. When using thinner fonts, try to improve contrast and font size accordingly, even more than what WCAG would suggest.</li>
<li>Choose fonts that are easy to read. There has been a large and still inconclusive debate on which font styles are better for users, but one thing I can say for sure is that popular fonts (as in fonts that the user might be already familiar with) are generally the least challenging for users with reading issues.</li>
</ul><p><a href="https://www.w3.org/WAI/WCAG21/Understanding/text-spacing.html">WCAG recommendations on text are fairly clear</a> and fortunately are the most commonly implemented of recommendations, but even they can still fall short sometimes. So, better to follow <a href="http://adrianroselli.com/2015/03/typefaces-for-dyslexia.html#Tips">specific guides on accessible text</a> and your best judgement. <a href="https://www.smashingmagazine.com/2018/09/importance-manual-accessibility-testing/">Passing automated tests does not guarantee actual accessibility.</a></p>
<p>Another issue on which my experience with vertigo proved to be similar to that of people with dyslexia and attention disorders was how hard it was for me to keep my attention in just one place. In that sense…</p>
<h2>Animations are bad (and parallax is pure evil)<a class="subhead-anchor" href="#section4">#section4</a></h2>
<p>Val Head has already covered <a href="https://alistapart.com/article/designing-safer-web-animation-for-motion-sensitivity">visually-triggered vestibular disorders</a> in an outstanding article, so I would recommend giving it a good read if you haven’t already.</p>
<p>To summarize, animations can trigger nausea, dizziness, and headaches in some users, so we should use them purposely and responsibly.</p>
<p>While most animations did not trigger my symptoms, parallax scrolling did. I’d never been a fan of parallax to begin with, as I found it confusing. And when you’re experiencing vertigo, the issues introduced by parallax scrolling compound.</p>
<p>Really, there are no words to describe just how bad a simple parallax effect, scrolljacking, or even <code>background-attachment: fixed</code> would make me feel. I would rather jump on one of those 20-G centrifuges astronauts use than look at a website with parallax scrolling.</p>
<p>Every time I encountered it, I would put the bucket beside me to good use and be forced to lie in bed for <em>hours</em> as I felt the room spinning around me, and no meds could get me out of it. It was <em>THAT</em> bad.</p>
<p>Though normal animations did not trigger a reaction as severe, they still posed a big problem. The extreme, conscious, focused effort it took to read would make it such that anything moving on the screen would instantly break my focus, and force me to start the paragraph all over. And I mean <em>anything</em>.</p>
<p>I would constantly find myself reading a website only to have the typical collapsing navigation bar on scroll distract me just enough that I’d totally lose count of where I was at. Autoplaying carousels were <em>so</em> annoying I would delete them using dev tools as soon as they showed up. Background videos would make me get out of the website desperately.</p>
<p>Over time I started using mouse selection as a pointer; a visual indication of what I’d already read so I could get back to it whenever something distracted me. Then I tried custom stylesheets to disable transforms and animations whenever possible, but that also meant many websites having critical elements not appear at all, as they were implemented to start off-screen or otherwise invisible, and show up on scroll.</p>
<p>Of course, deleting stuff via dev tools or using custom stylesheets is not something we can expect 99.99% of our users to even know about.</p>
<p>So if anything, consider reducing animations to a minimum. Provide users with controls to turn off non-essential animations (<a href="https://www.w3.org/WAI/WCAG21/Understanding/animation-from-interactions.html">WCAG 2.2.3 Animation from Interactions</a>) and to pause, stop, or hide them (<a href="https://www.w3.org/WAI/WCAG21/Understanding/pause-stop-hide.html">WCAG 2.2.2 Pause, Stop, Hide</a>). Implement animations and transitions in such a way that if the user disables them, critical elements still display.</p>
<p>And be extra careful with parallax: my recommendation is to, at the very least, try limiting its use to the header (“hero”) only, and be mindful of getting a smooth, realistic parallax experience. My vertigo self would have said, “<em>just don’t freaking use parallax. Never. EVER.</em>” But I guess that might be a hard idea to sell to stakeholders and designers.</p>
<p>Also consider learning how to use the <code>prefers-reduced-motion</code> feature query. This is a newer addition to the specs (it’s part of the <a href="https://drafts.csswg.org/mediaqueries-5/#descdef-media-prefers-reduced-motion">Media Queries Level 5 module</a> , which is at an early Editor’s Draft stage) that allows authors to apply selective styling depending on whether the user has requested the system to minimize the use of animations. <a href="https://caniuse.com/#search=prefers-reduced-motion">OS and browser support for it is still quite limited</a>, but the day will come when we will set any moving thing inside a query for when the user has <code>no-preference</code>, blocking animations from those who choose <code>reduce</code>.</p>
<p>After about a week of wrestling websites to provide a static experience, I remembered something that would prove to be my biggest ally while the vertigo lasted:</p>
<h2>Reader mode<a class="subhead-anchor" href="#section5">#section5</a></h2>
<p>Some browsers include a “reader mode” that strips the content from any styling choices, isolates it from any distraction, and provides a perfect WCAG compliant layout for the text to maximize readability.</p>
<p>It is extremely helpful to provide a clear and consistent reading experience throughout multiple websites, especially for users with any kind of reading impairment.</p>
<p>I have to confess: before experiencing my vestibular disorder, I had never used Reader Mode (the formal name varies in browsers) or even checked if my projects were compatible with it. I didn’t even think it was such a useful feature, as a quick search for “reader mode” actually returned quite a few threads by users asking how to disable it or how to take the button for it out of Firefox’s address bar. (It seems some people are unwittingly activating it…perhaps the icon is not clear enough.)</p>
<p>Displaying the button to access Reader Mode is toggled by browser heuristics, which are based on the use (or not) of semantic tags in a page’s HTML. Unfortunately this meant not all websites provided such a “luxury.”</p>
<p>I really wish I wouldn’t have to say this in 2019…but please, <em>please</em> use semantic tags. Correct <a href="https://alistapart.com/article/conversational-semantics">conversational semantics</a> allow your website to be displayed in Reader Mode, and provide a better experience for users of screen readers. Again, accessibility is intersectional.</p>
<p>Reader Mode proved to be extremely useful while my vertigo lasted. But there was something even better:</p>
<h2>Dark color schemes<a class="subhead-anchor" href="#section6">#section6</a></h2>
<p>By the fourth week, I started feeling mostly fine. I opened Visual Studio Code to <em>try</em> to get back to work. In doing so, it served me well to find one more revelation: a light-text-on-dark-background scheme was SO much easier for me to read. (Though I still was not able to return to work at this time.)</p>
<p>I was quite surprised, as I had always preferred light mode with dark-text-on-light-background for reading, and dark mode, with light-text-on-dark for coding. I didn’t know at the time that I was suffering from <em>photophobia</em> (which is a sensitivity to light), which was one of the reasons I found it hard to read on my desktop and to use my mobile device at all.</p>
<p>As far as I know, photophobia is not a common symptom of <em>vestibular disorders</em>, but there are many conditions that will trigger it, so it’s worth looking into for our projects’ accessibility.</p>
<p>CSS is also planning a media query to switch color schemes. Known as <code>prefers-color-scheme</code>, it allows applying styles based on the user’s stated preference for dark or light theming. It’s also part of the Media Queries Level 5 spec, and at the time of writing this article <a href="https://caniuse.com/#search=prefers-color-scheme">it’s only available in Safari Technology Preview</a>, with Mozilla planning to ship it in the upcoming Firefox 67. Luckily there’s a <a href="https://github.com/csstools/css-prefers-color-scheme/blob/HEAD/README-POSTCSS.md">PostCSS plugin</a> that allows us to use it in most modern browsers by turning <code>prefers-color-scheme</code>queries into <code>color-index</code> queries, which have much better support.</p>
<p>If PostCSS is not your cup of tea, or for whatever reason you cannot use that approach to automate switching color schemes to a user’s preference, try at least to provide a theming option in your app’s configuration. Theming has become extremely simple since the release of CSS Custom Properties, so implementing this sort of switch is relatively easy and will greatly benefit anyone experiencing photophobia.</p>
<h2>Moving on<a class="subhead-anchor" href="#section7">#section7</a></h2>
<p>After a month and some days, the vertigo disappeared completely, and I was able to return to work without needing any meds or further treatment. It should stay that way, as for most people it’s a once-in-a-lifetime occurrence.</p>
<p>I went back to my <em>abled</em> life, but the experience changed my mindset for good.</p>
<p>As I said before, I always cared for making my projects compatible for people using keyboard navigation and screen readers. But I learned the hard way that there are plenty of “invisible conditions” that are just as important to take into consideration: vestibular disorders, <a href="https://alistapart.com/article/designing-for-cognitive-differences">cognitive differences</a>, dyslexia, and color blindness, just to name a few. I was totally neglecting those most of the time, barely addressing the issues in order to pass automated tests, which means I was unintentionally annoying some users by making websites inaccessible to them.</p>
<p>After my experience with vertigo, I’ve turned to an <a href="https://www.24a11y.com/2017/accessibility-first/">accessibility-first approach to design and development</a>. Now I ask myself, “am I leaving anyone behind with this decision?,” before dropping a single line of code. Accessibility should never be an afterthought.</p>
<p>Making sure my projects work from the start for those with difficulties also improves the experience for everyone else. Think about how improving text styles for users with dyslexia, vertigo, or visual problems improves readability for all users, or how being able to control animations or choose a color scheme can be critical for users with attention disorders and photophobia, respectively, while also a nice feature for everybody.</p>
<p>It also turned my workflow into a much smoother development experience, as addressing accessibility issues from the beginning can mean a slower start, but it’s also much easier and faster than trying to fix broken accessibility afterwards.</p>
<p>I hope that by sharing my personal experience with vertigo, I’ve illustrated how we can all design and develop a better web for everybody. Remember, <a href="https://uxmag.com/articles/we-re-just-temporarily-abled">we’re all just temporarily abled</a>.</p>
<p><br /></p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Our own @zeldman paints the complicated catch-22 that our free, democratized web has with our money-making capitalist roots. As creators, how do we untangle this web? #LetsFixThis</div><div class="entry-content">Jeremy Wagner plots a course to avoid the unnecessary bloat and inaccessible patterns of current JavaScript trends.</div><div class="entry-content">Technology can easily become a platform for hate, and we have an ethical responsibility to fix it. ALA's own Tatiana Mac discusses</div><div class="entry-content">Screen readers are diverse and complex: front-end developer Melanie Richards breaks down how they access our content step-by-step.</div><div class="entry-content">Brandon Gregory discusses designing for conversions, which allows products to reach their targets and serve the right people.</div>]]></description>
      <link>https://alistapart.com/article/accessibility-for-vestibular/</link>
      <guid>https://alistapart.com/article/accessibility-for-vestibular/</guid>
      <pubDate>Thu, 04 Apr 2019 01:04:00 +0200</pubDate>
    </item>
    <item>
      <title><![CDATA[<![CDATA[ Responsible JavaScript: Part I ]]]]><![CDATA[>]]></title>
      <description><![CDATA[<div class="entry-content">
<p>By the numbers, <a href="https://httparchive.org/reports/state-of-javascript#bytesJs">JavaScript is a performance liability</a>. If the trend persists, the median page will be shipping at least 400 KB of it before too long, and that’s merely what’s <em>transferred</em>. Like other text-based resources, JavaScript is almost always served compressed—but that might be the only thing we’re getting consistently right in its delivery.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>Unfortunately, while reducing resource transfer time is a big part of that whole performance thing, compression has no effect on how long browsers take to process a script once it arrives in its entirety. If a server sends 400 KB of compressed JavaScript, the actual amount browsers have to process after decompression is north of a megabyte. How well devices cope with these heavy workloads depends, well, on the <em>device</em>. <a href="https://medium.com/@addyosmani/the-cost-of-javascript-in-2018-7d8950fbb5d4">Much has been written</a> about how adept various devices are at processing lots of JavaScript, but the truth is, the amount of time it takes to process even a trivial amount of it varies greatly between devices.</p>
<p>Take, for example, this <a href="https://devmode.jeremy.codes/">throwaway project of mine</a>, which serves around 23 KB of uncompressed JavaScript. On a mid-2017 MacBook Pro, Chrome chews through this comparably tiny payload in about 25 ms. On a <a href="https://www.gsmarena.com/nokia_2-8513.php">Nokia 2 Android phone</a>, however, that figure balloons to around 190 ms. That’s not an insignificant amount of time, but in either case, the page gets interactive reasonably fast.</p>
<p>Now for the big question: how do you think that little Nokia 2 does on an average page? It chokes. Even on a fast connection, browsing the web on it is an exercise in patience as JavaScript-laden web pages brick it for considerable stretches of time.</p>
<figure id="figure1" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/04/fig-01-2x.png?w=960" alt="A performance timeline for a JavaScript-heavy website. Most of the timeline is JavaScript." class="wp-image-6000652" /><figcaption><em>Figure 1. A performance timeline overview of a Nokia 2 Android phone browsing on a page where excessive JavaScript monopolizes the main thread.</em></figcaption></figure><p>While devices and the networks they navigate the web on are largely improving, we’re eating those gains as trends suggest. We need to use JavaScript <em>responsibly</em>. That begins with understanding <em>what</em> we’re building as well as <em>how</em> we’re building it.</p>
<h2>The mindset of “sites” versus “apps”<a class="subhead-anchor" href="#section1">#section1</a></h2>
<p>Nomenclature can be strange in that we sometimes loosely identify things with terms that are inaccurate, yet their meanings are implicitly understood by everyone. Sometimes we overload the term “bee” to also mean “wasp”, even though the differences between bees and wasps are substantial. Those differences can motivate you to deal with each one differently. For instance, we’ll want to destroy a wasp nest, but because bees are highly beneficial and vulnerable insects, we may opt to relocate them.</p>
<p>We can be just as fast and loose in interchanging the terms “website” and “web app”. The differences between them are less clear than those between yellowjackets and honeybees, but conflating them can bring about painful outcomes. The pain comes in the affordances we allow ourselves when something is merely a “web<em>site</em>” versus a fully-featured “web app.” If you’re making an informational website for a business, you’re less likely to lean on a powerful framework to manage changes in the DOM or implement client-side routing—at least, I <em>hope</em>. Using tools so ill-suited for the task would not only be a detriment to the people who use that site but arguably less productive.</p>
<p>When we build a web <em>app</em>, though, <em>look out</em>. We’re installing packages which usher in hundreds—if not <em>thousands</em>—of dependencies, <a href="https://snyk.io/blog/malicious-code-found-in-npm-package-event-stream/">some of which</a> we’re not sure are even safe. We’re also writing complicated configurations for module bundlers. In this frenzied, yet ubiquitous, sort of dev environment, it takes knowledge and vigilance to ensure what gets built is fast and accessible. If you doubt this, run <a href="https://docs.npmjs.com/cli/ls.html#prod--production"><code>npm ls --prod</code></a> in your project’s root directory and <a href="https://gist.github.com/malchata/dae0a011033846e2cb44d315b0496f0d">see if you recognize everything in that list</a>. Even if you do, that doesn’t account for third party scripts—of which I’m sure your site has at least a few.</p>
<p>What we tend to forget is that the environment websites and web apps occupy is one and the same. Both are subject to the <em>same environmental pressures</em> that the large gradient of networks and devices impose. Those constraints don’t suddenly vanish when we decide to call what we build “apps”, nor do our users’ phones gain magical new powers when we do so.</p>
<p>It’s our responsibility to evaluate who uses what we make, and accept that the conditions under which they access the internet can be different than what we’ve assumed. We need to know the purpose we’re trying to serve, and only <em>then</em> can we build something that admirably serves that purpose—<a href="https://css-tricks.com/simple-boring/">even if it isn’t exciting to build</a>.</p>
<p>That means reassessing our reliance on JavaScript and how the use of it—particularly to the exclusion of HTML and CSS—can tempt us to adopt unsustainable patterns which harm performance and accessibility.</p>
<h2>Don’t let frameworks force you into unsustainable patterns<a class="subhead-anchor" href="#section2">#section2</a></h2>
<p>I’ve been witness to some strange discoveries in codebases when working with teams that depend on frameworks to help them be highly productive. One characteristic common among many of them is that poor accessibility and performance patterns often result. Take the React component below, for example:</p>
<pre id="snippet1" class="wp-block-code language-javascript"><code>import React, { Component } from "react";
import { validateEmail } from "helpers/validation";
class SignupForm extends Component {
  constructor (props) {
    super(props);
    this.handleSubmit = this.handleSubmit.bind(this);
    this.updateEmail = this.updateEmail.bind(this);
    this.state.email = "";
  }
  updateEmail (event) {
    this.setState({
      email: event.target.value
    });
  }
  handleSubmit () {
    // If the email checks out, submit
    if (validateEmail(this.state.email)) {
      // ...
    }
  }
  render () {
    return (
      &lt;div&gt;
        &lt;span class="email-label"&gt;Enter your email:&lt;/span&gt;
        &lt;input type="text" id="email" onChange={this.updateEmail} /&gt;
        &lt;button onClick={this.handleSubmit}&gt;Sign Up&lt;/button&gt;
      &lt;/div&gt;
    );
  }
}</code></pre>
<p>There are some notable accessibility issues here:</p>
<ol><li>A form that doesn’t use a <code>&lt;form&gt;</code> element is <em>not</em> a form. Indeed, you could paper over this by specifying <a href="https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/Form_Role"><code>role="form"</code></a> in the parent <code>&lt;div&gt;</code>, but if you’re building a form—and this <em>sure looks like one</em>—use a <code>&lt;form&gt;</code> element with the proper <code>action</code> and <code>method</code> attributes. The <code>action</code> attribute is crucial, as it ensures the form will still do <em>something</em> in the absence of JavaScript—provided the component is server-rendered, of course.</li>
<li>A <code>&lt;span&gt;</code> is not a substitute for a <code>&lt;label&gt;</code> element, which provides accessibility benefits <code>&lt;span&gt;</code>s don’t.</li>
<li>If we intend to do something on the client side prior to submitting a form, then we should move the action bound to the <code>&lt;button&gt;</code> element’s <code>onClick</code> handler to the <code>&lt;form&gt;</code> element’s <code>onSubmit</code> handler.</li>
<li>Incidentally, why use JavaScript to validate an email address when HTML5 offers form validation controls in almost every browser back to IE 10? There’s an opportunity here to rely on the browser and use an <a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/email">appropriate input type</a>, as well as the <a href="https://developer.mozilla.org/en-US/docs/Learn/HTML/Forms/Form_validation#The_required_attribute"><code>required</code></a> attribute—but be aware that getting this to work right with screen readers <a href="https://developer.paciellogroup.com/blog/2019/02/required-attribute-requirements/">takes a little know-how</a>.</li>
<li>While not an accessibility issue, this component doesn’t rely on any state or lifecycle methods, which means it can be refactored into a stateless functional component, which uses considerably less JavaScript than a full-fledged React component.</li>
</ol><p>Knowing these things, we can refactor this component:</p>
<pre id="snippet2" class="wp-block-code language-javascript"><code>import React from "react";
const SignupForm = props =&gt; {
  const handleSubmit = event =&gt; {
    // Needed in case we're sending data to the server XHR-style
    // (but will still work if server-rendered with JS disabled).
    event.preventDefault();
    // Carry on...
  };
  return (
    &lt;form method="POST" action="/signup" onSubmit={handleSubmit}&gt;
      &lt;label for="email" class="email-label"&gt;Enter your email:&lt;/label&gt;
      &lt;input type="email" id="email" required /&gt;
      &lt;button&gt;Sign Up&lt;/button&gt;
    &lt;/form&gt;
  );
};</code></pre>
<p>Not only is this component now more accessible, but it also uses less JavaScript. In a world that’s drowning in JavaScript, deleting lines of it should feel downright therapeutic. <a href="https://alistapart.com/article/paint-the-picture-not-the-frame">The browser gives us so much for free</a>, and we should try to take advantage of that as often as possible.</p>
<p>This is not to say that inaccessible patterns occur <em>only</em> when frameworks are used, but rather that a sole preference for JavaScript <em>will</em> eventually surface gaps in our understanding of HTML and CSS. These knowledge gaps will often result in mistakes we may not even be aware of. Frameworks can be useful tools that increase our productivity, but continuing education in core web technologies is essential to creating <em>usable</em> experiences, no matter what tools we choose to use.</p>
<h2>Rely on the web platform and you’ll go far, fast<a class="subhead-anchor" href="#section3">#section3</a></h2>
<p>While we’re on the subject of frameworks, it must be said that the web platform is a formidable framework of its own. As the previous section showed, we’re better off when we can rely on established markup patterns and browser features. The alternative is to reinvent them, and invite all the pain such endeavors all but guarantee us, or worse: merely <em>assume</em> that the author of every JavaScript package we install has solved the problem comprehensively and thoughtfully.</p>
<h3>SINGLE PAGE APPLICATIONS<a class="subhead-anchor" href="#section4">#section4</a></h3>
<p>One of the tradeoffs developers are quick to make is to adopt the single page application (SPA) model, even if it’s not a fit for the project. Yes, you <em>do</em> gain better perceived performance with the client-side routing of an SPA, but what do you <em>lose</em>? The browser’s own navigation functionality—albeit synchronous—provides a slew of benefits. For one, history is managed according to <a href="https://html.spec.whatwg.org/#the-history-interface">a complex specification</a>. Users without JavaScript—be it by <a href="https://kryogenix.org/code/browser/everyonehasjs.html">their own choice or not</a>—won’t lose access altogether. For SPAs to remain available when JavaScript is not, server-side rendering suddenly becomes a thing you have to consider.</p>
<figure id="figure2" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/04/fig2.png?w=960" alt="Two series of screenshots. On the left, we have a blank screen for several seconds until the app appears after 5.24s. On the right, the basic components appear at 4ms and the site is fully usable at 5.16s." class="wp-image-6000653" /><figcaption><em>Figure 2. A comparison of an example app loading on a slow connection. The app on the left depends entirely upon JavaScript to render a page. The app on the right renders a response on the server, but then uses </em><a href="https://reactjs.org/docs/react-dom.html#hydrate">client-side hydration</a><em> to attach components to the existing server-rendered markup.</em></figcaption></figure><p>Accessibility is also harmed if a client-side router fails to let people know what content on the page has changed. This can leave those reliant on assistive technology to suss out what changes have occurred on the page, which can be an arduous task.</p>
<p>Then there’s our old nemesis: overhead. Some client-side routers are very small, but when you <em>start</em> with <a href="https://bundlephobia.com/result?p=react-dom@16.8.2">React</a>, <a href="https://bundlephobia.com/result?p=react-router@4.3.1">a compatible router</a>, and possibly even <a href="https://bundlephobia.com/result?p=redux@4.0.1">a state management library</a>, you’re accepting that there’s a certain amount of code you can never optimize away—approximately 135 KB in this case. Carefully consider what you’re building and whether a client side router is worth the tradeoffs you’ll inevitably make. Typically, you’re better off without one.</p>
<p>If you’re concerned about the perceived navigation performance, you <em>could</em> lean on <a href="https://www.w3.org/TR/resource-hints/#prefetch-link-relation-type"><code>rel=prefetch</code></a> to speculatively fetch documents on the same origin. This has a dramatic effect on improving perceived loading performance of pages, as the document is immediately available in the cache. Because prefetches are done at a low priority, they’re also less likely to contend with critical resources for bandwidth.</p>
<figure id="figure3" class="wp-block-image"><img src="https://alistapart.com/wp-content/uploads/2019/04/fig3.png?w=960" alt="Screenshot showing a list of assets loaded on a webpage. 'writing/' is labeled as prefetched on initial navigation. This asset is then loaded in 2ms when actually requested by the user." class="wp-image-7171594" /><figcaption>Figure 3. The HTML for the writing/ URL is prefetched on the initial page. When the writing/ URL is requested by the user, the HTML for it is loaded instantaneously from the browser cache.</figcaption></figure><p>The primary drawback with link prefetching is that you need to be aware that it <em>can</em> be potentially wasteful. <a href="https://github.com/GoogleChromeLabs/quicklink">Quicklink</a>, a tiny link prefetching script from Google, mitigates this somewhat by checking if the current client is on a slow connection—or has <a href="https://support.google.com/chrome/answer/2392284?co=GENIE.Platform%3DAndroid&amp;hl=en">data saver mode</a> enabled—and avoids prefetching links on cross-origins by default.</p>
<p><a href="https://adactio.com/articles/13796">Service workers</a> are also hugely beneficial to perceived performance for returning users, whether we use client side routing or not—<a href="https://developers.google.com/web/fundamentals/primers/service-workers/high-performance-loading#for_best_performance_bypass_the_network_for_navigations">provided you know the ropes</a>. <a href="https://developers.google.com/web/ilt/pwa/caching-files-with-service-worker">When we precache routes with a service worker</a>, we get many of the same benefits as link prefetching, but with a much greater degree of control over requests and responses. Whether you think of your site as an “app” or not, adding a service worker to it is perhaps one of the most responsible uses of JavaScript that exists today.</p>
<h3>JAVASCRIPT ISN’T THE SOLUTION TO YOUR LAYOUT WOES<a class="subhead-anchor" href="#section5">#section5</a></h3>
<p>If we’re installing a package to solve a layout problem, proceed with caution and ask “what am I trying to accomplish?” CSS is <a href="https://twitter.com/rachelandrew/status/1088870059240505344"><em>designed to do this job</em></a>, and requires no abstractions to use effectively. Most layout issues JavaScript packages attempt to solve, like <a href="https://www.npmjs.com/package/flexibility">box placement, alignment, and sizing</a>, <a href="https://www.npmjs.com/package/shave">managing text overflow</a>, and even <a href="https://www.npmjs.com/package/lost">entire layout systems</a>, are solvable with CSS <em>today</em>. Modern layout engines like Flexbox and Grid are supported well enough that we shouldn’t need to start a project with any layout framework. CSS <em>is</em> the framework. When we have <a href="https://hacks.mozilla.org/2016/08/using-feature-queries-in-css/">feature queries</a>, progressively enhancing layouts to adopt new layout engines is suddenly <a href="https://hacks.mozilla.org/2016/08/using-feature-queries-in-css/">not so hard</a>.</p>
<pre id="snippet3" class="wp-block-code language-css"><code>/* Your mobile-first, non-CSS grid styles goes here */
/* The @supports rule below is ignored by browsers that don't
   support CSS grid, _or_ don't support @supports. */
@supports (display: grid) {
  /* Larger screen layout */
  @media (min-width: 40em) {
    /* Your progressively enhanced grid layout styles go here */
  }
}</code></pre>
<p>Using JavaScript solutions for layout and presentations problems is not new. It was something we did when we lied to ourselves in 2009 that every website had to look in IE6 exactly as it did in the more capable browsers of that time. If we’re still developing websites to look the same in every browser in 2019, we should reassess our development goals. There will <em>always</em> be some browser we’ll have to support that can’t do everything those modern, evergreen browsers can. Total visual parity on all platforms is not only a pursuit made in vain, it’s the principal foe of <a href="https://alistapart.com/article/understandingprogressiveenhancement">progressive enhancement</a>.</p>
<h2>I’m not here to kill JavaScript<a class="subhead-anchor" href="#section6">#section6</a></h2>
<p>Make no mistake, I have no ill will toward JavaScript. It’s given me a career and—if I’m being honest with myself—a source of enjoyment for over a decade. Like any long-term relationship, I learn more about it the more time I spend with it. It’s a mature, feature-rich language that only gets more capable and elegant with every passing year.</p>
<p>Yet, there are times when I feel like JavaScript and I are at odds. I <em>am</em> critical of JavaScript. Or maybe more accurately, I’m critical of how we’ve developed a tendency to view it as a first resort to building for the web. As I pick apart yet another bundle not unlike a tangled ball of Christmas tree lights, it’s become clear that the web is <em>drunk</em> on JavaScript. We reach for it for almost everything, even when the occasion doesn’t call for it. Sometimes I wonder how vicious the hangover will be.</p>
<p>In a series of articles to follow, I’ll be giving more practical advice to follow to stem the encroaching tide of excessive JavaScript and how we can wrangle it so that <em>what</em> we build for the web is usable—or at least <em>more</em> so—for everyone everywhere. Some of the advice will be preventative. Some will be mitigating “hair of the dog” measures. In either case, the outcomes will hopefully be the same. I believe that we all love the web and want to do right by it, but I want us to think about how to make it more resilient and inclusive for all.</p>
<p><br /></p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Our own @zeldman paints the complicated catch-22 that our free, democratized web has with our money-making capitalist roots. As creators, how do we untangle this web? #LetsFixThis</div><div class="entry-content">A month of experiencing a temporary disability changed @fcorradini’s perspective on how to take more care when conducting accessibility testing. He shares the impact.</div><div class="entry-content">Technology can easily become a platform for hate, and we have an ethical responsibility to fix it. ALA's own Tatiana Mac discusses</div><div class="entry-content">Screen readers are diverse and complex: front-end developer Melanie Richards breaks down how they access our content step-by-step.</div><div class="entry-content">Brandon Gregory discusses designing for conversions, which allows products to reach their targets and serve the right people.</div>]]></description>
      <link>https://alistapart.com/article/responsible-javascript-part-1/</link>
      <guid>https://alistapart.com/article/responsible-javascript-part-1/</guid>
      <pubDate>Thu, 28 Mar 2019 09:03:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[Responsible JavaScript: Part I]]></title>
      <description><![CDATA[<p>By the numbers, <a rel="noopener" href="https://httparchive.org/reports/state-of-javascript#bytesJs">JavaScript is a performance liability</a>. If the trend persists, the median page will be shipping at least 400 KB of it before too long, and that’s merely what’s <em>transferred</em>. Like other text-based resources, JavaScript is almost always served compressed—but that might be the only thing we’re getting consistently right in its delivery.</p>


<p>Unfortunately, while reducing resource transfer time is a big part of that whole performance thing, compression has no effect on how long browsers take to process a script once it arrives in its entirety. If a server sends 400 KB of compressed JavaScript, the actual amount browsers have to process after decompression is north of a megabyte. How well devices cope with these heavy workloads depends, well, on the <em>device</em>. <a rel="noopener" href="https://medium.com/@addyosmani/the-cost-of-javascript-in-2018-7d8950fbb5d4">Much has been written</a> about how adept various devices are at processing lots of JavaScript, but the truth is, the amount of time it takes to process even a trivial amount of it varies greatly between devices.</p>
<p>Take, for example, this <a rel="noopener" href="https://devmode.jeremy.codes/">throwaway project of mine</a>, which serves around 23 KB of uncompressed JavaScript. On a mid-2017 MacBook Pro, Chrome chews through this comparably tiny payload in about 25 ms. On a <a rel="noopener" href="https://www.gsmarena.com/nokia_2-8513.php">Nokia 2 Android phone</a>, however, that figure balloons to around 190 ms. That’s not an insignificant amount of time, but in either case, the page gets interactive reasonably fast.</p>
<p>Now for the big question: how do you think that little Nokia 2 does on an average page? It chokes. Even on a fast connection, browsing the web on it is an exercise in patience as JavaScript-laden web pages brick it for considerable stretches of time.</p>
<figure><img src="https://alistapart.com/d/responsible-javascript-part-1/fig-01.png" alt="A performance timeline for a JavaScript-heavy website. Most of the timeline is JavaScript." /><figcaption>Figure 1. A performance timeline overview of a Nokia 2 Android phone browsing on a page where excessive JavaScript monopolizes the main thread.</figcaption></figure><p>While devices and the networks they navigate the web on are largely improving, we’re eating those gains as trends suggest. We need to use JavaScript <em>responsibly</em>. That begins with understanding <em>what</em> we’re building as well as <em>how</em> we’re building it.</p>
<h2>The mindset of “sites” versus “apps”</h2>
<p>Nomenclature can be strange in that we sometimes loosely identify things with terms that are inaccurate, yet their meanings are implicitly understood by everyone. Sometimes we overload the term “bee” to also mean “wasp”, even though the differences between bees and wasps are substantial. Those differences can motivate you to deal with each one differently. For instance, we’ll want to destroy a wasp nest, but because bees are highly beneficial and vulnerable insects, we may opt to relocate them.</p>
<p>We can be just as fast and loose in interchanging the terms “website” and “web app”. The differences between them are less clear than those between yellowjackets and honeybees, but conflating them can bring about painful outcomes. The pain comes in the affordances we allow ourselves when something is merely a “web<em>site</em>” versus a fully-featured “web app.” If you’re making an informational website for a business, you’re less likely to lean on a powerful framework to manage changes in the DOM or implement client-side routing—at least, I <em>hope</em>. Using tools so ill-suited for the task would not only be a detriment to the people who use that site but arguably less productive.</p>
<p>When we build a web <em>app</em>, though, <em>look out</em>. We’re installing packages which usher in hundreds—if not <em>thousands</em>—of dependencies, <a rel="noopener" href="https://snyk.io/blog/malicious-code-found-in-npm-package-event-stream/">some of which</a> we’re not sure are even safe. We’re also writing complicated configurations for module bundlers. In this frenzied, yet ubiquitous, sort of dev environment, it takes knowledge and vigilance to ensure what gets built is fast and accessible. If you doubt this, run <a rel="noopener" href="https://docs.npmjs.com/cli/ls.html#prod--production"><code>npm ls --prod</code></a> in your project’s root directory and <a rel="noopener" href="https://gist.github.com/malchata/dae0a011033846e2cb44d315b0496f0d">see if you recognize everything in that list</a>. Even if you do, that doesn’t account for third party scripts—of which I’m sure your site has at least a few.</p>
<p>What we tend to forget is that the environment websites and web apps occupy is one and the same. Both are subject to the <em>same environmental pressures</em> that the large gradient of networks and devices impose. Those constraints don’t suddenly vanish when we decide to call what we build “apps”, nor do our users’ phones gain magical new powers when we do so.</p>
<p>It’s our responsibility to evaluate who uses what we make, and accept that the conditions under which they access the internet can be different than what we’ve assumed. We need to know the purpose we’re trying to serve, and only <em>then</em> can we build something that admirably serves that purpose—<a rel="noopener" href="https://css-tricks.com/simple-boring/">even if it isn’t exciting to build</a>.</p>
<p>That means reassessing our reliance on JavaScript and how the use of it—particularly to the exclusion of HTML and CSS—can tempt us to adopt unsustainable patterns which harm performance and accessibility.</p>
<h2>Don’t let frameworks force you into unsustainable patterns</h2>
<p>I’ve been witness to some strange discoveries in codebases when working with teams that depend on frameworks to help them be highly productive. One characteristic common among many of them is that poor accessibility and performance patterns often result. Take the React component below, for example:</p>
<pre><code class="language-javascript">import React, { Component } from "react";
import { validateEmail } from "helpers/validation";
class SignupForm extends Component {
  constructor(props) {
    this.handleSubmit = this.handleSubmit.bind(this);
    this.updateEmail = this.updateEmail.bind(this);
    this.email = "";
  }
  updateEmail (event) {
    this.setState({
      email: event.target.value
    });
  }
  handleSubmit () {
    // If the email checks out, submit
    if (validateEmail(this.state.email)) {
      // ...
    }
  }
  render() {
    return (
      &lt;div&gt;
        &lt;span class="email-label"&gt;Enter your email:&lt;/span&gt;
        &lt;input type="text" id="email" onChange={this.updateEmail} /&gt;
        &lt;button onClick={this.handleSubmit}&gt;Sign Up&lt;/button&gt;
      &lt;/div&gt;
    );
  }
}</code></pre>
<p>There are some notable accessibility issues here:</p>
<ol type="1"><li>A form that doesn’t use a <code>&lt;form&gt;</code> element is <em>not</em> a form. Indeed, you could paper over this by specifying <a rel="noopener" href="https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/Form_Role"><code>role="form"</code></a> in the parent <code>&lt;div&gt;</code>, but if you’re building a form—and this <em>sure looks like one</em>—use a <code>&lt;form&gt;</code> element with the proper <code>action</code> and <code>method</code> attributes. The <code>action</code> attribute is crucial, as it ensures the form will still do <em>something</em> in the absence of JavaScript—provided the component is server-rendered, of course.</li>
<li>A <code>&lt;span&gt;</code> is not a substitute for a <code>&lt;label&gt;</code> element, which provides accessibility benefits <code>&lt;span&gt;</code>s don’t.</li>
<li>A <code>&lt;button&gt;</code> without <code>type="submit"</code> is just a <code>&lt;button&gt;</code> that only does what’s bound to it. If we intend to do something prior to submitting a form, then we should add <code>type="submit"</code> and move the action bound to the <code>onClick</code> handler to the <code>&lt;form&gt;</code> element’s <code>onSubmit</code> handler.</li>
<li>Incidentally, why use JavaScript to validate an email address when HTML5 offers form validation controls in almost every browser back to IE 10? There’s an opportunity here to rely on the browser and use an <a rel="noopener" href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/email">appropriate input type</a>, as well as the <a rel="noopener" href="https://developer.mozilla.org/en-US/docs/Learn/HTML/Forms/Form_validation#The_required_attribute"><code>required</code></a> attribute—but be aware that getting this to work right with screen readers <a rel="noopener" href="https://developer.paciellogroup.com/blog/2019/02/required-attribute-requirements/">takes a little know-how</a>.</li>
</ol><p>Knowing these things, we can refactor this component:</p>
<pre><code class="language-javascript">import React, { Component } from "react";
class SignupForm extends Component {
  constructor(props) {
    this.handleSubmit = this.handleSubmit.bind(this);
  }
  handleSubmit (event) {
    // Needed in case we're sending data to the server XHR-style
    // (but will still work if server-rendered with JS disabled).
    event.preventDefault();
    // Carry on…
  }
  render() {
    return (
      &lt;form method="POST" action="/signup" onSubmit={this.handleSubmit}&gt;
        &lt;label for="email" class="email-label"&gt;Enter your email:&lt;/label&gt;
        &lt;input type="email" id="email" required /&gt;
        &lt;button type="submit"&gt;Sign Up&lt;/button&gt;
      &lt;/form&gt;
    );
  }
}</code></pre>
<p>Not only is this component now more accessible, but it also uses less JavaScript. In a world that’s drowning in JavaScript, deleting lines of it should feel downright therapeutic. <a rel="noopener" href="https://alistapart.com/article/paint-the-picture-not-the-frame">The browser gives us so much for free</a>, and we should try to take advantage of that as often as possible.</p>
<p>This is not to say that inaccessible patterns occur <em>only</em> when frameworks are used, but rather that a sole preference for JavaScript <em>will</em> eventually surface gaps in our understanding of HTML and CSS. These knowledge gaps will often result in mistakes we may not even be aware of. Frameworks can be useful tools that increase our productivity, but continuing education in core web technologies is essential to creating <em>usable</em> experiences, no matter what tools we choose to use.</p>
<h2>Rely on the web platform and you’ll go far, fast</h2>
<p>While we’re on the subject of frameworks, it must be said that the web platform is a formidable framework of its own. As the previous section showed, we’re better off when we can rely on established markup patterns and browser features. The alternative is to reinvent them, and invite all the pain such endeavors all but guarantee us, or worse: merely <em>assume</em> that the author of every JavaScript package we install has solved the problem comprehensively and thoughtfully.</p>
<h3>Single page applications</h3>
<p>One of the tradeoffs developers are quick to make is to adopt the single page application (SPA) model, even if it’s not a fit for the project. Yes, you <em>do</em> gain better perceived performance with the client-side routing of an SPA, but what do you <em>lose</em>? The browser’s own navigation functionality—albeit synchronous—provides a slew of benefits. For one, history is managed according to <a rel="noopener" href="https://html.spec.whatwg.org/#the-history-interface">a complex specification</a>. Users without JavaScript—be it by <a rel="noopener" href="https://kryogenix.org/code/browser/everyonehasjs.html">their own choice or not</a>—won’t lose access altogether. For SPAs to remain available when JavaScript is not, server-side rendering suddenly becomes a thing you have to consider.</p>
<figure><img src="https://alistapart.com/d/responsible-javascript-part-1/fig2.png" alt="Two series of screenshots. On the left, we have a blank screen for several seconds until the app appears after 5.24s. On the right, the basic components appear at 4ms and the site is fully usable at 5.16s." /><figcaption>Figure 2. A comparison of an example app loading on a slow connection. The app on the left depends entirely upon JavaScript to render a page. The app on the right renders a response on the server, but then uses <a rel="noopener" href="https://reactjs.org/docs/react-dom.html#hydrate">client-side hydration</a> to attach components to the existing server-rendered markup.</figcaption></figure><p>Accessibility is also harmed if a client-side router fails to let people know what content on the page has changed. This can leave those reliant on assistive technology to suss out what changes have occurred on the page, which can be an arduous task.</p>
<p>Then there’s our old nemesis: overhead. Some client-side routers are very small, but when you <em>start</em> with <a rel="noopener" href="https://bundlephobia.com/result?p=react-dom@16.8.2">React</a>, <a rel="noopener" href="https://bundlephobia.com/result?p=react-router@4.3.1">a compatible router</a>, and possibly even <a rel="noopener" href="https://bundlephobia.com/result?p=redux@4.0.1">a state management library</a>, you’re accepting that there’s a certain amount of code you can never optimize away—approximately 135 KB in this case. Carefully consider what you’re building and whether a client side router is worth the tradeoffs you’ll inevitably make. Typically, you’re better off without one.</p>
<p>If you’re concerned about the perceived navigation performance, you <em>could</em> lean on <a rel="noopener" href="https://www.w3.org/TR/resource-hints/#prefetch-link-relation-type"><code>rel=prefetch</code></a> to speculatively fetch documents on the same origin. This has a dramatic effect on improving perceived loading performance of pages, as the document is immediately available in the cache. Because prefetches are done at a low priority, they’re also less likely to contend with critical resources for bandwidth.</p>
<figure><img src="https://alistapart.com/d/responsible-javascript-part-1/fig3.png" alt="Screenshot showing a list of assets loaded on a webpage. 'writing/' is labeled as prefetched on initial navigation. This asset is then loaded in 2ms when actually requested by the user." /><figcaption>Figure 3. The HTML for the writing/ URL is prefetched on the initial page. When the writing/ URL is requested by the user, the HTML for it is loaded instantaneously from the browser cache.</figcaption></figure><p>The primary drawback with link prefetching is that you need to be aware that it <em>can</em> be potentially wasteful. <a rel="noopener" href="https://github.com/GoogleChromeLabs/quicklink">Quicklink</a>, a tiny link prefetching script from Google, mitigates this somewhat by checking if the current client is on a slow connection—or has <a rel="noopener" href="https://support.google.com/chrome/answer/2392284?co=GENIE.Platform%3DAndroid&amp;hl=en">data saver mode</a> enabled—and avoids prefetching links on cross-origins by default.</p>
<p><a rel="noopener" href="https://adactio.com/articles/13796">Service workers</a> are also hugely beneficial to perceived performance for returning users, whether we use client side routing or not—<a rel="noopener" href="https://developers.google.com/web/fundamentals/primers/service-workers/high-performance-loading#for_best_performance_bypass_the_network_for_navigations">provided you know the ropes</a>. <a rel="noopener" href="https://developers.google.com/web/ilt/pwa/caching-files-with-service-worker">When we precache routes with a service worker</a>, we get many of the same benefits as link prefetching, but with a much greater degree of control over requests and responses. Whether you think of your site as an “app” or not, adding a service worker to it is perhaps one of the most responsible uses of JavaScript that exists today.</p>
<h3>JavaScript isn’t the solution to your layout woes</h3>
<p>If we’re installing a package to solve a layout problem, proceed with caution and ask “what am I trying to accomplish?” CSS is <a rel="noopener" href="https://twitter.com/rachelandrew/status/1088870059240505344"><em>designed to do this job</em></a>, and requires no abstractions to use effectively. Most layout issues JavaScript packages attempt to solve, like <a rel="noopener" href="https://www.npmjs.com/package/flexibility">box placement, alignment, and sizing</a>, <a rel="noopener" href="https://www.npmjs.com/package/shave">managing text overflow</a>, and even <a rel="noopener" href="https://www.npmjs.com/package/lost">entire layout systems</a>, are solvable with CSS <em>today</em>. Modern layout engines like Flexbox and Grid are supported well enough that we shouldn’t need to start a project with any layout framework. CSS <em>is</em> the framework. When we have <a rel="noopener" href="https://hacks.mozilla.org/2016/08/using-feature-queries-in-css/">feature queries</a>, progressively enhancing layouts to adopt new layout engines is suddenly <a rel="noopener" href="https://hacks.mozilla.org/2016/08/using-feature-queries-in-css/">not so hard</a>.</p>
<pre><code class="language-css">/* Your mobile-first, non-CSS grid styles goes here */
/* The @supports rule below is ignored by browsers that don't
   support CSS grid, _or_ don't support @supports. */
@supports (display: grid) {
  /* Larger screen layout */
  @media (min-width: 40em) {
    /* Your progressively enhanced grid layout styles go here */
  }
}</code></pre>
<p>Using JavaScript solutions for layout and presentations problems is not new. It was something we did when we lied to ourselves in 2009 that every website had to look in IE6 exactly as it did in the more capable browsers of that time. If we’re still developing websites to look the same in every browser in 2019, we should reassess our development goals. There will <em>always</em> be some browser we’ll have to support that can’t do everything those modern, evergreen browsers can. Total visual parity on all platforms is not only a pursuit made in vain, it’s the principal foe of <a rel="noopener" href="https://alistapart.com/article/understandingprogressiveenhancement">progressive enhancement</a>.</p>
<h2>I’m not here to kill JavaScript</h2>
<p>Make no mistake, I have no ill will toward JavaScript. It’s given me a career and—if I’m being honest with myself—a source of enjoyment for over a decade. Like any long-term relationship, I learn more about it the more time I spend with it. It’s a mature, feature-rich language that only gets more capable and elegant with every passing year.</p>
<p>Yet, there are times when I feel like JavaScript and I are at odds. I <em>am</em> critical of JavaScript. Or maybe more accurately, I’m critical of how we’ve developed a tendency to view it as a first resort to building for the web. As I pick apart yet another bundle not unlike a tangled ball of Christmas tree lights, it’s become clear that the web is <em>drunk</em> on JavaScript. We reach for it for almost everything, even when the occasion doesn’t call for it. Sometimes I wonder how vicious the hangover will be.</p>
<p>In a series of articles to follow, I’ll be giving more practical advice to follow to stem the encroaching tide of excessive JavaScript and how we can wrangle it so that <em>what</em> we build for the web is usable—or at least <em>more</em> so—for everyone everywhere. Some of the advice will be preventative. Some will be mitigating “hair of the dog” measures. In either case, the outcomes will hopefully be the same. I believe that we all love the web and want to do right by it, but I want us to think about how to make it more resilient and inclusive for all.</p>
<footer class="entry-footer nocontent"><h1>About the Author</h1>
<div class="byline author vcard"><a class="photo" href="https://alistapart.com/author/jeremy-wagner"><img src="https://alistapart.com/d/_made/pix/authors/photos/jlwagner-400x400_120_120_c1.jpg" alt="Image of Jeremy Wagner" /></a>
<h2>
Jeremy Wagner is an independent web performance consultant from Minnesota. He's the author of <em><a href="https://www.manning.com/books/web-performance-in-action?a_aid=webopt&amp;a_bid=63c31090" rel="noopener">Web Performance in Action</a></em> and <em><a href="https://www.smashingmagazine.com/ebooks/the-webp-manual/" rel="noopener">The WebP Manual</a></em>, and <a href="https://speaking.jeremy.codes/" rel="noopener">speaks whenever he can get a gig</a>.</h2></div>
<h3>More from this Author</h3>
<ul class="author-more"><li><a href="https://alistapart.com/article/considering-how-we-use-http2">Considering How We Use HTTP/2</a></li>
<li><a href="https://alistapart.com/article/gauging-the-perception-of-lossy-images-a-study">How People Perceive Lossy Image Quality: A Study</a></li>
<li><a href="https://alistapart.com/article/designing-for-research">Designing for Research</a></li>
<li><a href="https://alistapart.com/article/using-http-2-responsibly-adapting-for-users">Using HTTP/2 Responsibly: Adapting for Users</a></li>
</ul>
</footer>]]></description>
      <link>http://alistapart.com/article/responsible-javascript-part-1</link>
      <guid>http://alistapart.com/article/responsible-javascript-part-1</guid>
      <pubDate>Thu, 28 Mar 2019 01:03:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[<![CDATA[ Canary in a Coal Mine: How Tech Provides Platforms for Hate ]]]]><![CDATA[>]]></title>
      <description><![CDATA[<div class="entry-content">
<p>As I write this, the world is sending its thoughts and prayers to our Muslim cousins. The Christchurch act of terrorism has once again reminded the world that white supremacy’s rise is very real, that its perpetrators are no longer on the fringes of society, but centered in our holiest places of worship. People are begging us to not share videos of the mass murder or the hateful manifesto that the white supremacist terrorist wrote. That’s what he wants: for his proverbial message of hate to be spread to the ends of the earth.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>We live in a time where you can stream a mass murder and hate crime from the <em>comfort of your home</em>. Children can access these videos, too.</p>
<p>As I work through the pure pain, unsurprised, observing the toll on Muslim communities (as a non-Muslim, who matters least in this event), I think of the imperative role that our industry plays in this story.</p>
<p>At time of writing, YouTube has failed to ban and to remove this video. If you search for the video (which I strongly advise against), it still comes up with a mere content warning; the same content warning that appears for casually risqué content. You can bypass the warning and watch people get murdered. <a href="https://afrotech.com/tech-companies-are-scrambling-to-remove-video-of-the-christchurch-shooting">Even when the video gets flagged and taken down, new ones get uploaded.</a></p>
<p><a href="https://www.theverge.com/2019/2/25/18229714/cognizant-facebook-content-moderator-interviews-trauma-working-conditions-arizona" rel="noopener">Human moderators have to relive watching this trauma over and over again</a> for unlivable wages. News outlets are <em>embedding the video</em> into their articles and publishing the hateful manifesto. Why? What does this accomplish?</p>
<p>I was taught in journalism class that media (photos, video, infographics, etc.) should be additive (a progressive enhancement, if you will) and provide something to the story for the reader that words cannot.</p>
<p>Is it necessary to show murder for our dear readers to understand the cruelty and finality of it? Do readers gain something more from watching fellow humans have their lives stolen from them? What psychological damage are we inflicting upon millions of people   and for what?</p>
<p>Who benefits?</p>
<p>The mass shooter(s) who had a message to accompany their mass murder. News outlets are thirsty for perverse clicks to garner more ad revenue. We, by way of our platforms, give agency and credence to these acts of violence, then pilfer profits from them. Tech is a money-making accomplice to these hate crimes.</p>
<p>Christchurch is just one example in an endless array where the <a href="https://www.sarawb.com/technically-wrong/" rel="noopener">tools and products we create are used as a vehicle for harm and for hate</a>.</p>
<p><a href="https://www.theatlantic.com/politics/archive/2018/04/white-supremacy-is-still-americas-biggest-security-threat/557591/" rel="noopener">Facebook and the Cambridge Analytica scandal played a critical role in the outcome of the 2016 presidential election</a>. The concept of “race realism,” which is essentially a term that white supremacists use to codify their false racist pseudo-science, was actively tested on Facebook’s platform to see how the term would sit with people who are ignorantly sitting on the fringes of white supremacy. Full-blown white supremacists don’t need this soft language. This is how radicalization works.</p>
<p>The strategies articulated in the above article are not new. Racist propaganda predates social media platforms. What we have to be mindful with is that we’re building smarter tools with power we don’t yet fully understand: you can now have an <a href="https://www.theverge.com/tldr/2019/2/15/18226005/ai-generated-fake-people-portraits-thispersondoesnotexist-stylegan" rel="noopener">AI-generated human face</a>. Our technology is accelerating at a frightening rate, a rate faster than our reflective understanding of its impact.</p>
<p>Combine the time-tested methods of spreading white supremacy, the power to manipulate perception through technology, and the magnitude and reach that has become democratized and anonymized.</p>
<p>We’re staring at our own reflection in the <em>Black Mirror</em>.</p>
<h2>The right to speak versus the right to survive<a class="subhead-anchor" href="#section1">#section1</a></h2>
<p>Tech has proven time and time again that it voraciously protects first amendment rights above all else. (I will also take this opportunity to remind you that the first amendment of the United States offers protection to the people from the <em>government</em> abolishing free speech, not from <em>private money-making corporations</em>).</p>
<p>Evelyn Beatrice Hall writes in <em>The Friends of Voltaire</em>, “I disapprove of what you say, but I will defend to the death your right to say it.” Fundamentally, Hall’s quote expresses that we must protect, possibly above all other freedoms, the freedom to say whatever we want to say. (Fun fact: The quote is often misattributed to Voltaire, but Hall actually wrote it to explain Voltaire’s ideologies.)</p>
<p>And the logical anchor here is sound: We must grant everyone else the same rights that we would like for ourselves. Former <em>99u</em> editor Sean Blanda wrote a thoughtful piece on the “<a href="https://medium.com/@SeanBlanda/the-other-side-is-not-dumb-2670c1294063" rel="noopener">Other Side</a>,” where he posits that we lack tolerance for people who don’t think like us, but that we must because we might one day be on the other side. I agree in theory.</p>
<p>But, what happens when a portion of the rights we grant to one group (let’s say, free speech to white supremacists) means the active oppression another group’s right (let’s say, every person of color’s right to live)?</p>
<p>James Baldwin expresses this idea with a clause, “We can disagree and still love each other unless your disagreement is rooted in my oppression and denial of my humanity and right to exist.”</p>
<p>It would seem that we have a moral quandary where two sets of rights cannot coexist. Do we protect the privilege for all users to say what they want, or do we protect all users from hate? Because of this perceived moral quandary, tech has often opted out of this conversation altogether. Platforms like Twitter and Facebook, two of the biggest offenders, continue to allow hate speech to ensue with irregular to no regulation.</p>
<p><a href="https://www.wired.com/story/jack-dorsey-twitters-role-free-speech-filter-bubbles/" rel="noopener">When explicitly asked about his platform</a> as a free-speech platform and its consequence to privacy and safety, Twitter CEO Jack Dorsey said,</p>
<figure class="quote"><blockquote cite="https://www.wired.com/story/jack-dorsey-twitters-role-free-speech-filter-bubbles/">
<p>“So we believe that we can only serve the public conversation, we can only stand for freedom of expression if people feel safe to express themselves in the first place. We can only do that if they feel that they are not being silenced.”</p>
</blockquote>
</figure><p>Dorsey and Twitter are most concerned about protecting <em>expression</em> and about not silencing people. In his mind, if he allows people to say whatever they want on his platform, he has succeeded. When asked about why he’s failed to implement AI to filter abuse like, say, Instagram had implemented, he said that he’s most concerned about being able to explain <em>why</em> the AI flagged something as abusive. Again, Dorsey protects the freedom of speech (and thus, the perpetrators of abuse) before the <em>victims</em> of abuse.</p>
<p>But he’s inconsistent about it. In a <a href="https://extremism.gwu.edu/sites/g/files/zaxdzs2191/f/downloads/Nazis%20v.%20ISIS.pdf" rel="noopener">study by George Washington University comparing white nationalists and ISIS social media usage</a>, Twitter’s freedom of speech was not granted to ISIS. Twitter suspended 1,100 accounts related to ISIS whereas it suspended only seven accounts related to Nazis, white nationalism, and white supremacy, despite the accounts having more than seven times the followers, and tweeting 25 times more than the ISIS accounts. Twitter here made a moral judgment that the fewer, less active, and less influential ISIS accounts were somehow not welcome on their platform, whereas the prolific and burgeoning Nazi and white supremacy accounts were.</p>
<p>So, Twitter has shown that it won’t protect free speech at <em>all</em> costs or for <em>all</em> users. We can only conclude that Twitter is either intentionally protecting white supremacy or simply doesn’t think it’s very dangerous. Regardless of which it is (I think I know), the outcome does not change the fact that white supremacy is running rampant on its platforms and many others.</p>
<p>Let’s brainwash ourselves for a moment and pretend like Twitter does want to support freedom of speech equitably and stays neutral and fair to complete this logical exercise: Going back to the dichotomy of rights example I provided earlier, where either the right to free speech or the right to safety and survival prevail, the rights and the power will fall into the hands of the dominant group or ideologue.</p>
<p>In case you are somehow unaware, the dominating ideologue, whether you’re a flagrant white supremacist or not, is white supremacy. White supremacy was baked into <a href="https://www.theroot.com/to-be-clear-white-supremacy-is-the-foundation-of-our-c-1797990783" rel="noopener">founding principles of the United States</a>, the country where the majority of these platforms were founded and exist. (I am not suggesting that white supremacy doesn’t exist globally, as it does, evidenced most recently by the terrorist attack in Christchurch. I’m centering the conversation intentionally around the United States as it is my lived experience and where most of these companies operate.)</p>
<p>Facebook attempted to educate its team on white supremacy in order to address how to regulate free speech. A laugh-cry excerpt:</p>
<figure class="quote"><blockquote>
<p>“White nationalism and calling for an exclusively white state is not a violation for our policy unless it explicitly excludes other PCs [protected characteristics].”</p>
</blockquote>
</figure><p>White nationalism is a softened synonym for white supremacy so that racists-lite can feel more comfortable with their transition into hate. White nationalism (a.k.a. white supremacy) by definition explicitly seeks to eradicate all people of color. So, Facebook should see white nationalist speech as exclusionary, and therefore a violation of their policies.</p>
<p>Regardless of what tech leaders like Dorsey or Facebook CEO Zuckerberg say or what mediocre and uninspired condolences they might offer, inaction is an action.</p>
<p>Companies that use terms and conditions or acceptable use policies to defend their inaction around hate speech are enabling and perpetuating white supremacy. Policies are written by humans to protect that group of human’s ideals. The message they use might be that they are protecting free speech, but hate speech is a form of free speech. So effectively, they are protecting hate speech. Well, as long as it’s for white supremacy and not the Islamic State.</p>
<p>Whether the motivation is fear (losing loyal Nazi customers and their sympathizers) or hate (because their CEO is a white supremacist), it does not change the impact: Hate speech is tolerated, enabled, and amplified by way of their platforms.</p>
<h2>“That wasn’t our intent”<a class="subhead-anchor" href="#section2">#section2</a></h2>
<p>Product creators might be thinking, <em>Hey, look, I don’t intentionally create a platform for hate. The way these features were used was never our intent.</em></p>
<p><strong>Intent does not erase impact.</strong></p>
<p>We cannot absolve ourselves of culpability merely because we failed to conceive such evil use cases when we built it. While we very well might not have created these platforms with the explicit intent to help Nazis or imagined it would be used to spread their hate, the reality is that our platforms <em>are</em> being used in this way.</p>
<p>As product creators, it is our responsibility to protect the safety of our users by stopping those that intend to or already cause them harm. Better yet, we ought to think of this <em>before</em> we build the platforms to prevent this in the first place.</p>
<p>The question to answer isn’t, “Have I made a place where people have the freedom to express themselves?” Instead we have to ask, “Have I made a place where everyone has the safety to exist?” If you have created a place where a dominant group can embroil and embolden hate against another group, you have failed to create a safe place. The foundations of hateful speech (beyond the psychological trauma of it) lead to events like Christchurch.</p>
<p>We must protect safety over speech.</p>
<h2>The Domino Effect<a class="subhead-anchor" href="#section3">#section3</a></h2>
<p>This week, <a href="https://www.engadget.com/2019/03/14/slack-removed-28-accounts-with-ties-to-hate-groups/" rel="noopener">Slack banned 28 hate groups</a>. What is most notable, to me, is that the groups did not break any parts of their Acceptable Use Policy. Slack issued a statement:</p>
<figure class="quote"><blockquote cite="https://slackhq.com/slack-statement-hate-groups">
<p>The use of Slack by hate groups runs counter to everything we believe in at Slack and is not welcome on our platform… Using Slack to encourage or incite hatred and violence against groups or individuals because of who they are is antithetical to our values and the very purpose of Slack.</p>
</blockquote>
</figure><p>That’s it.</p>
<p>It is not illegal for tech companies like Slack to ban groups from using their proprietary software because it is a private company that can regulate users if they do not align with their vision as a company. Think of it as the “no shoes, no socks, no service” model, but for tech.</p>
<p>Slack simply decided that supporting the workplace collaboration of Nazis around efficient ways to evangelize white supremacy was probably not in line with their company directives around inclusion. I imagine Slack also considered how their employees of color most ill-affected by white supremacy would feel working for a company that supported it, actively or not.</p>
<p>What makes the Slack example so notable is that they acted swiftly and on their own accord. Slack chose the safety of all their users over the speech of some.</p>
<p>When caught with their enablement of white supremacy, some companies will only budge under pressure from activist groups, users, and employees.</p>
<p><a href="https://www.cbsnews.com/news/paypal-suspends-dozens-of-racist-groups-sites-altright-com/" rel="noopener">PayPal finally banned hate groups after Charlottesville</a> and after Southern Poverty Law Center (SPLC) explicitly called them out for enabling hate. SPLC had identified this fact for three years prior. PayPal had ignored them for all three years.</p>
<p>Unfortunately, taking these “stances” against something as clearly and viscerally wrong as white supremacy is rare for companies to do. The tech industry tolerates this inaction through unspoken agreements.</p>
<p>If Facebook doesn’t do anything about racist political propaganda, <a href="https://www.vox.com/2018/12/13/18136253/pewdiepie-vs-tseries-links-to-white-supremacist-alt-right-redpill" rel="noopener">YouTube doesn’t do anything about PewDiePie</a>, and Twitter doesn’t do <a href="https://tech.co/news/amnesty-study-misogyny-racism-twitter-2018-12" rel="noopener">anything about disproportionate abuse against Black women</a>, it says to the smaller players in the industry that they don’t have to either.</p>
<p>The tech industry reacts to its peers. When there is disruption, as was the case with Airbnb, who <a href="https://slate.janrainsso.com//static/server.html?origin=http%3A%2F%2Fwww.slate.com%2Farticles%2Ftechnology%2Ftechnology%2F2017%2F08%2Fairbnb_s_ban_of_nazis_in_charlottesville_sets_an_important_standard_for.html" rel="noopener">screened and rejected any guests who they believed to be partaking in the Unite the Right Charlottesville rally</a>, companies follow suit. <a href="https://www.npr.org/sections/thetwo-way/2017/08/14/543360434/white-supremacist-site-is-banned-by-go-daddy-after-virginia-rally" rel="noopener">GoDaddy cancelled Daily Stormer’s domain registration</a> and Google did the same when they attempted migration.</p>
<p>If one company, like Slack or Airbnb, decides to do something about the role it’s going to play, it creates a perverse kind of FOMO for the rest: Fear of missing out of doing the right thing and standing on the right side of history.</p>
<h2>Don’t have FOMO, do something<a class="subhead-anchor" href="#section4">#section4</a></h2>
<p>The type of activism at those companies all started with one individual. If you want to be part of the solution, I’ve gathered some places to start. The list is not exhaustive, and, as with all things, I recommend researching beyond this abridged summary.</p>
<ol><li><strong>Understand how white supremacy impacts you as an individual.</strong><br />
Now, if you are a person of color, queer, disabled, or trans, it’s likely that you know this very intimately.
<p>If you are not any of those things, then you, as a majority person, need to understand how white supremacy protects you and works in your favor. It’s not easy work, it is uncomfortable and unfamiliar, but you have the most powerful tools to fix tech. The resources are aplenty, but my favorite abridged list:</p>
<ol type="a"><li><a href="https://www.sceneonradio.org/seeing-white/" rel="noopener">Seeing White</a> podcast</li>
<li>Ijeoma Oluo’s <em>So you want to talk about race</em></li>
<li>Reni Eddo-Lodge’s <em>Why I’m no longer talking to white people about race</em> (Very key read for UK folks)</li>
<li>Robin DiAngelo’s <em>White Fragility</em></li>
</ol></li>
<li><strong>See where your company stands: Read your company’s policies like accepted use and privacy policies and find your CEO’s stance on safety and free speech.</strong><br />
While these policies are baseline (and in the Slack example, sort of irrelevant), it’s important to known your company’s track record. As an employee, your actions and decisions either uphold the ideologies behind the company or they don’t. Ask yourself if the company’s ideologies are worth upholding and whether they align with your own. Education will help you to flag if something contradicts those policies, or if the policies themselves allow for unethical activity.</li>
<li><strong>Examine everything you do critically on an ongoing basis.</strong><br />
You may feel your role is small or that your company is immune—maybe you are responsible for the maintenance of one small algorithm. But consider how that algorithm or similar ones can be exploited. Some key questions I ask myself:
<ol type="a"><li>Who benefits from this? Who is harmed?</li>
<li>How could this be used for harm?</li>
<li>Who does this exclude? Who is missing?</li>
<li>What does this protect? For whom? Does it do so equitably?</li>
</ol></li>
<li><strong>See something? Say something.</strong><br />
If you believe that your company is creating something that is or can be used for harm, it is your responsibility to say something. Now, I’m not naïve to the fact that there is inherent risk in this. You might fear ostracization or termination. You need to protect yourself first. But you also need to do something.
<ol type="a"><li>Find someone who you trust who might be at less risk. Maybe if you’re a nonbinary person of color, find a white cis man who is willing to speak up. Maybe if you’re a white man who is new to the company, find a white man who has more seniority or tenure. But also, consider how you have so much more relative privilege compared to most other people and that you might be the safest option.</li>
<li>Unionize. Find peers who might feel the same way and write a collective statement.</li>
<li>Get someone influential outside of the company (if knowledge is public) to say something.</li>
</ol></li>
<li><strong>Listen to concerns, no matter how small, particularly if they’re coming from the most endangered groups.</strong><br />
If your user or peer feels unsafe, you need to understand why. People often feel like small things can be overlooked, as their initial impact might be less, but it is in the smallest cracks that hate can grow. Allowing one insensitive comment about race is still allowing hate speech. If someone, particularly someone in a marginalized group, brings up a concern, you need to do your due diligence to listen to it and to understand its impact.</li>
</ol><p>I cannot emphasize this last point enough.</p>
<p>What I say today is not new. Versions of this article have been written before. Women of color like me have voiced similar concerns not only in writing, but in design reviews, in closed door meetings to key stakeholders, in Slack DMs. We’ve blown our whistles.</p>
<p>But here is the power of white supremacy.</p>
<p>White supremacy is so ingrained in every single aspect of how this nation was built, how our corporations function, and who is in control. If you are not convinced of this, you are not paying attention or intentionally ignoring the truth.</p>
<p>Queer, Muslim, disabled, trans women and nonbinary folks of color — the marginalized groups most impacted by this — are the ones who are voicing these concerns most voraciously. Speaking up requires us to enter the spotlight and outside of safety—we take a risk and are not heard.</p>
<p>The silencing of our voices is one of many effective tools of white supremacy. Our silencing lives within every microaggression, each time we’re talked over, or not invited to partake in key decisions.</p>
<p>In tech, I feel I am a canary in a coal mine. I have sung my song to warn the miners of the toxicity. My sensitivity to it is heightened, because of my existence.</p>
<p>But the miners look at me and tell me that my lived experience is false. It does not align with their narrative as humans. They don’t understand why I sing.</p>
<p>If the people at the highest echelons of the tech industry—the white, male CEOs in power—fail to listen to its most marginalized people—the queer, disabled, trans, people of color—the fate of the canaries will too become the fate of the miners.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Our own @zeldman paints the complicated catch-22 that our free, democratized web has with our money-making capitalist roots. As creators, how do we untangle this web? #LetsFixThis</div><div class="entry-content">A month of experiencing a temporary disability changed @fcorradini’s perspective on how to take more care when conducting accessibility testing. He shares the impact.</div><div class="entry-content">Jeremy Wagner plots a course to avoid the unnecessary bloat and inaccessible patterns of current JavaScript trends.</div><div class="entry-content">Screen readers are diverse and complex: front-end developer Melanie Richards breaks down how they access our content step-by-step.</div><div class="entry-content">Brandon Gregory discusses designing for conversions, which allows products to reach their targets and serve the right people.</div>]]></description>
      <link>https://alistapart.com/article/canary-in-a-coal-mine-how-tech-provides-platforms-for-hate/</link>
      <guid>https://alistapart.com/article/canary-in-a-coal-mine-how-tech-provides-platforms-for-hate/</guid>
      <pubDate>Tue, 19 Mar 2019 09:03:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[Canary in a Coal Mine: How Tech Provides Platforms for Hate]]></title>
      <description><![CDATA[<p>As I write this, the world is sending its thoughts and prayers to our Muslim cousins. The Christchurch act of terrorism has once again reminded the world that white supremacy’s rise is very real, that its perpetrators are no longer on the fringes of society, but centered in our holiest places of worship. People are begging us to not share videos of the mass murder or the hateful manifesto that the white supremacist terrorist wrote. That’s what he wants: for his proverbial message of hate to be spread to the ends of the earth.</p>


<p>We live in a time where you can stream a mass murder and hate crime from the <em>comfort of your home</em>. Children can access these videos, too.</p>
<p>As I work through the pure pain, unsurprised, observing the toll on Muslim communities (as a non-Muslim, who matters least in this event), I think of the imperative role that our industry plays in this story.</p>
<p>At time of writing, YouTube has failed to ban and to remove this video. If you search for the video (which I strongly advise against), it still comes up with a mere content warning; the same content warning that appears for casually risqué content. You can bypass the warning and watch people get murdered. <a href="https://afrotech.com/tech-companies-are-scrambling-to-remove-video-of-the-christchurch-shooting">Even when the video gets flagged and taken down, new ones get uploaded.</a></p>
<p><a href="https://www.theverge.com/2019/2/25/18229714/cognizant-facebook-content-moderator-interviews-trauma-working-conditions-arizona" rel="noopener">Human moderators have to relive watching this trauma over and over again</a> for unlivable wages. News outlets are <em>embedding the video</em> into their articles and publishing the hateful manifesto. Why? What does this accomplish?</p>
<p>I was taught in journalism class that media (photos, video, infographics, etc.) should be additive (a progressive enhancement, if you will) and provide something to the story for the reader that words cannot.</p>
<p>Is it necessary to show murder for our dear readers to understand the cruelty and finality of it? Do readers gain something more from watching fellow humans have their lives stolen from them? What psychological damage are we inflicting upon millions of people   and for what?</p>
<p>Who benefits?</p>
<p>The mass shooter(s) who had a message to accompany their mass murder. News outlets are thirsty for perverse clicks to garner more ad revenue. We, by way of our platforms, give agency and credence to these acts of violence, then pilfer profits from them. Tech is a money-making accomplice to these hate crimes.</p>
<p>Christchurch is just one example in an endless array where the <a href="https://www.sarawb.com/technically-wrong/" rel="noopener">tools and products we create are used as a vehicle for harm and for hate</a>.</p>
<p><a href="https://www.theatlantic.com/politics/archive/2018/04/white-supremacy-is-still-americas-biggest-security-threat/557591/" rel="noopener">Facebook and the Cambridge Analytica scandal played a critical role in the outcome of the 2016 presidential election</a>. The concept of “race realism,” which is essentially a term that white supremacists use to codify their false racist pseudo-science, was actively tested on Facebook’s platform to see how the term would sit with people who are ignorantly sitting on the fringes of white supremacy. Full-blown white supremacists don’t need this soft language. This is how radicalization works.</p>
<p>The strategies articulated in the above article are not new. Racist propaganda predates social media platforms. What we have to be mindful with is that we’re building smarter tools with power we don’t yet fully understand: you can now have an <a href="https://www.theverge.com/tldr/2019/2/15/18226005/ai-generated-fake-people-portraits-thispersondoesnotexist-stylegan" rel="noopener">AI-generated human face</a>. Our technology is accelerating at a frightening rate, a rate faster than our reflective understanding of its impact.</p>
<p>Combine the time-tested methods of spreading white supremacy, the power to manipulate perception through technology, and the magnitude and reach that has become democratized and anonymized.</p>
<p>We’re staring at our own reflection in the <em>Black Mirror</em>.</p>
<h2>The right to speak versus the right to survive</h2>
<p>Tech has proven time and time again that it voraciously protects first amendment rights above all else. (I will also take this opportunity to remind you that the first amendment of the United States offers protection to the people from the <em>government</em> abolishing free speech, not from <em>private money-making corporations</em>).</p>
<p>Evelyn Beatrice Hall writes in <em>The Friends of Voltaire</em>, “I disapprove of what you say, but I will defend to the death your right to say it.” Fundamentally, Hall’s quote expresses that we must protect, possibly above all other freedoms, the freedom to say whatever we want to say. (Fun fact: The quote is often misattributed to Voltaire, but Hall actually wrote it to explain Voltaire’s ideologies.)</p>
<p>And the logical anchor here is sound: We must grant everyone else the same rights that we would like for ourselves. Former <em>99u</em> editor Sean Blanda wrote a thoughtful piece on the “<a href="https://medium.com/@SeanBlanda/the-other-side-is-not-dumb-2670c1294063" rel="noopener">Other Side</a>,” where he posits that we lack tolerance for people who don’t think like us, but that we must because we might one day be on the other side. I agree in theory.</p>
<p>But, what happens when a portion of the rights we grant to one group (let’s say, free speech to white supremacists) means the active oppression another group’s right (let’s say, every person of color’s right to live)?</p>
<p>James Baldwin expresses this idea with a clause, “We can disagree and still love each other unless your disagreement is rooted in my oppression and denial of my humanity and right to exist.”</p>
<p>It would seem that we have a moral quandary where two sets of rights cannot coexist. Do we protect the privilege for all users to say what they want, or do we protect all users from hate? Because of this perceived moral quandary, tech has often opted out of this conversation altogether. Platforms like Twitter and Facebook, two of the biggest offenders, continue to allow hate speech to ensue with irregular to no regulation.</p>
<p><a href="https://www.wired.com/story/jack-dorsey-twitters-role-free-speech-filter-bubbles/" rel="noopener">When explicitly asked about his platform</a> as a free-speech platform and its consequence to privacy and safety, Twitter CEO Jack Dorsey said,</p>
<figure class="quote" id="figure1"><blockquote cite="https://www.wired.com/story/jack-dorsey-twitters-role-free-speech-filter-bubbles/">
<p>“So we believe that we can only serve the public conversation, we can only stand for freedom of expression if people feel safe to express themselves in the first place. We can only do that if they feel that they are not being silenced.”</p>
</blockquote>
</figure><p>Dorsey and Twitter are most concerned about protecting <em>expression</em> and about not silencing people. In his mind, if he allows people to say whatever they want on his platform, he has succeeded. When asked about why he’s failed to implement AI to filter abuse like, say, Instagram had implemented, he said that he’s most concerned about being able to explain <em>why</em> the AI flagged something as abusive. Again, Dorsey protects the freedom of speech (and thus, the perpetrators of abuse) before the <em>victims</em> of abuse.</p>
<p>But he’s inconsistent about it. In a <a href="https://extremism.gwu.edu/sites/g/files/zaxdzs2191/f/downloads/Nazis%20v.%20ISIS.pdf" rel="noopener">study by George Washington University comparing white nationalists and ISIS social media usage</a>, Twitter’s freedom of speech was not granted to ISIS. Twitter suspended 1,100 accounts related to ISIS whereas it suspended only seven accounts related to Nazis, white nationalism, and white supremacy, despite the accounts having far more than seven times the followers, and tweeting 25 times the more than the ISIS accounts. Twitter here made a moral judgment that the fewer, less active, and less influential ISIS accounts were somehow not welcome on their platform, whereas the prolific and burgeoning Nazi and white supremacy accounts were.</p>
<p>So, Twitter has shown that it won’t protect free speech at <em>all</em> costs or for <em>all</em> users. We can only conclude that Twitter is either intentionally protecting white supremacy or simply doesn’t think it’s very dangerous. Regardless of which it is (I think I know), the outcome does not change the fact that white supremacy is running rampant on its platforms and many others.</p>
<p>Let’s brainwash ourselves for a moment and pretend like Twitter does want to support freedom of speech equitably and stays neutral and fair to complete this logical exercise: Going back to the dichotomy of rights example I provided earlier, where either the right to free speech or the right to safety and survival prevail, the rights and the power will fall into the hands of the dominant group or ideologue.</p>
<p>In case you are somehow unaware, the dominating ideologue, whether you’re a flagrant white supremacist or not, is white supremacy. White supremacy was baked into <a href="https://www.theroot.com/to-be-clear-white-supremacy-is-the-foundation-of-our-c-1797990783" rel="noopener">founding principles of the United States</a>, the country where the majority of these platforms were founded and exist. (I am not suggesting that white supremacy doesn’t exist globally, as it does, evidenced most recently by the terrorist attack in Christchurch. I’m centering the conversation intentionally around the United States as it is my lived experience and where these most of these companies operate.)</p>
<p>Facebook attempted to educate its team on white supremacy in order to address how to regulate free speech. A laugh-cry excerpt:</p>
<figure class="quote" id="figure2"><blockquote>
<p>“White nationalism and calling for an exclusively white state is not a violation for our policy unless it explicitly excludes other PCs [protected characteristics].”</p>
</blockquote>
</figure><p>White nationalism is a softened synonym for white supremacy so that racists-lite can feel more comfortable with their transition into hate. White nationalism (a.k.a. white supremacy) by definition explicitly seeks to eradicate all people of color. So, Facebook should see white nationalist speech as exclusionary, and therefore a violation of their policies.</p>
<p>Regardless of what tech leaders like Dorsey or Zuckerberg say or what mediocre and uninspired condolences they might offer, inaction is an action.</p>
<p>Companies that use terms and conditions or acceptable use policies to defend their inaction around hate speech are enabling and perpetuating white supremacy. Policies are written by humans to protect that group of human’s ideals. The message they use might be that they are protecting free speech, but hate speech is a form of free speech. So effectively, they are protecting hate speech. Well, as long as it’s for white supremacy and not the Islamic State.</p>
<p>Whether the motivation is fear (losing loyal Nazi customers and their sympathizers) or hate (because their CEO is a white supremacist), it does not change the impact: Hate speech is tolerated, enabled, and amplified by way of their platforms.</p>
<h2>“That wasn’t our intent”</h2>
<p>Product creators might be thinking, <em>Hey, look, I don’t intentionally create a platform for hate. The way these features were used was never our intent.</em></p>
<p><strong>Intent does not erase impact.</strong></p>
<p>We cannot absolve ourselves of culpability merely because we failed to conceive such evil use cases when we built it. While we very well might not have created these platforms with the explicit intent to help Nazis or imagined it would be used to spread their hate, the reality is that our platforms <em>are</em> being used in this way.</p>
<p>As product creators, it is our responsibility to protect the safety of our users by stopping those that intend to or already cause them harm. Better yet, we ought to think of this <em>before</em> we build the platforms to prevent this in the first place.</p>
<p>The question to answer isn’t, “Have I made a place where people have the freedom to express themselves?” Instead we have to ask, “Have I made a place where everyone has the safety to exist?” If you have created a place where a dominant group can embroil and embolden hate against another group, you have failed to create a safe place. The foundations of hateful speech (beyond the psychological trauma of it) lead to events like Christchurch.</p>
<p>We must protect safety over speech.</p>
<h2>The Domino Effect</h2>
<p>This week, <a href="https://www.engadget.com/2019/03/14/slack-removed-28-accounts-with-ties-to-hate-groups/" rel="noopener">Slack banned 28 hate groups</a>. What is most notable, to me, is that the groups did not break any parts of their Acceptable Use Policy. Slack issued a statement:</p>
<figure class="quote" id="figure3"><blockquote cite="https://slackhq.com/slack-statement-hate-groups">
<p>The use of Slack by hate groups runs counter to everything we believe in at Slack and is not welcome on our platform… Using Slack to encourage or incite hatred and violence against groups or individuals because of who they are is antithetical to our values and the very purpose of Slack.</p>
</blockquote>
</figure><p>That’s it.</p>
<p>It is not illegal for tech companies like Slack to ban groups from using their proprietary software because it is a private company that can regulate users if they do not align with their vision as a company. Think of it as the “no shoes, no socks, no service” model, but for tech.</p>
<p>Slack simply decided that supporting the workplace collaboration of Nazis around efficient ways to evangelize white supremacy was probably not in line with their company directives around inclusion. I imagine Slack also considered how their employees of color most ill-affected by white supremacy would feel working for a company that supported it, actively or not.</p>
<p>What makes the Slack example so notable is that they acted swiftly and on their own accord. Slack chose the safety of all their users over the speech of some.</p>
<p>When caught with their enablement of white supremacy, some companies will only budge under pressure from activist groups, users, and employees.</p>
<p><a href="https://www.cbsnews.com/news/paypal-suspends-dozens-of-racist-groups-sites-altright-com/" rel="noopener">PayPal finally banned hate groups after Charlottesville</a> and after Southern Poverty Law Center (SPLC) explicitly called them out for enabling hate. SPLC had identified this fact for three years prior. PayPal had ignored them for all three years.</p>
<p>Unfortunately, taking these “stances” against something as clearly and viscerally wrong as white supremacy is rare for companies to do. The tech industry tolerates this inaction through unspoken agreements.</p>
<p>If Facebook doesn’t do anything about racist political propaganda, <a href="https://www.vox.com/2018/12/13/18136253/pewdiepie-vs-tseries-links-to-white-supremacist-alt-right-redpill" rel="noopener">YouTube doesn’t do anything about PewDiePie</a>, and Twitter doesn’t do <a href="https://tech.co/news/amnesty-study-misogyny-racism-twitter-2018-12" rel="noopener">anything about disproportionate abuse against Black women</a>, it says to the smaller players in the industry that they don’t have to either.</p>
<p>The tech industry reacts to its peers. When there is disruption, as was the case with Airbnb, who <a href="https://slate.janrainsso.com//static/server.html?origin=http%3A%2F%2Fwww.slate.com%2Farticles%2Ftechnology%2Ftechnology%2F2017%2F08%2Fairbnb_s_ban_of_nazis_in_charlottesville_sets_an_important_standard_for.html" rel="noopener">screened and rejected any guests who they believed to be partaking in the Unite the Right Charlottesville rally</a>, companies follow suit. <a href="https://www.npr.org/sections/thetwo-way/2017/08/14/543360434/white-supremacist-site-is-banned-by-go-daddy-after-virginia-rally" rel="noopener">GoDaddy cancelled Daily Stormer’s domain registration</a> and Google did the same when they attempted migration.</p>
<p>If one company, like Slack or Airbnb, decides to do something about the role it’s going to play, it creates a perverse kind of FOMO for the rest: Fear of missing out of doing the right thing and standing on the right side of history.</p>
<h2>Don’t have FOMO, do something</h2>
<p>The type of activism at those companies all started with one individual. If you want to be part of the solution, I’ve gathered some places to start. The list is not exhaustive, and, as with all things, I recommend researching beyond this abridged summary.</p>
<ol type="1"><li><strong>Understand how white supremacy impacts you as an individual.</strong><br />
Now, if you are a person of color, queer, disabled, or trans, it’s likely that you know this very intimately.
<p>If you are not any of those things, then you, as a majority person, need to understand how white supremacy protects you and works in your favor. It’s not easy work, it is uncomfortable and unfamiliar, but you have the most powerful tools to fix tech. The resources are aplenty, but my favorite abridged list:</p>
<ol type="a"><li><a href="https://www.sceneonradio.org/seeing-white/" rel="noopener">Seeing White</a> podcast</li>
<li>Ijeoma Oluo’s <em>So you want to talk about race</em></li>
<li>Reni Eddo-Lodge’s <em>Why I’m no longer talking to white people about race</em> (Very key read for UK folks)</li>
<li>Robin DiAngelo’s <em>White Fragility</em></li>
</ol></li>
<li>
<p><strong>See where your company stands: Read and your company’s policies like accepted use and privacy policies and find your CEO’s stance on safety and free speech</strong><br />
While these policies are baseline (and in the Slack example, sort of irrelevant), it’s important to known your company’s track record. As an employee, your actions and decisions either uphold the ideologies behind the company or they don’t. Ask yourself if the company’s ideologies are worth upholding and whether they align with your own. Education will help you to flag if something contradicts those policies, or if the policies themselves allow for unethical activity.</p>
</li>
<li>
<p><strong>Examine everything you do critically on an ongoing basis.</strong><br />
You may feel your role is small or that your company is immune—maybe you are responsible for the maintenance of one small algorithm. But consider how that algorithm or similar ones can be exploited. Some key questions I ask myself:</p>
<ol type="a"><li>Who benefits from this? Who is harmed?</li>
<li>How could this be used for harm?</li>
<li>Who does this exclude? Who is missing?</li>
<li>What does this protect? For whom? Does it do so equitably?</li>
</ol></li>
<li>
<p><strong>See something? Say something.</strong><br />
If you believe that your company is creating something that is or can be used for harm, it is your responsibility to say something. Now, I’m not naïve to the fact that there is inherent risk in this. You might fear ostracization or termination. You need to protect yourself first. But you also need to do something.</p>
<ol type="a"><li>Find someone who you trust who might be at less risk. Maybe if you’re a nonbinary person of color, find a white cis man who is willing to speak up. Maybe if you’re a white man who is new to the company, find a white man who has more seniority or tenure. But also, consider how you have so much more relative privilege compared to most other people and that you might be the safest option.</li>
<li>Unionize. Find peers who might feel the same way and write a collective statement.</li>
<li>Get someone influential outside of the company (if knowledge is public) to say something.</li>
</ol></li>
<li>
<p><strong>Listen to concerns, no matter how small, particularly if they’re coming from the most endangered groups.</strong><br />
If your user or peer feels unsafe, you need to understand why. People often feel like small things can be overlooked, as their initial impact might be less, but it is in the smallest cracks that hate can grow. Allowing one insensitive comment about race is still allowing hate speech. If someone, particularly someone in a marginalized group, brings up a concern, you need to do your due diligence to listen to it and to understand its impact.</p>
</li>
</ol><p>I cannot emphasize this last point enough.</p>
<p>What I say today is not new. Versions of this article have been written before. Women of color like me have voiced similar concerns not only in writing, but in design reviews, in closed door meetings to key stakeholders, in Slack DMs. We’ve blown our whistles.</p>
<p>But here is the power of white supremacy.</p>
<p>White supremacy is so ingrained in every single aspect of how this nation was built, how our corporations function, and who is in control. If you are not convinced of this, you are not paying attention or intentionally ignoring the truth.</p>
<p>Queer, Muslim, disabled, trans women and nonbinary folks of color — the marginalized groups most impacted by this — are the ones who are voicing these concerns most voraciously. Speaking up requires us to enter the spotlight and outside of safety—we take a risk and are are not heard.</p>
<p>The silencing of our voices is one of many effective tools of white supremacy. Our silencing lives within every microaggression, each time we’re talked over, or not invited to partake in key decisions.</p>
<p>In tech, I feel I am a canary in a coal mine. I have sung my song to warn the miners of the toxicity. My sensitivity to it is heightened, because of my existence.</p>
<p>But the miners look at me and tell me that my lived experience is false. It does not align with their narrative as humans. They don’t understand why I sing.</p>
<p>If the people at the highest echelons of the tech industry—the white, male CEOs in power—fail to listen to its most marginalized people—the queer, disabled, trans, people of color—the fate of the canaries will too become the fate of the miners.</p>
<footer class="entry-footer nocontent"><h1>About the Author</h1>
<div class="byline author vcard"><a class="photo" href="https://alistapart.com/author/tatianamac"><img src="https://alistapart.com/d/_made/pix/authors/photos/tatiana_120_120_c1.jpg" alt="Image of Tatiana Mac" /></a>
<h2>
<a href="http://www.tatianamac.com/">Tatiana Mac</a> is an inclusive and accessible designer who works to represent our diverse communities. She believes effective design can dismantle exclusionary systems in favor and build community-focused, inclusionary ones instead. An insatiable traveller and a lover of languages, she's always planning her next trip.</h2></div>

</footer>]]></description>
      <link>http://alistapart.com/article/canary-in-a-coal-mine-how-tech-provides-platforms-for-hate</link>
      <guid>http://alistapart.com/article/canary-in-a-coal-mine-how-tech-provides-platforms-for-hate</guid>
      <pubDate>Tue, 19 Mar 2019 01:03:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[Semantics to Screen Readers]]></title>
      <description><![CDATA[<p>As a child of the ’90s, one of my favorite movie quotes is from <a href="https://www.imdb.com/title/tt0116493"><cite>Harriet the Spy</cite></a>: “there are as many ways to live as there are people in this world, and each one deserves a closer look.” Likewise, there as many ways to browse the web as there are people online. We each bring unique context to our web experience based on our values, technologies, environments,  minds, and bodies.</p>


<p><em>Assistive technologies</em> (ATs), which are hardware and software that help us perceive and interact with digital content, come in diverse forms. ATs can use a whole host of user input, ranging from clicks and keystrokes to minor muscle movements. ATs may also present digital content in a variety of forms, such as Braille displays, color-shifted views, and decluttered <em>user interfaces</em> (UIs).</p>
<p>One more commonly known type of AT is the screen reader. Programs such as JAWS, Narrator, NVDA, and VoiceOver can take digital content and present it to users through voice output, may display this output visually on the user’s screen, and can have Braille display and/or screen magnification capabilities built in.</p>
<p>If you make websites, you may have tested your sites with a screen reader. But how do these and other assistive programs actually access your content? What information do they use? We’ll take a detailed step-by-step view of how the process works.</p>
<p><em>(For simplicity we’ll continue to reference “browsers” and “screen readers” throughout this article. These are essentially shorthands for “browsers and other applications,” and “screen readers and other assistive technologies,” respectively.)</em></p>
<h2>The semantics-to-screen-readers pipeline</h2>
<p>Accessibility <em>application programming interfaces</em> (APIs) create a useful link between user applications and the assistive technologies that wish to interact with them. Accessibility APIs facilitate communicating accessibility information about user interfaces (UIs) to the ATs. The API expects information to be structured in a certain way, so that whether a button is properly marked up in web content or is sitting inside a native app taskbar, a button is a button is a button as far as ATs are concerned. That said, screen readers and other ATs can do some app-specific handling if they wish.</p>
<p>On the web specifically, there are some browser and screen reader combinations where accessibility API information is supplemented by access to DOM structures. For this article, we’ll focus specifically on accessibility APIs as a link between web content and the screen reader.</p>
<p>Here’s the breakdown of how web content reaches screen readers via accessibility APIs:</p>
<p>The <strong>web developer</strong> uses host language markup (HTML, SVG, etc.), and potentially roles, states, and properties from the <a href="https://rawgit.com/w3c/aria/master/">ARIA suite</a> where needed to provide the semantics of their content. Semantic markup communicates what type an element is, what content it contains, what state it’s in, etc.</p>
<p>The <strong>browser rendering engine</strong> (alternatively referred to as a “user agent”) takes this information and maps it into an accessibility API. Different accessibility APIs are available on different operating systems, so a browser that is available on multiple platforms should support multiple accessibility APIs. Accessibility API mappings are maintained on a lower level than web platform APIs, so web developers don’t directly interact with accessibility APIs.</p>
<p>The <strong>accessibility API</strong> includes a collection of <a href="https://en.wikipedia.org/wiki/Interface_(computing)">interfaces</a> that browsers and other apps can plumb into, and generally acts as an intermediary between the browser and the screen reader. Accessibility APIs provide interfaces for representing the structure, relationships, semantics, and state of digital content, as well as means to surface dynamic changes to said content. Accessibility APIs also allow screen readers to retrieve and interact with content via the API.</p>
<p>Again, web developers don’t interact with these APIs directly; the rendering engine handles translating web content into information useful to accessibility APIs.</p>
<h3>Examples of accessibility APIs</h3>
<ul><li><strong>Windows:</strong> <a href="https://docs.microsoft.com/en-us/windows/desktop/WinAuto/microsoft-active-accessibility">Microsoft Active Accessibility</a> (MSAA), extended with another API called <a href="https://wiki.linuxfoundation.org/accessibility/iaccessible2/start">IAccessible2</a> (IA2)</li>
<li><strong>Windows:</strong> <a href="https://docs.microsoft.com/en-us/windows/desktop/WinAuto/entry-uiauto-win32">UI Automation</a> (UIA), the Microsoft successor to MSAA. A browser on Windows can choose to support MSAA with IA2, UIA, or both.</li>
<li><strong>MacOS:</strong> <a href="https://developer.apple.com/documentation/appkit/nsaccessibility">NSAccessibility</a> (AXAPI)</li>
<li><strong>Linux/Gnome:</strong> <a href="https://developer.gnome.org/atk/stable/">Accessibility Toolkit</a> (ATK) and <a href="https://developer.gnome.org/libatspi/stable/">Assistive Technology Service Provider Interface</a> (AT-SPI). This case is a little different in that there are actually two separate APIs: one through which browsers and other applications pass information along to (ATK) and one that ATs then call from (AT-SPI).</li>
</ul><p>The <strong>screen reader</strong> uses client-side methods from these accessibility APIs to retrieve and handle information exposed by the browser. In browsers where direct access to the Document Object Model (DOM) is permitted, some screen readers may also take additional information from the DOM tree. A screen reader can also interact with apps that use differing accessibility APIs.</p>
<p>No matter where they get their information, screen readers can dream up any interaction modes they want to provide to their users (I’ve provided links to screen reader commands at the end of this article). Testing by site creators can help identify content that feels awkward in a particular navigation mode, such as multiple links with the same text (“Learn more”), as one example.</p>
<h3>Example of this pipeline: surfacing a button element to screen reader users</h3>
<p>Let’s suppose for a moment that a screen reader wants to understand what object is next in the accessibility tree (which I’ll explain further in the next section), so it can surface that object to the user as they navigate to it. The flow will go a little something like this:</p>
<figure><img src="https://alistapart.com/d/semantics-to-screen-readers/fig1.png" alt="Diagram showing the client (screen reader) making a call to the accessibility API, which passes along the request to the provider (browser), which checks the content in the web document, which sends the information back up the chain" /><figcaption>Diagram illustrating the steps involved in presenting the next object in a document; detailed list follows</figcaption></figure><ol><li>The screen reader requests information from the API about the next accessible object, relative to the current object.</li>
<li>The API (as an intermediary) passes along this request to the browser.</li>
<li>At some point, the browser references DOM and style information, and discovers that the relevant element is a non-hidden button: <code>&lt;button&gt;Do a thing&lt;/button&gt;</code>.</li>
<li>The browser maps this HTML button into the format the API expects, such as an accessible object with various properties: <strong>Name:</strong> Do a thing, <strong>Role:</strong> Button.</li>
<li>The API returns this information from the browser to the screen reader.</li>
<li>The screen reader can then surface this object to the user, perhaps stating “Button, Do a thing.”</li>
</ol><p>Suppose that the screen reader user would now like to “click” this button. Here’s how their action flows all the way back to web content:</p>
<figure><img src="https://alistapart.com/d/semantics-to-screen-readers/fig2.png" alt="Diagram showing a user using a 'primary action' command to a client (screen reader), which passes the command to the accessibility API, which passes the command along to the provider (browser), which passes the command as a click event to the web document" /><figcaption>Diagram illustrating the steps involved in routing a screen reader click to web content; detailed list follows</figcaption></figure><ol><li>The user provides a particular screen reader command, such as a keystroke or gesture.</li>
<li>The screen reader calls a method into the API to invoke the button.</li>
<li>The API forwards this interaction to the browser.</li>
<li>How a browser may respond to incoming interactions depends on the context, but in this case the browser can raise this as a “click” event through web APIs. The browser should give no indication that the click came from an assistive technology, as doing so would violate the user’s right to privacy.</li>
<li>The web developer has registered a JavaScript event listener for clicks; their callback function is now executed as if the user clicked with a mouse.</li>
</ol><p>Now that we have a general sense of the pipeline, let’s go into a little more detail on the accessibility tree.</p>
<h2>The accessibility tree</h2>
<figure><img src="https://alistapart.com/d/semantics-to-screen-readers/fig3.png" alt="Screenshot showing the accessibility tools in Microsoft Edge" /><figcaption>Dev Tools in Microsoft Edge showing the DOM tree and accessibility tree side by side; there are more nodes in the DOM tree</figcaption></figure><p>The <em>accessibility tree</em> is a hierarchical representation of elements in a UI or document, as computed for an accessibility API. In modern browsers, the accessibility tree for a given document is a separate, parallel structure to the DOM tree. “Parallel” does not necessarily mean there is a 1:1 match between the nodes of these two trees. Some elements may be excluded from the accessibility tree, for example if they are hidden or are not semantically useful (think non-focusable wrapper <code>div</code>s without any semantics added by a web developer).</p>
<p>This idea of a hierarchical structure is somewhat of an abstraction. The definition of what exactly an accessibility tree is in practice has been debated and partially defined in multiple places, so implementations may differ in various ways.</p>
<p>For example, it’s not actually necessary to generate accessible objects for every element in the DOM whenever the DOM tree is constructed. As a performance consideration, a browser could choose to deal with only a subset of objects and their relationships at a time—that is, however much is necessary to fulfill the requests coming from ATs. The rendering engine could make these computations during all user sessions, or only do so when assistive technologies are actively running.</p>
<p>Generally speaking, modern web browsers wait until after style computation to build up any accessible objects. Browsers wait in part because generated content (such as <code>::before</code> and <code>::after</code>) ƒcan contain text that can participate in calculation of the accessible object’s name. CSS styles can also impact accessible objects in other various ways: text styling can come through as attributes on accessible text ranges. Display property values can impact the computation of line text ranges. These are just a few ways in which style can impact accessibility semantics.</p>
<p>Browsers may also use different structures as the basis for accessible object computation. One rendering engine may walk the DOM tree and cross-reference style computations to build up parallel tree structures; another engine may use only the nodes that are available in a style tree in order to build up their accessibility tree.</p>
<p>User agent participants in the standards community are currently thinking through how we can better document our implementation details, and whether it might make sense to standardize more of these details further down the road.</p>
<p>Let’s now focus on the branches of this tree, and explore how individual accessibility objects are computed.</p>
<h3>Building up accessible objects</h3>
<p>From API to API, an accessible object will generally include a few things:</p>
<ul><li><strong>Role</strong>, or the type of accessible object (for example, Button). The role tells a user how they can expect to interact with the control. It is typically presented when screen reader focus moves onto the accessible object, and it can be used to provide various other functionalities, such as skipping around content via one type of object.</li>
<li><strong>Name</strong>, if specified. The name is an (ideally short) identifier that better helps the user identify and understand the purpose of an accessible object. The name is often presented when screen focus moves to the object (more on this later), can be used as an identifier when presenting a list of available objects, and can be used as a hook for functionalities such as voice commands.</li>
<li><strong>Description and/or help text</strong>, if specified. We’ll use “Description” as a shorthand. The Description can be considered supplemental to the Name; it’s not the main identifier but can provide further information about the accessible object. Sometimes this is presented when moving focus to the accessible object, sometimes not; this variation depends on both the screen reader’s user experience design and the user’s chosen verbosity settings.</li>
<li><strong>Properties and methods surfacing additional semantics.</strong> For simplicity’s sake, we won’t go through all of these. For your awareness, properties can include details like layout information or available interactions (such as invoking the element or modifying its value).</li>
</ul><p>Let’s walk through an example using markup for a simple mood tracker. We’ll use simplified property names and values, because these can differ between accessibility APIs.</p>
<figure><img src="https://alistapart.com/d/semantics-to-screen-readers/fig4.png" alt="" /></figure><pre><code class="language-javascript">&lt;form&gt;
  &lt;label for="mood"&gt;On a scale of 1–10, what is your mood today?&lt;/label&gt;
  &lt;input id="mood" type="range"
       min="1" max="10" value="5"
       aria-describedby="helperText" /&gt;
  &lt;p id="helperText"&gt;Some helpful pointers about how to rate your mood.&lt;/p&gt;
  &lt;!-- Using a div with button role for the purposes of showing how the accessibility tree is created. Please use the button element! --&gt;
  &lt;div tabindex="0" role="button"&gt;Log Mood&lt;/div&gt;
&lt;/form&gt;</code></pre>
<p>First up is our <code>form</code> element. This form doesn’t have any attributes that would give it an accessible Name, and a form landmark without a Name isn’t very useful when jumping between landmarks. Therefore, <a href="https://www.w3.org/TR/html-aam-1.0/#html-element-role-mappings">HTML mapping standards</a> specify that it should be mapped as a group.</p>
<p>Here’s the beginning of our tree:</p>
<ul><li><strong>Role:</strong> Group</li>
</ul><p>Next up is the <code>label</code>. This one doesn’t have an accessible Name either, so we’ll just nest it as an object of role “Label” underneath the form:</p>
<ul><li><strong>Role:</strong> Group
<ul><li><strong>Role:</strong> Label</li>
</ul></li>
</ul><p>Let’s add the range <code>input</code>, which will map into various APIs as a “Slider.” Due to the relationship created by the <code>for</code> attribute on the <code>label</code> and <code>id</code> attribute on the <code>input</code>, this slider will take its Name from the label contents. The <code>aria-describedby</code> attribute is another id reference and points to a paragraph with some text content, which will be used for the slider’s Description. The slider object’s properties will also store “labelledby” and “describedby” relationships pointing to these other elements. And it will specify the current, minimum, and maximum values of the slider. If one of these range values were not available, <a href="https://www.w3.org/TR/wai-aria-1.2/#slider">ARIA standards specify what should be the default value</a>. Our updated tree:</p>
<ul><li><strong>Role:</strong> Group
<ul><li><strong>Role:</strong> Label</li>
<li><strong>Role:</strong> Slider<br /><strong>Name:</strong> On a scale of 1–10, what is your mood today?<br /><strong>Description:</strong> Some helpful pointers about how to rate your mood.<br /><strong>LabelledBy:</strong> mood<br /><strong>DescribedBy:</strong> helperText<br /><strong>ValueNow:</strong> 5<br /><strong>ValueMin:</strong> 1<br /><strong>ValueMax:</strong> 10</li>
</ul></li>
</ul><p>The paragraph will be added as a simple paragraph object (“Text” or “Group” in some APIs):</p>
<ul><li><strong>Role:</strong> Group
<ul><li><strong>Role:</strong> Label</li>
<li><strong>Role:</strong> Slider<br /><strong>Name:</strong> On a scale of 1–10, what is your mood today?<br /><strong>Description:</strong> Some helpful pointers about how to rate your mood.<br /><strong>LabelledBy:</strong> mood<br /><strong>DescribedBy:</strong> helperText<br /><strong>ValueNow:</strong> 5<br /><strong>ValueMin:</strong> 1<br /><strong>ValueMax:</strong> 10</li>
<li><strong>Role:</strong> Paragraph</li>
</ul></li>
</ul><p>The final element is an example of when role semantics are added via the ARIA <code>role</code> attribute. This <code>div</code> will map as a Button with the name “Log Mood,” as buttons can take their name from their children. This button will also be surfaced as “invokable” to screen readers and other ATs; special types of buttons could provide expand/collapse functionality (buttons with the <code>aria-expanded</code> attribute), or toggle functionality (buttons with the <code>aria-pressed</code> attribute). Here’s our tree now:</p>
<ul><li><strong>Role:</strong> Group
<ul><li><strong>Role:</strong> Label</li>
<li><strong>Role:</strong> Slider<br /><strong>Name:</strong> On a scale of 1–10, what is your mood today?<br /><strong>Description:</strong> Some helpful pointers about how to rate your mood.<br /><strong>LabelledBy:</strong> mood<br /><strong>DescribedBy:</strong> helperText<br /><strong>ValueNow:</strong> 5<br /><strong>ValueMin:</strong> 1<br /><strong>ValueMax:</strong> 10</li>
<li><strong>Role:</strong> Paragraph</li>
<li><strong>Role:</strong> Button<br /><strong>Name:</strong> Log Mood</li>
</ul></li>
</ul><h3>On choosing host language semantics</h3>
<p>Our sample markup mentions that it is preferred to use the HTML-native <code>button</code> element rather than a <code>div</code> with a <code>role</code> of “button.” Our buttonified <code>div</code> can be operated as a button via accessibility APIs, as the ARIA attribute is doing what it should—conveying semantics. But there’s a lot you can get for free when you choose native elements. In the case of <code>button</code>, that includes focus handling, user input handling, form submission, and basic styling.</p>
<p>Aaron Gustafson has what he refers to as an <a href="https://www.smashingmagazine.com/2016/05/developing-dependency-awareness/">“exhaustive treatise” on buttons</a> in particular, but generally speaking it’s great to let the web platform do the heavy lifting of semantics and interaction for us when we can.</p>
<p>ARIA roles, states, and properties are still a great tool to have in your toolbelt. Some good use cases for these are</p>
<ul><li>providing further semantics and relationships that are not naturally expressed in the host language;</li>
<li>supplementing semantics in markup we perhaps don’t have complete control over;</li>
<li>patching potential cross-browser inconsistencies;</li>
<li>and making custom elements perceivable and operable to users of assistive technologies.</li>
</ul><h3>Notes on inclusion or exclusion in the tree</h3>
<p>Standards define some rules around when user agents should exclude elements from the accessibility tree. Excluded elements can include those hidden by CSS, or the <code>aria-hidden</code> or <code>hidden</code> attributes; their children would be excluded as well. Children of particular roles (like <code>checkbox</code>) can also be excluded from the tree, unless they meet special exceptions. The full rules can be found in the <a href="https://www.w3.org/TR/wai-aria-1.2/#accessibility_tree">“Accessibility Tree” section of the ARIA specification</a>. That being said, there are still some differences between implementers, some of which include more <code>div</code>s and <code>span</code>s in the tree than others do.</p>
<h3>Notes on name and description computation</h3>
<p>How names and descriptions are computed can be a bit confusing. Some elements have special rules, and some ARIA roles allow name computation from the element’s contents, whereas others do not. Name and description computation could probably be its own article, so we won’t get into all the details here (refer to “Further reading and resources” for some links). Some short pointers:</p>
<ul><li><code>aria-label</code>, <code>aria-labelledby</code>, and <code>aria-describedby</code> take precedence over other means of calculating name and description.</li>
<li>If you expect a particular HTML attribute to be used for the name, check the <a href="https://w3c.github.io/html-aam/#accessible-name-and-description-computation">name computation rules for HTML elements</a>. In your scenario, it may be used for the full description instead.</li>
<li>Generated content (<code>::before</code> and <code>::after</code>) can participate in the accessible name when said name is taken from the element’s contents. That being said, <a href="https://www.w3.org/WAI/WCAG21/Techniques/failures/F87">web developers should not rely on pseudo-elements for non-decorative content</a>, as this content could be lost when a stylesheet fails to load or user styles are applied to the page.</li>
</ul><p>When in doubt, reach out to the community! Tag questions on social media with “#accessibility.” “#a11y” is a common shorthand; the “11” stands for “11 middle letters in the word ‘accessibility.’” If you find an inconsistency in a particular browser, file a bug! Bug tracker links are provided in “Further reading and resources.”</p>
<h2>Not just accessible objects</h2>
<p>Besides a hierarchical structure of objects, accessibility APIs also offer interfaces that allow ATs to interact with text. ATs can retrieve content text ranges, text selections, and a variety of text attributes that they can build experiences on top of. For example, if someone writes an email and uses color alone to highlight their added comments, the person reading the email could increase the verbosity of speech output in their screen reader to know when they’re encountering phrases with that styling. However, it would be better for the email author to include very brief text labels in this scenario.</p>
<p>The big takeaway here for web developers is to keep in mind that the accessible name of an element may not always be surfaced in every <a href="https://tink.uk/understanding-screen-reader-interaction-modes/">navigation mode</a> in every screen reader. So if your <code>aria-label</code> text isn’t being read out in a particular mode, the screen reader may be primarily using text interfaces and only conditionally stopping on objects. It may be worth your while to consider using text content—even if <a href="https://a11yproject.com/posts/how-to-hide-content/">visually hidden</a>—instead of text via an ARIA attribute. <a href="https://developer.paciellogroup.com/blog/2017/07/short-note-on-aria-label-aria-labelledby-and-aria-describedby/">Read more thoughts on <code>aria-label</code> and <code>aria-labelledby</code>.</a></p>
<h2>Accessibility API events</h2>
<p>It is the responsibility of browsers to surface changes to content, structure, and user input. Browsers do this by sending the accessibility API notifications about various events, which screen readers can subscribe to; again, for performance reasons, browsers could choose to send notifications only when ATs are active.</p>
<p>Let’s suppose that a screen reader wants to surface changes to a live region (an element with <code>role="alert"</code> or <code>aria-live</code>):</p>
<figure><img src="https://alistapart.com/d/semantics-to-screen-readers/fig5.png" alt="Diagram showing a client (screen reader), which is already subscribed to live region events and can request more info about the live region, which receives a notification from the accessibility API, which gets a notification that a live region has changed from the provider (browser), which has a live region changed by the web document" /><figcaption>Diagram illustrating the steps involved in announcing a live region via a screen reader; detailed list follows</figcaption></figure><ol><li>The screen reader subscribes to event notifications; it could subscribe to notifications of all types, or just certain types as categorized by the accessibility API. Let’s assume in our example that the screen reader is at least listening to live region change events.</li>
<li>In the web content, the web developer changes the text content of a live region.</li>
<li>The browser (provider) recognizes this as a live region change event, and sends the accessibility API a notification.</li>
<li>The API passes this notification along to the screen reader.</li>
<li>The screen reader can then use metadata from the notification to look up the relevant accessible objects via the accessibility API, and can surface the changes to the user.</li>
</ol><p>ATs aren’t required to do anything with the information they retrieve. This can make it a bit trickier as a web developer to figure out why a screen reader isn’t announcing a change: it may be that notifications aren’t being raised (for example, because a browser is not sending notifications for a live region dynamically inserted into web content), or the AT is not subscribed or responding to that type of event.</p>
<h2>Testing with screen readers and dev tools</h2>
<p>While conformance checkers can help catch some basic accessibility issues, it’s ideal to walk through your content manually using a variety of contexts, such as</p>
<ul><li>using a keyboard only;</li>
<li>with various OS accessibility settings turned on;</li>
<li>and at different zoom levels and text sizes, and so on.</li>
</ul><p>As you do this, keep in mind the <a href="https://www.w3.org/TR/WCAG21/"><cite>Web Content Accessibility Guidelines (WCAG 2.1)</cite></a>, which give general guidelines around expectations for inclusive web content. If you can test with users after your own manual test passes, all the better!</p>
<p>Robust accessibility testing could probably be its own series of articles. In this one, we’ll go over some tips for testing with screen readers, and catching accessibility errors as they are mapped into the accessibility API in a more general sense.</p>
<h3>Screen reader testing</h3>
<p>Screen readers exist in many forms: some are pre-installed on the operating system and others are separate applications that in some cases are free to download. The <a href="https://webaim.org/projects/screenreadersurvey7/">WebAIM screen reader user survey</a> provides a list of commonly used screen reader and browser combinations among survey participants. The “Further reading and resources” section at the end of this article includes full screen reader user docs, and Deque University has a great set of <a href="https://dequeuniversity.com/resources/">screen reader command cheat sheets</a> that you can refer to. Some actions you might take to test your content:</p>
<ul><li>Read the next/previous item.</li>
<li>Read the next/previous line.</li>
<li>Read continuously from a particular point.</li>
<li>Jump by headings, landmarks, and links.</li>
<li>Tab around focusable elements only.</li>
<li>Get a summary of all elements of a particular type within the page.</li>
<li>Search the page for specific content.</li>
<li>Use table-specific commands to interact with your tables.</li>
<li>Jump around by form field; are field instructions discoverable in this navigational mode?</li>
<li>Use keyboard commands to interact with all interactive elements. Are your JavaScript-driven interactions still operable with screen readers (which can intercept key input in certain modes)? <a href="https://www.w3.org/TR/wai-aria-practices/#aria_ex"><cite>WAI-ARIA Authoring Practices 1.1</cite></a> includes notes on expected keyboard interactions for various widgets.</li>
<li>Try out anything that creates a content change or results in navigating elsewhere. Would it be obvious, via screen reader output, that a change occurred?</li>
</ul><h3>Tracking down the source of unexpected behavior</h3>
<p>If a screen reader does not announce something as you’d expect, here are a few different checks you can run:</p>
<ul><li><strong>Does this reproduce with the same screen reader in multiple browsers on this OS?</strong> It may be an issue with the screen reader or your expectation may not match the screen reader’s user experience design. For example, a screen reader may choose to not expose the accessible name of a static, non-interactive element. Checking the user docs or filing a screen reader issue with a simple test case would be a great place to start.</li>
<li><strong>Does this reproduce with multiple screen readers in the same browser, but not in other browsers on this OS?</strong> The browser in question may have an issue, there may be compatibility differences between browsers (such as a browser doing extra helpful but non-standard computations), or a screen reader’s support for a specific accessibility API may vary. Filing a browser issue with a simple test case would be a great place to start; if it’s not a browser bug, the developer can route it to the right place or make a code suggestion.</li>
<li><strong>Does this reproduce with multiple screen readers in multiple browsers?</strong> There may be something you can adjust in your code, or your expectations may differ from standards and common practices.</li>
<li><strong>How does this element’s accessibility properties and structure show up in browser dev tools?</strong></li>
</ul><h3>Inspecting accessibility trees and properties in dev tools</h3>
<p>Major modern browsers provide dev tools to help you observe the structure of the accessibility tree as well as a given element’s accessibility properties. By observing which accessible objects are generated for your elements and which properties are exposed on a given element, you may be able to pinpoint issues that are occurring either in front-end code or in how the browser is mapping your content into the accessibility API.</p>
<p>Let’s suppose that we are testing this piece of code in Microsoft Edge with a screen reader:</p>
<pre><code class="language-markup">&lt;div class="form-row"&gt;
  &lt;label&gt;Favorite color&lt;/label&gt;
  &lt;input id="myTextInput" type="text" /&gt;
&lt;/div&gt;</code></pre>
<p>We’re navigating the page by form field, and when we land on this text field, the screen reader just tells us this is an “edit” control—it doesn’t mention a name for this element. Let’s check the tools for the element’s accessible name.</p>
<p><strong>1. Inspect the element to bring up the dev tools.</strong></p>
<figure><img src="https://alistapart.com/d/semantics-to-screen-readers/fig6.png" alt="Screenshot showing the Microsoft Edge dev tools inspecting an input element" /><figcaption>The Microsoft Edge dev tools, with an input element highlighted in the DOM tree</figcaption></figure><p><strong>2. Bring up the accessibility tree for this page by clicking the accessibility tree button (a circle with two arrows) or pressing Ctrl+Shift+A (Windows).</strong></p>
<figure><img src="https://alistapart.com/d/semantics-to-screen-readers/fig7.png" alt="Screenshot showing the Microsoft Edge tools inspecting an input element with the Accessibility Tree panel open" /><figcaption>The accessibility tree button activated in the Microsoft Edge dev tools</figcaption></figure><p>Reviewing the accessibility tree is an extra step for this particular flow but can be helpful to do.</p>
<p>When the Accessibility Tree pane comes up, we notice there’s a tree node that just says “textbox:,” with nothing after the colon. That suggests there’s not a name for this element. (Also notice that the <code>div</code> around our form input didn’t make it into the accessibility tree; it was not semantically useful).</p>
<p><strong>3. Open the Accessibility Properties pane, which is a sibling of the Styles pane.</strong> If we scroll down to the Name property—aha! It’s blank. No name is provided to the accessibility API. (Side note: some other accessibility properties are filtered out of this list by default; toggle the filter button—which looks like a funnel—in the pane to get the full list).</p>
<figure><img src="https://alistapart.com/d/semantics-to-screen-readers/fig8.png" alt="Screenshot showing the Microsoft Edge tools inspecting an input element with the Accessibility Tree panel open" /><figcaption>The Accessibility Properties pane open in Microsoft Edge dev tools, in the same area as the Styles pane</figcaption></figure><p><strong>4. Check the code.</strong> We realize that we didn’t associate the <code>label</code> with the text field; that is one strategy for providing an <a href="https://w3c.github.io/html-aam/#input-type-text-input-type-password-input-type-search-input-type-tel-input-type-url-and-textarea-element">accessible name for a text input</a>. We add <code>for="myTextInput"</code> to the label:</p>
<pre><code class="language-markup">&lt;div class="form-row"&gt;
  &lt;label for="myTextInput"&gt;Favorite color&lt;/label&gt;
  &lt;input id="myTextInput" type="text" /&gt;
&lt;/div&gt;</code></pre>
<p>And now the field has a name:</p>
<figure><img src="https://alistapart.com/d/semantics-to-screen-readers/fig9.png" alt="Screenshot showing the Microsoft Edge tools inspecting an input element with the Accessibility Tree panel open, where the input's Name attribute now has a value" /><figcaption>The accessible Name property set to the value of “Favorite color” inside Microsoft Edge dev tools</figcaption></figure><p>In another use case, we have a breadcrumb component, where the current page link is marked with <code>aria-current="page"</code>:</p>
<pre><code class="language-markup">&lt;nav class="breadcrumb" aria-label="Breadcrumb"&gt;
  &lt;ol&gt;
    &lt;li&gt;
      &lt;a href="/cat/"&gt;Category&lt;/a&gt;
    &lt;/li&gt;
    &lt;li&gt;
      &lt;a href="/cat/sub/"&gt;Sub-Category&lt;/a&gt;
    &lt;/li&gt;
    &lt;li&gt;
      &lt;a aria-current="page" href="/cat/sub/page/"&gt;Page&lt;/a&gt;
    &lt;/li&gt;
  &lt;/ol&gt;
&lt;/nav&gt;</code></pre>
<p>When navigating onto the current page link, however, we don’t get any indication that this is the current page. We’re not exactly sure how this maps into accessibility properties, so we can reference a specification like <cite>Core Accessibility API Mappings 1.2</cite> (Core-AAM). Under the “<a href="https://w3c.github.io/core-aam/#mapping_state-property">State and Property Mapping</a>” table, we find mappings for “<code>aria-current</code> with non-<code>false</code> allowed value.” We can check for these listed properties in the Accessibility Properties pane. Microsoft Edge, at the time of writing, maps into UIA (UI Automation), so when we check AriaProperties, we find that yes, “current=page” is included within this property value.</p>
<figure><img src="https://alistapart.com/d/semantics-to-screen-readers/fig10.png" alt="Screenshot showing the Microsoft Edge tools inspecting an input element with the Accessibility Tree panel open, where the input's AriaProperties attribute now has a value of current=page" /><figcaption>The accessible Name property set to the value of “Favorite color” inside Microsoft Edge dev tools</figcaption></figure><p>Now we know that the value is presented correctly to the accessibility API, but the particular screen reader is not using the information.</p>
<p>As a side note, Microsoft Edge’s current dev tools expose these accessibility API properties quite literally. Other browsers’ dev tools may simplify property names and values to make them easier to read, particularly if they support more than one accessibility API. The important bit is to find if there’s a property with roughly the name you expect and whether its value is what you expect. You can also use this method of checking through the property names and values if mapping specs, like Core-AAM, are a bit intimidating!</p>
<h3>Advanced accessibility tools</h3>
<p>While browser dev tools can tell us a lot about the accessibility semantics of our markup, they don’t generally include representations of text ranges or event notifications. On Windows, the <a href="https://developer.microsoft.com/en-us/windows/downloads/windows-10-sdk">Windows SDK</a> includes advanced tools that can help debug these parts of MSAA or UIA mappings: <a href="https://docs.microsoft.com/en-us/windows/desktop/winauto/inspect-objects">Inspect</a> and <a href="https://docs.microsoft.com/en-us/windows/desktop/winauto/accessible-event-watcher">AccEvent</a> (Accessible Event Watcher). Using these tools presumes knowledge of the Windows accessibility APIs, so if this is too granular for you and you’re stuck on an issue, please reach out to the relevant browser team!</p>
<p>There is also an Accessibility Inspector in Xcode on MacOS, with which you can inspect web content in Safari. This tool can be accessed by going to <strong>Xcode &gt; Open Developer Tool &gt; Accessibility Inspector</strong>.</p>
<h2>Diversity of experience</h2>
<p>Equipped with an accessibility tree, detailed object information, event notifications, and methods for interacting with accessible objects, screen readers can craft a browsing experience tailored to their audiences. In this article, we’ve used the term “screen readers” as a proxy for a whole host of tools that may use accessibility APIs to provide the best user experience possible. Assistive technologies can use the APIs to augment presentation or support varying types of user input. Examples of other ATs include screen magnifiers, cognitive support tools, speech command programs, and some brilliant new app that hasn’t been dreamed up yet. Further, assistive technologies of the same “type” may differ in how they present information, and users who share the same tool may further adjust settings to their liking.</p>
<p>As web developers, we don’t necessarily need to make sure that each instance surfaces information identically, because each user’s preferences will not be exactly the same. Our aim is to ensure that no matter how a user chooses to explore our sites, content is <a href="https://www.w3.org/TR/UNDERSTANDING-WCAG20/intro.html#introduction-fourprincs-head">perceivable, operable, understandable, and robust</a>. By testing with a variety of assistive technologies—including but not limited to screen readers—we can help create a better web for all the many people who use it.</p>
<h2>Further reading and resources</h2>
<ul><li><a href="https://webaim.org/projects/lowvisionsurvey2/">WebAIM “Survey of Users with Low Vision”</a></li>
<li><a href="https://webaim.org/projects/screenreadersurvey7/">WebAIM “Screen Reader User Survey”</a></li>
<li>W3C developer guides
<ul><li><a href="https://www.w3.org/WAI/roles/">W3C Web Accessibility Initiative (WAI) resources</a></li>
<li><a href="https://www.w3.org/TR/WCAG21/"><cite>Web Content Accessibility Guidelines (WCAG) 2.1</cite></a></li>
<li><a href="https://www.w3.org/TR/wai-aria-practices-1.1/"><cite>WAI-ARIA Authoring Practices 1.1</cite></a></li>
<li><a href="https://www.w3.org/TR/html-aria/"><cite>ARIA in HTML</cite></a></li>
<li><a href="https://www.w3.org/TR/using-aria/"><cite>Using ARIA</cite></a></li>
</ul></li>
<li>
<p>W3C specifications: The docs below are known as “AAMs.” They detail how content maps into various accessibility APIs and may be less relevant to web developers’ day-to-day work. However, some have notes on how specific elements’ names and descriptions are meant to be calculated:</p>
<ul><li><a href="https://alistapart.com/article/semantics-to-screen-readers"><cite>Core Accessibility API Mappings 1.1</cite></a></li>
<li><a href="https://alistapart.com/article/semantics-to-screen-readers"><cite>Graphics Accessibility API Mappings</cite></a></li>
<li><a href="https://alistapart.com/article/semantics-to-screen-readers"><cite>HTML Accessibility API Mappings 1.0</cite></a></li>
<li><a href="https://alistapart.com/article/semantics-to-screen-readers"><cite>SVG Accessibility API Mappings</cite></a></li>
</ul></li>
<li><a href="https://inclusive-components.design/"><cite>Inclusive Components</cite></a></li>
<li>
<p><a href="https://alistapart.com/topic/accessibility"><cite>A List Apart</cite> articles on accessibility</a></p>
<ul><li><a href="https://alistapart.com/article/conversational-semantics">“Conversational Semantics”</a></li>
<li><a href="https://alistapart.com/column/wai-finding-with-aria-landmark-roles">“WAI-finding with ARIA Landmark Roles”</a></li>
</ul></li>
<li><a href="https://www.smashingmagazine.com/2018/09/importance-manual-accessibility-testing/">“The Importance of Manual Accessibility Testing”</a></li>
<li><a href="https://dequeuniversity.com/resources/">Deque University screen reader shortcuts references</a></li>
<li>
<p>Screen reader user docs (commands)</p>
<ul><li><a href="https://www.freedomscientific.com/products/blindness/jawsdocumentation">JAWS user docs</a></li>
<li><a href="https://support.microsoft.com/en-us/help/22798/windows-10-complete-guide-to-narrator">Narrator user docs</a></li>
<li><a href="https://www.nvaccess.org/files/nvda/documentation/userGuide.html">NVDA user docs</a></li>
<li><a href="https://help.apple.com/voiceover/mac/10.14/">VoiceOver user docs (VoiceOver command charts)</a></li>
<li><a href="https://help.apple.com/iphone/10/#/iph3e2e415f">iOS VoiceOver user docs</a></li>
</ul></li>
<li>
<p>Browser rendering engine bug trackers</p>
<ul><li><a href="https://bugs.chromium.org/p/chromium/issues/list">Chrome</a></li>
<li><a href="https://bugzilla.mozilla.org/describecomponents.cgi?product=Core">Firefox</a></li>
<li><a href="http://issues.microsoftedge.com/">Microsoft Edge</a></li>
<li><a href="https://bugs.webkit.org/query.cgi?format=specific&amp;product=WebKit">Safari</a></li>
</ul></li>
</ul><footer class="entry-footer nocontent"><h1>About the Author</h1>
<div class="byline author vcard"><a class="photo" href="https://alistapart.com/author/melanie-richards"><img src="https://alistapart.com/d/_made/pix/authors/photos/melanie-richards_120_120_c1.jpg" alt="Image of Melanie Richards" /></a>
<h2>
<a href="https://melanie-richards.com/">Melanie Richards</a> is a web designer / front-end developer currently helping to shape the web platform as a Program Manager on the Microsoft Edge team. She is a member of the CSS and ARIA Working Groups at the W3C. In her spare time, Melanie hikes, weaves, and schemes on how to bring more art back to the internet.</h2></div>

</footer>]]></description>
      <link>http://alistapart.com/article/semantics-to-screen-readers</link>
      <guid>http://alistapart.com/article/semantics-to-screen-readers</guid>
      <pubDate>Thu, 28 Feb 2019 01:02:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[<![CDATA[ Semantics to Screen Readers ]]]]><![CDATA[>]]></title>
      <description><![CDATA[<div class="entry-content">
<p>As a child of the ’90s, one of my favorite movie quotes is from <a href="https://www.imdb.com/title/tt0116493"><cite>Harriet the Spy</cite></a>: “there are as many ways to live as there are people in this world, and each one deserves a closer look.” Likewise, there as many ways to browse the web as there are people online. We each bring unique context to our web experience based on our values, technologies, environments, minds, and bodies.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p><em>Assistive technologies</em> (ATs), which are hardware and software that help us perceive and interact with digital content, come in diverse forms. ATs can use a whole host of user input, ranging from clicks and keystrokes to minor muscle movements. ATs may also present digital content in a variety of forms, such as Braille displays, color-shifted views, and decluttered <em>user interfaces</em> (UIs).</p>
<p>One more commonly known type of AT is the screen reader. Programs such as JAWS, Narrator, NVDA, and VoiceOver can take digital content and present it to users through voice output, may display this output visually on the user’s screen, and can have Braille display and/or screen magnification capabilities built in.</p>
<p>If you make websites, you may have tested your sites with a screen reader. But how do these and other assistive programs actually access your content? What information do they use? We’ll take a detailed step-by-step view of how the process works.</p>
<p><em>(For simplicity we’ll continue to reference “browsers” and “screen readers” throughout this article. These are essentially shorthands for “browsers and other applications,” and “screen readers and other assistive technologies,” respectively.)</em></p>
<h2>The semantics-to-screen-readers pipeline<a class="subhead-anchor" href="#section1">#section1</a></h2>
<p>Accessibility <em>application programming interfaces</em> (APIs) create a useful link between user applications and the assistive technologies that wish to interact with them. Accessibility APIs facilitate communicating accessibility information about user interfaces (UIs) to the ATs. The API expects information to be structured in a certain way, so that whether a button is properly marked up in web content or is sitting inside a native app taskbar, a button is a button is a button as far as ATs are concerned. That said, screen readers and other ATs can do some app-specific handling if they wish.</p>
<p>On the web specifically, there are some browser and screen reader combinations where accessibility API information is supplemented by access to DOM structures. For this article, we’ll focus specifically on accessibility APIs as a link between web content and the screen reader.</p>
<p>Here’s the breakdown of how web content reaches screen readers via accessibility APIs:</p>
<p>The <strong>web developer</strong> uses host language markup (HTML, SVG, etc.), and potentially roles, states, and properties from the <a href="https://rawgit.com/w3c/aria/master/">ARIA suite</a> where needed to provide the semantics of their content. Semantic markup communicates what type an element is, what content it contains, what state it’s in, etc.</p>
<p>The <strong>browser rendering engine</strong> (alternatively referred to as a “user agent”) takes this information and maps it into an accessibility API. Different accessibility APIs are available on different operating systems, so a browser that is available on multiple platforms should support multiple accessibility APIs. Accessibility API mappings are maintained on a lower level than web platform APIs, so web developers don’t directly interact with accessibility APIs.</p>
<p>The <strong>accessibility API</strong> includes a collection of <a href="https://en.wikipedia.org/wiki/Interface_(computing)">interfaces</a> that browsers and other apps can plumb into, and generally acts as an intermediary between the browser and the screen reader. Accessibility APIs provide interfaces for representing the structure, relationships, semantics, and state of digital content, as well as means to surface dynamic changes to said content. Accessibility APIs also allow screen readers to retrieve and interact with content via the API.</p>
<p>Again, web developers don’t interact with these APIs directly; the rendering engine handles translating web content into information useful to accessibility APIs.</p>
<h3>Examples of accessibility APIs<a class="subhead-anchor" href="#section2">#section2</a></h3>
<ul><li><strong>Windows:</strong> <a href="https://docs.microsoft.com/en-us/windows/desktop/WinAuto/microsoft-active-accessibility">Microsoft Active Accessibility</a> (MSAA), extended with another API called <a href="https://wiki.linuxfoundation.org/accessibility/iaccessible2/start">IAccessible2</a> (IA2)</li>
<li><strong>Windows:</strong> <a href="https://docs.microsoft.com/en-us/windows/desktop/WinAuto/entry-uiauto-win32">UI Automation</a> (UIA), the Microsoft successor to MSAA. A browser on Windows can choose to support MSAA with IA2, UIA, or both.</li>
<li><strong>MacOS:</strong> <a href="https://developer.apple.com/documentation/appkit/nsaccessibility">NSAccessibility</a> (AXAPI)</li>
<li><strong>Linux/Gnome:</strong> <a href="https://developer.gnome.org/atk/stable/">Accessibility Toolkit</a> (ATK) and <a href="https://developer.gnome.org/libatspi/stable/">Assistive Technology Service Provider Interface</a> (AT-SPI). This case is a little different in that there are actually two separate APIs: one through which browsers and other applications pass information along to (ATK) and one that ATs then call from (AT-SPI).</li>
</ul><p>The <strong>screen reader</strong> uses client-side methods from these accessibility APIs to retrieve and handle information exposed by the browser. In browsers where direct access to the Document Object Model (DOM) is permitted, some screen readers may also take additional information from the DOM tree. A screen reader can also interact with apps that use differing accessibility APIs.</p>
<p>No matter where they get their information, screen readers can dream up any interaction modes they want to provide to their users (I’ve provided links to screen reader commands at the end of this article). Testing by site creators can help identify content that feels awkward in a particular navigation mode, such as multiple links with the same text (“Learn more”), as one example.</p>
<h3>Example of this pipeline: surfacing a button element to screen reader users<a class="subhead-anchor" href="#section3">#section3</a></h3>
<p>Let’s suppose for a moment that a screen reader wants to understand what object is next in the accessibility tree (which I’ll explain further in the next section), so it can surface that object to the user as they navigate to it. The flow will go a little something like this:</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2019/02/fig1.png" alt="Diagram showing the client (screen reader) making a call to the accessibility API, which passes along the request to the provider (browser), which checks the content in the web document, which sends the information back up the chain" /><figcaption>Diagram illustrating the steps involved in presenting the next object in a document; detailed list follows</figcaption></figure><ol><li>The screen reader requests information from the API about the next accessible object, relative to the current object.</li>
<li>The API (as an intermediary) passes along this request to the browser.</li>
<li>At some point, the browser references DOM and style information, and discovers that the relevant element is a non-hidden button: <code>&lt;button&gt;Do a thing&lt;/button&gt;</code>.</li>
<li>The browser maps this HTML button into the format the API expects, such as an accessible object with various properties: <strong>Name:</strong> Do a thing, <strong>Role:</strong> Button.</li>
<li>The API returns this information from the browser to the screen reader.</li>
<li>The screen reader can then surface this object to the user, perhaps stating “Button, Do a thing.”</li>
</ol><p>Suppose that the screen reader user would now like to “click” this button. Here’s how their action flows all the way back to web content:</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2019/02/fig2.png" alt="Diagram showing a user using a 'primary action' command to a client (screen reader), which passes the command to the accessibility API, which passes the command along to the provider (browser), which passes the command as a click event to the web document" /><figcaption>Diagram illustrating the steps involved in routing a screen reader click to web content; detailed list follows</figcaption></figure><ol><li>The user provides a particular screen reader command, such as a keystroke or gesture.</li>
<li>The screen reader calls a method into the API to invoke the button.</li>
<li>The API forwards this interaction to the browser.</li>
<li>How a browser may respond to incoming interactions depends on the context, but in this case the browser can raise this as a “click” event through web APIs. The browser should give no indication that the click came from an assistive technology, as doing so would violate the user’s right to privacy.</li>
<li>The web developer has registered a JavaScript event listener for clicks; their callback function is now executed as if the user clicked with a mouse.</li>
</ol><p>Now that we have a general sense of the pipeline, let’s go into a little more detail on the accessibility tree.</p>
<h2>The accessibility tree<a class="subhead-anchor" href="#section4">#section4</a></h2>
<figure><img src="https://alistapart.com/wp-content/uploads/2019/02/fig3.png" alt="Screenshot showing the accessibility tools in Microsoft Edge" /><figcaption>Dev Tools in Microsoft Edge showing the DOM tree and accessibility tree side by side; there are more nodes in the DOM tree</figcaption></figure><p>The <em>accessibility tree</em> is a hierarchical representation of elements in a UI or document, as computed for an accessibility API. In modern browsers, the accessibility tree for a given document is a separate, parallel structure to the DOM tree. “Parallel” does not necessarily mean there is a 1:1 match between the nodes of these two trees. Some elements may be excluded from the accessibility tree, for example if they are hidden or are not semantically useful (think non-focusable wrapper <code>div</code>s without any semantics added by a web developer).</p>
<p>This idea of a hierarchical structure is somewhat of an abstraction. The definition of what exactly an accessibility tree is in practice has been debated and partially defined in multiple places, so implementations may differ in various ways.</p>
<p>For example, it’s not actually necessary to generate accessible objects for every element in the DOM whenever the DOM tree is constructed. As a performance consideration, a browser could choose to deal with only a subset of objects and their relationships at a time—that is, however much is necessary to fulfill the requests coming from ATs. The rendering engine could make these computations during all user sessions, or only do so when assistive technologies are actively running.</p>
<p>Generally speaking, modern web browsers wait until after style computation to build up any accessible objects. Browsers wait in part because generated content (such as <code>::before</code> and <code>::after</code>) ƒcan contain text that can participate in calculation of the accessible object’s name. CSS styles can also impact accessible objects in other various ways: text styling can come through as attributes on accessible text ranges. Display property values can impact the computation of line text ranges. These are just a few ways in which style can impact accessibility semantics.</p>
<p>Browsers may also use different structures as the basis for accessible object computation. One rendering engine may walk the DOM tree and cross-reference style computations to build up parallel tree structures; another engine may use only the nodes that are available in a style tree in order to build up their accessibility tree.</p>
<p>User agent participants in the standards community are currently thinking through how we can better document our implementation details, and whether it might make sense to standardize more of these details further down the road.</p>
<p>Let’s now focus on the branches of this tree, and explore how individual accessibility objects are computed.</p>
<h3>Building up accessible objects<a class="subhead-anchor" href="#section5">#section5</a></h3>
<p>From API to API, an accessible object will generally include a few things:</p>
<ul><li><strong>Role</strong>, or the type of accessible object (for example, Button). The role tells a user how they can expect to interact with the control. It is typically presented when screen reader focus moves onto the accessible object, and it can be used to provide various other functionalities, such as skipping around content via one type of object.</li>
<li><strong>Name</strong>, if specified. The name is an (ideally short) identifier that better helps the user identify and understand the purpose of an accessible object. The name is often presented when screen focus moves to the object (more on this later), can be used as an identifier when presenting a list of available objects, and can be used as a hook for functionalities such as voice commands.</li>
<li><strong>Description and/or help text</strong>, if specified. We’ll use “Description” as a shorthand. The Description can be considered supplemental to the Name; it’s not the main identifier but can provide further information about the accessible object. Sometimes this is presented when moving focus to the accessible object, sometimes not; this variation depends on both the screen reader’s user experience design and the user’s chosen verbosity settings.</li>
<li><strong>Properties and methods surfacing additional semantics.</strong> For simplicity’s sake, we won’t go through all of these. For your awareness, properties can include details like layout information or available interactions (such as invoking the element or modifying its value).</li>
</ul><p>Let’s walk through an example using markup for a simple mood tracker. We’ll use simplified property names and values, because these can differ between accessibility APIs.</p>
<figure id="figure4"><img src="https://alistapart.com/wp-content/uploads/2019/02/fig4.png" alt="" /></figure><pre><code class="language-javascript">&lt;form&gt;
  &lt;label for="mood"&gt;On a scale of 1–10, what is your mood today?&lt;/label&gt;
  &lt;input id="mood" type="range"
       min="1" max="10" value="5"
       aria-describedby="helperText" /&gt;
  &lt;p id="helperText"&gt;Some helpful pointers about how to rate your mood.&lt;/p&gt;
  &lt;!-- Using a div with button role for the purposes of showing how the accessibility tree is created. Please use the button element! --&gt;
  &lt;div tabindex="0" role="button"&gt;Log Mood&lt;/div&gt;
&lt;/form&gt;</code></pre>
<p>First up is our <code>form</code> element. This form doesn’t have any attributes that would give it an accessible Name, and a form landmark without a Name isn’t very useful when jumping between landmarks. Therefore, <a href="https://www.w3.org/TR/html-aam-1.0/#html-element-role-mappings">HTML mapping standards</a> specify that it should be mapped as a group.</p>
<p>Here’s the beginning of our tree:</p>
<ul><li><strong>Role:</strong> Group</li>
</ul><p>Next up is the <code>label</code>. This one doesn’t have an accessible Name either, so we’ll just nest it as an object of role “Label” underneath the form:</p>
<ul><li><strong>Role:</strong> Group
<ul><li><strong>Role:</strong> Label</li>
</ul></li>
</ul><p>Let’s add the range <code>input</code>, which will map into various APIs as a “Slider.” Due to the relationship created by the <code>for</code> attribute on the <code>label</code> and <code>id</code> attribute on the <code>input</code>, this slider will take its Name from the label contents. The <code>aria-describedby</code> attribute is another id reference and points to a paragraph with some text content, which will be used for the slider’s Description. The slider object’s properties will also store “labelledby” and “describedby” relationships pointing to these other elements. And it will specify the current, minimum, and maximum values of the slider. If one of these range values were not available, <a href="https://www.w3.org/TR/wai-aria-1.2/#slider">ARIA standards specify what should be the default value</a>. Our updated tree:</p>
<ul><li><strong>Role:</strong> Group
<ul><li><strong>Role:</strong> Label</li>
<li><strong>Role:</strong> Slider<br /><strong>Name:</strong> On a scale of 1–10, what is your mood today?<br /><strong>Description:</strong> Some helpful pointers about how to rate your mood.<br /><strong>LabelledBy:</strong> mood<br /><strong>DescribedBy:</strong> helperText<br /><strong>ValueNow:</strong> 5<br /><strong>ValueMin:</strong> 1<br /><strong>ValueMax:</strong> 10</li>
</ul></li>
</ul><p>The paragraph will be added as a simple paragraph object (“Text” or “Group” in some APIs):</p>
<ul><li><strong>Role:</strong> Group
<ul><li><strong>Role:</strong> Label</li>
<li><strong>Role:</strong> Slider<br /><strong>Name:</strong> On a scale of 1–10, what is your mood today?<br /><strong>Description:</strong> Some helpful pointers about how to rate your mood.<br /><strong>LabelledBy:</strong> mood<br /><strong>DescribedBy:</strong> helperText<br /><strong>ValueNow:</strong> 5<br /><strong>ValueMin:</strong> 1<br /><strong>ValueMax:</strong> 10</li>
<li><strong>Role:</strong> Paragraph</li>
</ul></li>
</ul><p>The final element is an example of when role semantics are added via the ARIA <code>role</code> attribute. This <code>div</code> will map as a Button with the name “Log Mood,” as buttons can take their name from their children. This button will also be surfaced as “invokable” to screen readers and other ATs; special types of buttons could provide expand/collapse functionality (buttons with the <code>aria-expanded</code> attribute), or toggle functionality (buttons with the <code>aria-pressed</code> attribute). Here’s our tree now:</p>
<ul><li><strong>Role:</strong> Group
<ul><li><strong>Role:</strong> Label</li>
<li><strong>Role:</strong> Slider<br /><strong>Name:</strong> On a scale of 1–10, what is your mood today?<br /><strong>Description:</strong> Some helpful pointers about how to rate your mood.<br /><strong>LabelledBy:</strong> mood<br /><strong>DescribedBy:</strong> helperText<br /><strong>ValueNow:</strong> 5<br /><strong>ValueMin:</strong> 1<br /><strong>ValueMax:</strong> 10</li>
<li><strong>Role:</strong> Paragraph</li>
<li><strong>Role:</strong> Button<br /><strong>Name:</strong> Log Mood</li>
</ul></li>
</ul><h3>On choosing host language semantics<a class="subhead-anchor" href="#section6">#section6</a></h3>
<p>Our sample markup mentions that it is preferred to use the HTML-native <code>button</code> element rather than a <code>div</code> with a <code>role</code> of “button.” Our buttonified <code>div</code> can be operated as a button via accessibility APIs, as the ARIA attribute is doing what it should—conveying semantics. But there’s a lot you can get for free when you choose native elements. In the case of <code>button</code>, that includes focus handling, user input handling, form submission, and basic styling.</p>
<p>Aaron Gustafson has what he refers to as an <a href="https://www.smashingmagazine.com/2016/05/developing-dependency-awareness/">“exhaustive treatise” on buttons</a> in particular, but generally speaking it’s great to let the web platform do the heavy lifting of semantics and interaction for us when we can.</p>
<p>ARIA roles, states, and properties are still a great tool to have in your toolbelt. Some good use cases for these are</p>
<ul><li>providing further semantics and relationships that are not naturally expressed in the host language;</li>
<li>supplementing semantics in markup we perhaps don’t have complete control over;</li>
<li>patching potential cross-browser inconsistencies;</li>
<li>and making custom elements perceivable and operable to users of assistive technologies.</li>
</ul><h3>Notes on inclusion or exclusion in the tree<a class="subhead-anchor" href="#section7">#section7</a></h3>
<p>Standards define some rules around when user agents should exclude elements from the accessibility tree. Excluded elements can include those hidden by CSS, or the <code>aria-hidden</code> or <code>hidden</code> attributes; their children would be excluded as well. Children of particular roles (like <code>checkbox</code>) can also be excluded from the tree, unless they meet special exceptions. The full rules can be found in the <a href="https://www.w3.org/TR/wai-aria-1.2/#accessibility_tree">“Accessibility Tree” section of the ARIA specification</a>. That being said, there are still some differences between implementers, some of which include more <code>div</code>s and <code>span</code>s in the tree than others do.</p>
<h3>Notes on name and description computation<a class="subhead-anchor" href="#section8">#section8</a></h3>
<p>How names and descriptions are computed can be a bit confusing. Some elements have special rules, and some ARIA roles allow name computation from the element’s contents, whereas others do not. Name and description computation could probably be its own article, so we won’t get into all the details here (refer to “Further reading and resources” for some links). Some short pointers:</p>
<ul><li><code>aria-label</code>, <code>aria-labelledby</code>, and <code>aria-describedby</code> take precedence over other means of calculating name and description.</li>
<li>If you expect a particular HTML attribute to be used for the name, check the <a href="https://w3c.github.io/html-aam/#accessible-name-and-description-computation">name computation rules for HTML elements</a>. In your scenario, it may be used for the full description instead.</li>
<li>Generated content (<code>::before</code> and <code>::after</code>) can participate in the accessible name when said name is taken from the element’s contents. That being said, <a href="https://www.w3.org/WAI/WCAG21/Techniques/failures/F87">web developers should not rely on pseudo-elements for non-decorative content</a>, as this content could be lost when a stylesheet fails to load or user styles are applied to the page.</li>
</ul><p>When in doubt, reach out to the community! Tag questions on social media with “#accessibility.” “#a11y” is a common shorthand; the “11” stands for “11 middle letters in the word ‘accessibility.’” If you find an inconsistency in a particular browser, file a bug! Bug tracker links are provided in “Further reading and resources.”</p>
<h2>Not just accessible objects<a class="subhead-anchor" href="#section9">#section9</a></h2>
<p>Besides a hierarchical structure of objects, accessibility APIs also offer interfaces that allow ATs to interact with text. ATs can retrieve content text ranges, text selections, and a variety of text attributes that they can build experiences on top of. For example, if someone writes an email and uses color alone to highlight their added comments, the person reading the email could increase the verbosity of speech output in their screen reader to know when they’re encountering phrases with that styling. However, it would be better for the email author to include very brief text labels in this scenario.</p>
<p>The big takeaway here for web developers is to keep in mind that the accessible name of an element may not always be surfaced in every <a href="https://tink.uk/understanding-screen-reader-interaction-modes/">navigation mode</a> in every screen reader. So if your <code>aria-label</code> text isn’t being read out in a particular mode, the screen reader may be primarily using text interfaces and only conditionally stopping on objects. It may be worth your while to consider using text content—even if <a href="https://a11yproject.com/posts/how-to-hide-content/">visually hidden</a>—instead of text via an ARIA attribute. <a href="https://developer.paciellogroup.com/blog/2017/07/short-note-on-aria-label-aria-labelledby-and-aria-describedby/">Read more thoughts on <code>aria-label</code> and <code>aria-labelledby</code>.</a></p>
<h2>Accessibility API events<a class="subhead-anchor" href="#section10">#section10</a></h2>
<p>It is the responsibility of browsers to surface changes to content, structure, and user input. Browsers do this by sending the accessibility API notifications about various events, which screen readers can subscribe to; again, for performance reasons, browsers could choose to send notifications only when ATs are active.</p>
<p>Let’s suppose that a screen reader wants to surface changes to a live region (an element with <code>role="alert"</code> or <code>aria-live</code>):</p>
<figure id="figure5"><img src="https://alistapart.com/wp-content/uploads/2019/02/fig5.png" alt="Diagram showing a client (screen reader), which is already subscribed to live region events and can request more info about the live region, which receives a notification from the accessibility API, which gets a notification that a live region has changed from the provider (browser), which has a live region changed by the web document" /><figcaption>Diagram illustrating the steps involved in announcing a live region via a screen reader; detailed list follows</figcaption></figure><ol><li>The screen reader subscribes to event notifications; it could subscribe to notifications of all types, or just certain types as categorized by the accessibility API. Let’s assume in our example that the screen reader is at least listening to live region change events.</li>
<li>In the web content, the web developer changes the text content of a live region.</li>
<li>The browser (provider) recognizes this as a live region change event, and sends the accessibility API a notification.</li>
<li>The API passes this notification along to the screen reader.</li>
<li>The screen reader can then use metadata from the notification to look up the relevant accessible objects via the accessibility API, and can surface the changes to the user.</li>
</ol><p>ATs aren’t required to do anything with the information they retrieve. This can make it a bit trickier as a web developer to figure out why a screen reader isn’t announcing a change: it may be that notifications aren’t being raised (for example, because a browser is not sending notifications for a live region dynamically inserted into web content), or the AT is not subscribed or responding to that type of event.</p>
<h2 id="section11">Testing with screen readers and dev tools<a class="subhead-anchor" href="#section11">#section11</a></h2>
<p>While conformance checkers can help catch some basic accessibility issues, it’s ideal to walk through your content manually using a variety of contexts, such as</p>
<ul><li>using a keyboard only;</li>
<li>with various OS accessibility settings turned on;</li>
<li>and at different zoom levels and text sizes, and so on.</li>
</ul><p>As you do this, keep in mind the <a href="https://www.w3.org/TR/WCAG21/"><cite>Web Content Accessibility Guidelines (WCAG 2.1)</cite></a>, which give general guidelines around expectations for inclusive web content. If you can test with users after your own manual test passes, all the better!</p>
<p>Robust accessibility testing could probably be its own series of articles. In this one, we’ll go over some tips for testing with screen readers, and catching accessibility errors as they are mapped into the accessibility API in a more general sense.</p>
<h3 id="section12">Screen reader testing<a class="subhead-anchor" href="#section12">#section12</a></h3>
<p>Screen readers exist in many forms: some are pre-installed on the operating system and others are separate applications that in some cases are free to download. The <a href="https://webaim.org/projects/screenreadersurvey7/">WebAIM screen reader user survey</a> provides a list of commonly used screen reader and browser combinations among survey participants. The “Further reading and resources” section at the end of this article includes full screen reader user docs, and Deque University has a great set of <a href="https://dequeuniversity.com/resources/">screen reader command cheat sheets</a> that you can refer to. Some actions you might take to test your content:</p>
<ul><li>Read the next/previous item.</li>
<li>Read the next/previous line.</li>
<li>Read continuously from a particular point.</li>
<li>Jump by headings, landmarks, and links.</li>
<li>Tab around focusable elements only.</li>
<li>Get a summary of all elements of a particular type within the page.</li>
<li>Search the page for specific content.</li>
<li>Use table-specific commands to interact with your tables.</li>
<li>Jump around by form field; are field instructions discoverable in this navigational mode?</li>
<li>Use keyboard commands to interact with all interactive elements. Are your JavaScript-driven interactions still operable with screen readers (which can intercept key input in certain modes)? <a href="https://www.w3.org/TR/wai-aria-practices/#aria_ex"><cite>WAI-ARIA Authoring Practices 1.1</cite></a> includes notes on expected keyboard interactions for various widgets.</li>
<li>Try out anything that creates a content change or results in navigating elsewhere. Would it be obvious, via screen reader output, that a change occurred?</li>
</ul><h3 id="section13">Tracking down the source of unexpected behavior<a class="subhead-anchor" href="#section13">#section13</a></h3>
<p>If a screen reader does not announce something as you’d expect, here are a few different checks you can run:</p>
<ul><li><strong>Does this reproduce with the same screen reader in multiple browsers on this OS?</strong> It may be an issue with the screen reader or your expectation may not match the screen reader’s user experience design. For example, a screen reader may choose to not expose the accessible name of a static, non-interactive element. Checking the user docs or filing a screen reader issue with a simple test case would be a great place to start.</li>
<li><strong>Does this reproduce with multiple screen readers in the same browser, but not in other browsers on this OS?</strong> The browser in question may have an issue, there may be compatibility differences between browsers (such as a browser doing extra helpful but non-standard computations), or a screen reader’s support for a specific accessibility API may vary. Filing a browser issue with a simple test case would be a great place to start; if it’s not a browser bug, the developer can route it to the right place or make a code suggestion.</li>
<li><strong>Does this reproduce with multiple screen readers in multiple browsers?</strong> There may be something you can adjust in your code, or your expectations may differ from standards and common practices.</li>
<li><strong>How does this element’s accessibility properties and structure show up in browser dev tools?</strong></li>
</ul><h3 id="section14">Inspecting accessibility trees and properties in dev tools<a class="subhead-anchor" href="#section14">#section14</a></h3>
<p>Major modern browsers provide dev tools to help you observe the structure of the accessibility tree as well as a given element’s accessibility properties. By observing which accessible objects are generated for your elements and which properties are exposed on a given element, you may be able to pinpoint issues that are occurring either in front-end code or in how the browser is mapping your content into the accessibility API.</p>
<p>Let’s suppose that we are testing this piece of code in Microsoft Edge with a screen reader:</p>
<pre><code class="language-markup">&lt;div class="form-row"&gt;
  &lt;label&gt;Favorite color&lt;/label&gt;
  &lt;input id="myTextInput" type="text" /&gt;
&lt;/div&gt;</code></pre>
<p>We’re navigating the page by form field, and when we land on this text field, the screen reader just tells us this is an “edit” control—it doesn’t mention a name for this element. Let’s check the tools for the element’s accessible name.</p>
<p><strong>1. Inspect the element to bring up the dev tools.</strong></p>
<figure id="figure6"><img src="https://alistapart.com/wp-content/uploads/2019/02/fig6.png" alt="Screenshot showing the Microsoft Edge dev tools inspecting an input element" /><figcaption>The Microsoft Edge dev tools, with an input element highlighted in the DOM tree</figcaption></figure><p><strong>2. Bring up the accessibility tree for this page by clicking the accessibility tree button (a circle with two arrows) or pressing Ctrl+Shift+A (Windows).</strong></p>
<figure id="figure7"><img src="https://alistapart.com/wp-content/uploads/2019/02/fig7.png" alt="Screenshot showing the Microsoft Edge tools inspecting an input element with the Accessibility Tree panel open" /><figcaption>The accessibility tree button activated in the Microsoft Edge dev tools</figcaption></figure><p>Reviewing the accessibility tree is an extra step for this particular flow but can be helpful to do.</p>
<p>When the Accessibility Tree pane comes up, we notice there’s a tree node that just says “textbox:,” with nothing after the colon. That suggests there’s not a name for this element. (Also notice that the <code>div</code> around our form input didn’t make it into the accessibility tree; it was not semantically useful).</p>
<p><strong>3. Open the Accessibility Properties pane, which is a sibling of the Styles pane.</strong> If we scroll down to the Name property—aha! It’s blank. No name is provided to the accessibility API. (Side note: some other accessibility properties are filtered out of this list by default; toggle the filter button—which looks like a funnel—in the pane to get the full list).</p>
<figure id="figure8"><img src="https://alistapart.com/wp-content/uploads/2019/02/fig8.png" alt="Screenshot showing the Microsoft Edge tools inspecting an input element with the Accessibility Tree panel open" /><figcaption>The Accessibility Properties pane open in Microsoft Edge dev tools, in the same area as the Styles pane</figcaption></figure><p><strong>4. Check the code.</strong> We realize that we didn’t associate the <code>label</code> with the text field; that is one strategy for providing an <a href="https://w3c.github.io/html-aam/#input-type-text-input-type-password-input-type-search-input-type-tel-input-type-url-and-textarea-element">accessible name for a text input</a>. We add <code>for="myTextInput"</code> to the label:</p>
<pre><code class="language-markup">&lt;div class="form-row"&gt;
  &lt;label for="myTextInput"&gt;Favorite color&lt;/label&gt;
  &lt;input id="myTextInput" type="text" /&gt;
&lt;/div&gt;</code></pre>
<p>And now the field has a name:</p>
<figure id="figure9"><img src="https://alistapart.com/wp-content/uploads/2019/02/fig9.png" alt="Screenshot showing the Microsoft Edge tools inspecting an input element with the Accessibility Tree panel open, where the input's Name attribute now has a value" /><figcaption>The accessible Name property set to the value of “Favorite color” inside Microsoft Edge dev tools</figcaption></figure><p>In another use case, we have a breadcrumb component, where the current page link is marked with <code>aria-current="page"</code>:</p>
<pre id="snippet4"><code class="language-markup">&lt;nav class="breadcrumb" aria-label="Breadcrumb"&gt;
  &lt;ol&gt;
    &lt;li&gt;
      &lt;a href="/cat/"&gt;Category&lt;/a&gt;
    &lt;/li&gt;
    &lt;li&gt;
      &lt;a href="/cat/sub/"&gt;Sub-Category&lt;/a&gt;
    &lt;/li&gt;
    &lt;li&gt;
      &lt;a aria-current="page" href="/cat/sub/page/"&gt;Page&lt;/a&gt;
    &lt;/li&gt;
  &lt;/ol&gt;
&lt;/nav&gt;</code></pre>
<p>When navigating onto the current page link, however, we don’t get any indication that this is the current page. We’re not exactly sure how this maps into accessibility properties, so we can reference a specification like <cite>Core Accessibility API Mappings 1.2</cite> (Core-AAM). Under the “<a href="https://w3c.github.io/core-aam/#mapping_state-property">State and Property Mapping</a>” table, we find mappings for “<code>aria-current</code> with non-<code>false</code> allowed value.” We can check for these listed properties in the Accessibility Properties pane. Microsoft Edge, at the time of writing, maps into UIA (UI Automation), so when we check AriaProperties, we find that yes, “current=page” is included within this property value.</p>
<figure id="figure10"><img src="https://alistapart.com/wp-content/uploads/2019/02/fig10.png" alt="Screenshot showing the Microsoft Edge tools inspecting an input element with the Accessibility Tree panel open, where the input's AriaProperties attribute now has a value of current=page" /><figcaption>The accessible Name property set to the value of “Favorite color” inside Microsoft Edge dev tools</figcaption></figure><p>Now we know that the value is presented correctly to the accessibility API, but the particular screen reader is not using the information.</p>
<p>As a side note, Microsoft Edge’s current dev tools expose these accessibility API properties quite literally. Other browsers’ dev tools may simplify property names and values to make them easier to read, particularly if they support more than one accessibility API. The important bit is to find if there’s a property with roughly the name you expect and whether its value is what you expect. You can also use this method of checking through the property names and values if mapping specs, like Core-AAM, are a bit intimidating!</p>
<h3 id="section15">Advanced accessibility tools<a class="subhead-anchor" href="#section15">#section15</a></h3>
<p>While browser dev tools can tell us a lot about the accessibility semantics of our markup, they don’t generally include representations of text ranges or event notifications. On Windows, the <a href="https://developer.microsoft.com/en-us/windows/downloads/windows-10-sdk">Windows SDK</a> includes advanced tools that can help debug these parts of MSAA or UIA mappings: <a href="https://docs.microsoft.com/en-us/windows/desktop/winauto/inspect-objects">Inspect</a> and <a href="https://docs.microsoft.com/en-us/windows/desktop/winauto/accessible-event-watcher">AccEvent</a> (Accessible Event Watcher). Using these tools presumes knowledge of the Windows accessibility APIs, so if this is too granular for you and you’re stuck on an issue, please reach out to the relevant browser team!</p>
<p>There is also an Accessibility Inspector in Xcode on MacOS, with which you can inspect web content in Safari. This tool can be accessed by going to <strong>Xcode &gt; Open Developer Tool &gt; Accessibility Inspector</strong>.</p>
<h2 id="section16">Diversity of experience<a class="subhead-anchor" href="#section16">#section16</a></h2>
<p>Equipped with an accessibility tree, detailed object information, event notifications, and methods for interacting with accessible objects, screen readers can craft a browsing experience tailored to their audiences. In this article, we’ve used the term “screen readers” as a proxy for a whole host of tools that may use accessibility APIs to provide the best user experience possible. Assistive technologies can use the APIs to augment presentation or support varying types of user input. Examples of other ATs include screen magnifiers, cognitive support tools, speech command programs, and some brilliant new app that hasn’t been dreamed up yet. Further, assistive technologies of the same “type” may differ in how they present information, and users who share the same tool may further adjust settings to their liking.</p>
<p>As web developers, we don’t necessarily need to make sure that each instance surfaces information identically, because each user’s preferences will not be exactly the same. Our aim is to ensure that no matter how a user chooses to explore our sites, content is <a href="https://www.w3.org/TR/UNDERSTANDING-WCAG20/intro.html#introduction-fourprincs-head">perceivable, operable, understandable, and robust</a>. By testing with a variety of assistive technologies—including but not limited to screen readers—we can help create a better web for all the many people who use it.</p>
<h2 id="section17">Further reading and resources<a class="subhead-anchor" href="#section17">#section17</a></h2>
<ul><li><a href="https://webaim.org/projects/lowvisionsurvey2/">WebAIM “Survey of Users with Low Vision”</a></li>
<li><a href="https://webaim.org/projects/screenreadersurvey7/">WebAIM “Screen Reader User Survey”</a></li>
<li>W3C developer guides
<ul><li><a href="https://www.w3.org/WAI/roles/">W3C Web Accessibility Initiative (WAI) resources</a></li>
<li><a href="https://www.w3.org/TR/WCAG21/"><cite>Web Content Accessibility Guidelines (WCAG) 2.1</cite></a></li>
<li><a href="https://www.w3.org/TR/wai-aria-practices-1.1/"><cite>WAI-ARIA Authoring Practices 1.1</cite></a></li>
<li><a href="https://www.w3.org/TR/html-aria/"><cite>ARIA in HTML</cite></a></li>
<li><a href="https://www.w3.org/TR/using-aria/"><cite>Using ARIA</cite></a></li>
</ul></li>
<li>W3C specifications: The docs below are known as “AAMs.” They detail how content maps into various accessibility APIs and may be less relevant to web developers’ day-to-day work. However, some have notes on how specific elements’ names and descriptions are meant to be calculated:
<ul><li><a href="https://www.w3.org/TR/core-aam-1.1/"><cite>Core Accessibility API Mappings 1.1</cite></a></li>
<li><a href="https://www.w3.org/TR/graphics-aam-1.0/"><cite>Graphics Accessibility API Mappings</cite></a></li>
<li><a href="https://www.w3.org/TR/html-aam-1.0/"><cite>HTML Accessibility API Mappings 1.0</cite></a></li>
<li><a href="https://www.w3.org/TR/svg-aam-1.0/"><cite>SVG Accessibility API Mappings</cite></a></li>
</ul></li>
<li><a href="https://inclusive-components.design/"><cite>Inclusive Components</cite></a></li>
<li><a href="https://alistapart.com/topic/accessibility"><cite>A List Apart</cite> articles on accessibility</a>
<ul><li><a href="https://alistapart.com/article/conversational-semantics">“Conversational Semantics”</a></li>
<li><a href="https://alistapart.com/column/wai-finding-with-aria-landmark-roles">“WAI-finding with ARIA Landmark Roles”</a></li>
</ul></li>
<li><a href="https://www.smashingmagazine.com/2018/09/importance-manual-accessibility-testing/">“The Importance of Manual Accessibility Testing”</a></li>
<li><a href="https://dequeuniversity.com/resources/">Deque University screen reader shortcuts references</a></li>
<li>Screen reader user docs (commands)
<ul><li><a href="https://www.freedomscientific.com/products/blindness/jawsdocumentation">JAWS user docs</a></li>
<li><a href="https://support.microsoft.com/en-us/help/22798/windows-10-complete-guide-to-narrator">Narrator user docs</a></li>
<li><a href="https://www.nvaccess.org/files/nvda/documentation/userGuide.html">NVDA user docs</a></li>
<li><a href="https://help.apple.com/voiceover/mac/10.14/">VoiceOver user docs (VoiceOver command charts)</a></li>
<li><a href="https://help.apple.com/iphone/10/#/iph3e2e415f">iOS VoiceOver user docs</a></li>
</ul></li>
<li>Browser rendering engine bug trackers
<ul><li><a href="https://bugs.chromium.org/p/chromium/issues/list">Chrome</a></li>
<li><a href="https://bugzilla.mozilla.org/describecomponents.cgi?product=Core">Firefox</a></li>
<li><a href="http://issues.microsoftedge.com/">Microsoft Edge</a></li>
<li><a href="https://bugs.webkit.org/query.cgi?format=specific&amp;product=WebKit">Safari</a></li>
</ul></li>
</ul><div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Our own @zeldman paints the complicated catch-22 that our free, democratized web has with our money-making capitalist roots. As creators, how do we untangle this web? #LetsFixThis</div><div class="entry-content">A month of experiencing a temporary disability changed @fcorradini’s perspective on how to take more care when conducting accessibility testing. He shares the impact.</div><div class="entry-content">Jeremy Wagner plots a course to avoid the unnecessary bloat and inaccessible patterns of current JavaScript trends.</div><div class="entry-content">Technology can easily become a platform for hate, and we have an ethical responsibility to fix it. ALA's own Tatiana Mac discusses</div><div class="entry-content">Brandon Gregory discusses designing for conversions, which allows products to reach their targets and serve the right people.</div>]]></description>
      <link>https://alistapart.com/article/semantics-to-screen-readers/</link>
      <guid>https://alistapart.com/article/semantics-to-screen-readers/</guid>
      <pubDate>Thu, 28 Feb 2019 01:02:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[Designing for Conversions]]></title>
      <description><![CDATA[<p>What makes creative successful? Creative work often lives in the land of feeling—we can say we like something, point to how happy the client is, or talk about how delighted users will be, but can’t objectively measure feelings. Measuring the success of creative work doesn’t have to stop with feeling. In fact, we can assign it numbers, do math with it, and track improvement to show clients objectively how well our creative is working for them.</p>


<p>David Ogilvy once said, “If it doesn’t sell, it isn’t creative.” While success may not be a tangible metric for us, it is for our clients. They have hard numbers to meet, and as designers, we owe it to them to think about how our work can meet those goals. We can track sales, sure, but websites are ripe with other opportunities for measuring improvements. Designing for conversions will not only make you a more effective designer or copywriter, it will make you much more valuable to your clients, and that’s something we should all seek out.</p>
<h2>Wait—what’s a conversion?</h2>
<p>Before designing for conversions, let’s establish a baseline for what, exactly, we’re talking about. A <em>conversion</em> is an action taken by the user that accomplishes a business goal. If your site sells things, a conversion would be a sale. If you collect user information to achieve your business goals, like lead aggregation, it would be a form submission. Conversions can also be things like newsletter sign-ups or even hits on a page containing important information that you need users to read. You need some tangible action to measure the success of your site—that’s your conversion.</p>
<p>Through analytics, you know how many people are coming to your site. You can use this to measure what percentage of users are converting. This number is your <em>conversion rate</em>, and it’s the single greatest metric for measuring the success of a creative change. In your analytics, you can set up goals and conversion funnels to track this for you (more on conversion funnels shortly). It doesn’t matter how slick that new form looks or how clever that headline is—if the conversion rate drops, it’s not a success. In fact, once you start measuring success by conversion rate, you’ll be surprised to see how even the cleverest designs applied in the wrong places can fail to achieve your goals.</p>
<p>Conversions aren’t always a one-step process. Many of us have multi-step forms or long check-out processes where it can be very useful to track how far a user gets. It’s possible to set up multiple goals along the way so your analytics can give you this data. This is called a <em>conversion funnel</em>. Ideally, you’ll coordinate with the rest of your organization to get data beyond the website as well. For instance, changing button copy may lead to increased form submissions but a drop in conversions from lead to sale afterward. In this case, the button copy update probably confused users rather than selling them on the product. A good conversion funnel will safeguard against false positives like that.</p>
<p>It’s also important to track the <em>bounce rate</em>, which is the percentage of users that hit a page and leave without converting or navigating to other pages. A higher bounce rate is an indication that there’s a mismatch between the user’s expectations when landing on your site and what they find once landing there. Bounce rate is really a part of the conversion funnel, and reducing bounce rate can be just as important as improving conversion rate.</p>
<h2>Great. So how do we do that?</h2>
<p>When I was first getting started in conversion-driven design, it honestly felt a little weird. It feels shady to focus obsessively on getting the user to complete an action. But this focus is in no way about tricking the user into doing something they don’t want to do—that’s a bad business model. As Gerry McGovern has commented, if business goals don’t align with customer goals, your business has no future. So if we’re not tricking users, what <em>are</em> we doing?</p>
<p>Users come to your site with a problem, and they’re looking for a solution. The goal is to find users whose problems will be solved by choosing your product. With that in mind, improving the conversion rate doesn’t mean tricking users into doing something—it means showing the <em>right</em> users how to solve their problem. That means making two things clear: that your product will solve the user’s problem, and what the user must do to proceed.</p>
<p>The first of these two points is the <em>value proposition</em>. This is how the user determines whether your product can solve his or her problem. It can be a simple description of the benefits, customer testimonials, or just a statement about what the product will do for the user. A page is not limited to one value proposition—it’s good to have several. (Hint: the page’s headline should almost always be a value proposition!) The user should be able to determine quickly why your product will be helpful in solving their problem. Once the value of your product has been made clear, you need to direct the user to convert with a call to action.</p>
<p>A <em>call to action</em> tells the user what they must do to solve their problem—which, in your case, means to convert. Most buttons and links should be calls to action, but a bit of copy directly following a value proposition is a good place too. Users should never have to look around to find out what the next step is—it should be easy to spot and clear in its intention. Also, ease of access is a big success factor here. My team’s testing found that replacing a Request Information button (that pointed to a form page) with an actual form on every page significantly boosted the conversion rate. If you’re also trying to get information from a user, consider a big form at the top of the page so users can’t miss it. When they scroll down the page and are ready to convert, they remember the form and have no question as to what they have to do.</p>
<p>So improving conversion rate (and, to some degree, decreasing bounce rate) is largely about adding clarity around the value proposition and call to action. There are other factors as well, like decreasing friction in the conversion process and improving performance, but these two things are where the magic happens, and conversion problems are usually problems with one of them.</p>
<h2>So, value propositions…how do I do those?</h2>
<p>The number one thing to remember when crafting a value proposition is that you’re not selling a product—you’re selling a solution. Value propositions begin with the user’s problem and focus on that. Users don’t care about the history of your company, how many awards you’ve won, or what clever puns you’ve come up with—they care about whether your product will solve their problem. If they don’t get the impression that it can do that, they will leave and go to a competitor.</p>
<p>In my work with landing pages for career schools, we initially included pictures of people in graduation gowns and caps. We assumed that the most exciting part of going back to school was graduating. Data showed us that we were wrong. Our testing showed that photos of people doing the jobs they would be training for performed much better. In short, our assumption was that showing the product (the school) was more important than showing the benefit (a new career). The problem users were trying to solve wasn’t a diploma—it was a career, and focusing on the user showed a significant improvement in conversion rate.</p>
<p>We had some clients that insisted on using their branding on the landing pages, including one school that wanted to use an eagle as their hero image because their main website had eagles everywhere. This absolutely bombed in conversions. No matter how strong or consistent your branding is, it will not outperform talking about users and their problems.</p>
<p>Websites that get paid for clicks have mastered writing headlines this way. Clickbait headlines get a groan from copywriters—especially since they often use their powers for evil and not good—but there are some important lessons we can learn from them. Take this headline, for instance:</p>
<p><strong>Get an Associate’s degree in nursing</strong></p>
<p>Just like in the example above with the college graduates, we’re selling the product—not the benefit. This doesn’t necessarily show that we understand the user’s problem, and it does nothing to get them excited about our program. Compare that headline to this one:</p>
<p><strong>Is your job stuck in a rut? Get trained for a new career in nursing in only 18 months!</strong></p>
<p>In this case, we lead with the user’s problem. That immediately gets users’ attention. We then skip to a benefit: a quick turnaround. No time is wasted talking about the product—we save that for the body copy. The headline focuses entirely on the user.</p>
<p>In your sign-up or check-out process, always lead with the information the user is most interested in. In our case, letting the user first select their school campus and area of study showed a significant improvement over leading with contact information. Similarly, put the less-exciting content last. In our testing, users were least excited about sharing their telephone number. Moving that field to be the last one in the form decreased form abandonment and improved conversions.</p>
<p>As designers, be cognizant of what your copywriters are doing. If the headline is the primary value proposition (as it should be), make sure the headline is the focal point of your design. Ensure the messaging behind your design is in line with the messaging in the content. If there’s a disagreement in what the user’s problem is or how your product will solve that problem, the conversion rate will suffer.</p>
<p>Once the value proposition has been clearly defined and stated, it’s time to focus on the call to action.</p>
<h2>What about the call to action?</h2>
<p>For conversion-driven sites, a good call to action is the most important component. If a user is ready to convert and has insufficient direction on how to do so, you lose a sale at 90 percent completion. It needs to be abundantly clear to the user how to proceed, and that’s where the call to action steps in.</p>
<p>When crafting a call to action, don’t be shy. Buttons should be large, forms should be hard to miss, and language should be imperative. A call to action should be one of the first things the user notices on the page, even if he or she won’t be thinking about it again until after doing some research on the page. Having the next step right in front of the user vastly increases the chance of conversion, so users need to know that it’s there waiting.</p>
<p>That said, a call to action should never get in the way of a value proposition. I see this all the time: a modal window shows as soon as I get to a site, asking me to subscribe to their mailing list before I have an inkling of the value the site can give me. I dismiss these without looking, and that call to action is completely missed. Make it clear <em>how</em> to convert, and make it easy, but don’t ask for a conversion before the user is ready. For situations like the one above, a better strategy might be asking me to subscribe as I exit the site; marketing to visitors who are leaving <a href="https://beeketing.com/blog/best-exit-intent-coupon-pop-ups/">has been shown to be effective</a>.</p>
<p>In my former team’s tests, there were some design choices that could improve calls to action. For instance, picking a bright color that stood out from the rest of the site for the submit button did show an improvement in conversions, and <a href="https://www.ironpaper.com/webintel/articles/content-analytics/">reducing clutter around the call to action improved conversion rates by 232%</a>. But most of the gains here were in either layout or copy; don’t get so caught up in minor design changes that you ignore more significant changes like these.</p>
<p>Ease of access is another huge factor to consider. As mentioned above, when my team was getting started, we had a Request Information link in the main navigation and a button somewhere on the page that would lead the user to the form. The single biggest positive change we saw involved putting a form at the top of every page. For longer forms, we would break this form up into two or three steps, but having that first step in sight was a huge improvement, even if one click doesn’t seem like a lot of effort.</p>
<p>Another important element is headings. Form headings should ask the user to do something. It’s one thing to label a form “Request Information”; it’s another to ask them to “Request Information Now.” Simply adding <a href="https://blog.wishpond.com/post/103290853633/the-25-best-words-to-use-in-your-call-to-action">action words</a>, like “now” or “today,” can change a description into an imperative action and improve conversion rates.</p>
<p>With submit buttons, always take the opportunity to communicate value. The worst thing you can put on a submit button is the word “Submit.” We found that switching this button copy out with “Request Information” showed a significant improvement. Think about the implied direction of the interaction. “Submit” implies the user is giving something to us; “Request Information” implies we’re giving something to the user. The user is already apprehensive about handing over their information—communicate to them that they’re getting something out of the deal.</p>
<p>Changing phrasing to be more personal to the user can also be very effective. One study showed that writing button copy in first person—for instance, “Create My Account” versus “Create Your Account”—<a href="https://unbounce.com/a-b-testing/failed-ab-test-results/">showed a significant boost in conversions</a>, boosting click-through rates by 90%.</p>
<p>Users today are fearful that their information will be used for nefarious purposes. Make it a point to reassure them that their data is safe. Our testing showed that the best way to do this is to add a link to the privacy policy (“Your information is secure!”) with a little lock icon right next to the submit button. Users will often skip right over a small text link, so that lock icon is essential—so essential, in fact, that it may be more important than the privacy policy itself. I’m somewhat ashamed to admit this, but I once forgot to create a page for the privacy policy linked to from a landing page, so that little lock icon linked out to a 404. I expected a small boost in conversions when I finally uploaded the privacy policy, but nope—nobody noticed. Reassurance is a powerful thing.</p>
<h2>Measure, measure, measure</h2>
<p>One of the worst things you can do is push out a creative change, assume it’s great, and move on to the next task. <a href="https://alistapart.com/article/a-primer-on-a-b-testing">A/B testing</a> is ideal and will allow you to test a creative change directly against the old creative, eliminating other variables like time, media coverage, and anything else you might not be thinking of. Creative changes should be applied methodically and scientifically—just because two or three changes together show an improvement in conversion rate doesn’t mean that one of them wouldn’t perform better alone.</p>
<p>Measuring tangible things like conversion rate not only helps your client or business, but can also give new purpose to your designs and creative decisions. It’s a lot easier to push for your creative decisions when you have hard data to back up why they’re the best choice for the client or project. Having this data on hand will give you more authority in dealing with clients or marketing folks, which is good for your creative and your career. If my time in the design world has taught me anything, it’s that, in the realm of creativity, certainty can be hard to come by. So, perhaps most importantly, objective measures of success give you, and your client, the reassurance that you’re doing the right thing.</p>
<footer class="entry-footer nocontent"><h1>About the Author</h1>
<div class="byline author vcard"><a class="photo" href="https://alistapart.com/author/brandongregory"><img src="https://alistapart.com/d/_made/pix/authors/photos/brandon-gregory-400_120_120_c1.jpg" alt="Image of Brandon Gregory" /></a>
<h2>
<a href="http://brandongregorycreative.com/">Brandon Gregory</a> is a designer and developer in the Kansas City area, currently working at Sprint as a senior application developer. He’s into cats, music, psychology, writing, and cats. He writes about mental health and other things on <a href="https://medium.com/@brandongregory1981">Medium</a> and <a href="https://brandontalksmovies.com/">reviews classic films</a>. Also, he’s in a band. One time, he rocked so hard it killed a man.</h2></div>
<h3>More from this Author</h3>
<ul class="author-more"><li><a href="https://alistapart.com/article/mental-illness-in-the-web-industry">Mental Illness in the Web Industry</a></li>
<li><a href="https://alistapart.com/article/so-you-want-to-write-an-article">So You Want to Write an Article?</a></li>
<li><a href="https://alistapart.com/article/defeating-workplace-drama-with-emotional-intelligence">Defeating Workplace Drama with Emotional Intelligence</a></li>
<li><a href="https://alistapart.com/article/fixing-variable-scope-issues-with-ecmascript-6">Fixing Variable Scope Issues with ECMAScript 6</a></li>
</ul>
</footer>]]></description>
      <link>http://alistapart.com/article/designing-for-conversions</link>
      <guid>http://alistapart.com/article/designing-for-conversions</guid>
      <pubDate>Thu, 14 Feb 2019 03:02:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[<![CDATA[ Designing for Conversions ]]]]><![CDATA[>]]></title>
      <description><![CDATA[<div class="entry-content">
<p>What makes creative successful? Creative work often lives in the land of feeling—we can say we like something, point to how happy the client is, or talk about how delighted users will be, but can’t objectively measure feelings. Measuring the success of creative work doesn’t have to stop with feeling. In fact, we can assign it numbers, do math with it, and track improvement to show clients objectively how well our creative is working for them.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>David Ogilvy once said, “If it doesn’t sell, it isn’t creative.” While success may not be a tangible metric for us, it is for our clients. They have hard numbers to meet, and as designers, we owe it to them to think about how our work can meet those goals. We can track sales, sure, but websites are ripe with other opportunities for measuring improvements. Designing for conversions will not only make you a more effective designer or copywriter, it will make you much more valuable to your clients, and that’s something we should all seek out.</p>
<h2>Wait—what’s a conversion?<a class="subhead-anchor" href="#section1">#section1</a></h2>
<p>Before designing for conversions, let’s establish a baseline for what, exactly, we’re talking about. A <em>conversion</em> is an action taken by the user that accomplishes a business goal. If your site sells things, a conversion would be a sale. If you collect user information to achieve your business goals, like lead aggregation, it would be a form submission. Conversions can also be things like newsletter sign-ups or even hits on a page containing important information that you need users to read. You need some tangible action to measure the success of your site—that’s your conversion.</p>
<p>Through analytics, you know how many people are coming to your site. You can use this to measure what percentage of users are converting. This number is your <em>conversion rate</em>, and it’s the single greatest metric for measuring the success of a creative change. In your analytics, you can set up goals and conversion funnels to track this for you (more on conversion funnels shortly). It doesn’t matter how slick that new form looks or how clever that headline is—if the conversion rate drops, it’s not a success. In fact, once you start measuring success by conversion rate, you’ll be surprised to see how even the cleverest designs applied in the wrong places can fail to achieve your goals.</p>
<p>Conversions aren’t always a one-step process. Many of us have multi-step forms or long check-out processes where it can be very useful to track how far a user gets. It’s possible to set up multiple goals along the way so your analytics can give you this data. This is called a <em>conversion funnel</em>. Ideally, you’ll coordinate with the rest of your organization to get data beyond the website as well. For instance, changing button copy may lead to increased form submissions but a drop in conversions from lead to sale afterward. In this case, the button copy update probably confused users rather than selling them on the product. A good conversion funnel will safeguard against false positives like that.</p>
<p>It’s also important to track the <em>bounce rate</em>, which is the percentage of users that hit a page and leave without converting or navigating to other pages. A higher bounce rate is an indication that there’s a mismatch between the user’s expectations when landing on your site and what they find once landing there. Bounce rate is really a part of the conversion funnel, and reducing bounce rate can be just as important as improving conversion rate.</p>
<h2>Great. So how do we do that?<a class="subhead-anchor" href="#section2">#section2</a></h2>
<p>When I was first getting started in conversion-driven design, it honestly felt a little weird. It feels shady to focus obsessively on getting the user to complete an action. But this focus is in no way about tricking the user into doing something they don’t want to do—that’s a bad business model. As Gerry McGovern has commented, if business goals don’t align with customer goals, your business has no future. So if we’re not tricking users, what <em>are</em> we doing?</p>
<p>Users come to your site with a problem, and they’re looking for a solution. The goal is to find users whose problems will be solved by choosing your product. With that in mind, improving the conversion rate doesn’t mean tricking users into doing something—it means showing the <em>right</em> users how to solve their problem. That means making two things clear: that your product will solve the user’s problem, and what the user must do to proceed.</p>
<p>The first of these two points is the <em>value proposition</em>. This is how the user determines whether your product can solve his or her problem. It can be a simple description of the benefits, customer testimonials, or just a statement about what the product will do for the user. A page is not limited to one value proposition—it’s good to have several. (Hint: the page’s headline should almost always be a value proposition!) The user should be able to determine quickly why your product will be helpful in solving their problem. Once the value of your product has been made clear, you need to direct the user to convert with a call to action.</p>
<p>A <em>call to action</em> tells the user what they must do to solve their problem—which, in your case, means to convert. Most buttons and links should be calls to action, but a bit of copy directly following a value proposition is a good place too. Users should never have to look around to find out what the next step is—it should be easy to spot and clear in its intention. Also, ease of access is a big success factor here. My team’s testing found that replacing a Request Information button (that pointed to a form page) with an actual form on every page significantly boosted the conversion rate. If you’re also trying to get information from a user, consider a big form at the top of the page so users can’t miss it. When they scroll down the page and are ready to convert, they remember the form and have no question as to what they have to do.</p>
<p>So improving conversion rate (and, to some degree, decreasing bounce rate) is largely about adding clarity around the value proposition and call to action. There are other factors as well, like decreasing friction in the conversion process and improving performance, but these two things are where the magic happens, and conversion problems are usually problems with one of them.</p>
<h2>So, value propositions…how do I do those?<a class="subhead-anchor" href="#section3">#section3</a></h2>
<p>The number one thing to remember when crafting a value proposition is that you’re not selling a product—you’re selling a solution. Value propositions begin with the user’s problem and focus on that. Users don’t care about the history of your company, how many awards you’ve won, or what clever puns you’ve come up with—they care about whether your product will solve their problem. If they don’t get the impression that it can do that, they will leave and go to a competitor.</p>
<p>In my work with landing pages for career schools, we initially included pictures of people in graduation gowns and caps. We assumed that the most exciting part of going back to school was graduating. Data showed us that we were wrong. Our testing showed that photos of people doing the jobs they would be training for performed much better. In short, our assumption was that showing the product (the school) was more important than showing the benefit (a new career). The problem users were trying to solve wasn’t a diploma—it was a career, and focusing on the user showed a significant improvement in conversion rate.</p>
<p>We had some clients that insisted on using their branding on the landing pages, including one school that wanted to use an eagle as their hero image because their main website had eagles everywhere. This absolutely bombed in conversions. No matter how strong or consistent your branding is, it will not outperform talking about users and their problems.</p>
<p>Websites that get paid for clicks have mastered writing headlines this way. Clickbait headlines get a groan from copywriters—especially since they often use their powers for evil and not good—but there are some important lessons we can learn from them. Take this headline, for instance:</p>
<p><strong>Get an Associate’s degree in nursing</strong></p>
<p>Just like in the example above with the college graduates, we’re selling the product—not the benefit. This doesn’t necessarily show that we understand the user’s problem, and it does nothing to get them excited about our program. Compare that headline to this one:</p>
<p><strong>Is your job stuck in a rut? Get trained for a new career in nursing in only 18 months!</strong></p>
<p>In this case, we lead with the user’s problem. That immediately gets users’ attention. We then skip to a benefit: a quick turnaround. No time is wasted talking about the product—we save that for the body copy. The headline focuses entirely on the user.</p>
<p>In your sign-up or check-out process, always lead with the information the user is most interested in. In our case, letting the user first select their school campus and area of study showed a significant improvement over leading with contact information. Similarly, put the less-exciting content last. In our testing, users were least excited about sharing their telephone number. Moving that field to be the last one in the form decreased form abandonment and improved conversions.</p>
<p>As designers, be cognizant of what your copywriters are doing. If the headline is the primary value proposition (as it should be), make sure the headline is the focal point of your design. Ensure the messaging behind your design is in line with the messaging in the content. If there’s a disagreement in what the user’s problem is or how your product will solve that problem, the conversion rate will suffer.</p>
<p>Once the value proposition has been clearly defined and stated, it’s time to focus on the call to action.</p>
<h2>What about the call to action?<a class="subhead-anchor" href="#section4">#section4</a></h2>
<p>For conversion-driven sites, a good call to action is the most important component. If a user is ready to convert and has insufficient direction on how to do so, you lose a sale at 90 percent completion. It needs to be abundantly clear to the user how to proceed, and that’s where the call to action steps in.</p>
<p>When crafting a call to action, don’t be shy. Buttons should be large, forms should be hard to miss, and language should be imperative. A call to action should be one of the first things the user notices on the page, even if he or she won’t be thinking about it again until after doing some research on the page. Having the next step right in front of the user vastly increases the chance of conversion, so users need to know that it’s there waiting.</p>
<p>That said, a call to action should never get in the way of a value proposition. I see this all the time: a modal window shows as soon as I get to a site, asking me to subscribe to their mailing list before I have an inkling of the value the site can give me. I dismiss these without looking, and that call to action is completely missed. Make it clear <em>how</em> to convert, and make it easy, but don’t ask for a conversion before the user is ready. For situations like the one above, a better strategy might be asking me to subscribe as I exit the site; marketing to visitors who are leaving <a href="https://beeketing.com/blog/best-exit-intent-coupon-pop-ups/">has been shown to be effective</a>.</p>
<p>In my former team’s tests, there were some design choices that could improve calls to action. For instance, picking a bright color that stood out from the rest of the site for the submit button did show an improvement in conversions, and <a href="https://www.ironpaper.com/webintel/articles/content-analytics/">reducing clutter around the call to action improved conversion rates by 232%</a>. But most of the gains here were in either layout or copy; don’t get so caught up in minor design changes that you ignore more significant changes like these.</p>
<p>Ease of access is another huge factor to consider. As mentioned above, when my team was getting started, we had a Request Information link in the main navigation and a button somewhere on the page that would lead the user to the form. The single biggest positive change we saw involved putting a form at the top of every page. For longer forms, we would break this form up into two or three steps, but having that first step in sight was a huge improvement, even if one click doesn’t seem like a lot of effort.</p>
<p>Another important element is headings. Form headings should ask the user to do something. It’s one thing to label a form “Request Information”; it’s another to ask them to “Request Information Now.” Simply adding <a href="https://blog.wishpond.com/post/103290853633/the-25-best-words-to-use-in-your-call-to-action">action words</a>, like “now” or “today,” can change a description into an imperative action and improve conversion rates.</p>
<p>With submit buttons, always take the opportunity to communicate value. The worst thing you can put on a submit button is the word “Submit.” We found that switching this button copy out with “Request Information” showed a significant improvement. Think about the implied direction of the interaction. “Submit” implies the user is giving something to us; “Request Information” implies we’re giving something to the user. The user is already apprehensive about handing over their information—communicate to them that they’re getting something out of the deal.</p>
<p>Changing phrasing to be more personal to the user can also be very effective. One study showed that writing button copy in first person—for instance, “Create My Account” versus “Create Your Account”—<a href="https://unbounce.com/a-b-testing/failed-ab-test-results/">showed a significant boost in conversions</a>, boosting click-through rates by 90%.</p>
<p>Users today are fearful that their information will be used for nefarious purposes. Make it a point to reassure them that their data is safe. Our testing showed that the best way to do this is to add a link to the privacy policy (“Your information is secure!”) with a little lock icon right next to the submit button. Users will often skip right over a small text link, so that lock icon is essential—so essential, in fact, that it may be more important than the privacy policy itself. I’m somewhat ashamed to admit this, but I once forgot to create a page for the privacy policy linked to from a landing page, so that little lock icon linked out to a 404. I expected a small boost in conversions when I finally uploaded the privacy policy, but nope—nobody noticed. Reassurance is a powerful thing.</p>
<h2>Measure, measure, measure<a class="subhead-anchor" href="#section5">#section5</a></h2>
<p>One of the worst things you can do is push out a creative change, assume it’s great, and move on to the next task. <a href="https://alistapart.com/article/a-primer-on-a-b-testing">A/B testing</a> is ideal and will allow you to test a creative change directly against the old creative, eliminating other variables like time, media coverage, and anything else you might not be thinking of. Creative changes should be applied methodically and scientifically—just because two or three changes together show an improvement in conversion rate doesn’t mean that one of them wouldn’t perform better alone.</p>
<p>Measuring tangible things like conversion rate not only helps your client or business, but can also give new purpose to your designs and creative decisions. It’s a lot easier to push for your creative decisions when you have hard data to back up why they’re the best choice for the client or project. Having this data on hand will give you more authority in dealing with clients or marketing folks, which is good for your creative and your career. If my time in the design world has taught me anything, it’s that, in the realm of creativity, certainty can be hard to come by. So, perhaps most importantly, objective measures of success give you, and your client, the reassurance that you’re doing the right thing.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Our own @zeldman paints the complicated catch-22 that our free, democratized web has with our money-making capitalist roots. As creators, how do we untangle this web? #LetsFixThis</div><div class="entry-content">A month of experiencing a temporary disability changed @fcorradini’s perspective on how to take more care when conducting accessibility testing. He shares the impact.</div><div class="entry-content">Jeremy Wagner plots a course to avoid the unnecessary bloat and inaccessible patterns of current JavaScript trends.</div><div class="entry-content">Technology can easily become a platform for hate, and we have an ethical responsibility to fix it. ALA's own Tatiana Mac discusses</div><div class="entry-content">Screen readers are diverse and complex: front-end developer Melanie Richards breaks down how they access our content step-by-step.</div>]]></description>
      <link>https://alistapart.com/article/designing-for-conversions/</link>
      <guid>https://alistapart.com/article/designing-for-conversions/</guid>
      <pubDate>Thu, 14 Feb 2019 03:02:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[Paint the Picture, Not the Frame: How Browsers Provide Everything Users Need]]></title>
      <description><![CDATA[<p>Kip Williams, professor of psychology sciences at Purdue University, conducted <a href="https://en.m.wikipedia.org/wiki/Social_rejection#Ball_toss_/_cyberball_experiments">a fascinating experiment</a> called “cyberball.” In his experiment, a test subject and two other participants played a computer game of catch. At a predetermined time, the test subject was excluded from the game, forcing them to only observe as the clock ran down.</p>
<figure><img src="https://alistapart.com/d/paint-the-picture-not-the-frame/cyberball.jpg" alt="From the cyberball game, three outlined figures playing catch. Player 1 is mid-throw to Player 3." /></figure>

<p>The experience showed increases in self-reported levels of anger and sadness, as well as lowering levels of <a href="https://the-mouse-trap.com/2017/09/09/the-four-needs-for-meaning/">the four needs</a>. The digital version of the experiment created results that matched the results of <a href="https://psycnet.apa.org/record/1999-10159-002">the original physical one</a>, meaning that these feelings occurred regardless of context.</p>
<p>After the game was concluded, the test subject was told that the other participants were robots, not other human participants. Interestingly, the reveal of automated competitors did not lessen the negative feelings reported. In fact, it <em>increased</em> feelings of anger, while also decreasing participants’ sense of willpower and/or self-regulation.</p>
<p>In other words: people who feel they are rejected by a digital system will feel hurt and have their sense of autonomy reduced, even when they believe there isn’t another human directly responsible.</p>
<h2>So, what does this have to with browsers?</h2>
<p>Every adjustment to the appearance and behavior of the features browsers let you manipulate is a roll of the dice, gambling on the delight of some at the expense of alienating others.</p>
<p>When using a browser to navigate the web, there’s <a href="https://louderthanten.com/coax/design-machines">a lot of sameness</a>, until there isn’t. Most of the time we’re hopping from page-to-page and site-to-site, clicking links, pressing buttons, watching videos, filling out forms, writing messages, etc. But every once in awhile we stumble across something new and novel that makes us pause to figure out what’s going on.</p>
<p>Every website and web app is its own self-contained experience, with its own ideas of how things should look and behave. Some are closer to others, but each one requires learning how to operate the interface to a certain degree.</p>
<p>Some browsers can also have parts of their functionality and appearance altered, meaning that as with websites, there can be unexpected discrepancies. We’ll unpack some of the nuance behind some of these features, and more importantly, why most of them are better off left alone.</p>
<h2>Scroll-to-top</h2>
<p>All the major desktop browsers allow you to hit the <kbd>Home</kbd> key on the keyboard to jump to the top of the page. Some scrollbar implementations allow you to click on the top of the scrollbar area to do the same. Some browsers allow you to type <kbd>Command+Up</kbd> (macOS) / <kbd>Ctrl+Up</kbd> (Windows), as well. People who use assistive technology like screen readers can use things like <a href="https://www.w3.org/TR/wai-aria-practices/examples/landmarks/">banner landmarks</a> to navigate the same way (provided they are correctly declared in the site’s HTML).</p>
<p>However, not every device has an easily discoverable way to invoke this functionality: many laptops don’t have a <kbd>Home</kbd> key on their keyboard. The <a href="https://9to5mac.com/2018/03/02/how-to-jump-top-of-webpages-twitter-facebook-iphone/">tap-the-clock-to-jump-to-the-top</a> functionality on iOS is difficult to discover, and can be surprising and frustrating if accidentally activated. You need <a href="https://matatk.agrip.org.uk/landmarks/">specialized browser extensions</a> to recreate screen reader landmark navigation techniques.</p>
<p>One commonly implemented UI solution for longer pages is the scroll-to-top button. It’s often fixed to the bottom-right corner of the screen. Activating this control will take the user to the top of the page, regardless of how far down they’ve scrolled.</p>
<p>If your site features a large amount of content per page, it may be worth investigating this UI pattern. Try looking at analytics and/or conducting user tests to see where and how often this feature is used. The caveat being if it’s used too often, it might be worth taking a long, hard look at your information architecture and content strategy.</p>
<p>Three things I like about the scroll-to-top pattern are:</p>
<ul><li>Its functionality is pretty obvious (especially if properly labeled).</li>
<li>Provided it is designed well, it can provide a decent-sized touch target in <a href="https://usabilla.com/blog/designing-thumbs-thumb-zone/">a thumb-friendly area</a>. For <a href="https://webaim.org/articles/motor/motordisabilities">motor control considerations</a>, its touch target can be superior to narrow scroll or status bars, which can make for frustratingly small targets to hit.</li>
<li>It does not alter or remove existing scroll behavior, augmenting it instead. If somebody is used to one way of scrolling to the top, you’re not overriding it or interrupting it.</li>
</ul><p>If you’re implementing this sort of functionality, I have four requests to help make the experience work for everyone (I find the <a href="https://github.com/cferdinandi/smooth-scroll">Smooth Scroll</a> library to be a helpful starting place):</p>
<ul><li>Honor user requests for <a href="https://css-tricks.com/introduction-reduced-motion-media-query/">reduced motion</a>. The dramatic scrolling effect of whipping from the bottom of the page to the top may be a <a href="http://reverttosaved.com/2018/10/16/trying-to-explain-reduce-motion-to-designers-who-dont-have-a-vestibular-disorder/">vestibular trigger</a>, a situation where the system that controls your body’s sense of physical position and orientation in the world is disrupted, causing things like headaches, nausea, vertigo, migraines, and hearing loss.</li>
<li>Ensure keyboard focus is moved to the top of the document, mirroring what occurs visually. Applying this practice will improve <em>all</em> users’ experiences. Otherwise, hitting <kbd>Tab</kbd> after scrolling to the top would send the user down to the first interactive element that follows where the focus had been before they activated the scroll button.</li>
<li>Ensure the button does not make other content unusable by obscuring it. Be sure to account for when the browser is in a zoomed-in state, not just in its default state.</li>
<li>Be mindful of other fixed-position elements. I’ve seen my fair share of websites that also have a chatbot or <a href="https://material.io/design/components/buttons-floating-action-button.html">floating action button</a> competing to live in the same space.</li>
</ul><figure><img src="https://alistapart.com/d/paint-the-picture-not-the-frame/floating-button.jpg" alt="A red chat icon overlaps with a corner of the scroll to top icon, obscuring a portion of the arrow." /></figure><h2>Scrollbars</h2>
<p>If you’re old enough to remember, it was once considered fashionable to style your website scrollbars. Internet Explorer allowed this customization via <a href="https://www.hongkiat.com/blog/css-scroll-bar/">a series of vendor-specific properties</a>. At best, they looked great! If the designer and developer were both skilled and detail-oriented, you’d get something that looked like a natural extension of the rest of the website.</p>
<p>However, the stakes for a quality design were pretty high: scrollbars are part of an application’s interface, not a website’s. In inclusive design, it’s part of what we call <a href="https://developer.paciellogroup.com/blog/2017/08/inclusive-design-principle-be-consistent/#culturalconsistency"><em>external consistency</em></a>. External consistency is the idea that an object’s functionality is informed and reinforced by similar implementations elsewhere. It’s why you can flip a wall switch in most houses and be guaranteed the lights come on instead of flushing the toilet.</p>
<p>While scrollbars have some minor visual differences between operating systems (and <a href="https://imgur.com/a/q7nojaU">operating system versions</a>), they’re consistent externally in function. Scrollbars are also consistent internally, in that every window and program on the OS that requires scrolling has the same scrollbar treatment.</p>
<p>If you customize your website’s scrollbar colors, for less technologically literate people, yet another aspect of the interface has changed without warning or instruction on how to change it back. If the user is already confused about how things on the screen work, it’s one less familiar thing for them to cling to as stable and reliable.</p>
<p>You might be rolling your eyes reading this, but I’d ask you to check out <a href="https://jboriss.wordpress.com/2011/07/06/user-testing-in-the-wild-joes-first-computer-encounter/">this incredible article by Jennifer Morrow</a> instead. In it, she describes conducting a guerilla user test at a mall, only to have the session completely derailed when she discovers someone who has never used a computer before.</p>
<p>What she discovers is as important as it is shocking. The gist of it is that some people (even those who have used a computer before) don’t understand the nuance of the various “layers” you navigate through to operate a computer: the hardware, the OS, the browser installed on the OS, the website the browser is displaying, the website’s modals and disclosure statements, etc. To them, the experience is flat.</p>
<p>We should not expect these users to juggle this kind of cognitive overhead. These kinds of abstractions are crafted to be <a href="https://uxplanet.org/radio-buttons-ux-design-588e5c0a50dc#6500">analogous to real-world objects</a>, specifically so people can get what they want from a digital system without having to be programmers. Adding unnecessary complexity weakens these metaphors and gives users one less reference point to rely on.</p>
<p>Remember the cyberball experiment. When a user is already in a distressed emotional state, our poorly-designed custom scrollbar might be the death-by-a-thousand-paper-cuts moment where they give up on trying to get what they want and reject the system entirely.</p>
<p>While Morrow’s article was written in 2011, it’s just as relevant now as it was then. More and more people are using the internet globally, and more and more services integral to living daily life are getting digitized. It’s up to us as responsible designers and developers to be sure we make everyone, regardless of device, circumstance, or ability feel welcome.</p>
<p>In addition to unnecessarily abandoning external consistency, there is the issue of custom scrollbar styling potentially not having <a href="https://a11yproject.com/posts/what-is-color-contrast/">sufficient color contrast</a>. The too-light colors can create a situation where a person experiencing low-vision conditions won’t be able to perceive, and therefore operate, a website’s scrolling mechanism.</p>
<p>This article won’t even begin to unpack the issues involved with custom implementations of scrollbars, where instead of theming the OS’s native scrollbars with CSS, one instead replaces them with a JavaScript solution. Trust me when I say I have yet to see one implemented in a way that could successfully and reliably recreate all features and functionality across all <a href="https://manuals.playstation.net/document/en/ps4/browser/browse.html">devices</a>, OSes, browsers, and <a href="https://medium.com/@mandy.michael/building-websites-for-safari-reader-mode-and-other-reading-apps-1562913c86c9">browsing modes</a>.</p>
<p>In my opinion? Don’t alter the default appearance of an OS’s scrollbars. Use that time to work on something else instead, say, checking for and fixing color contrast problems.</p>
<h2>Scrolling</h2>
<p>The main concern about altering scrolling behavior is one of consent: it’s taking an externally consistent, system-wide behavior and suddenly altering it without permission. The term <em>scrolljacking</em> has been coined to describe this practice. It is not to be confused with <a href="https://pudding.cool/process/how-to-implement-scrollytelling/"><em>scrollytelling</em></a>, a more considerate treatment of scrolling behavior that honors the OS’s scrolling settings.</p>
<p>Altering the scrolling behavior on your website or web app can fly in the face of someone’s specific, expressed preferences. For some people, it’s simply an annoyance. For people with motor control concerns, it could make moving through a site difficult. In some extreme cases, the unannounced discrepancy between the amount of scrolling and the distance traveled can also be vestibular triggers. Another consideration is if your modified scrolling behavior <a href="https://www.sitepoint.com/scrolljacking-accessibility/">accidentally locks out people</a> who don’t use mice, touch, or trackpads to scroll.</p>
<p>All in all, I think <a href="https://robinrendle.com/notes/scrolljacking/">Robin Rendle said it best</a>:</p>
<figure class="quote"><blockquote>
<p>Scrolljacking, as I shall now refer to it both sarcastically and honestly, is a failure of the web designer’s first objective; it attacks a standardised pattern and greedily assumes control over the user’s input.</p>
</blockquote>
</figure><h2>Highlighting</h2>
<p>Another OS feature we’re permitted to style in the browser is highlighted text. Much like scrollbars, this is an interface element that is shared by all apps on the OS, not just the browser.</p>
<p>Breaking the external consistency of the OS’s highlighting color has a lot of the same concerns as styled scrollbars, namely altering the expected behavior of something that functions reliably everywhere else. It’s potentially disorienting and alienating, and may deny someone’s expressed preferences.</p>
<p>Some people highlight text as they read. If your custom highlight style has a low contrast ratio between the highlighted text color and the highlighted text’s background color, the person reading your website or web app may be unable to perceive the text they’re highlighting. The effect will cause the text to seemingly disappear as they try to read.</p>
<p>Other people just may not care for your aesthetic sensibilities. Both macOS and Windows allow you to specify a custom highlight color. In a scenario where someone has deliberately set a preference other than the system default, a styled highlight color may override their stated specifications.</p>
<p>For me, the potential risks far outweigh the vanity of a bespoke highlight style—better to just leave it be.</p>
<h2>Text resizing</h2>
<p><a href="https://medium.com/@vamptvo/pixels-vs-ems-users-do-change-font-size-5cfb20831773">Lots of people change text size</a> to suit their needs. And that’s a good thing. We want people to be able to read our content and act upon it, regardless of whatever circumstances they may be experiencing.</p>
<p>For the problem of too-small text, some designers turn to text resizing widgets, a custom UI pattern that lets a person cycle through a number of preset CSS <code>font-size</code> values. Commonly found in places with heavy text content, text resizing widgets are often paired with complex, multicolumn designs. News sites are a common example.</p>
<p>Before I dive into my concerns with text resizing widgets, I want to ask: if you find that your site needs a specialized widget to manage your text size, why not just take the simpler route and <a href="https://cushionapp.com/journal/improving-readability">increase your base text size</a>?</p>
<p>Like many <a href="https://thatcrazycrippledchick.blogspot.com/2013/12/this-is-what-disability-binarism-looks.html">accessibility concerns</a>, a request for a larger font size isn’t necessarily indicative of <a href="https://medium.com/@mosaicofminds/a-disability-is-a-mismatch-between-a-persons-abilities-and-their-environment-cc39e29e8e74">a permanent disability condition</a>. It’s often circumstantial, such as a situation where you’re showing a website on your office’s crappy projector.</p>
<p>Browsers allow users to change their preferred default font size, resizing text across websites accordingly. Browsers excel at handling this setting when you write CSS that takes advantage of <a href="https://allthingssmitty.com/2017/01/30/nope-nope-nope-line-height-is-unitless/">unitless <code>line-height</code> values</a> and <a href="https://thecssworkshop.com/lessons/relative-units">relative <code>font-size</code> units</a>.</p>
<p>Some designers may feel that granting this liberty to users somehow detracts from their intended branding. Good designers understand that there’s more to branding than just how something looks. It’s about implementing the initial design in the browser, then <a href="https://css-tricks.com/building-resizeable-components-relative-css-units/">working <em>with</em> the browser’s capabilities</a> to best serve the person using it. Even if things like the font size are adjusted, a strong brand will still shine through with the ease of your user flows, quality of your typography and palette, strength of your copywriting, etc.</p>
<p>Unfortunately, custom browser text resizing widgets lack a universal approach. If you rely on browser text settings, it just works—consistently, with the same controls, gestures, and keyboard shortcuts, for every page on every website, even in <a href="https://kryogenix.org/code/browser/everyonehasjs.html">less-than-ideal conditions</a>. You don’t have to write and maintain extra code, test for regressions, or write copy instructing the user on where to find your site’s text resizing widget and how to use it.</p>
<p>Behavioral consistency is incredibly important. Browser text resizing is applied to all text on the page proportionately every time the setting is changed. These settings are also retained for the next time you visit. Not every custom text resizing widget does this, nor will it resize all content to <a href="https://www.w3.org/TR/UNDERSTANDING-WCAG20/visual-audio-contrast-scale.html">the degree stipulated by the Web Content Accessibility Guidelines</a>.</p>
<h2>High-contrast themes</h2>
<p>When I say high-contrast themes, I’m not talking about things like a <a href="https://paulmillr.com/posts/using-dark-mode-in-css/">dark mode</a>. I’m talking about a response to people reporting that they need to <a href="https://accessibility.blog.gov.uk/2017/03/27/how-users-change-colours-on-websites/">change your website or web app’s colors</a> to be more visually accessible to them.</p>
<p>Much like text resizing controls, themes that are designed to provide higher contrast color values are perplexing: if you’re taking the time to make one, why not just fix the insufficient contrast values in your regular CSS? Effectively <a href="https://csswizardry.com/2016/10/pragmatic-practical-progressive-theming-with-custom-properties/">managing themes in CSS</a> is a complicated, resource-intensive affair, even under ideal situations.</p>
<p>Most site-provided high-contrast themes are static in that the designer or developer made decisions about which color values to use, which can be a problem. Too much contrast has been known to be a trigger for things like migraines, as well as potentially making it difficult to focus for users with some forms of attention-deficit hyperactivity disorder (ADHD).</p>
<p>The contrast conundrum leads us to a difficult thing to come to terms with when it comes to accessibility: what works for one person may actually inhibit another. Because of this, it’s important to make things open and interoperable. Leave ultimate control up to the end user so they may decide how to best interact with content.</p>
<p>If you are going to follow through on providing this kind of feature, some advice: <a href="https://support.microsoft.com/en-us/help/13862/windows-use-high-contrast-mode">model it after the Windows High Contrast mode</a>. It’s a specialized Windows feature that allows a person to force a high color palette onto all aspects of the OS’s UI, including anything the browser displays. It offers four themes out of the box but also allows a user to suit their individual needs by specifying their own colors.</p>
<p>Your high contrast mode feature should do the same. Offer a range of themes with different palettes, and let the user pick colors that work best for them—it will guarantee that if your offerings fail, people still have the ability to self-select.</p>
<h2>Moving focus</h2>
<p>Keyboard focus is how people who rely on input such as keyboards, switch controls, voice inputs, eye tracking, and <a href="https://webaim.org/articles/motor/assistive">other forms of assistive technology</a> navigate and operate digital interfaces. While you can do things like use <a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#autofocus">the <code>autofocus</code> attribute</a> to move keyboard focus to the first input on a page after it loads, it is not recommended.</p>
<p>For people experiencing low- and no-vision conditions, it is equivalent to being abruptly and instantaneously moved to a new location. It’s a confusing and disorienting experience—there’s a reason why there’s a trope in sci-fi movies of people vomiting after being teleported for the first time.</p>
<p>For people with motor control concerns, moving focus without their permission means they may be transported to a place where they didn’t intend to go. Digging themselves out of this location becomes annoying at best and effort-intensive at worst. Websites without <a href="https://webdesign.tutsplus.com/articles/the-importance-of-heading-levels-for-assistive-technology--cms-31753">heading elements</a> or document landmarks to serve as navigational aids can worsen this effect.</p>
<p>This is all about consent. Moving focus is fine so long as a person deliberately initiates an action that requires it (<a href="https://developer.paciellogroup.com/blog/2018/06/the-current-state-of-modal-dialog-accessibility/">shifting focus to an opened modal</a>, for example). I don’t come to your house and force you to click on things, so don’t move my keyboard focus unless I specifically ask you to.</p>
<p>Let the browser handle keyboard focus. Provided you use semantic markup, browsers do this well. Some tips:</p>
<ul><li>Use <a href="https://developer.paciellogroup.com/blog/2014/08/using-the-tabindex-attribute/">the <code>tabindex</code> attribute</a> with care and discretion.</li>
<li>Don’t declare <code>tabindex</code> on interactive elements (<code>a</code>, <code>button</code>, <code>input</code>, <code>select</code>, <code>summary</code>, and <code>textarea</code>).</li>
<li>Don’t use <a href="http://www.karlgroves.com/2018/11/13/why-using-tabindex-values-greater-than-0-is-bad/">a manually curated <code>tabindex</code> order</a> that runs parallel to what you’d expect a user to click on. Instead, author your HTML in such a way that the resulting DOM <a href="https://www.w3.org/TR/WCAG20-TECHS/C27.html">matches the visual order of the page</a>. Taking a <a href="https://www.levelaccess.com/what-does-responsive-web-design-have-to-do-with-accessibility/">responsive, mobile first approach</a> helps out a lot here.</li>
</ul><h2>The clipboard and browser history</h2>
<p>The clipboard is sacred space. Don’t prevent people from copying things to it, and don’t append extra content to what they copy. The same goes for browser history and back and forward buttons. Don’t mess around with time travel, and just let the browser do its job.</p>
<h2>Wrapping up</h2>
<p>In the game part of cyberball, the fun comes from being able to participate with others, passing the ball back and forth. With the web, fun comes from being able to navigate through it. In both situations, fun stops when people get locked out, forced to watch passively from the sidelines.</p>
<p>Fortunately, the web doesn’t have to be one long cyberball experiment. While altering the powerful, assistive technology-friendly features of browsers can enhance the experience for some users, it carries a great risk of alienating others if changes are made with ignorance about exactly how much will be affected.</p>
<p>Remember that this is all in the service of what ultimately matters: creating robust experiences that allow people to successfully use your website or web app regardless of their ability or circumstance. Sometimes the best strategy is to let things be.</p>
<footer class="entry-footer nocontent"><h1>About the Author</h1>
<div class="byline author vcard"><a class="photo" href="https://alistapart.com/author/ericbailey"><img src="https://alistapart.com/d/_made/pix/authors/photos/eric-bailey_120_120_c1.jpg" alt="Image of Eric Bailey" /></a>
<h2>
Eric Bailey is a Boston-based designer who helps create straightforward solutions that address a person’s practical, physical, cognitive, and emotional needs using accessible, performant, device-agnostic technology. He's an inclusive design advocate, <a href="https://a11yproject.com/">A11Y Project</a> maintainer, <a href="https://developer.mozilla.org/en-US/docs/Web">MDN Web Docs</a> contributor, and recovering curmudgeon.</h2></div>

</footer>]]></description>
      <link>http://alistapart.com/article/paint-the-picture-not-the-frame</link>
      <guid>http://alistapart.com/article/paint-the-picture-not-the-frame</guid>
      <pubDate>Thu, 07 Feb 2019 02:02:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[<![CDATA[ Paint the Picture, Not the Frame: How Browsers Provide Everything Users Need ]]]]><![CDATA[>]]></title>
      <description><![CDATA[<div class="entry-content">
<p>Kip Williams, professor of psychology sciences at Purdue University, conducted <a href="https://en.m.wikipedia.org/wiki/Social_rejection#Ball_toss_/_cyberball_experiments">a fascinating experiment</a> called “cyberball.” In his experiment, a test subject and two other participants played a computer game of catch. At a predetermined time, the test subject was excluded from the game, forcing them to only observe as the clock ran down.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<figure><img src="https://alistapart.com/wp-content/uploads/2019/02/cyberball.jpg" alt="From the cyberball game, three outlined figures playing catch. Player 1 is mid-throw to Player 3." /><br /></figure><p>The experience showed increases in self-reported levels of anger and sadness, as well as lowering levels of <a href="https://the-mouse-trap.com/2017/09/09/the-four-needs-for-meaning/">the four needs</a>. The digital version of the experiment created results that matched the results of <a href="https://psycnet.apa.org/record/1999-10159-002">the original physical one</a>, meaning that these feelings occurred regardless of context.</p>
<p>After the game was concluded, the test subject was told that the other participants were robots, not other human participants. Interestingly, the reveal of automated competitors did not lessen the negative feelings reported. In fact, it <em>increased</em> feelings of anger, while also decreasing participants’ sense of willpower and/or self-regulation.</p>
<p>In other words: people who feel they are rejected by a digital system will feel hurt and have their sense of autonomy reduced, even when they believe there isn’t another human directly responsible.</p>
<h2>So, what does this have to with browsers?<a class="subhead-anchor" href="#section1">#section1</a></h2>
<p>Every adjustment to the appearance and behavior of the features browsers let you manipulate is a roll of the dice, gambling on the delight of some at the expense of alienating others.</p>
<p>When using a browser to navigate the web, there’s <a href="https://louderthanten.com/coax/design-machines">a lot of sameness</a>, until there isn’t. Most of the time we’re hopping from page-to-page and site-to-site, clicking links, pressing buttons, watching videos, filling out forms, writing messages, etc. But every once in awhile we stumble across something new and novel that makes us pause to figure out what’s going on.</p>
<p>Every website and web app is its own self-contained experience, with its own ideas of how things should look and behave. Some are closer to others, but each one requires learning how to operate the interface to a certain degree.</p>
<p>Some browsers can also have parts of their functionality and appearance altered, meaning that as with websites, there can be unexpected discrepancies. We’ll unpack some of the nuance behind some of these features, and more importantly, why most of them are better off left alone.</p>
<h2>Scroll-to-top<a class="subhead-anchor" href="#section2">#section2</a></h2>
<p>All the major desktop browsers allow you to hit the <kbd>Home</kbd> key on the keyboard to jump to the top of the page. Some scrollbar implementations allow you to click on the top of the scrollbar area to do the same. Some browsers allow you to type <kbd>Command+Up</kbd> (macOS) / <kbd>Ctrl+Up</kbd> (Windows), as well. People who use assistive technology like screen readers can use things like <a href="https://www.w3.org/TR/wai-aria-practices/examples/landmarks/">banner landmarks</a> to navigate the same way (provided they are correctly declared in the site’s HTML).</p>
<p>However, not every device has an easily discoverable way to invoke this functionality: many laptops don’t have a <kbd>Home</kbd> key on their keyboard. The <a href="https://9to5mac.com/2018/03/02/how-to-jump-top-of-webpages-twitter-facebook-iphone/">tap-the-clock-to-jump-to-the-top</a> functionality on iOS is difficult to discover, and can be surprising and frustrating if accidentally activated. You need <a href="https://matatk.agrip.org.uk/landmarks/">specialized browser extensions</a> to recreate screen reader landmark navigation techniques.</p>
<p>One commonly implemented UI solution for longer pages is the scroll-to-top button. It’s often fixed to the bottom-right corner of the screen. Activating this control will take the user to the top of the page, regardless of how far down they’ve scrolled.</p>
<p>If your site features a large amount of content per page, it may be worth investigating this UI pattern. Try looking at analytics and/or conducting user tests to see where and how often this feature is used. The caveat being if it’s used too often, it might be worth taking a long, hard look at your information architecture and content strategy.</p>
<p>Three things I like about the scroll-to-top pattern are:</p>
<ul><li>Its functionality is pretty obvious (especially if properly labeled).</li>
<li>Provided it is designed well, it can provide a decent-sized touch target in <a href="https://usabilla.com/blog/designing-thumbs-thumb-zone/">a thumb-friendly area</a>. For <a href="https://webaim.org/articles/motor/motordisabilities">motor control considerations</a>, its touch target can be superior to narrow scroll or status bars, which can make for frustratingly small targets to hit.</li>
<li>It does not alter or remove existing scroll behavior, augmenting it instead. If somebody is used to one way of scrolling to the top, you’re not overriding it or interrupting it.</li>
</ul><p>If you’re implementing this sort of functionality, I have four requests to help make the experience work for everyone (I find the <a href="https://github.com/cferdinandi/smooth-scroll">Smooth Scroll</a> library to be a helpful starting place):</p>
<ul><li>Honor user requests for <a href="https://css-tricks.com/introduction-reduced-motion-media-query/">reduced motion</a>. The dramatic scrolling effect of whipping from the bottom of the page to the top may be a <a href="http://reverttosaved.com/2018/10/16/trying-to-explain-reduce-motion-to-designers-who-dont-have-a-vestibular-disorder/">vestibular trigger</a>, a situation where the system that controls your body’s sense of physical position and orientation in the world is disrupted, causing things like headaches, nausea, vertigo, migraines, and hearing loss.</li>
<li>Ensure keyboard focus is moved to the top of the document, mirroring what occurs visually. Applying this practice will improve <em>all</em> users’ experiences. Otherwise, hitting <kbd>Tab</kbd> after scrolling to the top would send the user down to the first interactive element that follows where the focus had been before they activated the scroll button.</li>
<li>Ensure the button does not make other content unusable by obscuring it. Be sure to account for when the browser is in a zoomed-in state, not just in its default state.</li>
<li>Be mindful of other fixed-position elements. I’ve seen my fair share of websites that also have a chatbot or <a href="https://material.io/design/components/buttons-floating-action-button.html">floating action button</a> competing to live in the same space.</li>
</ul><figure><img src="https://alistapart.com/wp-content/uploads/2019/02/floating-button.jpg" alt="A red chat icon overlaps with a corner of the scroll to top icon, obscuring a portion of the arrow." /><br /></figure><h2>Scrollbars<a class="subhead-anchor" href="#section3">#section3</a></h2>
<p>If you’re old enough to remember, it was once considered fashionable to style your website scrollbars. Internet Explorer allowed this customization via <a href="https://www.hongkiat.com/blog/css-scroll-bar/">a series of vendor-specific properties</a>. At best, they looked great! If the designer and developer were both skilled and detail-oriented, you’d get something that looked like a natural extension of the rest of the website.</p>
<p>However, the stakes for a quality design were pretty high: scrollbars are part of an application’s interface, not a website’s. In inclusive design, it’s part of what we call <a href="https://developer.paciellogroup.com/blog/2017/08/inclusive-design-principle-be-consistent/#culturalconsistency"><em>external consistency</em></a>. External consistency is the idea that an object’s functionality is informed and reinforced by similar implementations elsewhere. It’s why you can flip a wall switch in most houses and be guaranteed the lights come on instead of flushing the toilet.</p>
<p>While scrollbars have some minor visual differences between operating systems (and <a href="https://imgur.com/a/q7nojaU">operating system versions</a>), they’re consistent externally in function. Scrollbars are also consistent internally, in that every window and program on the OS that requires scrolling has the same scrollbar treatment.</p>
<p>If you customize your website’s scrollbar colors, for less technologically literate people, yet another aspect of the interface has changed without warning or instruction on how to change it back. If the user is already confused about how things on the screen work, it’s one less familiar thing for them to cling to as stable and reliable.</p>
<p>You might be rolling your eyes reading this, but I’d ask you to check out <a href="https://jboriss.wordpress.com/2011/07/06/user-testing-in-the-wild-joes-first-computer-encounter/">this incredible article by Jennifer Morrow</a> instead. In it, she describes conducting a guerilla user test at a mall, only to have the session completely derailed when she discovers someone who has never used a computer before.</p>
<p>What she discovers is as important as it is shocking. The gist of it is that some people (even those who have used a computer before) don’t understand the nuance of the various “layers” you navigate through to operate a computer: the hardware, the OS, the browser installed on the OS, the website the browser is displaying, the website’s modals and disclosure statements, etc. To them, the experience is flat.</p>
<p>We should not expect these users to juggle this kind of cognitive overhead. These kinds of abstractions are crafted to be <a href="https://uxplanet.org/radio-buttons-ux-design-588e5c0a50dc#6500">analogous to real-world objects</a>, specifically so people can get what they want from a digital system without having to be programmers. Adding unnecessary complexity weakens these metaphors and gives users one less reference point to rely on.</p>
<p>Remember the cyberball experiment. When a user is already in a distressed emotional state, our poorly-designed custom scrollbar might be the death-by-a-thousand-paper-cuts moment where they give up on trying to get what they want and reject the system entirely.</p>
<p>While Morrow’s article was written in 2011, it’s just as relevant now as it was then. More and more people are using the internet globally, and more and more services integral to living daily life are getting digitized. It’s up to us as responsible designers and developers to be sure we make everyone, regardless of device, circumstance, or ability feel welcome.</p>
<p>In addition to unnecessarily abandoning external consistency, there is the issue of custom scrollbar styling potentially not having <a href="https://a11yproject.com/posts/what-is-color-contrast/">sufficient color contrast</a>. The too-light colors can create a situation where a person experiencing low-vision conditions won’t be able to perceive, and therefore operate, a website’s scrolling mechanism.</p>
<p>This article won’t even begin to unpack the issues involved with custom implementations of scrollbars, where instead of theming the OS’s native scrollbars with CSS, one instead replaces them with a JavaScript solution. Trust me when I say I have yet to see one implemented in a way that could successfully and reliably recreate all features and functionality across all <a href="https://manuals.playstation.net/document/en/ps4/browser/browse.html">devices</a>, OSes, browsers, and <a href="https://medium.com/@mandy.michael/building-websites-for-safari-reader-mode-and-other-reading-apps-1562913c86c9">browsing modes</a>.</p>
<p>In my opinion? Don’t alter the default appearance of an OS’s scrollbars. Use that time to work on something else instead, say, checking for and fixing color contrast problems.</p>
<h2>Scrolling<a class="subhead-anchor" href="#section4">#section4</a></h2>
<p>The main concern about altering scrolling behavior is one of consent: it’s taking an externally consistent, system-wide behavior and suddenly altering it without permission. The term <em>scrolljacking</em> has been coined to describe this practice. It is not to be confused with <a href="https://pudding.cool/process/how-to-implement-scrollytelling/"><em>scrollytelling</em></a>, a more considerate treatment of scrolling behavior that honors the OS’s scrolling settings.</p>
<p>Altering the scrolling behavior on your website or web app can fly in the face of someone’s specific, expressed preferences. For some people, it’s simply an annoyance. For people with motor control concerns, it could make moving through a site difficult. In some extreme cases, the unannounced discrepancy between the amount of scrolling and the distance traveled can also be vestibular triggers. Another consideration is if your modified scrolling behavior <a href="https://www.sitepoint.com/scrolljacking-accessibility/">accidentally locks out people</a> who don’t use mice, touch, or trackpads to scroll.</p>
<p>All in all, I think <a href="https://robinrendle.com/notes/scrolljacking/">Robin Rendle said it best</a>:</p>
<figure class="quote"><blockquote>
<p>Scrolljacking, as I shall now refer to it both sarcastically and honestly, is a failure of the web designer’s first objective; it attacks a standardised pattern and greedily assumes control over the user’s input.</p>
</blockquote>
</figure><h2>Highlighting<a class="subhead-anchor" href="#section5">#section5</a></h2>
<p>Another OS feature we’re permitted to style in the browser is highlighted text. Much like scrollbars, this is an interface element that is shared by all apps on the OS, not just the browser.</p>
<p>Breaking the external consistency of the OS’s highlighting color has a lot of the same concerns as styled scrollbars, namely altering the expected behavior of something that functions reliably everywhere else. It’s potentially disorienting and alienating, and may deny someone’s expressed preferences.</p>
<p>Some people highlight text as they read. If your custom highlight style has a low contrast ratio between the highlighted text color and the highlighted text’s background color, the person reading your website or web app may be unable to perceive the text they’re highlighting. The effect will cause the text to seemingly disappear as they try to read.</p>
<p>Other people just may not care for your aesthetic sensibilities. Both macOS and Windows allow you to specify a custom highlight color. In a scenario where someone has deliberately set a preference other than the system default, a styled highlight color may override their stated specifications.</p>
<p>For me, the potential risks far outweigh the vanity of a bespoke highlight style—better to just leave it be.</p>
<h2>Text resizing<a class="subhead-anchor" href="#section6">#section6</a></h2>
<p><a href="https://medium.com/@vamptvo/pixels-vs-ems-users-do-change-font-size-5cfb20831773">Lots of people change text size</a> to suit their needs. And that’s a good thing. We want people to be able to read our content and act upon it, regardless of whatever circumstances they may be experiencing.</p>
<p>For the problem of too-small text, some designers turn to text resizing widgets, a custom UI pattern that lets a person cycle through a number of preset CSS <code>font-size</code> values. Commonly found in places with heavy text content, text resizing widgets are often paired with complex, multicolumn designs. News sites are a common example.</p>
<p>Before I dive into my concerns with text resizing widgets, I want to ask: if you find that your site needs a specialized widget to manage your text size, why not just take the simpler route and <a href="https://cushionapp.com/journal/improving-readability">increase your base text size</a>?</p>
<p>Like many <a href="https://thatcrazycrippledchick.blogspot.com/2013/12/this-is-what-disability-binarism-looks.html">accessibility concerns</a>, a request for a larger font size isn’t necessarily indicative of <a href="https://medium.com/@mosaicofminds/a-disability-is-a-mismatch-between-a-persons-abilities-and-their-environment-cc39e29e8e74">a permanent disability condition</a>. It’s often circumstantial, such as a situation where you’re showing a website on your office’s crappy projector.</p>
<p>Browsers allow users to change their preferred default font size, resizing text across websites accordingly. Browsers excel at handling this setting when you write CSS that takes advantage of <a href="https://allthingssmitty.com/2017/01/30/nope-nope-nope-line-height-is-unitless/">unitless <code>line-height</code> values</a> and <a href="https://thecssworkshop.com/lessons/relative-units">relative <code>font-size</code> units</a>.</p>
<p>Some designers may feel that granting this liberty to users somehow detracts from their intended branding. Good designers understand that there’s more to branding than just how something looks. It’s about implementing the initial design in the browser, then <a href="https://css-tricks.com/building-resizeable-components-relative-css-units/">working <em>with</em> the browser’s capabilities</a> to best serve the person using it. Even if things like the font size are adjusted, a strong brand will still shine through with the ease of your user flows, quality of your typography and palette, strength of your copywriting, etc.</p>
<p>Unfortunately, custom browser text resizing widgets lack a universal approach. If you rely on browser text settings, it just works—consistently, with the same controls, gestures, and keyboard shortcuts, for every page on every website, even in <a href="https://kryogenix.org/code/browser/everyonehasjs.html">less-than-ideal conditions</a>. You don’t have to write and maintain extra code, test for regressions, or write copy instructing the user on where to find your site’s text resizing widget and how to use it.</p>
<p>Behavioral consistency is incredibly important. Browser text resizing is applied to all text on the page proportionately every time the setting is changed. These settings are also retained for the next time you visit. Not every custom text resizing widget does this, nor will it resize all content to <a href="https://www.w3.org/TR/UNDERSTANDING-WCAG20/visual-audio-contrast-scale.html">the degree stipulated by the Web Content Accessibility Guidelines</a>.</p>
<h2>High-contrast themes<a class="subhead-anchor" href="#section7">#section7</a></h2>
<p>When I say high-contrast themes, I’m not talking about things like a <a href="https://paulmillr.com/posts/using-dark-mode-in-css/">dark mode</a>. I’m talking about a response to people reporting that they need to <a href="https://accessibility.blog.gov.uk/2017/03/27/how-users-change-colours-on-websites/">change your website or web app’s colors</a> to be more visually accessible to them.</p>
<p>Much like text resizing controls, themes that are designed to provide higher contrast color values are perplexing: if you’re taking the time to make one, why not just fix the insufficient contrast values in your regular CSS? Effectively <a href="https://csswizardry.com/2016/10/pragmatic-practical-progressive-theming-with-custom-properties/">managing themes in CSS</a> is a complicated, resource-intensive affair, even under ideal situations.</p>
<p>Most site-provided high-contrast themes are static in that the designer or developer made decisions about which color values to use, which can be a problem. Too much contrast has been known to be a trigger for things like migraines, as well as potentially making it difficult to focus for users with some forms of attention-deficit hyperactivity disorder (ADHD).</p>
<p>The contrast conundrum leads us to a difficult thing to come to terms with when it comes to accessibility: what works for one person may actually inhibit another. Because of this, it’s important to make things open and interoperable. Leave ultimate control up to the end user so they may decide how to best interact with content.</p>
<p>If you are going to follow through on providing this kind of feature, some advice: <a href="https://support.microsoft.com/en-us/help/13862/windows-use-high-contrast-mode">model it after the Windows High Contrast mode</a>. It’s a specialized Windows feature that allows a person to force a high color palette onto all aspects of the OS’s UI, including anything the browser displays. It offers four themes out of the box but also allows a user to suit their individual needs by specifying their own colors.</p>
<p>Your high contrast mode feature should do the same. Offer a range of themes with different palettes, and let the user pick colors that work best for them—it will guarantee that if your offerings fail, people still have the ability to self-select.</p>
<h2>Moving focus<a class="subhead-anchor" href="#section8">#section8</a></h2>
<p>Keyboard focus is how people who rely on input such as keyboards, switch controls, voice inputs, eye tracking, and <a href="https://webaim.org/articles/motor/assistive">other forms of assistive technology</a> navigate and operate digital interfaces. While you can do things like use <a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#autofocus">the <code>autofocus</code> attribute</a> to move keyboard focus to the first input on a page after it loads, it is not recommended.</p>
<p>For people experiencing low- and no-vision conditions, it is equivalent to being abruptly and instantaneously moved to a new location. It’s a confusing and disorienting experience—there’s a reason why there’s a trope in sci-fi movies of people vomiting after being teleported for the first time.</p>
<p>For people with motor control concerns, moving focus without their permission means they may be transported to a place where they didn’t intend to go. Digging themselves out of this location becomes annoying at best and effort-intensive at worst. Websites without <a href="https://webdesign.tutsplus.com/articles/the-importance-of-heading-levels-for-assistive-technology--cms-31753">heading elements</a> or document landmarks to serve as navigational aids can worsen this effect.</p>
<p>This is all about consent. Moving focus is fine so long as a person deliberately initiates an action that requires it (<a href="https://developer.paciellogroup.com/blog/2018/06/the-current-state-of-modal-dialog-accessibility/">shifting focus to an opened modal</a>, for example). I don’t come to your house and force you to click on things, so don’t move my keyboard focus unless I specifically ask you to.</p>
<p>Let the browser handle keyboard focus. Provided you use semantic markup, browsers do this well. Some tips:</p>
<ul><li>Use <a href="https://developer.paciellogroup.com/blog/2014/08/using-the-tabindex-attribute/">the <code>tabindex</code> attribute</a> with care and discretion.</li>
<li>Don’t declare <code>tabindex</code> on interactive elements (<code>a</code>, <code>button</code>, <code>input</code>, <code>select</code>, <code>summary</code>, and <code>textarea</code>).</li>
<li>Don’t use <a href="http://www.karlgroves.com/2018/11/13/why-using-tabindex-values-greater-than-0-is-bad/">a manually curated <code>tabindex</code> order</a> that runs parallel to what you’d expect a user to click on. Instead, author your HTML in such a way that the resulting DOM <a href="https://www.w3.org/TR/WCAG20-TECHS/C27.html">matches the visual order of the page</a>. Taking a <a href="https://www.levelaccess.com/what-does-responsive-web-design-have-to-do-with-accessibility/">responsive, mobile first approach</a> helps out a lot here.</li>
</ul><h2>The clipboard and browser history<a class="subhead-anchor" href="#section9">#section9</a></h2>
<p>The clipboard is sacred space. Don’t prevent people from copying things to it, and don’t append extra content to what they copy. The same goes for browser history and back and forward buttons. Don’t mess around with time travel, and just let the browser do its job.</p>
<h2>Wrapping up<a class="subhead-anchor" href="#section10">#section10</a></h2>
<p>In the game part of cyberball, the fun comes from being able to participate with others, passing the ball back and forth. With the web, fun comes from being able to navigate through it. In both situations, fun stops when people get locked out, forced to watch passively from the sidelines.</p>
<p>Fortunately, the web doesn’t have to be one long cyberball experiment. While altering the powerful, assistive technology-friendly features of browsers can enhance the experience for some users, it carries a great risk of alienating others if changes are made with ignorance about exactly how much will be affected.</p>
<p>Remember that this is all in the service of what ultimately matters: creating robust experiences that allow people to successfully use your website or web app regardless of their ability or circumstance. Sometimes the best strategy is to let things be.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Our own @zeldman paints the complicated catch-22 that our free, democratized web has with our money-making capitalist roots. As creators, how do we untangle this web? #LetsFixThis</div><div class="entry-content">A month of experiencing a temporary disability changed @fcorradini’s perspective on how to take more care when conducting accessibility testing. He shares the impact.</div><div class="entry-content">Jeremy Wagner plots a course to avoid the unnecessary bloat and inaccessible patterns of current JavaScript trends.</div><div class="entry-content">Technology can easily become a platform for hate, and we have an ethical responsibility to fix it. ALA's own Tatiana Mac discusses</div><div class="entry-content">Screen readers are diverse and complex: front-end developer Melanie Richards breaks down how they access our content step-by-step.</div>]]></description>
      <link>https://alistapart.com/article/paint-the-picture-not-the-frame/</link>
      <guid>https://alistapart.com/article/paint-the-picture-not-the-frame/</guid>
      <pubDate>Thu, 07 Feb 2019 02:02:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[<![CDATA[ UX in the Age of Personalization ]]]]><![CDATA[>]]></title>
      <description><![CDATA[<div class="entry-content">
<p>If you listened to episode 180 of <a href="http://5by5.tv/bigwebshow/180"><cite>The Big Web Show</cite></a>, you heard two key themes: 1) personalization is now woven into much of the fabric of our digital technology, and 2) designers need to be <strong>much</strong> more involved in its creation and deployment. In my <a href="https://alistapart.com/article/approaching-content-strategy-for-personalized-websites">previous article</a> we took a broad look at the first topic: the practice of harvesting user data to personalize web content, including the rewards (this website <em>gets</em> me!) and risks (creepy!). In this piece, we will take a more detailed look at the UX practitioner’s emerging role in personalization design: from influencing technology selection, to data modeling, to page-level implementation. And it’s high time we did.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<h2>A call to arms<a class="subhead-anchor" href="#section1">#section1</a></h2>
<p>Just as UX people took up the torch around <a href="https://alistapart.com/topic/content-strategy">content strategy</a> years ago, there is a watershed moment quickly approaching for personalization strategy. Simply put, the technology in this space is far outpacing the design practice. For example, while “personalized” emails have been around forever (“Dear COOLIN, …”), it’s now estimated that some <a href="https://www.evergage.com/wp-content/uploads/2018/04/Evergage-2018-Trends-in-Personalization-Survey.pdf">45% of organizations [PDF]</a> have attempted to personalize their homepage. If that scares you, it should: the same report indicated that fewer than a third think it’s actually working.</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2019/01/fig-1.jpg" alt="A bar chart showing the most commonly personalized experiences (in order of highest ranking to lowest): Email content at 71%, Home page at 45%, Landing pages at 37%, Interior pages at 28%, Product detail pages at 27%, Blog at 20%, Navigation at 18%, Search at 17%, Pricing at 14%, and App screens at 13%." /><figcaption>While good old “mail merge” personalization has been around forever, more organizations are now personalizing their website content. Source: Researchscape International survey of 300 marketing professionals from five countries, conducted February 22 to March 28, 2018.</figcaption></figure><p>As <a href="https://jeffmacintyre.com/">Jeff MacIntyre</a> points out, “personalization failures are typically design failures.” Indeed, many personalization programs are still driven primarily out of marketing and IT departments, a holdover from the legacy of the inbound, “creepy” targeted ad. Fixing that model will require the same paradigm shift we’ve used to tackle other challenges in our field: intentionally moving design “upstream,” in this case to technology selection, data collection, and page-level implementation.</p>
<p>That’s where you come in. In fact, if you’re anything like me, you’ve been doing this, quietly, already. Here are just a few examples of UX-specific tasks I’ve completed on recent design projects that had personalization aspects:</p>
<ul><li>aligning personalization to the <strong>core content strategy</strong>;</li>
<li>working with the marketing team to understand <strong>goals and objectives</strong>;</li>
<li>identifying <strong>user segments</strong> (personas) that may benefit from personalized content;</li>
<li>drafting personalization <strong>use cases</strong>;</li>
<li>assisting the technical team with <strong>product selection</strong>;</li>
<li>helping to define the user <strong>data model</strong>, including first- and third-party sources;</li>
<li>wireframing <strong>personalized components</strong> in the information architecture;</li>
<li><strong>taking inventory</strong> of existing content to repurpose for personalization;</li>
<li>writing or editing new <strong>personalized copy</strong>;</li>
<li>working with the design team to create <strong>personalized images</strong>;</li>
<li>developing a personalization <strong>editorial calendar</strong> and governance model;</li>
<li>helping to set up and monitor results from a personalization <strong>pilot</strong>;</li>
<li>partnering with the analytics team to make <strong>iterative improvements</strong>;</li>
<li>being a voice for the personalization program’s <strong>ethical standards</strong>;</li>
<li>and monitoring <strong>customer feedback</strong> to make sure people aren’t freaking the f* out.</li>
</ul><p>Sound familiar? Many of these are simply variants on the same, user-centered tactics you’ve relied on for years. The difference now is that personalization creates a “third dimension” of complexity relative to audience and content. We’ll define that complexity further in two parts: technical design and information design. (We should note again that the focus of this article is personalizing <em>web content</em>, although many of the same principles also apply to email and native applications.)</p>
<h2>Part 1: Personalization technical design<a class="subhead-anchor" href="#section2">#section2</a></h2>
<h3>Influencing technology decisions<a class="subhead-anchor" href="#section3">#section3</a></h3>
<p>When clients or internal stakeholders come to you with a desire to “do personalization,” the first thing to ask is what does that mean. As you’ve likely noticed, the technology landscape has now matured to the point where you can “personalize” a digital experience based on just about anything, from basic geolocation to complex machine learning algorithms. What’s more, such features are increasingly baked into your own CMS or readily available from third-party plugins (see chart below). So defining what personalization is—and isn’t—is a critical first step.</p>
<p>To accomplish this, I suggest asking two questions: 1) What <strong>data</strong> can you ethically collect on your users, and 2) which <strong>tactics</strong> best complement this data. Some capabilities may already exist in your current systems; some you may need to build into your future technology roadmap. The following is by no means an exhaustive list but highlights a few of the popular tactics out there today, and tools that support them:</p>
<figure><table><thead><tr><th scope="col">Tactic</th>
<th scope="col">Definition</th>
<th scope="col">Examples</th>
</tr></thead><tbody><tr><th data-title="Tactics" scope="row">Geolocation</th>
<td data-title="Definition">Personalizing based on the physical location of the user, via a geolocation-enabled device or a web browser IP address (which can triangulate your position based on nearby wifi devices).</td>
<td data-title="Examples"><strong>Examples:</strong> If I’m in Washington, DC, show me promotions for DC. If I’m in Paris, show me promotions for Paris, in French.
<p><strong>Sample Tools:</strong> MaxMind, HTML5 API</p>
</td>
</tr><tr><th data-title="Tactics" scope="row">Quizzes and Profile Info</th>
<td data-title="Definition">A simple, cost-effective way to gather first-party user data by asking basic questions to help assign someone to a segment. Often done as a layover “intercept” when the user arrives, which can then be modified based on a cookied profile. Generally must be exceptionally brief to be effective.</td>
<td data-title="Examples"><strong>Examples:</strong> Are you interested in our service for home use or business use? Are you in the market to buy or sell a house?</td>
</tr><tr><th data-title="Tactics" scope="row">Campaign Source</th>
<td data-title="Definition">One of the most popular methods of personalization, it directs a user to a customized landing page based on incoming campaign data. Can be used for everything from passing a unique discount code to personalizing content on the entire site.</td>
<td data-title="Examples"><strong>Examples:</strong> Customize landing page based on incoming email campaigns, social media campaigns, and paid search campaigns.</td>
</tr><tr><th data-title="Tactics" scope="row">Clicks or Pages Viewed</th>
<td data-title="Definition">Slightly more advanced approach to personalizing based on behavior; common on ecommerce.</td>
<td data-title="Examples"><strong>Examples:</strong> Products you previously viewed; suggested content you’ve recently been looking at.
<p><strong>Sample Tools:</strong> Dynamic Yield, Optimizely</p>
</td>
</tr><tr><th data-title="Tactics" scope="row">SIC and NAICS Codes</th>
<td data-title="Definition">Standard Industrial Classification (SIC) and North American Industry Classification System (NAICS) for classifying industries based on a universal four-digit code, e.g., Manufacturing 2000–3999. Helpful for determining who is visiting you from a business location, based on incoming IP address.</td>
<td data-title="Examples"><strong>Examples:</strong> Show me a different message if I work in the fashion industry vs. hog farming.
<p><strong>Sample Tools:</strong> Marketo, Oracle (BlueKai), Demandbase</p>
</td>
</tr><tr><th data-title="Tactics" scope="row">Geofencing</th>
<td data-title="Definition">Contextual personalization within a “virtual perimeter.” Establishes a fixed geographical boundary based on your device location, typically through RFID or GPS. Your device can then take an action when you enter or leave the location.</td>
<td data-title="Examples"><strong>Examples:</strong> Show me my boarding pass when I’m at the airport. Remind me about unused gift cards when I enter the store.
<p><strong>Sample Tools:</strong> Simpli.fi, Thinknear, Google Geofencing API.</p>
</td>
</tr><tr><th data-title="Tactics" scope="row">Behavioral Profiling</th>
<td data-title="Definition">Add a user to a segment based on similar users who fall into that segment. Often combined with machine learning to identify new segments that humans wouldn’t be able to predict.</td>
<td data-title="Examples"><strong>Examples:</strong> Sitecore pattern cards, e.g., impulse purchaser, buys in bulk, bargain hunter; expedites shipping.</td>
</tr><tr><th data-title="Tactics" scope="row">Machine Learning</th>
<td data-title="Definition">Identify patterns across large sets of data (often across channels) to better predict what a user will want. In theory, improves over time as algorithms “learn” from thousands of interactions. (Obvious downside: your site will need to support thousands of interactions.)</td>
<td data-title="Examples"><strong>Examples:</strong> Azure Machine Learning Studio, BloomReach (Hippo), Sitecore (xConnect, Cortex), Adobe Sensei.</td>
</tr></tbody></table></figure><p>As you can see, the best tactic(s) can vary dramatically based on your audience and how they interact with you. For example, if you’re a high-volume, B2C ecommerce site, you may have enough click-stream data to support useful personalized product recommendations. Conversely, if you’re a B2B business with a qualified lead model and fewer unique visitors, you may be better served by third-party data to help you tailor your message based on industry type (NAICS code) or geography. To help illustrate this idea, let’s do a quick mapping of tactics relative to visitor volume and session time:</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2019/01/fig-2.jpg" alt="A quadrant chart with Number of Visitors for the Y-Axis and Session Time for the X-Axis. In the top left quadrant (titled Advanced Segmentation) lie Geo-Fencing and Clicks or Pages Viewed. Directly between the top left and top right quadrant lies Behavioral Profiling. In the top right quadrant (titled Big Data 1-to-1) lies Machine Learning. In the bottom left quadrant (titled Basic Segmentation) lies Campaign Source, SIC/NASIC Codes, and Geo-Location. And finally in the bottom right quadrant (titled Basic Self Selection) lies Quizzes and Profile Info." /><figcaption>To find your personalization “sweet spot,” consider your audience in terms of volume (number of visits) and average attention span (time on site).</figcaption></figure><p>The good news here is that you needn’t have a massive data platform in place; you can begin to build audience profiles simply by asking users to self-identify via quizzes or profile info. But in either scenario, your goal is the same: help guide the technology decision toward a personalization approach that provides actual value to your audience, <em>not</em> “because we can.”</p>
<h2>Part 2: Personalization information design<a class="subhead-anchor" href="#section4">#section4</a></h2>
<h3>Personalization deliverables<a class="subhead-anchor" href="#section5">#section5</a></h3>
<p>Once you have a sense of the technical possibilities, it’s time to determine how the personalized experience will look. Let’s pretend we’re designing for a venture several of you inquired about in my <a href="https://alistapart.com/article/approaching-content-strategy-for-personalized-websites">previous article</a>: <strong>Reindeer Hugs International</strong>. As the name implies, this is a nonprofit that provides hugs to reindeer. RHI recently set new business goals and wants to personalize the website to help achieve them.</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2019/01/fig-3.jpg" alt="The very reputable-looking logo of Reindeer Hugs International. It seems legit." class="c1" /><figcaption>Seems reputable.</figcaption></figure><p>To address this goal, we propose four <strong>UX-specific deliverables</strong>:</p>
<ol><li>segments worksheet;</li>
<li>campaigns worksheet;</li>
<li>personalization wireframes;</li>
<li>and personalization copy deck.</li>
</ol><p>Following the technical model we discussed earlier, the first thing we do is define our audience based on existing site interaction patterns. We discover that RHI doesn’t get a ton of organic traffic, but they do have a reasonably active set of authenticated users (existing members) as well as some paid social media campaigns. Working with the marketing team, we propose personalizing the site for three <strong>high-potential segments</strong>, as follows:</p>
<h3>Segments worksheet<a class="subhead-anchor" href="#section6">#section6</a></h3>
<figure><table><thead><tr><th scope="col">Segment</th>
<th scope="col">How to Identify</th>
<th scope="col">Personalization Goal</th>
<th scope="col">Messaging Strategy</th>
</tr></thead><tbody><tr><th data-title="Segment" scope="row">Current Members</th>
<td data-title="How to Identify">Logged in or made guest contribution (track via cookie)</td>
<td data-title="Personalization Goal">Improve engagement with current members by 10%</td>
<td data-title="Messaging Strategy">You’re a hugging rock star, but you can hug it out even more.</td>
</tr><tr><th data-title="Segment" scope="row">Non-member Males</th>
<td data-title="How to Identify">Inbound Facebook and Instagram campaigns</td>
<td data-title="Personalization Goal">Improve conversion with non-member males age 25–34 by 5%</td>
<td data-title="Messaging Strategy">Make reindeer hugging manly again.</td>
</tr><tr><th data-title="Segment" scope="row">Non-member Parents</th>
<td data-title="How to Identify">Inbound Facebook and Instagram campaigns</td>
<td data-title="Personalization Goal">Improve conversion with non-member parents age 31–49 by 5%</td>
<td data-title="Messaging Strategy">Reindeer hugging is great for the kids.</td>
</tr></tbody></table></figure><p>Next, let’s determine the <em>specific value</em> we could add for these segments when they come to the site. To do this, we’ll revisit a model that we looked at previously for the <a href="https://alistapart.com/article/approaching-content-strategy-for-personalized-websites#section7">four personalization content types</a>. This will help us organize the collective content or “campaign” we show each segment based on a specific personalization goal:</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2019/01/fig-4.png" alt="The four contrasting tasks at hand: Alert, Make Easier, Cross-Sell, and Enrich" class="c1" /><figcaption>A Personalization Content Model showing four flavors of personalized content.</figcaption></figure><p>For example, current members who are logged in might benefit from a “Make Easier” campaign of links to members-only content. Conversely, <em>each</em> of our three segments could benefit from a personalized “Cross-Sell” campaign to help generate awareness. Let’s capture our ideas like this:</p>
<h3>Campaigns worksheet<a class="subhead-anchor" href="#section7">#section7</a></h3>
<figure><table class="multirow-span"><thead><tr><th scope="col">Segment</th>
<th scope="col">Alert</th>
<th scope="col">Make Easier</th>
<th scope="col">Cross-Sell</th>
<th scope="col">Enrich</th>
</tr></thead><tbody><tr><td data-title="Segment">Current Members</td>
<td data-title="Alert" rowspan="3" class="c2"><strong>Geolocation Banner</strong><br />
Hugs needed in your area (displays to any user with location data).</td>
<td data-title="Make Easier"><strong>Links for members</strong> who are logged in, such as to profile information, a member directory, and reindeer friends catalog.</td>
<td data-title="Cross-Sell" rowspan="3" class="c2"><strong>Capital Campaign</strong><br />
Generate awareness by audience (minimum three distinct messages).</td>
<td data-title="Enrich"><strong>Current Member Blog</strong><br />
Invest in creating original, hug-provoking content to further our brand.</td>
</tr><tr><td data-title="Segment">Non-member Males Age 25–34</td>
<td data-title="Make Easier" rowspan="2" class="c2"><strong>Non-Member CTA</strong> In the non-member experience, this will be replaced by a CTA.</td>
<td data-title="Enrich" rowspan="2" class="c2"><strong>Thought Leadership</strong><br />
Demonstrate that we are the definitive source for reindeer hugs.</td>
</tr><tr><td data-title="Segment">Non-member Parents Age 28–39</td>
</tr></tbody></table></figure><h3>Personalization wireframes<a class="subhead-anchor" href="#section8">#section8</a></h3>
<p>Now let’s decide where on the site we want to run these personalized campaigns. This isn’t too dissimilar from the work you already do around templates and components, with the addition that we can now have <strong>personalized zones</strong>. You can think of these as blocks where the CMS (or third-party plugin) will be running a series of calculations to determine the user segment in real-time (or based on a previously cached profile). To get the most coverage, these are typically dropped in at the template level. Here are examples for our home page template and interior page template:</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2019/01/fig-5.jpg" alt="Two separate wireframes with corresponding colored boxes showing which portions of the page relate to each type of personalization." /><figcaption>Showing component-level “zoning” on homepage and landing page templates. The colors correspond to the personalization content type.</figcaption></figure><p>Everything in white is the non-personalized, or “static,” content, which never changes, regardless of who you are. The personalized zones themselves (color-coded based on our content model) will also have an underlying <strong>default or <em>canonical</em> content set</strong> that appears if the system doesn’t get a personalized match. (Note: this is also the version of the content that is typically indexed by search engines.)</p>
<p>As you can see, an important rule of thumb is to personalize <em>around</em> the main content, not the entire page. There are a variety of reasons for this, including the risk of getting the audience wrong, effects on search indexing, and what’s known as the <strong><em>infinite content problem</em></strong>, i.e., can you realistically create content for every single audience on every single component? (Hint: no.)</p>
<p>OK, we’re getting close! Finally, let’s look at what specifically we want the system to show in these slots. Based on our campaigns worksheet, we know how many permutations of content we need. We sit down with the creative team to design our targeted messages, including the copy, images, and calls to action. Here’s what the capital campaign (the blue zone) might look like for our three audiences:</p>
<h3>Personalization copy deck<a class="subhead-anchor" href="#section9">#section9</a></h3>
<figure><table><caption>Reindeer Hugs International: Capital Campaign (Cross-Sell)</caption>
<thead><tr><th scope="col">Element</th>
<th scope="col">Definition</th>
<th scope="col">Asset</th>
</tr></thead><tbody><tr><td data-title="Element"><strong>Message A:</strong><br />
Current Member</td>
<td data-title="Definition"><strong>Headline:</strong> Take Your Hugs to the Next Level
<p><strong>Copy:</strong> You’re a hugging expert. But did you know you could hug two reindeers at once?</p>
<p><strong>Primary CTA:</strong> Sign up for our Two-for-One Hugs</p>
<p><strong>Secondary CTA:</strong> Learn More</p>
</td>
<td data-title="Asset"><img src="https://alistapart.com/wp-content/uploads/2019/01/table-img1.jpg" alt="A young woman hugging a very handsome reindeer." /><br />
Source: Current-Member.jpg<br />
Full-size render: 900×450<br />
Thumbnail render: 300×200</td>
</tr><tr><td data-title="Element"><strong>Message B:</strong><br />
Real Men Hug</td>
<td data-title="Definition"><strong>Headline:</strong> Real Men Hug Reindeer
<p><strong>Copy:</strong> Are you a real man?</p>
<p><strong>Primary CTA:</strong> Prove It</p>
<p><strong>Secondary CTA:</strong> [None]</p>
</td>
<td data-title="Asset"><img src="https://alistapart.com/wp-content/uploads/2019/01/table-img2.jpg" alt="A bearded man hugging another handsome reindeer." /><br />
Source: Man-Hug.jpg<br />
Full-size render: 900×450<br />
Thumbnail render: 300×200</td>
</tr><tr><td data-title="Element"><strong>Message C:</strong><br />
Parents with Young Kids</td>
<td data-title="Definition"><strong>Headline:</strong> Looking for a fun activity to do with the kids?
<p><strong>Copy:</strong> Reindeer hugs are 100% kid-friendly and 200% environmentally-friendly.</p>
<p><strong>Primary CTA:</strong> Shop Our Family Plan</p>
<p><strong>Secondary CTA:</strong> Learn More</p>
</td>
<td data-title="Asset"><img src="https://alistapart.com/wp-content/uploads/2019/01/table-img3.jpg" alt="A young child happily hugging a cute, unthreatening reindeer" /><br />
Source: Parents-Kids.jpg<br />
Full-size render: 900×450<br />
Thumbnail render: 300×200</td>
</tr></tbody></table></figure><p>That’s a pretty good start. We would want to follow a similar approach to detail our other three content campaigns, including alerts (e.g., hugs needed in your area), make easier (e.g., member shortcuts), and enrichment content (e.g., blog articles on latest reindeer fashions). When all the campaigns are up and running, we might expect the homepage to look something like this when seen by two different audiences, simultaneously, in real-time, in different browser sessions:</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2019/01/fig-9.jpg" alt="Two more detailed wireframes that show what the home page might look. On the left, one block has member links and info and another section has a members-only blog post. On the right, one block has a CTA on benefits that members get and a more general blog post." /><figcaption>Wireframes illustrating the anticipated homepage delivery to two distinct audiences: Current Member (left) and Non-Member Male 25–34 (right). If the system did not get an audience match, a default or non-personalized set of content would be shown.</figcaption></figure><h2>Part 3: Advanced personalization techniques<a class="subhead-anchor" href="#section10">#section10</a></h2>
<h3>Digital Experience Platforms<a class="subhead-anchor" href="#section11">#section11</a></h3>
<p>Of course, all of that work was fairly manual. If you are lucky enough to be working with an advanced <strong>DMP</strong> (Data Management Platform) or integrated <strong>DXP</strong> (<a href="https://www.gartner.com/reviews/market/horizontal-portals">Digital Experience Platform</a>) then you have even more possibilities at your disposal. For example, <strong>machine learning</strong> and <strong>behavior profiling</strong> can help you discover segments over time that you might never have dreamed of (the study we referenced earlier showed that 26% of marketing programs have tried some form of algorithmic one-to-one approach; 68% still use rules-based targeting to segments). This can be enhanced via <strong>parametric scoring</strong>, where actioning off of multiple data inputs can help you create blends of audience types (in our example, a thirty-three-year-old dad might get 60 percent Parent and 40 percent Real Man … or whatever). Likewise, on the content side, <strong>content scoring</strong> can help you deliver more nuanced content. (For example, we might tag an article with 20 percent Reindeer Advocacy and 80 percent Hug Best Practices.) Platforms like Sitecore can even illustrate these metrics, like in this example of a pattern card:</p>
<figure id="figure11"><img src="https://alistapart.com/wp-content/uploads/2019/01/fig-10.jpg" alt="Examples of a hexagonally shaped behavior diagram with the following personality traits at each corner clockwise from the top left: research, impulse purchase, returns merchandise, expedites shipping, bargain hunting, and buys in bulk." /><figcaption>The diagram at left shows how a particular user scores (some combination of research and returns merchandise). This most closely correlates to the “Neurotic Shopper” card, so we might show this user content on our free-returns policy. Source: <a href="https://www.berndtgroup.net/">The Berndt Group</a>.</figcaption></figure><h3>Cult of the complex<a class="subhead-anchor" href="#section12">#section12</a></h3>
<p>While all of that is super cool, even the most tech-savvy among us will benefit from starting out “simple,” lest you fall prey to the <a href="https://alistapart.com/article/cult-of-the-complex">cult of the complex</a>. The manual process of identifying your target audience and use cases, for example, is foundational to building an extensible personalization program, regardless of your tech stack. At a minimum, this approach will help you get buy-in from your team and organization vs. just telling everyone the site will be personalized in a “black box” somewhere. And even <em>with</em> the best-in-class products, I have yet to find seamless “one-click” personalization, where the system somehow magically does everything from finding audiences to pumping out content, all in real time. We’ll get there one day, perhaps.</p>
<p>But, in the meantime, it’s up to you.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Our own @zeldman paints the complicated catch-22 that our free, democratized web has with our money-making capitalist roots. As creators, how do we untangle this web? #LetsFixThis</div><div class="entry-content">A month of experiencing a temporary disability changed @fcorradini’s perspective on how to take more care when conducting accessibility testing. He shares the impact.</div><div class="entry-content">Jeremy Wagner plots a course to avoid the unnecessary bloat and inaccessible patterns of current JavaScript trends.</div><div class="entry-content">Technology can easily become a platform for hate, and we have an ethical responsibility to fix it. ALA's own Tatiana Mac discusses</div><div class="entry-content">Screen readers are diverse and complex: front-end developer Melanie Richards breaks down how they access our content step-by-step.</div>]]></description>
      <link>https://alistapart.com/article/emerging-ux-role-in-personalization/</link>
      <guid>https://alistapart.com/article/emerging-ux-role-in-personalization/</guid>
      <pubDate>Thu, 17 Jan 2019 02:01:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[UX in the Age of Personalization]]></title>
      <description><![CDATA[<p>If you listened to episode 180 of <a href="http://5by5.tv/bigwebshow/180"><cite>The Big Web Show</cite></a>, you heard two key themes: 1) personalization is now woven into much of the fabric of our digital technology, and 2) designers need to be <strong>much</strong> more involved in its creation and deployment. In my <a href="https://alistapart.com/article/approaching-content-strategy-for-personalized-websites">previous article</a> we took a broad look at the first topic: the practice of harvesting user data to personalize web content, including the rewards (this website <em>gets</em> me!) and risks (creepy!). In this piece, we will take a more detailed look at the UX practitioner’s emerging role in personalization design: from influencing technology selection, to data modeling, to page-level implementation. And it’s high time we did.</p>
<h2>A call to arms</h2>


<p>Just as UX people took up the torch around <a href="https://alistapart.com/topic/content-strategy">content strategy</a> years ago, there is a watershed moment quickly approaching for personalization strategy. Simply put, the technology in this space is far outpacing the design practice. For example, while “personalized” emails have been around forever (“Dear COOLIN, …”), it’s now estimated that some <a href="https://www.evergage.com/wp-content/uploads/2018/04/Evergage-2018-Trends-in-Personalization-Survey.pdf">45% of organizations [PDF]</a> have attempted to personalize their homepage. If that scares you, it should: the same report indicated that fewer than a third think it’s actually working.</p>
<figure><img src="https://alistapart.com/d/ux-of-personalization/fig-1.jpg" alt="A bar chart showing the most commonly personalized experiences (in order of highest ranking to lowest): Email content at 71%, Home page at 45%, Landing pages at 37%, Interior pages at 28%, Product detail pages at 27%, Blog at 20%, Navigation at 18%, Search at 17%, Pricing at 14%, and App screens at 13%." /><figcaption>While good old “mail merge” personalization has been around forever, more organizations are now personalizing their website content. Source: Researchscape International survey of 300 marketing professionals from five countries, conducted February 22 to March 28, 2018.</figcaption></figure><p>As <a href="https://jeffmacintyre.com/">Jeff MacIntyre</a> points out, “personalization failures are typically design failures.” Indeed, many personalization programs are still driven primarily out of marketing and IT departments, a holdover from the legacy of the inbound, “creepy” targeted ad. Fixing that model will require the same paradigm shift we’ve used to tackle other challenges in our field: intentionally moving design “upstream,” in this case to technology selection, data collection, and page-level implementation.</p>
<p>That’s where you come in. In fact, if you’re anything like me, you’ve been doing this, quietly, already. Here are just a few examples of UX-specific tasks I’ve completed on recent design projects that had personalization aspects:</p>
<ul><li>aligning personalization to the <strong>core content strategy</strong>;</li>
<li>working with the marketing team to understand <strong>goals and objectives</strong>;</li>
<li>identifying <strong>user segments</strong> (personas) that may benefit from personalized content;</li>
<li>drafting personalization <strong>use cases</strong>;</li>
<li>assisting the technical team with <strong>product selection</strong>;</li>
<li>helping to define the user <strong>data model</strong>, including first- and third-party sources;</li>
<li>wireframing <strong>personalized components</strong> in the information architecture;</li>
<li><strong>taking inventory</strong> of existing content to repurpose for personalization;</li>
<li>writing or editing new <strong>personalized copy</strong>;</li>
<li>working with the design team to create <strong>personalized images</strong>;</li>
<li>developing a personalization <strong>editorial calendar</strong> and governance model;</li>
<li>helping to set up and monitor results from a personalization <strong>pilot</strong>;</li>
<li>partnering with the analytics team to make <strong>iterative improvements</strong>;</li>
<li>being a voice for the personalization program’s <strong>ethical standards</strong>;</li>
<li>and monitoring <strong>customer feedback</strong> to make sure people aren’t freaking the f* out.</li>
</ul><p>Sound familiar? Many of these are simply variants on the same, user-centered tactics you’ve relied on for years. The difference now is that personalization creates a “third dimension” of complexity relative to audience and content. We’ll define that complexity further in two parts: technical design and information design. (We should note again that the focus of this article is personalizing <em>web content</em>, although many of the same principles also apply to email and native applications.)</p>
<h2>Part 1: Personalization technical design</h2>
<h3>Influencing technology decisions</h3>
<p>When clients or internal stakeholders come to you with a desire to “do personalization,” the first thing to ask is what does that mean. As you’ve likely noticed, the technology landscape has now matured to the point where you can “personalize” a digital experience based on just about anything, from basic geolocation to complex machine learning algorithms. What’s more, such features are increasingly baked into your own CMS or readily available from third-party plugins (see chart below). So defining what personalization is—and isn’t—is a critical first step.</p>
<p>To accomplish this, I suggest asking two questions: 1) What <strong>data</strong> can you ethically collect on your users, and 2) which <strong>tactics</strong> best complement this data. Some capabilities may already exist in your current systems; some you may need to build into your future technology roadmap. The following is by no means an exhaustive list but highlights a few of the popular tactics out there today, and tools that support them:</p>
<figure><table><thead><tr><th scope="col">Tactic</th>
<th scope="col">Definition</th>
<th scope="col">Examples</th>
</tr></thead><tbody><tr><th data-title="Tactics" scope="row">Geolocation</th>
<td data-title="Definition">Personalizing based on the physical location of the user, via a geolocation-enabled device or a web browser IP address (which can triangulate your position based on nearby wifi devices).</td>
<td data-title="Examples"><strong>Examples:</strong> If I’m in Washington, DC, show me promotions for DC. If I’m in Paris, show me promotions for Paris, in French.
<p><strong>Sample Tools:</strong> MaxMind, HTML5 API</p>
</td>
</tr><tr><th data-title="Tactics" scope="row">Quizzes and Profile Info</th>
<td data-title="Definition">A simple, cost-effective way to gather first-party user data by asking basic questions to help assign someone to a segment. Often done as a layover “intercept” when the user arrives, which can then be modified based on a cookied profile. Generally must be exceptionally brief to be effective.</td>
<td data-title="Examples"><strong>Examples:</strong> Are you interested in our service for home use or business use? Are you in the market to buy or sell a house?</td>
</tr><tr><th data-title="Tactics" scope="row">Campaign Source</th>
<td data-title="Definition">One of the most popular methods of personalization, it directs a user to a customized landing page based on incoming campaign data. Can be used for everything from passing a unique discount code to personalizing content on the entire site.</td>
<td data-title="Examples"><strong>Examples:</strong> Customize landing page based on incoming email campaigns, social media campaigns, and paid search campaigns.</td>
</tr><tr><th data-title="Tactics" scope="row">Clicks or Pages Viewed</th>
<td data-title="Definition">Slightly more advanced approach to personalizing based on behavior; common on ecommerce.</td>
<td data-title="Examples"><strong>Examples:</strong> Products you previously viewed; suggested content you’ve recently been looking at.
<p><strong>Sample Tools:</strong> Dynamic Yield, Optimizely</p>
</td>
</tr><tr><th data-title="Tactics" scope="row">SIC and NASIC Codes</th>
<td data-title="Definition">Standard Industrial Classification (SIC) and North American Industry Classification System (NAICS) for classifying industries based on a universal four-digit code, e.g., Manufacturing 2000–3999. Helpful for determining who is visiting you from a business location, based on incoming IP address.</td>
<td data-title="Examples"><strong>Examples:</strong> Show me a different message if I work in the fashion industry vs. hog farming.
<p><strong>Sample Tools:</strong> Marketo, Oracle (BlueKai), Demandbase</p>
</td>
</tr><tr><th data-title="Tactics" scope="row">Geofencing</th>
<td data-title="Definition">Contextual personalization within a “virtual perimeter.” Establishes a fixed geographical boundary based on your device location, typically through RFID or GPS. Your device can then take an action when you enter or leave the location.</td>
<td data-title="Examples"><strong>Examples:</strong> Show me my boarding pass when I’m at the airport. Remind me about unused gift cards when I enter the store.
<p><strong>Sample Tools:</strong> Simpli.fi, Thinknear, Google Geofencing API.</p>
</td>
</tr><tr><th data-title="Tactics" scope="row">Behavioral Profiling</th>
<td data-title="Definition">Add a user to a segment based on similar users who fall into that segment. Often combined with machine learning to identify new segments that humans wouldn’t be able to predict.</td>
<td data-title="Examples"><strong>Examples:</strong> Sitecore pattern cards, e.g., impulse purchaser, buys in bulk, bargain hunter; expedites shipping.</td>
</tr><tr><th data-title="Tactics" scope="row">Machine Learning</th>
<td data-title="Definition">Identify patterns across large sets of data (often across channels) to better predict what a user will want. In theory, improves over time as algorithms “learn” from thousands of interactions. (Obvious downside: your site will need to support thousands of interactions.)</td>
<td data-title="Examples"><strong>Examples:</strong> Azure Machine Learning Studio, BloomReach (Hippo), Sitecore (xConnect, Cortex), Adobe Sensei.</td>
</tr></tbody></table></figure><p>As you can see, the best tactic(s) can vary dramatically based on your audience and how they interact with you. For example, if you’re a high-volume, B2C e-commerce site, you may have enough click-stream data to support useful personalized product recommendations. Conversely, if you’re a B2B business with a qualified lead model and fewer unique visitors, you may be better served by third-party data to help you tailor your message based on industry type (NAICS code) or geography. To help illustrate this idea, let’s do a quick mapping of tactics relative to visitor volume and session time:</p>
<figure><img src="https://alistapart.com/d/ux-of-personalization/fig-2.jpg" alt="A quadrant chart with Number of Visitors for the Y-Axis and Session Time for the X-Axis. In the top left quadrant (titled Advanced Segmentation) lie Geo-Fencing and Clicks or Pages Viewed. Directly between the top left and top right quadrant lies Behavioral Profiling. In the top right quadrant (titled Big Data 1-to-1) lies Machine Learning. In the bottom left quadrant (titled Basic Segmentation) lies Campaign Source, SIC/NASIC Codes, and Geo-Location. And finally in the bottom right quadrant (titled Basic Self Selection) lies Quizzes and Profile Info." /><figcaption>To find your personalization “sweet spot,” consider your audience in terms of volume (number of visits) and average attention span (time on site).</figcaption></figure><p>The good news here is that you needn’t have a massive data platform in place; you can begin to build audience profiles simply by asking users to self-identify via quizzes or profile info. But in either scenario, your goal is the same: help guide the technology decision toward a personalization approach that provides actual value to your audience, <em>not</em> “because we can.”</p>
<h2>Part 2: Personalization information design</h2>
<h3>Personalization deliverables</h3>
<p>Once you have a sense of the technical possibilities, it’s time to determine how the personalized experience will look. Let’s pretend we’re designing for a venture several of you inquired about in my <a href="https://alistapart.com/article/approaching-content-strategy-for-personalized-websites">previous article</a>: <strong>Reindeer Hugs International</strong>. As the name implies, this is a nonprofit that provides hugs to reindeer. RHI recently set new business goals and wants to personalize the website to help achieve them.</p>
<figure><img src="https://alistapart.com/d/ux-of-personalization/fig-3.jpg" alt="The very reputable-looking logo of Reindeer Hugs International. It seems legit." class="c2" /><figcaption>Seems reputable.</figcaption></figure><p>To address this goal, we propose four <strong>UX-specific deliverables</strong>:</p>
<ol><li>segments worksheet;</li>
<li>campaigns worksheet;</li>
<li>personalization wireframes;</li>
<li>and personalization copy deck.</li>
</ol><p>Following the technical model we discussed earlier, the first thing we do is define our audience based on existing site interaction patterns. We discover that RHI doesn’t get a ton of organic traffic, but they do have a reasonably active set of authenticated users (existing members) as well as some paid social media campaigns. Working with the marketing team, we propose personalizing the site for three <strong>high-potential segments</strong>, as follows:</p>
<h3>Segments worksheet</h3>
<figure><table><thead><tr><th scope="col">Segment</th>
<th scope="col">How to Identify</th>
<th scope="col">Personalization Goal</th>
<th scope="col">Messaging Strategy</th>
</tr></thead><tbody><tr><th data-title="Segment" scope="row">Current Members</th>
<td data-title="How to Identify">Logged in or made guest contribution (track via cookie)</td>
<td data-title="Personalization Goal">Improve engagement with current members by 10%</td>
<td data-title="Messaging Strategy">You’re hugging a rock star, but you can hug it out even more.</td>
</tr><tr><th data-title="Segment" scope="row">Non-member Males</th>
<td data-title="How to Identify">Inbound Facebook and Instagram campaigns</td>
<td data-title="Personalization Goal">Improve conversion with non-member males age 25–34 by 5%</td>
<td data-title="Messaging Strategy">Make reindeer hugging manly again.</td>
</tr><tr><th data-title="Segment" scope="row">Non-member Parents</th>
<td data-title="How to Identify">Inbound Facebook and Instagram campaigns</td>
<td data-title="Personalization Goal">Improve conversion with non-member parents age 31–49 by 5%</td>
<td data-title="Messaging Strategy">Reindeer hugging is great for the kids.</td>
</tr></tbody></table></figure><p>Next, let’s determine the <em>specific value</em> we could add for these segments when they come to the site. To do this, we’ll revisit a model that we looked at previously for the <a href="https://alistapart.com/article/approaching-content-strategy-for-personalized-websites#section7">four personalization content types</a>. This will help us organize the collective content or “campaign” we show each segment based on a specific personalization goal:</p>
<figure><img src="https://alistapart.com/d/ux-of-personalization/fig-4.png" alt="The four contrasting tasks at hand: Alert, Make Easier, Cross-Sell, and Enrich" class="c2" /><figcaption>A Personalization Content Model showing four flavors of personalized content.</figcaption></figure><p>For example, current members who are logged in might benefit from a “Make Easier” campaign of links to members-only content. Conversely, <em>each</em> of our three segments could benefit from a personalized “Cross-Sell” campaign to help generate awareness. Let’s capture our ideas like this:</p>
<h3>Campaigns worksheet</h3>
<figure><table><thead><tr><th scope="col">Segment</th>
<th scope="col">Alert</th>
<th scope="col">Make Easier</th>
<th scope="col">Cross-Sell</th>
<th scope="col">Enrich</th>
</tr></thead><tbody><tr><td data-title="Segment">Current Members</td>
<td data-title="Alert" rowspan="3" class="c3"><strong>Geolocation Banner</strong><br />
Hugs needed in your area (displays to any user with location data).</td>
<td data-title="Make Easier"><strong>Links for members</strong> who are logged in, such as to profile information, a member directory, and reindeer friends catalog.</td>
<td data-title="Cross-Sell"><strong>Capital Campaign</strong><br />
Generate awareness by audience (minimum three distinct messages).</td>
<td data-title="Enrich"><strong>Current Member Blog</strong><br />
Invest in creating original, hug-provoking content to further our brand.</td>
</tr><tr><td data-title="Segment">Non-member Males Age 25–34</td>
<td data-title="Make Easier"><strong>Non-Member CTA</strong> In the non-member experience, this will be replaced by a CTA.</td>
<td data-title="Enrich"><strong>Thought Leadership</strong><br />
Demonstrate that we are the definitive source for reindeer hugs.</td>
</tr><tr><td data-title="Segment">Non-member Parents Age 28–39</td>
</tr></tbody></table></figure><h3>Personalization wireframes</h3>
<p>Now let’s decide where on the site we want to run these personalized campaigns. This isn’t too dissimilar from the work you already do around templates and components, with the addition that we can now have <strong>personalized zones</strong>. You can think of these as blocks where the CMS (or third-party plugin) will be running a series of calculations to determine the user segment in real-time (or based on a previously cached profile). To get the most coverage, these are typically dropped in at the template level. Here are examples for our home page template and interior page template:</p>
<figure><img src="https://alistapart.com/d/ux-of-personalization/fig-5.jpg" alt="Two separate wireframes with corresponding colored boxes showing which portions of the page relate to each type of personalization." /><figcaption>Showing component-level “zoning” on homepage and landing page templates. The colors correspond to the personalization content type.</figcaption></figure><p>Everything in white is the non-personalized, or “static,” content, which never changes, regardless of who you are. The personalized zones themselves (color-coded based on our content model) will also have an underlying <strong>default or <em>canonical</em> content set</strong> that appears if the system doesn’t get a personalized match. (Note: this is also the version of the content that is typically indexed by search engines.)</p>
<p>As you can see, an important rule of thumb is to personalize <em>around</em> the main content, not the entire page. There are a variety of reasons for this, including the risk of getting the audience wrong, effects on search indexing, and what’s known as the <strong><em>infinite content problem</em></strong>, i.e., can you realistically create content for every single audience on every single component? (Hint: no.)</p>
<p>OK, we’re getting close! Finally, let’s look at what specifically we want the system to show in these slots. Based on our campaigns worksheet, we know how many permutations of content we need. We sit down with the creative team to design our targeted messages, including the copy, images, and calls to action. Here’s what the capital campaign (the blue zone) might look like for our three audiences:</p>
<h3>Personalization copy deck</h3>
<figure><table><caption>Reindeer Hugs International: Capital Campaign (Cross-Sell)</caption>
<thead><tr><th scope="col">Element</th>
<th scope="col">Definition</th>
<th scope="col">Asset</th>
</tr></thead><tbody><tr><td data-title="Element"><strong>Message A:</strong><br />
Current Member</td>
<td data-title="Definition"><strong>Headline:</strong> Take Your Hugs to the Next Level
<p><strong>Copy:</strong> You’re a hugging expert. But did you know you could hug two reindeers at once?</p>
<p><strong>Primary CTA:</strong> Sign up for our Two-for-One Hugs</p>
<p><strong>Secondary CTA:</strong> Learn More</p>
</td>
<td data-title="Asset"><img src="https://alistapart.com/d/ux-of-personalization/table-img1.jpg" alt="A young woman hugging a very handsome reindeer." /><br />
Source: Current-Member.jpg<br />
Full-size render: 900x450<br />
Thumbnail render: 300x200</td>
</tr><tr><td data-title="Element"><strong>Message B:</strong><br />
Real Men Hug</td>
<td data-title="Definition"><strong>Headline:</strong> Real Men Hug Reindeer
<p><strong>Copy:</strong> Are you a real man?</p>
<p><strong>Primary CTA:</strong> Prove It</p>
<p><strong>Secondary CTA:</strong> [None]</p>
</td>
<td data-title="Asset"><img src="https://alistapart.com/d/ux-of-personalization/table-img2.jpg" alt="A bearded man hugging another handsome reindeer." /><br />
Source: Man-Hug.jpg<br />
Full-size render: 900x450<br />
Thumbnail render: 300x200</td>
</tr><tr><td data-title="Element"><strong>Message C:</strong><br />
Parents with Young Kids</td>
<td data-title="Definition"><strong>Headline:</strong> Looking for a fun activity to do with the kids?
<p><strong>Copy:</strong> Reindeer hugs are 100% kid-friendly and 200% environmentally-friendly.</p>
<p><strong>Primary CTA:</strong> Shop Our Family Plan</p>
<p><strong>Secondary CTA:</strong> Learn More</p>
</td>
<td data-title="Asset"><img src="https://alistapart.com/d/ux-of-personalization/table-img3.jpg" alt="A young child happily hugging a cute, unthreatening reindeer" /><br />
Source: Parents-Kids.jpg<br />
Full-size render: 900x450<br />
Thumbnail render: 300x200</td>
</tr></tbody></table></figure><p>That’s a pretty good start. We would want to follow a similar approach to detail our other three content campaigns, including alerts (e.g., hugs needed in your area), make easier (e.g., member shortcuts), and enrichment content (e.g., blog articles on latest reindeer fashions). When all the campaigns are up and running, we might expect the homepage to look something like this when seen by two different audiences, simultaneously, in real-time, in different browser sessions:</p>
<figure><img src="https://alistapart.com/d/ux-of-personalization/fig-9.jpg" alt="Two more detailed wireframes that show what the home page might look. On the left, one block has member links and info and another section has a members-only blog post. On the right, one block has a CTA on benefits that members get and a more general blog post." /><figcaption>Wireframes illustrating the anticipated homepage delivery to two distinct audiences: Current Member (left) and Non-Member Male 25–34 (right). If the system did not get an audience match, a default or non-personalized set of content would be shown.</figcaption></figure><h2>Part 3: Advanced personalization techniques</h2>
<h3>Digital Experience Platforms</h3>
<p>Of course, all of that work was fairly manual. If you are lucky enough to be working with an advanced <strong>DMP</strong> (Data Management Platform) or integrated <strong>DXP</strong> (<a href="https://www.gartner.com/reviews/market/horizontal-portals">Digital Experience Platform</a>) then you have even more possibilities at your disposal. For example, <strong>machine learning</strong> and <strong>behavior profiling</strong> can help you discover segments over time that you might never have dreamed of (the study we referenced earlier showed that 26% of marketing programs have tried some form of algorithmic one-to-one approach; 68% still use rules-based targeting to segments). This can be enhanced via <strong>parametric scoring</strong>, where actioning off of multiple data inputs can help you create blends of audience types (in our example, a thirty-three-year-old dad might get 60 percent Parent and 40 percent Real Man … or whatever). Likewise, on the content side, <strong>content scoring</strong> can help you deliver more nuanced content. (For example, we might tag an article with 20 percent Reindeer Advocacy and 80 percent Hug Best Practices.) Platforms like Sitecore can even illustrate these metrics, like in this example of a pattern card:</p>
<figure><img src="https://alistapart.com/d/ux-of-personalization/fig-10.jpg" alt="Examples of a hexagonally shaped behavior diagram with the following personality traits at each corner clockwise from the top left: research, impulse purchase, returns merchandise, expedites shipping, bargain hunting, and buys in bulk." /><figcaption>The diagram at left shows how a particular user scores (some combination of research and returns merchandise). This most closely correlates to the “Neurotic Shopper” card, so we might show this user content on our free-returns policy. Source: <a href="https://www.berndtgroup.net/">The Berndt Group</a>.</figcaption></figure><h3>Cult of the complex</h3>
<p>While all of that is super cool, even the most tech-savvy among us will benefit from starting out “simple,” lest you fall prey to the <a href="https://alistapart.com/article/cult-of-the-complex">cult of the complex</a>. The manual process of identifying your target audience and use cases, for example, is foundational to building an extensible personalization program, regardless of your tech stack. At a minimum, this approach will help you get buy-in from your team and organization vs. just telling everyone the site will be personalized in a “black box” somewhere. And even <em>with</em> the best-in-class products, I have yet to find seamless “one-click” personalization, where the system somehow magically does everything from finding audiences to pumping out content, all in real time. We’ll get there one day, perhaps.</p>
<p>But, in the meantime, it’s up to you.</p>
<footer class="entry-footer nocontent"><h1>About the Author</h1>
<div class="byline author vcard"><a class="photo" href="https://alistapart.com/author/colineagan"><img src="https://alistapart.com/d/_made/pix/authors/photos/photo_136079_120_120_c1.jpg" alt="Image of Colin Eagan" /></a>
<h2>
Colin A. Eagan, MS, is Principal for User Experience at <a href="http://www.icfi.com/interactive">ICF International</a> in Washington, DC, where he directs content strategy and information design projects for Fortune 500 companies, nonprofits, and government clients. He is a frequent contributor to UX conferences and publications, including Convey UX, IA Summit, <cite>Ad Age</cite>, and <cite>The UX Booth</cite>. He credits any career success thus far to not going to law school.</h2></div>
<h3>More from this Author</h3>
<ul class="author-more"><li><a href="https://alistapart.com/article/approaching-content-strategy-for-personalized-websites">Approaching Content Strategy for Personalized Websites</a></li>
</ul>
</footer>]]></description>
      <link>http://alistapart.com/article/emerging-ux-role-in-personalization</link>
      <guid>http://alistapart.com/article/emerging-ux-role-in-personalization</guid>
      <pubDate>Thu, 17 Jan 2019 02:01:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[Conversations with Robots: Voice, Smart Agents &amp; the Case for Structured Content]]></title>
      <description><![CDATA[<p>In late 2016, <a href="https://www.gartner.com/smarterwithgartner/gartner-predicts-a-virtual-world-of-exponential-change/">Gartner predicted</a> that 30 percent of web browsing sessions would be done without a screen by 2020. Earlier the same year, <a href="https://www.campaignlive.co.uk/article/just-say-it-future-search-voice-personal-digital-assistants/1392459">Comscore had predicted</a> that half of all searches would be voice searches by 2020. Though there’s <a href="https://econsultancy.com/the-state-of-mobile-voice-search-in-2018/">recent evidence</a> to suggest that the 2020 picture may be more complicated than these broad-strokes projections imply, we’re already seeing the impact that voice search, artificial intelligence, and smart software agents like Alexa and Google Assistant are making on the way information is found and consumed on the web.</p>


<p>In addition to the indexing function that traditional search engines perform, smart agents and AI-powered search algorithms are now bringing into the mainstream two additional modes of accessing information: aggregation and inference. As a result, design efforts that focus on creating visually effective pages are no longer sufficient to ensure the integrity or accuracy of content published on the web. Rather, by focusing on providing access to information in a structured, systematic way that is legible to both humans and machines, content publishers can ensure that their content is both accessible and accurate in these new contexts, whether or not they’re producing chatbots or tapping into AI directly. In this article, we’ll look at the forms and impact of structured content, and we’ll close with a set of resources that can help you get started with a structured content approach to information design.</p>
<h2>The role of structured content</h2>
<p>In their recent book, <a href="https://www.oreilly.com/library/view/designing-connected-content/9780134764061/"><cite>Designing Connected Content</cite></a>, Carrie Hane and Mike Atherton define structured content as content that is “planned, developed, and connected outside an interface so that it’s ready for any interface.” A structured content design approach frames content resources—like articles, recipes, product descriptions, how-tos, profiles, etc.—not as pages to be found and read, but as packages composed of small chunks of content data that all relate to one another in meaningful ways.</p>
<p>In a structured content design process, the relationships between content chunks are explicitly defined and described. This makes both the content chunks and the relationships between them legible to algorithms. Algorithms can then interpret a content package as the “page” I’m looking for—or remix and adapt that same content to give me a list of instructions, the number of stars on a review, the amount of time left until an office closes, and any number of other concise answers to specific questions.</p>
<p>Structured content is already a mainstay of many types of information on the web. Recipe listings, for instance, have been based on structured content for years. When I search, for example, “bouillabaisse recipe” on Google, I’m provided with a standard list of links to recipes, as well as an overview of recipe steps, an image, and a set of tags describing one example recipe:</p>
<figure><img src="https://alistapart.com/d/convo-w-robots/fig1-a.jpg" alt="Google search results page for a bouillabaisse recipe including an image, numbered directions, and tags." /><figcaption>A “featured snippet” for allrecipes.com on the Google results page.</figcaption></figure><figure><img src="https://alistapart.com/d/convo-w-robots/fig1-b.jpg" alt="Google Structured Data Testing tool showing the markup for a bouillabaisse recipe website on the left half of the screen and the structured data attributes and values for structured content on the right half of the screen." /><figcaption>The same allrecipes.com page viewed in <a href="https://search.google.com/structured-data/testing-tool/">Google’s Structured Data Testing Tool</a>. The pane on the right shows the machine-readable values.</figcaption></figure><p>This “featured snippet” view is possible because the content publisher, allrecipes.com, has broken this recipe into the smallest meaningful chunks appropriate for this subject matter and audience, and then expressed information about those chunks and the relationships between them in a machine-readable way. In this example, allrecipes.com has used both semantic HTML and <a href="http://linkeddata.org/faq">linked data</a> to make this content not merely a page, but also legible, accessible data that can be accurately interpreted, adapted, and remixed by algorithms and smart agents. Let’s look at each of these elements in turn to see how they work together across indexing, aggregation, and inference contexts.</p>
<h2>Software agent search and semantic HTML</h2>
<p>Semantic HTML is markup that communicates information about the meaningful relationships between document elements, as opposed to simply describing how they should look on screen. Semantic elements such as heading tags and list tags, for instance, indicate that the text they enclose is a heading (<code>&lt;h1&gt;</code>) for the set of list items (<code>&lt;li&gt;</code>) in the ordered list (<code>&lt;ol&gt;</code>) that follows.</p>
<figure><img src="https://alistapart.com/d/convo-w-robots/fig2.jpg" alt="A combined HTML code editor and preview window showing markup and results for heading, ordered list, and list item HTML tags." /></figure><p>HTML structured in this way is both presentational and semantic because people know what headings and lists look like and mean, and algorithms can recognize them as elements with defined, interpretable relationships.</p>
<p>HTML markup that focuses only on the <em>presentational</em> aspects of a “page” may look perfectly fine to a human reader but be completely illegible to an algorithm. Take, for example, the <a href="https://www.boston.gov/">City of Boston</a> website, redesigned a few years ago in collaboration with top-tier design and development partners. If I want to find information about how to pay a parking ticket, a link from the home page takes me directly to the “How to Pay a Parking Ticket” screen (scrolled to show detail):</p>
<figure><img src="https://alistapart.com/d/convo-w-robots/fig3.jpg" alt="The City of Boston website's “How to Pay a Parking Ticket” page, showing a tabbed view of ways to pay and instructions for the first of those ways, paying online." /></figure><p>As a human reading this page, I easily understand what my options are for paying: I can pay online, in person, by mail, or over the phone. If I ask Google Assistant how to pay a parking ticket in Boston, however, things get a bit confusing:</p>
<figure><img src="https://alistapart.com/d/convo-w-robots/fig4.jpg" alt="Google Assistant app on iPhone with the results of a “how do I pay a parking ticket in Boston” query, showing results only weakly related to the intended content." /></figure><p>None of the links provided in the Google Assistant results take me directly to the “How to Pay a Parking Ticket” page, nor do the descriptions clearly let me know I’m on the right track. (I didn’t ask about requesting a hearing.) This is because the content on the City of Boston parking ticket page is styled to communicate content relationships visually to human readers but is not structured semantically in a way that also communicates those relationships to inquisitive algorithms.</p>
<p>The City of Seattle’s “Pay My Ticket” page, though it lacks the polished visual style of Boston’s site, also communicates parking ticket payment options clearly to human visitors:</p>
<figure><img src="https://alistapart.com/d/convo-w-robots/fig5.jpg" alt="The City of Seattle website‘s “Pay My Ticket” page, showing four methods to pay a parking ticket in a simple, all-text layout." /></figure><p>The equivalent Google Assistant search, however, offers a much more helpful result than we see with Boston. In this case, the Google Assistant result links directly to the “Pay My Ticket” page and also lists several ways I can pay my ticket: online, by mail, and in person.</p>
<figure><img src="https://alistapart.com/d/convo-w-robots/fig6.jpg" alt="Google Assistant app on iPhone with the results of a “how do I pay a parking ticket in Seattle” query, showing nearly the same results as on the desktop web page referenced above." /></figure><p>Despite the visual simplicity of the City of Seattle parking ticket page, it more effectively ensures the integrity of its content across contexts because it’s composed of structured content that is marked up semantically. “Pay My Ticket” is a level-one heading (<code>&lt;h1&gt;</code>), and each of the options below it are level-two headings (<code>&lt;h2&gt;</code>), which indicate that they are subordinate to the level-one element.</p>
<figure><img src="https://alistapart.com/d/convo-w-robots/fig7.jpg" alt="The City of Seattle website’s “Pay My Ticket” page, with the HTML heading elements outlined and labeled for illustration." /></figure><p>These elements, when designed well, communicate information hierarchy and relationships visually to readers, and semantically to algorithms. This structure allows Google Assistant to reasonably surmise that the text in these <code>&lt;h2&gt;</code> headings represents payment options under the <code>&lt;h1&gt;</code> heading “Pay My Ticket.”</p>
<p>While this use of semantic HTML offers distinct advantages over the “page display” styling we saw on the City of Boston’s site, the Seattle page also shows a weakness that is typical of manual approaches to semantic HTML. You’ll notice that, in the Google Assistant results, the “Pay by Phone” option we saw on the web page was not listed. If we look at the markup of this page, we can see that while the three options found by Google Assistant are wrapped in both <code>&lt;strong&gt;</code> and <code>&lt;h2&gt;</code> tags, “Pay by Phone” is only marked up with an <code>&lt;h2&gt;</code>. This irregularity in semantic structure may be what’s causing Google Assistant to omit this option from its results.</p>
<figure><img src="https://alistapart.com/d/convo-w-robots/fig8.jpg" alt="The City of Seattle website’s 'Pay My Ticket' page, with two HTML heading elements outlined and labeled for illustration, and an open inspector panel, where we can see that the headings look the same to viewers but are marked up differently in the code." /></figure><p>Although each of these elements would look the same to a sighted human creating this page, the machine interpreting it reads a difference. While WYSIWYG text entry fields can theoretically support semantic HTML, in practice they all too often fall prey to the idiosyncrasies of even the most well-intentioned content authors. By making meaningful content structure a core element of a site’s content management system, organizations can create semantically correct HTML for every element, every time. This is also the foundation that makes it possible to capitalize on the rich relationship descriptions afforded by linked data.</p>
<h2>Linked data and content aggregation</h2>
<p>In addition to finding and excerpting information, such as recipe steps or parking ticket payment options, search and software agent algorithms also now aggregate content from multiple sources by using linked data.</p>
<p>In its most basic form, <em>linked data</em> is “<a href="http://linkeddata.org/faq">a set of best practices for connecting structured data on the web</a>.” Linked data extends the basic capabilities of semantic HTML by describing not only what kind of thing a page element is (“Pay My Ticket” is an <code>&lt;h1&gt;</code>), but also the real-world concept that thing represents: this <code>&lt;h1&gt;</code> represents a “pay action,” which inherits the structural characteristics of “trade actions” (the exchange of goods and services for money) and “actions” (activities carried out by an agent upon an object). Linked data creates a richer, more nuanced description of the relationship between page elements, and it provides the structural and conceptual information that algorithms need to meaningfully bring data together from disparate sources.</p>
<p>Say, for example, that I want to gather more information about two recommendations I’ve been given for orthopedic surgeons. A search for a first recommendation, Scott Ruhlman, MD, brings up a set of links as well as a <a href="https://en.wikipedia.org/wiki/Knowledge_Graph">Knowledge Graph</a> info box containing a photo, location, hours, phone number, and reviews from the web.</p>
<figure><img src="https://alistapart.com/d/convo-w-robots/fig9.jpg" alt="Google search results page for Scott Ruhlman, MD, showing a list of standard links and an info box with an image, a map, ratings, an address, and reviews information." /></figure><p>If we run Dr. Ruhlman’s Swedish Hospital profile page through Google’s <a href="https://search.google.com/structured-data/testing-tool">Structured Data Testing Tool</a>, we can see that content about him is structured as small, discrete elements, each of which is marked up with descriptive types and attributes that communicate both the meaning of those attributes’ values and the way they fit together as a whole—all in a machine-readable format.</p>
<figure><img src="https://alistapart.com/d/convo-w-robots/fig10.jpg" alt="Google Structured Data Testing tool, showing the markup for Dr. Ruhlman's profile page on the left half of the screen, and the structured data attributes and values for the structured content on that page on the right half of the screen." /></figure><p>In this example, Dr. Ruhlman’s profile is marked up with microdata based on the <a href="https://schema.org/">schema.org</a> vocabulary. Schema.org is a collaborative effort backed by Google, Yahoo, Bing, and Yandex that aims to create a common language for digital resources on the web. This structured content foundation provides the semantic base on which additional content relationships can be built. The Knowledge Graph info box, for instance, includes Google reviews, which are not part of Dr. Ruhlman’s profile, but which have been aggregated into this overview. The overview also includes an interactive map, made possible because Dr. Ruhlman’s office location is machine-readable.</p>
<figure><img src="https://alistapart.com/d/convo-w-robots/fig11.jpg" alt="Google search results info box for Dr. Ruhlman, showing an photo; a map; ratings; an address; reviews; buttons to ask a question, leave a review, and add a photo; and other people searched for." /></figure><p>The search for a second recommendation, Stacey Donion, MD, provides a very different experience. Like the City of Boston site above, Dr. Donion’s profile on the Kaiser Permanente website is perfectly intelligible to a sighted human reader. But because its markup is entirely presentational, its content is virtually invisible to software agents.</p>
<figure><img src="https://alistapart.com/d/convo-w-robots/fig12.jpg" alt="Google search results page for Dr. Donion, showing a list of standard links for Dr. Donion, and a 'Did you mean: Dr Stacy Donlon MD' link at the top. There is a Google info box, as with the previous search results page example. But in this case the box does not display information about the doctor we searched for, Dr. Donion, but rather for 'Kaiser Permanente Orthopedics: Morris Joseph MD.'" /></figure><p>In this example, we can see that Google is able to find plenty of links to Dr. Donion in its standard index results, but it isn’t able to “understand” the information about those sources well enough to present an aggregated result. In this case, the Knowledge Graph knows Dr. Donion is a Kaiser Permanente physician, but it pulls in the wrong location and the wrong physician’s name in its attempt to build a Knowledge Graph display.</p>
<p>You’ll also notice that while Dr. Stacey Donion is an exact match in all of the listed search results—which are numerous enough to fill the first results page—we’re shown a “did you mean” link for a different doctor. Stacy Donlon, MD, is a neurologist who practices at MultiCare Neuroscience Center, which is not affiliated with Kaiser Permanente. Multicare does, however, provide semantic and linked data-rich profiles for their physicians.</p>
<h2>Voice queries and content inference</h2>
<p>The increasing prevalence of voice as a mode of access to information makes providing structured, machine-intelligible content all the more important. Voice and smart software agents are not just freeing users from their keyboards, they’re changing user behavior. According to <a href="http://www.lsainsider.com/how-voice-search-queries-differ-from-non-voice-queries/archives">LSA Insider</a>, there are several important differences between voice queries and typed queries. Voice queries tend to be:</p>
<ul><li>longer;</li>
<li>more likely to ask who, what, and where;</li>
<li>more conversational;</li>
<li>and more specific.</li>
</ul><p>In order to tailor results to these more specifically formulated queries, software agents have begun inferring intent and then using the linked data at their disposal to assemble a targeted, concise response. If I ask Google Assistant what time Dr. Ruhlman’s office closes, for instance, it responds, “Dr. Ruhlman’s office closes at 5 p.m.,” and displays this result:</p>
<figure><img src="https://alistapart.com/d/convo-w-robots/fig13.jpg" alt="Google Assistant app on iPhone with the results of a “what time does dr. ruhlman office close” query. The results displayed include a card with “8:30AM–5:00PM” and the label, “Dr. Ruhlman Scott MD, Tuesday hours,” as well as links to call the office, search on Google, get directions, and visit a website. Additionally, there are four buttons labeled with the words “directions,” “phone number,” and “address,” and a thumbs-up emoji." /></figure><p>These results are not only aggregated from disparate sources, but are interpreted and remixed to provide a customized response to my specific question. Getting directions, placing a phone call, and accessing Dr. Ruhlman’s profile page on swedish.org are all at the tips of my fingers.</p>
<p>When I ask Google Assistant what time Dr. Donion’s office closes, the result is not only less helpful but actually points me in the wrong direction. Instead of a targeted selection of focused actions to follow up on my query, I’m presented with the hours of operation and contact information for MultiCare Neuroscience Center.</p>
<figure><img src="https://alistapart.com/d/convo-w-robots/fig14.jpg" alt="Google Assistant app on iPhone with the results of a “what time does Doc Dr Stacey donion office close” query. The results displayed include a card with “8AM–5PM” and the label “MulitCare Neuroscience Center, Monday hours,” as well as links to call the office, search on Google, get directions, or visit a website." /></figure><p>MultiCare Neuroscience Center, you’ll recall, is where Dr. Donlon—the neuroscientist Google thinks I may be looking for, not the orthopedic surgeon I’m actually looking for—practices. Dr. Donlon’s profile page, much like Dr. Ruhlman’s, is semantically structured and marked up with linked data.</p>
<p>To be fair, subsequent trials of this search did produce the generic (and partially incorrect) practice location for Dr. Donion (“Kaiser Permanente Orthopedics: Morris Joseph MD”). It is possible that through repeated exposure to the search term “Dr. Stacey Donion,” Google Assistant fine-tuned the responses it provided. The initial result, however, suggests that smart agents may be at least partially susceptible to the same <a href="https://en.wikipedia.org/wiki/Availability_heuristic">availability heuristic</a> that affects humans, wherein the information that is easiest to recall often seems the most correct.</p>
<p>There’s not enough evidence in this small sample to support a broad claim that algorithms have “cognitive” bias, but even when we allow for potentially confounding variables, we can see the compounding problems we risk by ignoring structured content. “Donlon,” for example, may well be a more common name than “Donion” and may be easily mistyped on a QWERTY keyboard. Regardless, the Kaiser Permanente result we’re given above for Dr. Donion is for the wrong physician. Furthermore, in the Google Assistant voice search, the interaction format doesn’t verify whether we meant Dr. Donlon; it just provides us with her facility’s contact information. In these cases, providing clear, machine-readable content can only work to our advantage.</p>
<h2>The business case for structured content design</h2>
<p>In 2012, content strategist Karen McGrane wrote that “you don’t get to decide which platform or device your customers use to access your content: <em>they</em> do.”</p>
<p>This statement was intended to help designers, strategists, and businesses prepare for the imminent rise of mobile. It continues to ring true for the era of linked data. With the growing prevalence of smart assistants and voice-based queries, an organization’s website is less and less likely to be a potential visitor’s first encounter with rich content. In many cases—such as finding location information, hours, phone numbers, and ratings—this pre-visit engagement may be a user’s only interaction with an information source.</p>
<p>These kinds of quick interactions, however, are only one small piece of a much larger issue: linked data is increasingly key to maintaining the integrity of content online. The organizations I’ve used as examples, like the hospitals, government agencies, and colleges I’ve consulted with for years, don’t measure the success of their communications efforts in page views or ad clicks. Success for them means connecting patients, constituents, and community members with services and accurate information about the organization, wherever that information might be found. This communication-based definition of success readily applies to virtually any type of organization working to further its business goals on the web.</p>
<p>The model of building pages and then expecting users to discover and parse those pages to answer questions, though time-tested in the pre-voice era, is quickly becoming insufficient for effective communication. It precludes organizations from participating in emergent patterns of information seeking and discovery. And—as we saw in the case of searching for information about physicians—it may lead software agents to make inferences based on insufficient or erroneous information, potentially routing customers to competitors who communicate more effectively.</p>
<p>By communicating clearly in a digital context that now includes aggregation and inference, organizations are more effectively able to speak to their users where users actually are, be it on a website, a search engine results page, or a voice-controlled digital assistant. They are also able to maintain greater control over the accuracy of their messages by ensuring that the correct content can be found and communicated across contexts.</p>
<h2>Getting started: who and how</h2>
<p>Design practices that build bridges between user needs and technology requirements to meet business goals are crucial to making this vision a reality. Information architects, content strategists, developers, and experience designers all have a role to play in designing and delivering effective structured content solutions.</p>
<p>Practitioners from across the design community have shared a wealth of resources in recent years on creating content systems that work for humans and algorithms alike. To learn more about implementing a structured content approach for your organization, these books and articles are a great place to start:</p>
<ul><li><a href="https://rosenfeldmedia.com/books/content-everywhere/"><cite>Content Everywhere</cite></a>, Sara Wachter-Boettcher</li>
<li>“<a href="https://alistapart.com/article/content-modelling-a-master-skill">Content Modelling: A Master Skill</a>,” Rachel Lovinger</li>
<li><a href="https://abookapart.com/products/content-strategy-for-mobile"><cite>Content Strategy for Mobile</cite></a>, Karen McGrane</li>
<li><a href="https://www.oreilly.com/library/view/designing-connected-content/9780134764061/"><cite>Designing Connected Content</cite></a>, Carrie Hane and Mike Atherton</li>
</ul><footer class="entry-footer nocontent"><h1>About the Author</h1>
<div class="byline author vcard"><a class="photo" href="https://alistapart.com/author/andyfitzgerald"><img src="https://alistapart.com/d/_made/pix/authors/photos/andy-fitz_120_120_c1.jpg" alt="Image of Andy Fitzgerald" /></a>
<h2>
Andy Fitzgerald is an independent designer whose practice focuses on user research, information architecture, interaction design, and prototyping. He works with organizations of all sizes to create elegant, purpose-driven solutions to complex information problems. Andy is an active member of the IA and UX communities, and speaks and facilitates workshops at conferences all over the world.</h2></div>

</footer>]]></description>
      <link>http://alistapart.com/article/conversations-with-robots</link>
      <guid>http://alistapart.com/article/conversations-with-robots</guid>
      <pubDate>Thu, 10 Jan 2019 02:01:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[<![CDATA[ Conversations with Robots: Voice, Smart Agents & the Case for Structured Content ]]]]><![CDATA[>]]></title>
      <description><![CDATA[<div class="entry-content">
<p>In late 2016, <a href="https://www.gartner.com/smarterwithgartner/gartner-predicts-a-virtual-world-of-exponential-change/">Gartner predicted</a> that 30 percent of web browsing sessions would be done without a screen by 2020. Earlier the same year, <a href="https://www.campaignlive.co.uk/article/just-say-it-future-search-voice-personal-digital-assistants/1392459">Comscore had predicted</a> that half of all searches would be voice searches by 2020. Though there’s <a href="https://econsultancy.com/the-state-of-mobile-voice-search-in-2018/">recent evidence</a> to suggest that the 2020 picture may be more complicated than these broad-strokes projections imply, we’re already seeing the impact that voice search, artificial intelligence, and smart software agents like Alexa and Google Assistant are making on the way information is found and consumed on the web.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>In addition to the indexing function that traditional search engines perform, smart agents and AI-powered search algorithms are now bringing into the mainstream two additional modes of accessing information: aggregation and inference. As a result, design efforts that focus on creating visually effective pages are no longer sufficient to ensure the integrity or accuracy of content published on the web. Rather, by focusing on providing access to information in a structured, systematic way that is legible to both humans and machines, content publishers can ensure that their content is both accessible and accurate in these new contexts, whether or not they’re producing chatbots or tapping into AI directly. In this article, we’ll look at the forms and impact of structured content, and we’ll close with a set of resources that can help you get started with a structured content approach to information design.</p>
<h2>The role of structured content<a class="subhead-anchor" href="#section1">#section1</a></h2>
<p>In their recent book, <a href="https://www.oreilly.com/library/view/designing-connected-content/9780134764061/"><cite>Designing Connected Content</cite></a>, Carrie Hane and Mike Atherton define structured content as content that is “planned, developed, and connected outside an interface so that it’s ready for any interface.” A structured content design approach frames content resources—like articles, recipes, product descriptions, how-tos, profiles, etc.—not as pages to be found and read, but as packages composed of small chunks of content data that all relate to one another in meaningful ways.</p>
<p>In a structured content design process, the relationships between content chunks are explicitly defined and described. This makes both the content chunks and the relationships between them legible to algorithms. Algorithms can then interpret a content package as the “page” I’m looking for—or remix and adapt that same content to give me a list of instructions, the number of stars on a review, the amount of time left until an office closes, and any number of other concise answers to specific questions.</p>
<p>Structured content is already a mainstay of many types of information on the web. Recipe listings, for instance, have been based on structured content for years. When I search, for example, “bouillabaisse recipe” on Google, I’m provided with a standard list of links to recipes, as well as an overview of recipe steps, an image, and a set of tags describing one example recipe:</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2019/01/fig1-a.jpg" alt="Google search results page for a bouillabaisse recipe including an image, numbered directions, and tags." /><figcaption>A “featured snippet” for allrecipes.com on the Google results page.</figcaption></figure><figure><img src="https://alistapart.com/wp-content/uploads/2019/01/fig1-b.jpg" alt="Google Structured Data Testing tool showing the markup for a bouillabaisse recipe website on the left half of the screen and the structured data attributes and values for structured content on the right half of the screen." /><figcaption>The same allrecipes.com page viewed in <a href="https://search.google.com/structured-data/testing-tool/">Google’s Structured Data Testing Tool</a>. The pane on the right shows the machine-readable values.</figcaption></figure><p>This “featured snippet” view is possible because the content publisher, allrecipes.com, has broken this recipe into the smallest meaningful chunks appropriate for this subject matter and audience, and then expressed information about those chunks and the relationships between them in a machine-readable way. In this example, allrecipes.com has used both semantic HTML and <a href="http://linkeddata.org/faq">linked data</a> to make this content not merely a page, but also legible, accessible data that can be accurately interpreted, adapted, and remixed by algorithms and smart agents. Let’s look at each of these elements in turn to see how they work together across indexing, aggregation, and inference contexts.</p>
<h2>Software agent search and semantic HTML<a class="subhead-anchor" href="#section2">#section2</a></h2>
<p>Semantic HTML is markup that communicates information about the meaningful relationships between document elements, as opposed to simply describing how they should look on screen. Semantic elements such as heading tags and list tags, for instance, indicate that the text they enclose is a heading (<code>&lt;h1&gt;</code>) for the set of list items (<code>&lt;li&gt;</code>) in the ordered list (<code>&lt;ol&gt;</code>) that follows.</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2019/01/fig2.jpg" alt="A combined HTML code editor and preview window showing markup and results for heading, ordered list, and list item HTML tags." /><br /></figure><p>HTML structured in this way is both presentational and semantic because people know what headings and lists look like and mean, and algorithms can recognize them as elements with defined, interpretable relationships.</p>
<p>HTML markup that focuses only on the <em>presentational</em> aspects of a “page” may look perfectly fine to a human reader but be completely illegible to an algorithm. Take, for example, the <a href="https://www.boston.gov/">City of Boston</a> website, redesigned a few years ago in collaboration with top-tier design and development partners. If I want to find information about how to pay a parking ticket, a link from the home page takes me directly to the “How to Pay a Parking Ticket” screen (scrolled to show detail):</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2019/01/fig3.jpg" alt="The City of Boston website's “How to Pay a Parking Ticket” page, showing a tabbed view of ways to pay and instructions for the first of those ways, paying online." /><br /></figure><p>As a human reading this page, I easily understand what my options are for paying: I can pay online, in person, by mail, or over the phone. If I ask Google Assistant how to pay a parking ticket in Boston, however, things get a bit confusing:</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2019/01/fig4.jpg" alt="Google Assistant app on iPhone with the results of a “how do I pay a parking ticket in Boston” query, showing results only weakly related to the intended content." /><br /></figure><p>None of the links provided in the Google Assistant results take me directly to the “How to Pay a Parking Ticket” page, nor do the descriptions clearly let me know I’m on the right track. (I didn’t ask about requesting a hearing.) This is because the content on the City of Boston parking ticket page is styled to communicate content relationships visually to human readers but is not structured semantically in a way that also communicates those relationships to inquisitive algorithms.</p>
<p>The City of Seattle’s “Pay My Ticket” page, though it lacks the polished visual style of Boston’s site, also communicates parking ticket payment options clearly to human visitors:</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2019/01/fig5.jpg" alt="The City of Seattle website‘s “Pay My Ticket” page, showing four methods to pay a parking ticket in a simple, all-text layout." /><br /></figure><p>The equivalent Google Assistant search, however, offers a much more helpful result than we see with Boston. In this case, the Google Assistant result links directly to the “Pay My Ticket” page and also lists several ways I can pay my ticket: online, by mail, and in person.</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2019/01/fig6.jpg" alt="Google Assistant app on iPhone with the results of a “how do I pay a parking ticket in Seattle” query, showing nearly the same results as on the desktop web page referenced above." /><br /></figure><p>Despite the visual simplicity of the City of Seattle parking ticket page, it more effectively ensures the integrity of its content across contexts because it’s composed of structured content that is marked up semantically. “Pay My Ticket” is a level-one heading (<code>&lt;h1&gt;</code>), and each of the options below it are level-two headings (<code>&lt;h2&gt;</code>), which indicate that they are subordinate to the level-one element.</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2019/01/fig7.jpg" alt="The City of Seattle website’s “Pay My Ticket” page, with the HTML heading elements outlined and labeled for illustration." /><br /></figure><p>These elements, when designed well, communicate information hierarchy and relationships visually to readers, and semantically to algorithms. This structure allows Google Assistant to reasonably surmise that the text in these <code>&lt;h2&gt;</code> headings represents payment options under the <code>&lt;h1&gt;</code> heading “Pay My Ticket.”</p>
<p>While this use of semantic HTML offers distinct advantages over the “page display” styling we saw on the City of Boston’s site, the Seattle page also shows a weakness that is typical of manual approaches to semantic HTML. You’ll notice that, in the Google Assistant results, the “Pay by Phone” option we saw on the web page was not listed. If we look at the markup of this page, we can see that while the three options found by Google Assistant are wrapped in both <code>&lt;strong&gt;</code> and <code>&lt;h2&gt;</code> tags, “Pay by Phone” is only marked up with an <code>&lt;h2&gt;</code>. This irregularity in semantic structure may be what’s causing Google Assistant to omit this option from its results.</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2019/01/fig8.jpg" alt="The City of Seattle website’s 'Pay My Ticket' page, with two HTML heading elements outlined and labeled for illustration, and an open inspector panel, where we can see that the headings look the same to viewers but are marked up differently in the code." /><br /></figure><p>Although each of these elements would look the same to a sighted human creating this page, the machine interpreting it reads a difference. While WYSIWYG text entry fields can theoretically support semantic HTML, in practice they all too often fall prey to the idiosyncrasies of even the most well-intentioned content authors. By making meaningful content structure a core element of a site’s content management system, organizations can create semantically correct HTML for every element, every time. This is also the foundation that makes it possible to capitalize on the rich relationship descriptions afforded by linked data.</p>
<h2>Linked data and content aggregation<a class="subhead-anchor" href="#section3">#section3</a></h2>
<p>In addition to finding and excerpting information, such as recipe steps or parking ticket payment options, search and software agent algorithms also now aggregate content from multiple sources by using linked data.</p>
<p>In its most basic form, <em>linked data</em> is “<a href="http://linkeddata.org/faq">a set of best practices for connecting structured data on the web</a>.” Linked data extends the basic capabilities of semantic HTML by describing not only what kind of thing a page element is (“Pay My Ticket” is an <code>&lt;h1&gt;</code>), but also the real-world concept that thing represents: this <code>&lt;h1&gt;</code> represents a “pay action,” which inherits the structural characteristics of “trade actions” (the exchange of goods and services for money) and “actions” (activities carried out by an agent upon an object). Linked data creates a richer, more nuanced description of the relationship between page elements, and it provides the structural and conceptual information that algorithms need to meaningfully bring data together from disparate sources.</p>
<p>Say, for example, that I want to gather more information about two recommendations I’ve been given for orthopedic surgeons. A search for a first recommendation, Scott Ruhlman, MD, brings up a set of links as well as a <a href="https://en.wikipedia.org/wiki/Knowledge_Graph">Knowledge Graph</a> info box containing a photo, location, hours, phone number, and reviews from the web.</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2019/01/fig9.jpg" alt="Google search results page for Scott Ruhlman, MD, showing a list of standard links and an info box with an image, a map, ratings, an address, and reviews information." /><br /></figure><p>If we run Dr. Ruhlman’s Swedish Hospital profile page through Google’s <a href="https://search.google.com/structured-data/testing-tool">Structured Data Testing Tool</a>, we can see that content about him is structured as small, discrete elements, each of which is marked up with descriptive types and attributes that communicate both the meaning of those attributes’ values and the way they fit together as a whole—all in a machine-readable format.</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2019/01/fig10.jpg" alt="Google Structured Data Testing tool, showing the markup for Dr. Ruhlman's profile page on the left half of the screen, and the structured data attributes and values for the structured content on that page on the right half of the screen." /><br /></figure><p>In this example, Dr. Ruhlman’s profile is marked up with microdata based on the <a href="https://schema.org/">schema.org</a> vocabulary. Schema.org is a collaborative effort backed by Google, Yahoo, Bing, and Yandex that aims to create a common language for digital resources on the web. This structured content foundation provides the semantic base on which additional content relationships can be built. The Knowledge Graph info box, for instance, includes Google reviews, which are not part of Dr. Ruhlman’s profile, but which have been aggregated into this overview. The overview also includes an interactive map, made possible because Dr. Ruhlman’s office location is machine-readable.</p>
<figure id="figure12"><img src="https://alistapart.com/wp-content/uploads/2019/01/fig11.jpg" alt="Google search results info box for Dr. Ruhlman, showing an photo; a map; ratings; an address; reviews; buttons to ask a question, leave a review, and add a photo; and other people searched for." /><br /></figure><p>The search for a second recommendation, Stacey Donion, MD, provides a very different experience. Like the City of Boston site above, Dr. Donion’s profile on the Kaiser Permanente website is perfectly intelligible to a sighted human reader. But because its markup is entirely presentational, its content is virtually invisible to software agents.</p>
<figure id="figure13"><img src="https://alistapart.com/wp-content/uploads/2019/01/fig12.jpg" alt="Google search results page for Dr. Donion, showing a list of standard links for Dr. Donion, and a 'Did you mean: Dr Stacy Donlon MD' link at the top. There is a Google info box, as with the previous search results page example. But in this case the box does not display information about the doctor we searched for, Dr. Donion, but rather for 'Kaiser Permanente Orthopedics: Morris Joseph MD.'" /><br /></figure><p>In this example, we can see that Google is able to find plenty of links to Dr. Donion in its standard index results, but it isn’t able to “understand” the information about those sources well enough to present an aggregated result. In this case, the Knowledge Graph knows Dr. Donion is a Kaiser Permanente physician, but it pulls in the wrong location and the wrong physician’s name in its attempt to build a Knowledge Graph display.</p>
<p>You’ll also notice that while Dr. Stacey Donion is an exact match in all of the listed search results—which are numerous enough to fill the first results page—we’re shown a “did you mean” link for a different doctor. Stacy Donlon, MD, is a neurologist who practices at MultiCare Neuroscience Center, which is not affiliated with Kaiser Permanente. Multicare does, however, provide semantic and linked data-rich profiles for their physicians.</p>
<h2>Voice queries and content inference<a class="subhead-anchor" href="#section4">#section4</a></h2>
<p>The increasing prevalence of voice as a mode of access to information makes providing structured, machine-intelligible content all the more important. Voice and smart software agents are not just freeing users from their keyboards, they’re changing user behavior. According to <a href="http://www.lsainsider.com/how-voice-search-queries-differ-from-non-voice-queries/archives">LSA Insider</a>, there are several important differences between voice queries and typed queries. Voice queries tend to be:</p>
<ul><li>longer;</li>
<li>more likely to ask who, what, and where;</li>
<li>more conversational;</li>
<li>and more specific.</li>
</ul><p>In order to tailor results to these more specifically formulated queries, software agents have begun inferring intent and then using the linked data at their disposal to assemble a targeted, concise response. If I ask Google Assistant what time Dr. Ruhlman’s office closes, for instance, it responds, “Dr. Ruhlman’s office closes at 5 p.m.,” and displays this result:</p>
<figure id="figure14"><img src="https://alistapart.com/wp-content/uploads/2019/01/fig13.jpg" alt="Google Assistant app on iPhone with the results of a “what time does dr. ruhlman office close” query. The results displayed include a card with “8:30AM–5:00PM” and the label, “Dr. Ruhlman Scott MD, Tuesday hours,” as well as links to call the office, search on Google, get directions, and visit a website. Additionally, there are four buttons labeled with the words “directions,” “phone number,” and “address,” and a thumbs-up emoji." /><br /></figure><p>These results are not only aggregated from disparate sources, but are interpreted and remixed to provide a customized response to my specific question. Getting directions, placing a phone call, and accessing Dr. Ruhlman’s profile page on swedish.org are all at the tips of my fingers.</p>
<p>When I ask Google Assistant what time Dr. Donion’s office closes, the result is not only less helpful but actually points me in the wrong direction. Instead of a targeted selection of focused actions to follow up on my query, I’m presented with the hours of operation and contact information for MultiCare Neuroscience Center.</p>
<figure id="figure15"><img src="https://alistapart.com/wp-content/uploads/2019/01/fig14.jpg" alt="Google Assistant app on iPhone with the results of a “what time does Doc Dr Stacey donion office close” query. The results displayed include a card with “8AM–5PM” and the label “MulitCare Neuroscience Center, Monday hours,” as well as links to call the office, search on Google, get directions, or visit a website." /><br /></figure><p>MultiCare Neuroscience Center, you’ll recall, is where Dr. Donlon—the neuroscientist Google thinks I may be looking for, not the orthopedic surgeon I’m actually looking for—practices. Dr. Donlon’s profile page, much like Dr. Ruhlman’s, is semantically structured and marked up with linked data.</p>
<p>To be fair, subsequent trials of this search did produce the generic (and partially incorrect) practice location for Dr. Donion (“Kaiser Permanente Orthopedics: Morris Joseph MD”). It is possible that through repeated exposure to the search term “Dr. Stacey Donion,” Google Assistant fine-tuned the responses it provided. The initial result, however, suggests that smart agents may be at least partially susceptible to the same <a href="https://en.wikipedia.org/wiki/Availability_heuristic">availability heuristic</a> that affects humans, wherein the information that is easiest to recall often seems the most correct.</p>
<p>There’s not enough evidence in this small sample to support a broad claim that algorithms have “cognitive” bias, but even when we allow for potentially confounding variables, we can see the compounding problems we risk by ignoring structured content. “Donlon,” for example, may well be a more common name than “Donion” and may be easily mistyped on a QWERTY keyboard. Regardless, the Kaiser Permanente result we’re given above for Dr. Donion is for the wrong physician. Furthermore, in the Google Assistant voice search, the interaction format doesn’t verify whether we meant Dr. Donlon; it just provides us with her facility’s contact information. In these cases, providing clear, machine-readable content can only work to our advantage.</p>
<h2>The business case for structured content design<a class="subhead-anchor" href="#section5">#section5</a></h2>
<p>In 2012, content strategist Karen McGrane wrote that “you don’t get to decide which platform or device your customers use to access your content: <em>they</em> do.”</p>
<p>This statement was intended to help designers, strategists, and businesses prepare for the imminent rise of mobile. It continues to ring true for the era of linked data. With the growing prevalence of smart assistants and voice-based queries, an organization’s website is less and less likely to be a potential visitor’s first encounter with rich content. In many cases—such as finding location information, hours, phone numbers, and ratings—this pre-visit engagement may be a user’s only interaction with an information source.</p>
<p>These kinds of quick interactions, however, are only one small piece of a much larger issue: linked data is increasingly key to maintaining the integrity of content online. The organizations I’ve used as examples, like the hospitals, government agencies, and colleges I’ve consulted with for years, don’t measure the success of their communications efforts in page views or ad clicks. Success for them means connecting patients, constituents, and community members with services and accurate information about the organization, wherever that information might be found. This communication-based definition of success readily applies to virtually any type of organization working to further its business goals on the web.</p>
<p>The model of building pages and then expecting users to discover and parse those pages to answer questions, though time-tested in the pre-voice era, is quickly becoming insufficient for effective communication. It precludes organizations from participating in emergent patterns of information seeking and discovery. And—as we saw in the case of searching for information about physicians—it may lead software agents to make inferences based on insufficient or erroneous information, potentially routing customers to competitors who communicate more effectively.</p>
<p>By communicating clearly in a digital context that now includes aggregation and inference, organizations are more effectively able to speak to their users where users actually are, be it on a website, a search engine results page, or a voice-controlled digital assistant. They are also able to maintain greater control over the accuracy of their messages by ensuring that the correct content can be found and communicated across contexts.</p>
<h2>Getting started: who and how<a class="subhead-anchor" href="#section6">#section6</a></h2>
<p>Design practices that build bridges between user needs and technology requirements to meet business goals are crucial to making this vision a reality. Information architects, content strategists, developers, and experience designers all have a role to play in designing and delivering effective structured content solutions.</p>
<p>Practitioners from across the design community have shared a wealth of resources in recent years on creating content systems that work for humans and algorithms alike. To learn more about implementing a structured content approach for your organization, these books and articles are a great place to start:</p>
<ul><li><a href="https://rosenfeldmedia.com/books/content-everywhere/"><cite>Content Everywhere</cite></a>, Sara Wachter-Boettcher</li>
<li>“<a href="https://alistapart.com/article/content-modelling-a-master-skill">Content Modelling: A Master Skill</a>,” Rachel Lovinger</li>
<li><a href="https://abookapart.com/products/content-strategy-for-mobile"><cite>Content Strategy for Mobile</cite></a>, Karen McGrane</li>
<li><a href="https://www.oreilly.com/library/view/designing-connected-content/9780134764061/"><cite>Designing Connected Content</cite></a>, Carrie Hane and Mike Atherton</li>
</ul><div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Our own @zeldman paints the complicated catch-22 that our free, democratized web has with our money-making capitalist roots. As creators, how do we untangle this web? #LetsFixThis</div><div class="entry-content">A month of experiencing a temporary disability changed @fcorradini’s perspective on how to take more care when conducting accessibility testing. He shares the impact.</div><div class="entry-content">Jeremy Wagner plots a course to avoid the unnecessary bloat and inaccessible patterns of current JavaScript trends.</div><div class="entry-content">Technology can easily become a platform for hate, and we have an ethical responsibility to fix it. ALA's own Tatiana Mac discusses</div><div class="entry-content">Screen readers are diverse and complex: front-end developer Melanie Richards breaks down how they access our content step-by-step.</div>]]></description>
      <link>https://alistapart.com/article/conversations-with-robots/</link>
      <guid>https://alistapart.com/article/conversations-with-robots/</guid>
      <pubDate>Thu, 10 Jan 2019 02:01:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[Taming Data with JavaScript]]></title>
      <description><![CDATA[<p>I love data. I also love JavaScript. Yet, data and client-side JavaScript are often considered mutually exclusive. The industry typically sees data processing and aggregation as a back-end function, while JavaScript is just for displaying the pre-aggregated data. Bandwidth and processing time are seen as huge bottlenecks for dealing with data on the client side. And, for the most part, I agree. But there are situations where processing data in the the browser makes perfect sense. In those use cases, how can we be successful?</p>
<h2>Think about the data</h2>


<p>Working with data in JavaScript requires both complete data and an understanding of the tools available without having to make unnecessary server calls. It helps to draw a distinction between trilateral data and summarized data.</p>
<p><em>Trilateral data</em> consists of raw, transactional data. This is the low-level detail that, by itself, is nearly impossible to analyze. On the other side of the spectrum you have your <em>summarized data</em>. This is the data that can be presented in a meaningful and thoughtful manner. We’ll call this our <em>composed data</em>. Most important to developers are the data structures that reside between our transactional details and our fully composed data. This is our “sweet spot.” These datasets are aggregated but contain more than what we need for the final presentation. They are multidimensional in that they have two or more different dimensions (and multiple measures) that provide flexibility for how the data can be presented. These datasets allow your end users to shape the data and extract information for further analysis. They are small and performant, but offer enough detail to allow for insights that you, as the author, may not have anticipated.</p>
<p>Getting your data into perfect form so you can avoid any and all manipulation in the front end doesn’t need to be the goal. Instead, get the data reduced to a multidimensional dataset. Define several key dimensions (e.g., people, products, places, and time) and measures (e.g., sum, count, average, minimum, and maximum) that your client would be interested in. Finally, present the data on the page with form elements that can slice the data in a way that allows for deeper analysis.</p>
<p>Creating datasets is a delicate balance. You’ll want to have enough data to make your analytics meaningful without putting too much stress on the client machine. This means coming up with clear, concise requirements. Depending on how wide your dataset is, you might need to include a lot of different dimensions and metrics. A few things to keep in mind:</p>
<ul><li>Is the variety of content an edge case or something that will be used frequently? Go with the 80/20 rule: 80% of users generally need 20% of what’s available.</li>
<li>Is each dimension finite? Dimensions should always have a predetermined set of values. For example, an ever-increasing product inventory might be too overwhelming, whereas product categories might work nicely.</li>
<li>When possible, aggregate the data—dates especially. If you can get away with aggregating by years, do it. If you need to go down to quarters or months, you can, but avoid anything deeper.</li>
<li>Less is more. A dimension that has fewer values is better for performance. For instance, take a dataset with 200 rows. If you add another dimension that has four possible values, the most it will grow is 200 * 4 = 800 rows. If you add a dimension that has 50 values, it’ll grow 200 * 50 = 10,000 rows. This will be compounded with each dimension you add.</li>
<li>In multidimensional datasets, avoid summarizing measures that need to be recalculated every time the dataset changes. For instance, if you plan to show averages, you should include the total and the count. Calculate averages dynamically. This way, if you are summarizing the data, you can recalculate averages using the summarized values.</li>
</ul><p>Make sure you understand the data you’re working with before attempting any of the above. You could make some wrong assumptions that lead to misinformed decisions. Data quality is always a top priority. This applies to the data you are both querying and manufacturing.</p>
<p>Never take a dataset and make assumptions about a dimension or a measure. Don’t be afraid to ask for <a href="http://library.ucmerced.edu/node/10249">data dictionaries</a> or other documentation about the data to help you understand what you are looking at. Data analysis is not something that you guess. There could be business rules applied, or data could be filtered out beforehand. If you don’t have this information in front of you, you can easily end up composing datasets and visualizations that are meaningless or—even worse—completely misleading.</p>
<p>The following code example will help explain this further. <a href="https://github.com/ignoreintuition/tamingData">Full code for this example can be found on GitHub.</a></p>
<h2>Our use case</h2>
<p>For our example we will use <a href="https://github.com/BuzzFeedNews/2015-11-refugees-in-the-united-states">BuzzFeed’s dataset</a> from “Where U.S. Refugees Come From—and Go—in Charts.” We’ll build a small app that shows us the number of refugees arriving in a selected state for a selected year. Specifically, we will show one of the following depending on the user’s request:</p>
<ul><li>total arrivals for a state in a given year;</li>
<li>total arrivals for all years for a given state;</li>
<li>and total arrivals for all states in a given year.</li>
</ul><p>The UI for selecting your state and year would be a simple form:</p>
<figure><img src="https://alistapart.com/d/taming-data-with-javascript/fig1.png" alt="Our UI for our data input" /></figure><p>The code will:</p>
<ol><li>Send a request for the data.</li>
<li>Convert the results to JSON.</li>
<li>Process the data.</li>
<li>Log any errors to the console. (<em>Note: To ensure that step 3 does not execute until after the complete dataset is retrieved, we use the then method and do all of our data processing within that block.</em>)</li>
<li>Display results back to the user.</li>
</ol><p>We do not want to pass excessively large datasets over the wire to browsers for two main reasons: bandwidth and CPU considerations. Instead, we’ll aggregate the data on the server with Node.js.</p>
<p><strong>Source data:</strong></p>
<pre><code class="language-javascript">[{"year":2005,"origin":"Afghanistan","dest_state":"Alabama","dest_city":"Mobile","arrivals":0},
{"year":2006,"origin":"Afghanistan","dest_state":"Alabama","dest_city":"Mobile","arrivals":0},
... ]</code></pre>
<p><strong>Multidimensional Data:</strong></p>
<pre><code class="language-javascript">[{"year": 2005, "state": "Alabama","total": 1386}, 
 {"year": 2005, "state": "Alaska", "total": 989}, 
... ]</code></pre>
<figure><img src="https://alistapart.com/d/taming-data-with-javascript/fig2.png" alt="Transactional Details show several items with Year, Origin, Destination, City, and Arrivals. This is filtered through semi-aggregate data: By Year, By State, and Total. In the final column, we see a table with the fully composed data resulting from running the Transactional Details through the semi-aggregate data." /></figure><h2>How to get your data structure into place</h2>
<h3>AJAX and the Fetch API</h3>
<p>There are a number of ways with JavaScript to retrieve data from an external source. Historically you would use an <a href="https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest">XHR request</a>. XHR is widely supported but is also fairly complex and requires several different methods. There are also libraries like <a href="https://github.com/axios/axios">Axios</a> or <a href="https://api.jquery.com/jquery.ajax/">jQuery’s AJAX API</a>. These can be helpful to reduce complexity and provide cross-browser support. These might be an option if you are already using these libraries, but we want to opt for native solutions whenever possible. Lastly, there is the more recent <a href="https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API">Fetch API</a>. This is <a href="https://caniuse.com/#search=fetch">less widely supported</a>, but it is straightforward and chainable. And if you are using a transpiler (e.g., <a href="https://babeljs.io/">Babel</a>), it will convert your code to a more widely supported equivalent.</p>
<p>For our use case, we’ll use the Fetch API to pull the data into our application:</p>
<pre><code class="language-javascript">window.fetchData = window.fetchData || {};
  fetch('./data/aggregate.json')
  .then(response =&gt; {
      // when the fetch executes we will convert the response
      // to json format and pass it to .then()
      return response.json();
  }).then(jsonData =&gt; {
      // take the resulting dataset and assign to a global object
      window.fetchData.jsonData = jsonData;
  }).catch(err =&gt; {
      console.log("Fetch process failed", err);
  });</code></pre>
<p>This code is a snippet from the main.js in the GitHub repo</p>
<p>The <code>fetch()</code> method sends a request for the data, and we convert the results to JSON. To ensure that the next statement doesn’t execute until after the complete dataset is retrieved, we use the <code>then()</code> method and do all our data processing within that block. Lastly, we <code>console.log()</code> any errors.</p>
<p>Our goal here is to identify the key dimensions we need for reporting—year and state—before we aggregate the number of arrivals for those dimensions, removing country of origin and destination city. You can refer to the Node.js script <code>/preprocess/index.js</code> from the GitHub repo for more details on how we accomplished this. It generates the <code>aggregate.json</code> file loaded by <code>fetch()</code> above.</p>
<h3>Multidimensional data</h3>
<p>The goal of multidimensional formatting is flexibility: data detailed enough that the user doesn’t need to send a query back to the server every time they want to answer a different question, but summarized so that your application isn’t churning through the entire dataset with every new slice of data. You need to anticipate the questions and provide data that formulates the answers. Clients want to be able to do some analysis without feeling constrained or completely overwhelmed.</p>
<p>As with most APIs, we’ll be working with JSON data. <a href="http://json.org/">JSON</a> is a standard that is used by most APIs to send data to applications as objects consisting of name and value pairs. Before we get back to our use case, let’s look at a sample multidimensional dataset:</p>
<pre><code class="language-javascript">const ds = [{
  "year": 2005,
  "state": "Alabama",
  "total": 1386,
  "priorYear": 1201
}, {
  "year": 2005,
  "state": "Alaska",
  "total": 811,
  "priorYear": 1541
}, {
  "year": 2006,
  "state": "Alabama",
  "total": 989,
  "priorYear": 1386
}];</code></pre>
<p>With your dataset properly aggregated, we can use JavaScript to further analyze it. Let’s take a look at some of JavaScript’s native array methods for composing data.</p>
<h2>How to work effectively with your data via JavaScript</h2>
<h3><code>Array.filter()</code></h3>
<p>The <code>filter()</code> method of the <code>Array</code> prototype (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter"><code>Array.prototype.filter()</code></a>) takes a function that tests every item in the array, returning another array containing only the values that passed the test. It allows you to create meaningful subsets of the data based on select dropdown or text filters. Provided you included meaningful, discrete dimensions for your multidimensional dataset, your user will be able to gain insight by viewing individual slices of data.</p>
<pre><code class="language-javascript">ds.filter(d =&gt; d.state === "Alabama");
// Result
[{
  state: "Alabama",
  total: 1386,
  year: 2005,
  priorYear: 1201
},{
  state: "Alabama",
  total: 989,
  year: 2006,
  priorYear: 1386
}]</code></pre>
<h3><code>Array.map()</code></h3>
<p>The <code>map()</code> method of the <code>Array</code> prototype (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map"><code>Array.prototype.map()</code></a>) takes a function and runs every array item through it, returning a new array with an equal number of elements. Mapping data gives you the ability to create related datasets. One use case for this is to map ambiguous data to more meaningful, descriptive data. Another is to take metrics and perform calculations on them to allow for more in-depth analysis.</p>
<p><strong>Use case #1—map data to more meaningful data:</strong></p>
<pre><code class="language-javascript">ds.map(d =&gt; (d.state.indexOf("Alaska")) ? "Contiguous US" : "Continental US");
// Result
[
  "Contiguous US", 
  "Continental US", 
  "Contiguous US"
]</code></pre>
<p><strong>Use case #2—map data to calculated results:</strong></p>
<pre><code class="language-javascript">ds.map(d =&gt; Math.round(((d.priorYear - d.total) / d.total) * 100));
// Result
[-13, 56, 40]</code></pre>
<h3><code>Array.reduce()</code></h3>
<p>The <code>reduce()</code> method of the <code>Array</code> prototype (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/reduce"><code>Array.prototype.reduce()</code></a>) takes a function and runs every array item through it, returning an aggregated result. It’s most commonly used to do math, like to add or multiply every number in an array, although it can also be used to concatenate strings or do many other things. I have always found this one tricky; it’s best learned through example.</p>
<p>When presenting data, you want to make sure it is summarized in a way that gives insight to your users. Even though you have done some general-level summarizing of the data server-side, this is where you allow for further aggregation based on the specific needs of the consumer. For our app we want to add up the total for every entry and show the aggregated result. We’ll do this by using <code>reduce()</code> to iterate through every record and add the current value to the accumulator. The final result will be the sum of all values (total) for the array.</p>
<pre><code class="language-javascript">ds.reduce((accumulator, currentValue) =&gt; 
accumulator + currentValue.total, 0);
// Result
3364</code></pre>
<h3>Applying these functions to our use case</h3>
<p>Once we have our data, we will assign an event to the “Get the Data” button that will present the appropriate subset of our data. Remember that we have several hundred items in our JSON data. The code for binding data via our button is in our main.js:</p>
<pre><code class="language-javascript"> document.getElementById("submitBtn").onclick =
  function(e){
      e.preventDefault();
      let state = document.getElementById("stateInput").value || "All"
      let year = document.getElementById("yearInput").value || "All"
      let subset = window.fetchData.filterData(year, state);
      if (subset.length == 0  )
        subset.push({'state': 'N/A', 'year': 'N/A', 'total': 'N/A'})
      document.getElementById("output").innerHTML =
      `&lt;table class="table"&gt;
        &lt;thead&gt;
          &lt;tr&gt;
            &lt;th scope="col"&gt;State&lt;/th&gt;
            &lt;th scope="col"&gt;Year&lt;/th&gt;
            &lt;th scope="col"&gt;Arrivals&lt;/th&gt;
          &lt;/tr&gt;
        &lt;/thead&gt;
        &lt;tbody&gt;
          &lt;tr&gt;
            &lt;td&gt;${subset[0].state}&lt;/td&gt;
            &lt;td&gt;${subset[0].year}&lt;/td&gt;
            &lt;td&gt;${subset[0].total}&lt;/td&gt;
          &lt;/tr&gt;
        &lt;/tbody&gt;
      &lt;/table&gt;`
  }</code></pre>
<figure><img src="https://alistapart.com/d/taming-data-with-javascript/fig3.png?asdf" alt="The final output once our code is applied" /></figure><p>If you leave either the state or year blank, that field will default to “All.” The following code is available in <code>/js/main.js</code>. You’ll want to look at the <code>filterData()</code> function, which is where we keep the lion’s share of the functionality for aggregation and filtering.</p>
<pre><code class="language-javascript">// with our data returned from our fetch call, we are going to 
// filter the data on the values entered in the text boxes
fetchData.filterData = function(yr, state) {
  // if "All" is entered for the year, we will filter on state 
  // and reduce the years to get a total of all years
  if (yr === "All") {
    let total = this.jsonData.filter(
      // return all the data where state
      // is equal to the input box
      dState =&gt; (dState.state === state)
        .reduce((accumulator, currentValue) =&gt; {
          // aggregate the totals for every row that has 
          // the matched value
          return accumulator + currentValue.total;
        }, 0);
    return [{'year': 'All', 'state': state, 'total': total}];
  }
  ...
  // if a specific year and state are supplied, simply
  // return the filtered subset for year and state based 
  // on the supplied values by chaining the two function
  // calls together 
  let subset = this.jsonData.filter(dYr =&gt; dYr.year === yr)
    .filter(dSt =&gt; dSt.state === state);
  return subset; 
};
// code that displays the data in the HTML table follows this. See main.js.</code></pre>
<p>When a state or a year is blank, it will default to “All” and we will filter down our dataset to that particular dimension, and summarize the metric for all rows in that dimension. When both a year and a state are entered, we simply filter on the values.</p>
<p>We now have a working example where we:</p>
<ul><li>Start with a raw, transactional dataset;</li>
<li>Create a semi-aggregated, multidimensional dataset;</li>
<li>And dynamically build a fully composed result.</li>
</ul><p>Note that once the data is pulled down by the client, we can manipulate the data in a number of different ways without having to make subsequent calls to the server. This is especially useful because if the user loses connectivity, they do not lose the ability to manipulate the data. This is useful if you are creating a progressive web app (PWA) that needs to be available offline. (If you are not sure if your web app should be a PWA, <a href="https://alistapart.com/article/yes-that-web-project-should-be-a-pwa">this article</a> can help.)</p>
<p>Once you get a firm handle on these three methods, you can create just about any analysis that you want on a dataset. Map a dimension in your dataset to a broader category and summarize using reduce. Combined with <a href="https://d3js.org/">a library like D3</a>, you can map this data into charts and graphs to allow a fully customizable data visualization.</p>
<h2>Conclusion</h2>
<p>This article gives a better sense of what is possible in JavaScript when working with data. As I mentioned, client-side JavaScript is in no way a substitute for translating and transforming data on the server, where the heavy lifting should be done. But by the same token, it also shouldn’t be completely ruled out when datasets are treated properly.</p>
<footer class="entry-footer nocontent"><h1>About the Author</h1>
<div class="byline author vcard"><a class="photo" href="https://alistapart.com/author/briangreig"><img src="https://alistapart.com/d/_made/pix/authors/photos/brian-greig_120_120_c1.jpg" alt="Image of Brian Greig" /></a>
<h2>
Brian Greig is a manager and developer in Charlotte NC where he works on vendor technology integration and analytics. Having grown up in the era of the first home PCs, Brian has a passion for both modern technology and vintage computers. You will often find him out and about with his family camping, biking, and generally enjoying the outdoors.</h2></div>

</footer>]]></description>
      <link>http://alistapart.com/article/taming-data-with-javascript</link>
      <guid>http://alistapart.com/article/taming-data-with-javascript</guid>
      <pubDate>Thu, 20 Dec 2018 02:12:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[<![CDATA[ Taming Data with JavaScript ]]]]><![CDATA[>]]></title>
      <description><![CDATA[<div class="entry-content">
<p>I love data. I also love JavaScript. Yet, data and client-side JavaScript are often considered mutually exclusive. The industry typically sees data processing and aggregation as a back-end function, while JavaScript is just for displaying the pre-aggregated data. Bandwidth and processing time are seen as huge bottlenecks for dealing with data on the client side. And, for the most part, I agree. But there are situations where processing data in the browser makes perfect sense. In those use cases, how can we be successful?</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<h2>Think about the data<a class="subhead-anchor" href="#section1">#section1</a></h2>
<p>Working with data in JavaScript requires both complete data and an understanding of the tools available without having to make unnecessary server calls. It helps to draw a distinction between trilateral data and summarized data.</p>
<p><em>Trilateral data</em> consists of raw, transactional data. This is the low-level detail that, by itself, is nearly impossible to analyze. On the other side of the spectrum you have your <em>summarized data</em>. This is the data that can be presented in a meaningful and thoughtful manner. We’ll call this our <em>composed data</em>. Most important to developers are the data structures that reside between our transactional details and our fully composed data. This is our “sweet spot.” These datasets are aggregated but contain more than what we need for the final presentation. They are multidimensional in that they have two or more different dimensions (and multiple measures) that provide flexibility for how the data can be presented. These datasets allow your end users to shape the data and extract information for further analysis. They are small and performant, but offer enough detail to allow for insights that you, as the author, may not have anticipated.</p>
<p>Getting your data into perfect form so you can avoid any and all manipulation in the front end doesn’t need to be the goal. Instead, get the data reduced to a multidimensional dataset. Define several key dimensions (e.g., people, products, places, and time) and measures (e.g., sum, count, average, minimum, and maximum) that your client would be interested in. Finally, present the data on the page with form elements that can slice the data in a way that allows for deeper analysis.</p>
<p>Creating datasets is a delicate balance. You’ll want to have enough data to make your analytics meaningful without putting too much stress on the client machine. This means coming up with clear, concise requirements. Depending on how wide your dataset is, you might need to include a lot of different dimensions and metrics. A few things to keep in mind:</p>
<ul><li>Is the variety of content an edge case or something that will be used frequently? Go with the 80/20 rule: 80% of users generally need 20% of what’s available.</li>
<li>Is each dimension finite? Dimensions should always have a predetermined set of values. For example, an ever-increasing product inventory might be too overwhelming, whereas product categories might work nicely.</li>
<li>When possible, aggregate the data—dates especially. If you can get away with aggregating by years, do it. If you need to go down to quarters or months, you can, but avoid anything deeper.</li>
<li>Less is more. A dimension that has fewer values is better for performance. For instance, take a dataset with 200 rows. If you add another dimension that has four possible values, the most it will grow is 200 * 4 = 800 rows. If you add a dimension that has 50 values, it’ll grow 200 * 50 = 10,000 rows. This will be compounded with each dimension you add.</li>
<li>In multidimensional datasets, avoid summarizing measures that need to be recalculated every time the dataset changes. For instance, if you plan to show averages, you should include the total and the count. Calculate averages dynamically. This way, if you are summarizing the data, you can recalculate averages using the summarized values.</li>
</ul><p>Make sure you understand the data you’re working with before attempting any of the above. You could make some wrong assumptions that lead to misinformed decisions. Data quality is always a top priority. This applies to the data you are both querying and manufacturing.</p>
<p>Never take a dataset and make assumptions about a dimension or a measure. Don’t be afraid to ask for <a href="http://library.ucmerced.edu/node/10249">data dictionaries</a> or other documentation about the data to help you understand what you are looking at. Data analysis is not something that you guess. There could be business rules applied, or data could be filtered out beforehand. If you don’t have this information in front of you, you can easily end up composing datasets and visualizations that are meaningless or—even worse—completely misleading.</p>
<p>The following code example will help explain this further. <a href="https://github.com/ignoreintuition/tamingData">Full code for this example can be found on GitHub.</a></p>
<h2>Our use case<a class="subhead-anchor" href="#section2">#section2</a></h2>
<p>For our example we will use <a href="https://github.com/BuzzFeedNews/2015-11-refugees-in-the-united-states">BuzzFeed’s dataset</a> from “Where U.S. Refugees Come From—and Go—in Charts.” We’ll build a small app that shows us the number of refugees arriving in a selected state for a selected year. Specifically, we will show one of the following depending on the user’s request:</p>
<ul><li>total arrivals for a state in a given year;</li>
<li>total arrivals for all years for a given state;</li>
<li>and total arrivals for all states in a given year.</li>
</ul><p>The UI for selecting your state and year would be a simple form:</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2018/12/fig1.png" alt="Our UI for our data input" /><br /></figure><p>The code will:</p>
<ol><li>Send a request for the data.</li>
<li>Convert the results to JSON.</li>
<li>Process the data.</li>
<li>Log any errors to the console. (<em>Note: To ensure that step 3 does not execute until after the complete dataset is retrieved, we use the then method and do all of our data processing within that block.</em>)</li>
<li>Display results back to the user.</li>
</ol><p>We do not want to pass excessively large datasets over the wire to browsers for two main reasons: bandwidth and CPU considerations. Instead, we’ll aggregate the data on the server with Node.js.</p>
<p><strong>Source data:</strong></p>
<pre><code class="language-javascript">[{"year":2005,"origin":"Afghanistan","dest_state":"Alabama","dest_city":"Mobile","arrivals":0},
{"year":2006,"origin":"Afghanistan","dest_state":"Alabama","dest_city":"Mobile","arrivals":0},
... ]</code></pre>
<p><strong>Multidimensional Data:</strong></p>
<pre><code class="language-javascript">[{"year": 2005, "state": "Alabama","total": 1386}, 
 {"year": 2005, "state": "Alaska", "total": 989}, 
... ]</code></pre>
<figure><img src="https://alistapart.com/wp-content/uploads/2018/12/fig2.png" alt="Transactional Details show several items with Year, Origin, Destination, City, and Arrivals. This is filtered through semi-aggregate data: By Year, By State, and Total. In the final column, we see a table with the fully composed data resulting from running the Transactional Details through the semi-aggregate data." /><br /></figure><h2>How to get your data structure into place<a class="subhead-anchor" href="#section3">#section3</a></h2>
<h3>AJAX and the Fetch API<a class="subhead-anchor" href="#section4">#section4</a></h3>
<p>There are a number of ways with JavaScript to retrieve data from an external source. Historically you would use an <a href="https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest">XHR request</a>. XHR is widely supported but is also fairly complex and requires several different methods. There are also libraries like <a href="https://github.com/axios/axios">Axios</a> or <a href="https://api.jquery.com/jquery.ajax/">jQuery’s AJAX API</a>. These can be helpful to reduce complexity and provide cross-browser support. These might be an option if you are already using these libraries, but we want to opt for native solutions whenever possible. Lastly, there is the more recent <a href="https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API">Fetch API</a>. This is <a href="https://caniuse.com/#search=fetch">less widely supported</a>, but it is straightforward and chainable. And if you are using a transpiler (e.g., <a href="https://babeljs.io/">Babel</a>), it will convert your code to a more widely supported equivalent.</p>
<p>For our use case, we’ll use the Fetch API to pull the data into our application:</p>
<pre><code class="language-javascript">window.fetchData = window.fetchData || {};
  fetch('./data/aggregate.json')
  .then(response =&gt; {
      // when the fetch executes we will convert the response
      // to json format and pass it to .then()
      return response.json();
  }).then(jsonData =&gt; {
      // take the resulting dataset and assign to a global object
      window.fetchData.jsonData = jsonData;
  }).catch(err =&gt; {
      console.log("Fetch process failed", err);
  });</code></pre>
<p>This code is a snippet from the main.js in the GitHub repo</p>
<p>The <code>fetch()</code> method sends a request for the data, and we convert the results to JSON. To ensure that the next statement doesn’t execute until after the complete dataset is retrieved, we use the <code>then()</code> method and do all our data processing within that block. Lastly, we <code>console.log()</code> any errors.</p>
<p>Our goal here is to identify the key dimensions we need for reporting—year and state—before we aggregate the number of arrivals for those dimensions, removing country of origin and destination city. You can refer to the Node.js script <code>/preprocess/index.js</code> from the GitHub repo for more details on how we accomplished this. It generates the <code>aggregate.json</code> file loaded by <code>fetch()</code> above.</p>
<h3>Multidimensional data<a class="subhead-anchor" href="#section5">#section5</a></h3>
<p>The goal of multidimensional formatting is flexibility: data detailed enough that the user doesn’t need to send a query back to the server every time they want to answer a different question, but summarized so that your application isn’t churning through the entire dataset with every new slice of data. You need to anticipate the questions and provide data that formulates the answers. Clients want to be able to do some analysis without feeling constrained or completely overwhelmed.</p>
<p>As with most APIs, we’ll be working with JSON data. <a href="http://json.org/">JSON</a> is a standard that is used by most APIs to send data to applications as objects consisting of name and value pairs. Before we get back to our use case, let’s look at a sample multidimensional dataset:</p>
<pre><code class="language-javascript">const ds = [{
  "year": 2005,
  "state": "Alabama",
  "total": 1386,
  "priorYear": 1201
}, {
  "year": 2005,
  "state": "Alaska",
  "total": 811,
  "priorYear": 1541
}, {
  "year": 2006,
  "state": "Alabama",
  "total": 989,
  "priorYear": 1386
}];</code></pre>
<p>With your dataset properly aggregated, we can use JavaScript to further analyze it. Let’s take a look at some of JavaScript’s native array methods for composing data.</p>
<h2>How to work effectively with your data via JavaScript<a class="subhead-anchor" href="#section6">#section6</a></h2>
<h3><code>Array.filter()</code><a class="subhead-anchor" href="#section7">#section7</a></h3>
<p>The <code>filter()</code> method of the <code>Array</code> prototype (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter"><code>Array.prototype.filter()</code></a>) takes a function that tests every item in the array, returning another array containing only the values that passed the test. It allows you to create meaningful subsets of the data based on select dropdown or text filters. Provided you included meaningful, discrete dimensions for your multidimensional dataset, your user will be able to gain insight by viewing individual slices of data.</p>
<pre id="snippet5"><code class="language-javascript">ds.filter(d =&gt; d.state === "Alabama");
// Result
[{
  state: "Alabama",
  total: 1386,
  year: 2005,
  priorYear: 1201
},{
  state: "Alabama",
  total: 989,
  year: 2006,
  priorYear: 1386
}]</code></pre>
<h3><code>Array.map()</code><a class="subhead-anchor" href="#section8">#section8</a></h3>
<p>The <code>map()</code> method of the <code>Array</code> prototype (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map"><code>Array.prototype.map()</code></a>) takes a function and runs every array item through it, returning a new array with an equal number of elements. Mapping data gives you the ability to create related datasets. One use case for this is to map ambiguous data to more meaningful, descriptive data. Another is to take metrics and perform calculations on them to allow for more in-depth analysis.</p>
<p><strong>Use case #1—map data to more meaningful data:</strong></p>
<pre id="snippet6"><code class="language-javascript">ds.map(d =&gt; (d.state.indexOf("Alaska")) ? "Contiguous US" : "Continental US");
// Result
[
  "Contiguous US", 
  "Continental US", 
  "Contiguous US"
]</code></pre>
<p><strong>Use case #2—map data to calculated results:</strong></p>
<pre id="snippet7"><code class="language-javascript">ds.map(d =&gt; Math.round(((d.priorYear - d.total) / d.total) * 100));
// Result
[-13, 56, 40]</code></pre>
<h3><code>Array.reduce()</code><a class="subhead-anchor" href="#section9">#section9</a></h3>
<p>The <code>reduce()</code> method of the <code>Array</code> prototype (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/reduce"><code>Array.prototype.reduce()</code></a>) takes a function and runs every array item through it, returning an aggregated result. It’s most commonly used to do math, like to add or multiply every number in an array, although it can also be used to concatenate strings or do many other things. I have always found this one tricky; it’s best learned through example.</p>
<p>When presenting data, you want to make sure it is summarized in a way that gives insight to your users. Even though you have done some general-level summarizing of the data server-side, this is where you allow for further aggregation based on the specific needs of the consumer. For our app we want to add up the total for every entry and show the aggregated result. We’ll do this by using <code>reduce()</code> to iterate through every record and add the current value to the accumulator. The final result will be the sum of all values (total) for the array.</p>
<pre id="snippet8"><code class="language-javascript">ds.reduce((accumulator, currentValue) =&gt; 
accumulator + currentValue.total, 0);
// Result
3364</code></pre>
<h3>Applying these functions to our use case<a class="subhead-anchor" href="#section10">#section10</a></h3>
<p>Once we have our data, we will assign an event to the “Get the Data” button that will present the appropriate subset of our data. Remember that we have several hundred items in our JSON data. The code for binding data via our button is in our main.js:</p>
<pre id="snippet9"><code class="language-javascript"> document.getElementById("submitBtn").onclick =
  function(e){
      e.preventDefault();
      let state = document.getElementById("stateInput").value || "All"
      let year = document.getElementById("yearInput").value || "All"
      let subset = window.fetchData.filterData(year, state);
      if (subset.length == 0  )
        subset.push({'state': 'N/A', 'year': 'N/A', 'total': 'N/A'})
      document.getElementById("output").innerHTML =
      `&lt;table class="table"&gt;
        &lt;thead&gt;
          &lt;tr&gt;
            &lt;th scope="col"&gt;State&lt;/th&gt;
            &lt;th scope="col"&gt;Year&lt;/th&gt;
            &lt;th scope="col"&gt;Arrivals&lt;/th&gt;
          &lt;/tr&gt;
        &lt;/thead&gt;
        &lt;tbody&gt;
          &lt;tr&gt;
            &lt;td&gt;${subset[0].state}&lt;/td&gt;
            &lt;td&gt;${subset[0].year}&lt;/td&gt;
            &lt;td&gt;${subset[0].total}&lt;/td&gt;
          &lt;/tr&gt;
        &lt;/tbody&gt;
      &lt;/table&gt;`
  }</code></pre>
<figure><img src="https://alistapart.com/wp-content/uploads/2018/12/fig3.png?asdf" alt="The final output once our code is applied" /><br /></figure><p>If you leave either the state or year blank, that field will default to “All.” The following code is available in <code>/js/main.js</code>. You’ll want to look at the <code>filterData()</code> function, which is where we keep the lion’s share of the functionality for aggregation and filtering.</p>
<pre id="snippet10"><code class="language-javascript">// with our data returned from our fetch call, we are going to 
// filter the data on the values entered in the text boxes
fetchData.filterData = function(yr, state) {
  // if "All" is entered for the year, we will filter on state 
  // and reduce the years to get a total of all years
  if (yr === "All") {
    let total = this.jsonData.filter(
      // return all the data where state
      // is equal to the input box
      dState =&gt; (dState.state === state)
        .reduce((accumulator, currentValue) =&gt; {
          // aggregate the totals for every row that has 
          // the matched value
          return accumulator + currentValue.total;
        }, 0);
    return [{'year': 'All', 'state': state, 'total': total}];
  }
  ...
  // if a specific year and state are supplied, simply
  // return the filtered subset for year and state based 
  // on the supplied values by chaining the two function
  // calls together 
  let subset = this.jsonData.filter(dYr =&gt; dYr.year === yr)
    .filter(dSt =&gt; dSt.state === state);
  return subset; 
};
// code that displays the data in the HTML table follows this. See main.js.</code></pre>
<p>When a state or a year is blank, it will default to “All” and we will filter down our dataset to that particular dimension, and summarize the metric for all rows in that dimension. When both a year and a state are entered, we simply filter on the values.</p>
<p>We now have a working example where we:</p>
<ul><li>Start with a raw, transactional dataset;</li>
<li>Create a semi-aggregated, multidimensional dataset;</li>
<li>And dynamically build a fully composed result.</li>
</ul><p>Note that once the data is pulled down by the client, we can manipulate the data in a number of different ways without having to make subsequent calls to the server. This is especially useful because if the user loses connectivity, they do not lose the ability to manipulate the data. This is useful if you are creating a progressive web app (PWA) that needs to be available offline. (If you are not sure if your web app should be a PWA, <a href="https://alistapart.com/article/yes-that-web-project-should-be-a-pwa">this article</a> can help.)</p>
<p>Once you get a firm handle on these three methods, you can create just about any analysis that you want on a dataset. Map a dimension in your dataset to a broader category and summarize using reduce. Combined with <a href="https://d3js.org/">a library like D3</a>, you can map this data into charts and graphs to allow a fully customizable data visualization.</p>
<h2>Conclusion<a class="subhead-anchor" href="#section11">#section11</a></h2>
<p>This article gives a better sense of what is possible in JavaScript when working with data. As I mentioned, client-side JavaScript is in no way a substitute for translating and transforming data on the server, where the heavy lifting should be done. But by the same token, it also shouldn’t be completely ruled out when datasets are treated properly.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Our own @zeldman paints the complicated catch-22 that our free, democratized web has with our money-making capitalist roots. As creators, how do we untangle this web? #LetsFixThis</div><div class="entry-content">A month of experiencing a temporary disability changed @fcorradini’s perspective on how to take more care when conducting accessibility testing. He shares the impact.</div><div class="entry-content">Jeremy Wagner plots a course to avoid the unnecessary bloat and inaccessible patterns of current JavaScript trends.</div><div class="entry-content">Technology can easily become a platform for hate, and we have an ethical responsibility to fix it. ALA's own Tatiana Mac discusses</div><div class="entry-content">Screen readers are diverse and complex: front-end developer Melanie Richards breaks down how they access our content step-by-step.</div>]]></description>
      <link>https://alistapart.com/article/taming-data-with-javascript/</link>
      <guid>https://alistapart.com/article/taming-data-with-javascript/</guid>
      <pubDate>Thu, 20 Dec 2018 02:12:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[Designing for Interaction Modes]]></title>
      <description><![CDATA[<p>We humans have developed ways of coping with digital interfaces. We have tactics. We accept shortcomings. We make do.</p>


<p>But why is it still so hard (on most of the internet) to avoid uphill struggles? Often, for example, a quality reading experience is only fully available via a hack, using <a href="https://www.howtogeek.com/326430/how-to-automatically-open-articles-in-safaris-reader-mode/">Safari’s reader view</a> or a browser plug-in. I use Instapaper to send articles to my Kindle—a device that’s devoted to reading mode—because reading is not just about getting the job done. The experience itself is also important.</p>
<p>The best experiences result from designers matching the way the computer behaves with the way our users are thinking, feeling, and interacting. This is what user experience design is all about. And yet, because of pressures, competing priorities, and industry trends, interaction modes are often an afterthought.</p>
<h2>Prioritizing interaction modes</h2>
<p>A while back I created a persona for Cambridge University Press named Rachel Research Gatherer. The Rachel bit, I now understand, was irrelevant (<a href="https://medium.com/@indiyoung/describing-personas-af992e3fc527">unhelpful, even</a>). But naming the research gatherer mode helped my team focus on what was needed to support the gathering of scholarly articles and books. The precise ordering and arrangement of citation data, author biographies, metrics, and publication metadata was all organized around this central thought:</p>
<p><em>The user is trying to gather research.</em></p>
<p>This focused our feature set and allowed for deprioritizing functionality related to other, non-essential modes (e.g., reading online—our research gatherers were only interested in saving PDFs to read later).</p>
<p>In fact, the best personas I’ve seen have always included the interaction mode (or dominant behavior) in the title, which encourages a focus on software that supports that way of interacting. Thinking about roles or demographic attributes just isn’t as helpful. Presuming that lots of research gatherers are going to show up, you want them to converse with software that is appropriately trained and has a research gathering mode that can easily be found and switched on. The leap to be made is one from understanding a human behavior to designing its matching counterpart: an appropriate computer behavior. I’ve come to think of interaction modes as aspects of the persona you want your digital product or service to have. They can codify a specific set of behaviors, morals, and manners.</p>
<h2>Moving between modes</h2>
<p>In most cases, designers have to account for multiple possible interaction modes and, crucially, the shifts between them.</p>
<p>Some shifts can be explicitly triggered by the user. Take Audible’s driving mode, which helps users stay safe by minimizing potential distractions: it filters out all but three controls and makes the entire upper part of the screen a giant play/pause button.</p>
<figure><img src="https://alistapart.com/d/designing-for-interaction-modes/fig1.png" alt="Mobile phone showing Audible's driving mode." class="c2" /><figcaption>Fig. 1: Audible’s driving mode.</figcaption></figure><p>Driving mode is activated by tapping on a tiny icon, but modes could equally be switched on via a link. If a link took you to “lost or stolen card” on your bank’s website, you might welcome a mode that deals with stressful situations. This might involve an appropriately short quantity of text and guidance—hopefully a quick-fix option (e.g., “freeze my card”) and directions to the nearest human support.</p>
<p>Modes can also shift in response to implied needs. The National Trust—an organization that maintains historic and natural sites across England, Wales, and Northern Ireland—has an app whose visit mode focuses on local events and information relevant to users’ geolocation. This mode is offered to the user when they approach a National Trust property. It’s a safe bet that they’re going to prefer this mode, but they’re offered the choice to activate it anyway. It’s good manners.</p>
<p>There are also times when there is no need to ask. Let’s consider another familiar human-computer interaction: evaluating, a mode in which the human tries to assess the quality or fitness of something, as one might do when comparison shopping for a new laptop. The computer (if trained appropriately) helps by surfacing the right metadata, summary info, reviews, and so on. A bit like research gathering, it’s a mode that might lead to reading mode, in a move from “Shall I read this?” to “I’m reading this!” A well-presented article will start with different content and functional elements than it continues with. The top of this page is all about supporting evaluation mode; then those elements fall away when the user indicates that they’ve shifted into reading mode. They show this intent by, say, scrolling slowly down the page or clicking a “read more” button.</p>
<figure><img src="https://alistapart.com/d/designing-for-interaction-modes/fig2.png" alt="One box containing a series of smaller boxes to represent content, broken up to show the layout. Another box containing smaller boxes representing unbroken narrative text." /><figcaption>Fig. 2: Evaluating mode might include the author bio, date, number of comments, classification tags, lead image, and the first paragraph with a “read more” button. Reading mode might include just beautiful text and the occasional supporting image.</figcaption></figure><p>The object, in this case an article, looks different, sometimes very different, when supporting different modes. And the user might move between these modes without even registering the shift.</p>
<h2>Interaction modes are computer behaviors</h2>
<p>A simple but important distinction to make when thinking about modes:</p>
<p><em>Interaction modes are something the software does, not something the user does; “reading” is just a shorthand for “reading mode.”</em></p>
<p>This distinction is critical, because it allows us to be so much more precise about the behavior of the components in a design system. We don’t always need to rely on individual interpretation of personae or journey maps, or remember an agreed set of design principles. We can, instead, bake our values into our modes. We can, for example, name components according to the mode they’re intended to support rather than just to create more purposeful and consistent designs (though these are great things to aim for).</p>
<p>Interaction modes also offer us a design tool that can help tame our technology, giving it manners that work in a variety of contexts. And in our world of agentive AI, chatbottery, and algorithms, getting a grip on this conduct is becoming increasingly important.</p>
<h2>Two moral questions</h2>
<p>As time goes on, we have more and more powerful controls available to us in fast digital mediums. There’s an increasing need to recognize that poor usability is not the only factor to watch out for. We need to be working design ethics into our decision making.</p>
<p>It could start with a simple moral question for design teams: how much are you going to help your users interact in the way that they would prefer? If they’re reading, how many ads (or other distractions) are you going to throw in their faces? Even though users might prefer ads to paying for content, there are better and worse ways to show people ads. Deliberately designing for a reading mode will give you a better shot at reconciling this conflict in a good way, allowing you to create the best reading space possible within the constraints. Compromises would become more deliberate and (hopefully) less damaging.</p>
<p>A second, less obvious, moral question is this: when should we use design to encourage a more appropriate way of interacting than the user’s default? In my article about <a href="https://alistapart.com/article/meta-moments-thoughtfulness-by-design">meta-moments</a>, I looked at some ways to slow the user’s experience (using roadblocks, speed bumps, or diversions in the design) when thoughtfulness is needed. The user could be agreeing to give a third party access to their data. Or they might be remortgaging their house. On these kinds of occasions, it’s right to encourage a slower, more attentive mode.</p>
<p>One way to approach this question is to capture the interaction modes that your users want or need, on a chart like this:</p>
<figure><img src="https://alistapart.com/d/designing-for-interaction-modes/fig3.png" alt="A chart. More detail in the following footnote link." /><figcaption id="ref1"><a href="#note1">Fig. 3 detailed description</a></figcaption></figure><p>To start off, this could just be an expert-led evaluation or a group <a href="http://gamestorming.com/350/">forced ranking</a> exercise along the following lines:</p>
<ol><li>Generate a list of interaction modes. Words ending in “-ing” can be useful.</li>
<li>Score for how much thoughtfulness is currently required.</li>
<li>Score for how much thoughtfulness is currently encouraged.</li>
<li>Get charting.</li>
</ol><p>Ideally, you want all your modes to fall close to a diagonal line that stretches from top right to bottom left of your chart. The amount of thoughtfulness we encourage (or leave space for) in each mode would then be roughly in proportion to the amount of thought required.</p>
<figure><img src="https://alistapart.com/d/designing-for-interaction-modes/fig4.png" alt="A chart. More detail in the following footnote link." /><figcaption id="ref2"><a href="#note2">Fig. 4 detailed description</a></figcaption></figure><p>This ethical line makes it look a little like there is only one way to get things right: precisely x amount of thought required = x amount of thought encouraged. It’s hard (and maybe impossible) to measure such things precisely, but that shouldn’t put us off, considering the relative needs in play. If nothing else, the visualization reminds us that there are many more ways to get design wrong than to get it right.</p>
<p>If you find the interaction modes you’re currently supporting don’t fall on the ethical line, you’ll want to move them with your team’s next design effort.</p>
<figure><img src="https://alistapart.com/d/designing-for-interaction-modes/fig5.png" alt="A chart. More detail in the following footnote link." /><figcaption id="ref3"><a href="#note3">Fig. 5 detailed description</a></figcaption></figure><p>Ultimately, deciding where to move interaction modes requires a degree of honest reflection and the willingness to shift any annoying or abusive experiences toward assisting or awakening ones.</p>
<figure><img src="https://alistapart.com/d/designing-for-interaction-modes/fig6.png" alt="A chart. More detail in the following footnote link." /><figcaption id="ref4"><a href="#note4">Fig. 6 detailed description</a></figcaption></figure><p>While most designers want to assist and awaken (and avoid abusing or annoying) our users, even a small team will have disagreements about the right path to take. And powerful drivers outside the team, from business models to technology trends, heavily influence design decisions. These factors need our greatest focus if we are to resist following zombie patterns (“our competitors have introduced sexy new feature X so we’d better do it too”) or the tendency to pander (often in the name of UX) to short-term interests. You might be rightly proud of being able to offer a current account opening experience that only takes <a href="https://www.starlingbank.com/open-bank-account-online">minutes</a>, but are you sure that this is right for everyone you’re offering it to? Don’t some folks need some extra guidance around how to configure things? Don’t people need to understand the commitments they’re making?</p>
<p>Adding this kind of consideration to the design process can pull against the push for speed and help designers resist the deployment of persuasion techniques in inappropriate contexts.</p>
<h2>Where to draw the line</h2>
<p>But how can we know which techniques are inappropriate? It can be hard to make a call on this. For example, testimonials and reviews can help reassure the user and build trust. They <em>could</em> also discourage independent research, but they’re hardly an abusive play.</p>
<figure><img src="https://alistapart.com/d/designing-for-interaction-modes/fig7.png" alt="A chart. More detail in the following footnote link." /><figcaption id="ref5"><a href="#note5">Fig. 7 detailed description</a></figcaption></figure><p>Someone might want to place a pop-up ad directly in the middle of your user’s reading experience, arguing that it is encouraging thoughtfulness about a product that would be in the user’s long-term interests to know about in that context. And they might be right.</p>
<p>For me, this is where good research comes in. We need to know the contexts for which more thoughtful engagement is appropriate to help our users achieve their long-term goals. We have to test our designs for whether they deliver comprehension and fair outcomes over a long timeframe. Only then can we know which of our nudges fall on the ethical line.</p>
<h2>Getting over your squeamishness</h2>
<p>You might feel squeamish about defining your users’ best interests for them. How do we dare to presume? Shouldn’t we just lay the facts and choices out there, and let people make all the decisions themselves?</p>
<p>I think there are two solid reasons for getting over this squeamishness. First, design decisions have moral consequences whether you intend them or not. As Tristan Harris puts it, “<a href="http://www.tristanharris.com/2016/05/how-technology-hijacks-peoples-minds%e2%80%8a-%e2%80%8afrom-a-magician-and-googles-design-ethicist/">If you control the menu, you control the choices.</a>” It is better, therefore, to make your decisions with some deliberateness and transparency.</p>
<p>Second, people are not as individual as we like to think we are. There are common misconceptions that lead to poor choices. To support choosing the right mortgage, for example, designers might reasonably seek out the things that typically trip people up (and are important to know). We need to convey the mechanics of the product: how the interest gets calculated, where fees and charges might come into play, and so on. We do this so we can be sure that the user knows their commitments and that they have the best possible chance of selecting something that meets their long-term needs.</p>
<h2>Bringing dark patterns into the light</h2>
<p>To help prioritize these considerations, you might add an understanding or clarifying mode to your chart. Just adding it to the chart will help get <em>designing for comprehension</em> on the agenda. Making space for this conversation will help force dark patterns into the light. Where things are less clear-cut, we might at least acknowledge the need for further research to help add in richer consideration of users and their needs.</p>
<section class="entry-footnotes"><h1>Notes</h1>
<ul class="the-footnotes"><li id="note1"><a class="count" href="#ref1">1.</a> [fig. 3] A two-dimensional chart with axes that meet in the middle. One axis goes from “encouraged to think (independently)” (left) to “encouraged not to think” (right). The other axis goes from “situation requires thought” (bottom) to "no need for thought” (top). Interaction modes are plotted on the chart. “Finding” falls into “no need for thought” and “encouraged not to think.” “Considering” is within "no need for thought” and "encouraged to think (independently).” “Clarifying” falls roughly in the middle of the “encouraged to think” axis and within “situation requires thought.” “Deciding” falls into “encouraged not to think” and “situation requires thought.”</li>
<li id="note2"><a class="count" href="#ref2">2.</a> [fig. 4] On this version of the chart, the ethical line is drawn diagonally between the top-right to the bottom-left corners. “Finding” and “considering” are plotted along the line in the top-right quadrant, which represents the overlap of “no need for thought” and “encouraged not to think.” “Clarifying” and “deciding” are plotted along the line in the bottom-left quadrant, which represents the overlap of “encouraged to think (independently)” and “situation requires thought.”</li>
<li id="note3"><a class="count" href="#ref3">3.</a> [fig. 5] This chart shows the placements of “deciding” on the previous two charts, with an arrow pointing from its initial position in the lower-right quadrant to its position along the ethical line in the lower-left quadrant.</li>
<li id="note4"><a class="count" href="#ref4">4.</a> [fig. 6] A label appears on each of the four quadrants. “Assist with good usability” appears on the top-right quadrant, where “encouraged not to think” overlaps with “no need for thought”; “awaken with meta-moments” appears on the bottom-left quadrant, where “encouraged to think (independently)” overlaps with “situation requires thought”; “annoy with poor usability” appears on the top-left quadrant, where “encouraged to think (independently)” overlaps with “no need for thought”; and “abuse with dark patterns” appears on the bottom-right quadrant, where “encouraged not to think” overlaps with “situation requires thought.”</li>
<li id="note5"><a class="count" href="#ref5">5.</a> [fig. 7] This chart shows how “persuasion design” might fall into more than one quadrant, depending on the situation. It falls mostly into the “abuse” quadrant. But it also overlaps with the “awaken” and “assist” quadrants.</li>
</ul></section><footer class="entry-footer nocontent"><h1>About the Author</h1>
<div class="byline author vcard"><a class="photo" href="https://alistapart.com/author/andrewgrimes"><img src="https://alistapart.com/d/_made/pix/authors/photos/photo_136062_120_120_c1.jpg" alt="Image of Andrew Grimes" /></a>
<h2>
Andrew Grimes is a user experience consultant based in Bath, UK. As a boy he dreamed of becoming a stuntman or a magician. Now he combines both—creating fierce and perilous wonders with UX strategy, research, and design. He is unapologetically optimistic about the potential of great design to improve our world.</h2></div>
<h3>More from this Author</h3>
<ul class="author-more"><li><a href="https://alistapart.com/article/meta-moments-thoughtfulness-by-design">Meta-Moments: Thoughtfulness by Design</a></li>
</ul>
</footer>]]></description>
      <link>http://alistapart.com/article/designing-for-interaction-modes</link>
      <guid>http://alistapart.com/article/designing-for-interaction-modes</guid>
      <pubDate>Thu, 13 Dec 2018 02:12:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[<![CDATA[ Designing for Interaction Modes ]]]]><![CDATA[>]]></title>
      <description><![CDATA[<div class="entry-content">
<p>We humans have developed ways of coping with digital interfaces. We have tactics. We accept shortcomings. We make do.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<p>But why is it still so hard (on most of the internet) to avoid uphill struggles? Often, for example, a quality reading experience is only fully available via a hack, using <a href="https://www.howtogeek.com/326430/how-to-automatically-open-articles-in-safaris-reader-mode/">Safari’s reader view</a> or a browser plug-in. I use Instapaper to send articles to my Kindle—a device that’s devoted to reading mode—because reading is not just about getting the job done. The experience itself is also important.</p>
<p>The best experiences result from designers matching the way the computer behaves with the way our users are thinking, feeling, and interacting. This is what user experience design is all about. And yet, because of pressures, competing priorities, and industry trends, interaction modes are often an afterthought.</p>
<h2>Prioritizing interaction modes<a class="subhead-anchor" href="#section1">#section1</a></h2>
<p>A while back I created a persona for Cambridge University Press named Rachel Research Gatherer. The Rachel bit, I now understand, was irrelevant (<a href="https://medium.com/@indiyoung/describing-personas-af992e3fc527">unhelpful, even</a>). But naming the research gatherer mode helped my team focus on what was needed to support the gathering of scholarly articles and books. The precise ordering and arrangement of citation data, author biographies, metrics, and publication metadata was all organized around this central thought:</p>
<p><em>The user is trying to gather research.</em></p>
<p>This focused our feature set and allowed for deprioritizing functionality related to other, non-essential modes (e.g., reading online—our research gatherers were only interested in saving PDFs to read later).</p>
<p>In fact, the best personas I’ve seen have always included the interaction mode (or dominant behavior) in the title, which encourages a focus on software that supports that way of interacting. Thinking about roles or demographic attributes just isn’t as helpful. Presuming that lots of research gatherers are going to show up, you want them to converse with software that is appropriately trained and has a research gathering mode that can easily be found and switched on. The leap to be made is one from understanding a human behavior to designing its matching counterpart: an appropriate computer behavior. I’ve come to think of interaction modes as aspects of the persona you want your digital product or service to have. They can codify a specific set of behaviors, morals, and manners.</p>
<h2>Moving between modes<a class="subhead-anchor" href="#section2">#section2</a></h2>
<p>In most cases, designers have to account for multiple possible interaction modes and, crucially, the shifts between them.</p>
<p>Some shifts can be explicitly triggered by the user. Take Audible’s driving mode, which helps users stay safe by minimizing potential distractions: it filters out all but three controls and makes the entire upper part of the screen a giant play/pause button.</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2018/12/fig1.png" alt="Mobile phone showing Audible's driving mode." class="c1" /><figcaption>Fig. 1: Audible’s driving mode.</figcaption></figure><p>Driving mode is activated by tapping on a tiny icon, but modes could equally be switched on via a link. If a link took you to “lost or stolen card” on your bank’s website, you might welcome a mode that deals with stressful situations. This might involve an appropriately short quantity of text and guidance—hopefully a quick-fix option (e.g., “freeze my card”) and directions to the nearest human support.</p>
<p>Modes can also shift in response to implied needs. The National Trust—an organization that maintains historic and natural sites across England, Wales, and Northern Ireland—has an app whose visit mode focuses on local events and information relevant to users’ geolocation. This mode is offered to the user when they approach a National Trust property. It’s a safe bet that they’re going to prefer this mode, but they’re offered the choice to activate it anyway. It’s good manners.</p>
<p>There are also times when there is no need to ask. Let’s consider another familiar human-computer interaction: evaluating, a mode in which the human tries to assess the quality or fitness of something, as one might do when comparison shopping for a new laptop. The computer (if trained appropriately) helps by surfacing the right metadata, summary info, reviews, and so on. A bit like research gathering, it’s a mode that might lead to reading mode, in a move from “Shall I read this?” to “I’m reading this!” A well-presented article will start with different content and functional elements than it continues with. The top of this page is all about supporting evaluation mode; then those elements fall away when the user indicates that they’ve shifted into reading mode. They show this intent by, say, scrolling slowly down the page or clicking a “read more” button.</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2018/12/fig2.png" alt="One box containing a series of smaller boxes to represent content, broken up to show the layout. Another box containing smaller boxes representing unbroken narrative text." /><figcaption>Fig. 2: Evaluating mode might include the author bio, date, number of comments, classification tags, lead image, and the first paragraph with a “read more” button. Reading mode might include just beautiful text and the occasional supporting image.</figcaption></figure><p>The object, in this case an article, looks different, sometimes very different, when supporting different modes. And the user might move between these modes without even registering the shift.</p>
<h2>Interaction modes are computer behaviors<a class="subhead-anchor" href="#section3">#section3</a></h2>
<p>A simple but important distinction to make when thinking about modes:</p>
<p><em>Interaction modes are something the software does, not something the user does; “reading” is just a shorthand for “reading mode.”</em></p>
<p>This distinction is critical, because it allows us to be so much more precise about the behavior of the components in a design system. We don’t always need to rely on individual interpretation of personae or journey maps, or remember an agreed set of design principles. We can, instead, bake our values into our modes. We can, for example, name components according to the mode they’re intended to support rather than just to create more purposeful and consistent designs (though these are great things to aim for).</p>
<p>Interaction modes also offer us a design tool that can help tame our technology, giving it manners that work in a variety of contexts. And in our world of agentive AI, chatbottery, and algorithms, getting a grip on this conduct is becoming increasingly important.</p>
<h2>Two moral questions<a class="subhead-anchor" href="#section4">#section4</a></h2>
<p>As time goes on, we have more and more powerful controls available to us in fast digital mediums. There’s an increasing need to recognize that poor usability is not the only factor to watch out for. We need to be working design ethics into our decision making.</p>
<p>It could start with a simple moral question for design teams: how much are you going to help your users interact in the way that they would prefer? If they’re reading, how many ads (or other distractions) are you going to throw in their faces? Even though users might prefer ads to paying for content, there are better and worse ways to show people ads. Deliberately designing for a reading mode will give you a better shot at reconciling this conflict in a good way, allowing you to create the best reading space possible within the constraints. Compromises would become more deliberate and (hopefully) less damaging.</p>
<p>A second, less obvious, moral question is this: when should we use design to encourage a more appropriate way of interacting than the user’s default? In my article about <a href="https://alistapart.com/article/meta-moments-thoughtfulness-by-design">meta-moments</a>, I looked at some ways to slow the user’s experience (using roadblocks, speed bumps, or diversions in the design) when thoughtfulness is needed. The user could be agreeing to give a third party access to their data. Or they might be remortgaging their house. On these kinds of occasions, it’s right to encourage a slower, more attentive mode.</p>
<p>One way to approach this question is to capture the interaction modes that your users want or need, on a chart like this:</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2018/12/fig3.png" alt="A chart. More detail in the following footnote link." /><figcaption id="ref1"><a href="#note1">Fig. 3 detailed description</a></figcaption></figure><p>To start off, this could just be an expert-led evaluation or a group <a href="http://gamestorming.com/350/">forced ranking</a> exercise along the following lines:</p>
<ol><li>Generate a list of interaction modes. Words ending in “-ing” can be useful.</li>
<li>Score for how much thoughtfulness is currently required.</li>
<li>Score for how much thoughtfulness is currently encouraged.</li>
<li>Get charting.</li>
</ol><p>Ideally, you want all your modes to fall close to a diagonal line that stretches from top right to bottom left of your chart. The amount of thoughtfulness we encourage (or leave space for) in each mode would then be roughly in proportion to the amount of thought required.</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2018/12/fig4.png" alt="A chart. More detail in the following footnote link." /><figcaption id="ref2"><a href="#note2">Fig. 4 detailed description</a></figcaption></figure><p>This ethical line makes it look a little like there is only one way to get things right: precisely x amount of thought required = x amount of thought encouraged. It’s hard (and maybe impossible) to measure such things precisely, but that shouldn’t put us off, considering the relative needs in play. If nothing else, the visualization reminds us that there are many more ways to get design wrong than to get it right.</p>
<p>If you find the interaction modes you’re currently supporting don’t fall on the ethical line, you’ll want to move them with your team’s next design effort.</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2018/12/fig5.png" alt="A chart. More detail in the following footnote link." /><figcaption id="ref3"><a href="#note3">Fig. 5 detailed description</a></figcaption></figure><p>Ultimately, deciding where to move interaction modes requires a degree of honest reflection and the willingness to shift any annoying or abusive experiences toward assisting or awakening ones.</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2018/12/fig6.png" alt="A chart. More detail in the following footnote link." /><figcaption id="ref4"><a href="#note4">Fig. 6 detailed description</a></figcaption></figure><p>While most designers want to assist and awaken (and avoid abusing or annoying) our users, even a small team will have disagreements about the right path to take. And powerful drivers outside the team, from business models to technology trends, heavily influence design decisions. These factors need our greatest focus if we are to resist following zombie patterns (“our competitors have introduced sexy new feature X so we’d better do it too”) or the tendency to pander (often in the name of UX) to short-term interests. You might be rightly proud of being able to offer a current account opening experience that only takes <a href="https://www.starlingbank.com/open-bank-account-online">minutes</a>, but are you sure that this is right for everyone you’re offering it to? Don’t some folks need some extra guidance around how to configure things? Don’t people need to understand the commitments they’re making?</p>
<p>Adding this kind of consideration to the design process can pull against the push for speed and help designers resist the deployment of persuasion techniques in inappropriate contexts.</p>
<h2>Where to draw the line<a class="subhead-anchor" href="#section5">#section5</a></h2>
<p>But how can we know which techniques are inappropriate? It can be hard to make a call on this. For example, testimonials and reviews can help reassure the user and build trust. They <em>could</em> also discourage independent research, but they’re hardly an abusive play.</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2018/12/fig7.png" alt="A chart. More detail in the following footnote link." /><figcaption id="ref5"><a href="#note5">Fig. 7 detailed description</a></figcaption></figure><p>Someone might want to place a pop-up ad directly in the middle of your user’s reading experience, arguing that it is encouraging thoughtfulness about a product that would be in the user’s long-term interests to know about in that context. And they might be right.</p>
<p>For me, this is where good research comes in. We need to know the contexts for which more thoughtful engagement is appropriate to help our users achieve their long-term goals. We have to test our designs for whether they deliver comprehension and fair outcomes over a long timeframe. Only then can we know which of our nudges fall on the ethical line.</p>
<h2>Getting over your squeamishness<a class="subhead-anchor" href="#section6">#section6</a></h2>
<p>You might feel squeamish about defining your users’ best interests for them. How do we dare to presume? Shouldn’t we just lay the facts and choices out there, and let people make all the decisions themselves?</p>
<p>I think there are two solid reasons for getting over this squeamishness. First, design decisions have moral consequences whether you intend them or not. As Tristan Harris puts it, “<a href="http://www.tristanharris.com/2016/05/how-technology-hijacks-peoples-minds%e2%80%8a-%e2%80%8afrom-a-magician-and-googles-design-ethicist/">If you control the menu, you control the choices.</a>” It is better, therefore, to make your decisions with some deliberateness and transparency.</p>
<p>Second, people are not as individual as we like to think we are. There are common misconceptions that lead to poor choices. To support choosing the right mortgage, for example, designers might reasonably seek out the things that typically trip people up (and are important to know). We need to convey the mechanics of the product: how the interest gets calculated, where fees and charges might come into play, and so on. We do this so we can be sure that the user knows their commitments and that they have the best possible chance of selecting something that meets their long-term needs.</p>
<h2>Bringing dark patterns into the light<a class="subhead-anchor" href="#section7">#section7</a></h2>
<p>To help prioritize these considerations, you might add an understanding or clarifying mode to your chart. Just adding it to the chart will help get <em>designing for comprehension</em> on the agenda. Making space for this conversation will help force dark patterns into the light. Where things are less clear-cut, we might at least acknowledge the need for further research to help add in richer consideration of users and their needs.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Our own @zeldman paints the complicated catch-22 that our free, democratized web has with our money-making capitalist roots. As creators, how do we untangle this web? #LetsFixThis</div><div class="entry-content">A month of experiencing a temporary disability changed @fcorradini’s perspective on how to take more care when conducting accessibility testing. He shares the impact.</div><div class="entry-content">Jeremy Wagner plots a course to avoid the unnecessary bloat and inaccessible patterns of current JavaScript trends.</div><div class="entry-content">Technology can easily become a platform for hate, and we have an ethical responsibility to fix it. ALA's own Tatiana Mac discusses</div><div class="entry-content">Screen readers are diverse and complex: front-end developer Melanie Richards breaks down how they access our content step-by-step.</div>]]></description>
      <link>https://alistapart.com/article/designing-for-interaction-modes/</link>
      <guid>https://alistapart.com/article/designing-for-interaction-modes/</guid>
      <pubDate>Thu, 13 Dec 2018 02:12:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[Progressive Web Apps: The Case for PWAs]]></title>
      <description><![CDATA[<p>Now that you know what a progressive web app is, you’re probably wondering if your organization would benefit from one. To determine if it makes sense for your organization, ask yourself two questions:</p>
<ol><li><strong>Does your organization have a website?</strong> If so, you would probably benefit from a progressive web app. This may sound flippant, but it’s true: nearly every website should be a progressive web app, because they represent best practices for the web.</li>
<li><strong>Does your organization make money on your website via ecommerce, advertising, or some other method?</strong> If so, you <em>definitely</em> need a progressive web app, because progressive web apps can have a significant impact on revenue.</li>
</ol>

<p>This doesn’t mean that your site needs to have every possible feature of progressive web apps. You may have no need to provide offline functionality, push notifications, or even the ability for people to install your website to their homescreen. You may only want the bare minimum: a secure site, a service worker to speed up the site, and a manifest file—things that benefit every website.</p>
<p>Of course, you may decide that your personal website or side project doesn’t warrant the extra effort to make it into a progressive web app. That’s understandable—and in the long run, even personal websites will gain progressive web app features when the underlying content management systems add support for them. For example, both <a href="https://magento.com/news-room/press-releases/magento-commerce-announces-progressive-web-applications-studio">Magento</a> and <a href="https://www.youtube.com/watch?v=Di7RvMlk9io">WordPress</a> have already announced their plans to bring progressive web apps to their respective platforms. Expect other platforms to follow suit.</p>
<p>But if you’re running any kind of website that makes money for your organization, then it would behoove you to start planning for how to convert your website to a progressive web app. Companies that have deployed progressive web apps have seen increases in conversion, user engagement, sales, and advertising revenue. For example, <a href="https://medium.com/dev-channel/a-pinterest-progressive-web-app-performance-case-study-3bd6ed2e6154">Pinterest saw core engagement increase by 60 percent</a> and user-generated ad revenue increase by 44 percent (Fig 2.1). <a href="https://www.youtube.com/watch?v=PsgW-0M67TQ&amp;feature=youtu.be&amp;t=34m4s">West Elm saw a 15 percent increase in average time spent on their site</a> and a 9 percent lift in revenue per visit.</p>
<figure><img src="https://alistapart.com/d/progressive-web-apps/fig2-1.jpg" alt="Comparing old mobile web to the progressive web version of Pinterest, the time spent that was greater than 5 minutes increased by 40%, the user-generated ad revenue increased by 44%, ad clickthroughs increased by 50%, and core engagement metrics improved by 60%. Even comparing to the native app, most of these same metrics increased between 2-5%." /><figcaption><strong>Fig 2.1:</strong> Addy Osmani, an engineering manager for Google, wrote <a href="https://medium.com/dev-channel/a-pinterest-progressive-web-app-performance-case-study-3bd6ed2e6154">a case study about Pinterest’s progressive web app</a>, comparing it to both their old mobile website and their native app.</figcaption></figure><p>The success stories for progressive web apps are so abundant that my company, Cloud Four, started a website called <a href="https://www.pwastats.com/">PWA Stats</a> to keep track of them (Fig 2.2). There’s a good chance that we’ve collected a case study from an organization similar to yours that you can use to convince your coworkers that building a progressive web app makes sense.</p>
<figure><img src="https://alistapart.com/d/progressive-web-apps/fig2-2.jpg" alt="A screenshot of the PWA Stats homepage, showing case studies for Uber, Trivago, Petlove, and the Grand Velas Riviera Maya resort." /><figcaption><strong>Fig 2.2:</strong> <a href="https://www.pwastats.com/">PWAstats.com</a> collects statistics and stories documenting the impact of progressive web apps.</figcaption></figure><p>And convincing them may be necessary. Despite the clear benefits of progressive web apps, many businesses still haven’t converted—often because they simply don’t know about PWAs yet. (So if you start building one now, you may get a jump on your competition!)</p>
<p>But there is also a lot of confusion about what progressive web apps are capable of, where they can be used, and how they relate to native apps. This confusion creates fear, uncertainty, and doubt (FUD) that slow the adoption of progressive web apps.</p>
<p>If you advocate for progressive web apps in your organization, you’ll likely find some confusion and possibly even encounter some resistance. So let’s equip you with arguments to cut through the FUD and convince your colleagues.</p>
<h2>Native apps and PWAs can coexist</h2>
<p>If your organization already has a native app, stakeholders may balk at the idea of <em>also</em> having a progressive web app—especially since the main selling point of PWAs is to enable native app features and functionality.</p>
<p>It’s tempting to view progressive web apps as competition to native apps—much of the press coverage has adopted this storyline. But the reality is that progressive web apps make sense irrespective of whether a company has a native app.</p>
<p>Set aside the “native versus web” debate, and focus on the experience you provide customers who interact with your organization via the web. Progressive web apps simply make sense on their own merits: they can help you reach more customers, secure your site, generate revenue, provide more reliable experiences, and notify users of updates—all as a complement to your native app.</p>
<h3>Reach more customers</h3>
<p>Not all of your current customers—and none of your potential customers—have your native app installed. Even your average customer is unlikely to have your app installed, and those customers who <em>do</em> have your app may still visit your site on a desktop computer.</p>
<p>Providing a better experience on the website itself will increase the chances that current and future customers will read your content or buy your products (or even download your native app!). A progressive web app can provide that better experience.</p>
<p>Despite what the tech press might have you believe, the mobile web is growing faster than native apps. comScore compared the top one thousand apps to the top one thousand mobile web properties and found that “<a href="https://www.comscore.com/Insights/Presentations-and-Whitepapers/2016/The-2016-US-Mobile-App-Report">mobile web audiences are almost 3x the size and growing 2x as fast as app audiences</a>”.</p>
<p>And while it’s true that people spend more time in their favorite apps than they do on the web, you may have trouble convincing people to install your app in the first place. <a href="https://www.comscore.com/Insights/Presentations-and-Whitepapers/2017/The-2017-US-Mobile-App-Report">Over half of smartphone users in the United States don’t download any apps</a> in a typical month.</p>
<p>Having a native app in an app store doesn’t guarantee that people will install it. It costs a lot to advertise an app and convince people to try it. According to app marketing company Liftoff, <a href="https://www.emarketer.com/Article/Cost-of-Acquiring-Mobile-App-User/1016688">the average cost to get someone to install an app is $4.12</a>, and that shoots up to $8.21 per install if you want someone to create an account in your app.</p>
<p>If you’re lucky enough to get someone to install your app, the next hurdle is convincing them to continue to use it. When analyst Andrew Chen analyzed user retention data from 125 million mobile phones, he found that “<a href="https://andrewchen.co/new-data-shows-why-losing-80-of-your-mobile-users-is-normal-and-that-the-best-apps-do-much-better/">the average app loses 77% of its DAUs [daily active users] within the first 3 days</a> after the install. Within 30 days, it’s lost 90% of DAUs. Within 90 days, it’s over 95%” (Fig 2.3).</p>
<figure><img src="https://alistapart.com/d/progressive-web-apps/fig2-3.jpg" alt="Chart: The average retention curve for Android apps drops precipitously within the first three days and continues to drop more slowly to near 0 over the next 90 days." /><figcaption><strong>Fig 2.3:</strong> App loyalty remains a big issue for native apps. The average app loses over 95 percent of its daily active users within 90 days.</figcaption></figure><p>Progressive web apps don’t have those same challenges. They’re as easy for people to discover as your website is, because they <em>are</em> your website. And the features of a progressive web app are available immediately. There’s no need to jump through the hoops of visiting an app store and downloading the app. Installation is fast: it happens in the background during the first site visit, and can literally be as simple as adding an icon to the home screen.</p>
<p>As Alex Russell wrote in <a href="https://medium.com/dev-channel/why-are-app-install-banners-still-a-thing-18f3952d349a">a 2017 Medium post</a>:</p>
<figure class="quote"><blockquote>
<p>The friction of PWA installation is <em>much</em> lower. Our internal metrics at Google show that for similar volume of prompting for PWA banners and native app banners — the closest thing to an apples-to-apples comparison we can find — <em>PWA banners convert 5–6x more often</em>. More than half of users who chose to install a native app from these banners fail to complete installing the app whereas PWA installation is near-instant.</p>
</blockquote>
</figure><p>In short, a large and growing percentage of your customers interact with you on the web. Progressive web apps can lead to more revenue and engagement from more customers.</p>
<h3>Secure your website</h3>
<p>If you’re collecting credit cards or private information, providing a secure website for your web visitors is a must. But even if your website doesn’t handle sensitive data, it still makes sense to use HTTPS and provide a secure experience. Even seemingly innocuous web traffic can provide signals that can identify individuals and potentially compromise them. That’s not to mention the concerns raised by revelations of government snooping.</p>
<p>It used to be that running a secure server was costly, confusing, and (seemingly) slower. Things have changed. SSL/TLS certificates used to cost hundreds of dollars, but now certificate provider <a href="https://letsencrypt.org/">Let’s Encrypt</a> gives them out for free. Many hosting providers have integrated with certificate providers so you can set up HTTPS with a single click. And it turns out that <a href="https://istlsfastyet.com/">HTTPS wasn’t as slow as we thought it was</a>.</p>
<p>Websites on HTTPS can also move to a new version of HTTP called HTTP/2. The biggest benefit is that HTTP/2 is significantly faster that HTTP/1. For many hosting providers and content delivery networks (CDNs), the moment you move to HTTPS, you get HTTP/2 with no additional work.</p>
<p>If that wasn’t enough incentive to move to HTTPS, browser makers are using a carrot-and-stick approach for pushing websites to make the change. For the stick, Chrome has started warning users when they enter data on a site that isn’t running HTTPS. By the time you read this, <a href="https://blog.chromium.org/2017/04/next-steps-toward-more-connection.html">Google plans to label all HTTP pages with a “Not secure” warning</a> (Fig 2.4). Other browsers will likely follow suit and start to flag sites that aren’t encrypted to make sure users are aware that their data could be intercepted.</p>
<figure><img src="https://alistapart.com/d/progressive-web-apps/fig2-4.jpg" alt="The eventual treatment of all HTTP pages in Chrome will be to show a red yield icon with the words 'Not secure'." /><figcaption>Fig 2.4: Google has announced its intention to <a href="https://www.chromium.org/Home/chromium-security/marking-http-as-non-secure">label any website that isn’t running HTTPS as not secure</a>. Different warning styles will be rolled out over time, until the label reaches the final state shown here.</figcaption></figure><p>For the HTTPS carrot, browsers are starting to require HTTPS to use new features. If you want to utilize the latest and greatest web tech, <a href="https://blog.mozilla.org/security/2018/01/15/secure-contexts-everywhere/">you’ll need to be running HTTPS</a>. In fact, some features that used to work on nonsecure HTTP that are considered to contain sensitive data—for example, geolocation—are being restricted to HTTPS now. On second thought, perhaps this is a bit of a stick as well. A carrot stick?</p>
<p>With all that in mind, it makes sense to set up a secure website for your visitors. You’ll avoid scary nonsecure warnings. You’ll get access to new browser features. You’ll gain speed benefits from HTTP/2. And: you’ll be setting yourself up for a progressive web app.</p>
<p>In order to use service workers, the core technology for progressive web apps, your website <em>must</em> be on HTTPS. So if you want to reap the rewards of all the PWA goodness, you need to do the work to make sure your foundation is secure.</p>
<h3>Generate more revenue</h3>
<p>There are numerous studies that show a connection between the speed of a website and the amount of time and money people are willing to spend on it. DoubleClick found that “<a href="https://marketingplatform.google.com/about/resources/">53% of mobile site visits are abandoned if pages take longer than 3 seconds to load</a>.” Walmart found that <a href="https://www.slideshare.net/devonauerswald/walmart-pagespeedslide">for every 100 milliseconds of improvement to page load time, there was up to a one percent increase in incremental revenue</a>.</p>
<p>Providing a fast web experience makes a big difference to the bottom line. Unfortunately, the average load time for mobile websites is <a href="https://marketingplatform.google.com/about/resources/">nineteen seconds on 3G connections</a>. That’s where a progressive web app can help.</p>
<p>Progressive web apps use service workers to provide an exceptionally fast experience. Service workers allow developers to explicitly define what files the browser should store in its local cache and under what circumstances the browser should check for updates to the cached files. Files that are stored in the local cache can be accessed much more quickly than files that are retrieved from the network.</p>
<p>When someone requests a new page from a progressive web app, most of the files needed to render that page are already stored on the local device. This means that the page can load nearly instantaneously because all the browser needs to download is the incremental information needed for that page.</p>
<p>In many ways, this is the same thing that makes native apps so fast. When someone installs a native app, they download the files necessary to run the app ahead of time. After that occurs, the native app only has to retrieve any new data. Service workers allow the web to do something similar.</p>
<p>The impact of progressive web apps on performance can be astounding. For example, <a href="https://medium.com/@addyosmani/a-tinder-progressive-web-app-performance-case-study-78919d98ece0">Tinder cut load times from 11.91 seconds to 4.69 seconds</a> with their progressive web app—and it’s 90 percent smaller than their native Android app. Hotel chain Treebo launched a progressive web app and <a href="https://tech.treebo.com/we-didnt-see-a-speed-limit-so-we-made-it-faster-treebo-and-pwas-the-journey-so-far-f7378410abc7">saw a fourfold increase in conversion rates year-over-year</a>; conversion rates for repeat users saw a threefold increase, and their median interactive time on mobile dropped to 1.5 seconds.</p>
<h3>Ensure network reliability</h3>
<p>Mobile networks are flaky. One moment you’re on a fast LTE connection, and the next you’re slogging along at 2G speeds—or simply offline. We’ve all experienced situations like this. But our websites are still primarily built with an assumption that networks are reliable.</p>
<p>With progressive web apps, you can create an app that continues to work when someone is offline. In fact, the technology used to create an offline experience is the same technology used to make web pages fast: service workers.</p>
<p>Remember, service workers allow us to explicitly tell the browser what to cache locally. We can expand what is stored locally—not only the assets needed to render the app, but also the content of pages—so that people can continue to view pages offline (Fig 2.5).</p>
<figure><img src="https://alistapart.com/d/progressive-web-apps/fig2-5.jpg" alt="Three screens from the housing.com site show how the design adapts to show when it is offline and that it can continue to show saved results even when offline." /><figcaption><strong>Fig 2.5:</strong> The header in <a href="https://housing.com">housing.com’s progressive web app</a> changes from purple (left) to gray when offline (middle). Content the user has previously viewed or favorited is available offline (right), which is important for housing.com’s home market in India, where network connectivity can be slow and unreliable.</figcaption></figure><p>Using a service worker, we can even precache the shell of our application behind the scenes. This means that when someone visits a progressive web app for the first time, the whole application could be downloaded, stored in the cache, and ready for offline use without requiring the person to take any action to initiate it. For more on when precaching makes sense, see Chapter 5.</p>
<h3>Keep users engaged</h3>
<p>Push notifications are perhaps the best way to keep people engaged with an application. They prompt someone to return to an app with tantalizing nuggets of new information, from breaking news alerts to chat messages.</p>
<p>So why limit push notifications to those who install a native application? For instance, if you have a chat or social media application, wouldn’t it be nice to notify people of new messages (Fig 2.6)?</p>
<figure><img src="https://alistapart.com/d/progressive-web-apps/fig2-6.jpg" alt="Two screens: On the left, a list of system notifications including one from the Twitter website. On the right, the notification opened on the Twitter site to a funny tweet about WiFi passwords in a bar." /><figcaption><strong>Fig 2.6:</strong> Twitter’s progressive web app, Twitter Lite, sends the same notifications that its native app sends. They appear alongside other app notifications (left). Selecting one takes you directly to the referenced tweet in Twitter Lite (right).</figcaption></figure><p>Progressive web apps—specifically our friend the service worker—make push notifications possible for any website to use. Notifications aren’t required for something to be a progressive web app, but they are often effective at increasing re-engagement and revenue:</p>
<ul><li>United eXtra Electronics saw <a href="https://developers.google.com/web/showcase/2016/extra">a fourfold increase in re-engagement and a 100 percent increase in sales</a> from users arriving via push notifications.</li>
<li>Notifications contributed to <a href="https://developers.google.com/web/showcase/2017/lancome">a 12 percent increase in recovered carts</a> for Lancôme.</li>
<li>Classified ads company OLX saw <a href="https://developers.google.com/web/showcase/2017/olx">a 250 percent increase in re-engagement</a> using push notifications and a 146 percent higher click-through rate on ads.</li>
<li>Carnival Cruise Line garnered <a href="https://developers.google.com/web/showcase/2016/carnival">a 42 percent open rate from its push notifications</a>. In addition to the 24 percent of mobile users who opted in to the notifications, 16 percent of desktop users opted in as well.</li>
</ul><p>We’ll talk more about push notifications in Chapter 6. For now, it can be helpful to know that progressive web apps can send push notifications, just like a native app—which may help you make the case to your company.</p>
<p>Whether you have a native app or not, a progressive web app is probably right for you. Every step toward a progressive web app is a step toward a better website. Websites <em>should</em> be secure. They <em>should</em> be fast. They would be better if they were available offline and able to send notifications when necessary.</p>
<p>For your customers who don’t have or use your native app, providing them with a better website experience is an excellent move for your business. It’s really that simple.</p>
<footer class="entry-footer nocontent"><h1>About the Author</h1>
<div class="byline author vcard"><a class="photo" href="https://alistapart.com/author/jason-grigsby"><img src="https://alistapart.com/d/_made/pix/authors/photos/jg-teso-casual_120_120_c1.jpg" alt="Image of Jason Grigsby" /></a>
<h2>
<a href="https://twitter.com/grigs">Jason Grigsby</a> is cofounder of <a href="https://cloudfour.com/">Cloud Four</a>, a small web consultancy with big aspirations. Since cofounding Cloud Four, he has had the good fortune to work on many fantastic projects, including the Obama ’08 iOS app. He was founder and president of Mobile Portland, where he helped start the world's first community device lab. He is the coauthor of <cite>Head First Mobile Web</cite> (O’Reilly 2011) and one of the signatories of the Future Friendly web manifesto. He participated in the Responsive Images Community Group, which helped define the new web standard for responsive images. He tracks progressive web app case studies at <a href="https://pwastats.com">pwastats.com</a>.</h2></div>
<h3>More from this Author</h3>
<ul class="author-more"><li><a href="https://alistapart.com/article/adapting-to-input">Adapting to Input</a></li>
</ul>
</footer>]]></description>
      <link>http://alistapart.com/article/progressive-web-apps-excerpt</link>
      <guid>http://alistapart.com/article/progressive-web-apps-excerpt</guid>
      <pubDate>Thu, 06 Dec 2018 03:12:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[<![CDATA[ Progressive Web Apps: The Case for PWAs ]]]]><![CDATA[>]]></title>
      <description><![CDATA[<div class="entry-content">
<p>Now that you know what a progressive web app is, you’re probably wondering if your organization would benefit from one. To determine if it makes sense for your organization, ask yourself two questions:</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<ol><li><strong>Does your organization have a website?</strong> If so, you would probably benefit from a progressive web app. This may sound flippant, but it’s true: nearly every website should be a progressive web app, because they represent best practices for the web.</li>
<li><strong>Does your organization make money on your website via ecommerce, advertising, or some other method?</strong> If so, you <em>definitely</em> need a progressive web app, because progressive web apps can have a significant impact on revenue.</li>
</ol><p>This doesn’t mean that your site needs to have every possible feature of progressive web apps. You may have no need to provide offline functionality, push notifications, or even the ability for people to install your website to their homescreen. You may only want the bare minimum: a secure site, a service worker to speed up the site, and a manifest file—things that benefit every website.</p>
<p>Of course, you may decide that your personal website or side project doesn’t warrant the extra effort to make it into a progressive web app. That’s understandable—and in the long run, even personal websites will gain progressive web app features when the underlying content management systems add support for them. For example, both <a href="https://magento.com/news-room/press-releases/magento-commerce-announces-progressive-web-applications-studio">Magento</a> and <a href="https://www.youtube.com/watch?v=Di7RvMlk9io">WordPress</a> have already announced their plans to bring progressive web apps to their respective platforms. Expect other platforms to follow suit.</p>
<p>But if you’re running any kind of website that makes money for your organization, then it would behoove you to start planning for how to convert your website to a progressive web app. Companies that have deployed progressive web apps have seen increases in conversion, user engagement, sales, and advertising revenue. For example, <a href="https://medium.com/dev-channel/a-pinterest-progressive-web-app-performance-case-study-3bd6ed2e6154">Pinterest saw core engagement increase by 60 percent</a> and user-generated ad revenue increase by 44 percent (Fig 2.1). <a href="https://www.youtube.com/watch?v=PsgW-0M67TQ&amp;feature=youtu.be&amp;t=34m4s">West Elm saw a 15 percent increase in average time spent on their site</a> and a 9 percent lift in revenue per visit.</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2018/12/fig2-1.jpg" alt="Comparing old mobile web to the progressive web version of Pinterest, the time spent that was greater than 5 minutes increased by 40%, the user-generated ad revenue increased by 44%, ad clickthroughs increased by 50%, and core engagement metrics improved by 60%. Even comparing to the native app, most of these same metrics increased between 2-5%." /><figcaption><strong>Fig 2.1:</strong> Addy Osmani, an engineering manager for Google, wrote <a href="https://medium.com/dev-channel/a-pinterest-progressive-web-app-performance-case-study-3bd6ed2e6154">a case study about Pinterest’s progressive web app</a>, comparing it to both their old mobile website and their native app.</figcaption></figure><p>The success stories for progressive web apps are so abundant that my company, Cloud Four, started a website called <a href="https://www.pwastats.com/">PWA Stats</a> to keep track of them (Fig 2.2). There’s a good chance that we’ve collected a case study from an organization similar to yours that you can use to convince your coworkers that building a progressive web app makes sense.</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2018/12/fig2-2.jpg" alt="A screenshot of the PWA Stats homepage, showing case studies for Uber, Trivago, Petlove, and the Grand Velas Riviera Maya resort." /><figcaption><strong>Fig 2.2:</strong> <a href="https://www.pwastats.com/">PWAstats.com</a> collects statistics and stories documenting the impact of progressive web apps.</figcaption></figure><p>And convincing them may be necessary. Despite the clear benefits of progressive web apps, many businesses still haven’t converted—often because they simply don’t know about PWAs yet. (So if you start building one now, you may get a jump on your competition!)</p>
<p>But there is also a lot of confusion about what progressive web apps are capable of, where they can be used, and how they relate to native apps. This confusion creates fear, uncertainty, and doubt (FUD) that slow the adoption of progressive web apps.</p>
<p>If you advocate for progressive web apps in your organization, you’ll likely find some confusion and possibly even encounter some resistance. So let’s equip you with arguments to cut through the FUD and convince your colleagues.</p>
<h2>Native apps and PWAs can coexist<a class="subhead-anchor" href="#section1">#section1</a></h2>
<p>If your organization already has a native app, stakeholders may balk at the idea of <em>also</em> having a progressive web app—especially since the main selling point of PWAs is to enable native app features and functionality.</p>
<p>It’s tempting to view progressive web apps as competition to native apps—much of the press coverage has adopted this storyline. But the reality is that progressive web apps make sense irrespective of whether a company has a native app.</p>
<p>Set aside the “native versus web” debate, and focus on the experience you provide customers who interact with your organization via the web. Progressive web apps simply make sense on their own merits: they can help you reach more customers, secure your site, generate revenue, provide more reliable experiences, and notify users of updates—all as a complement to your native app.</p>
<h3>Reach more customers<a class="subhead-anchor" href="#section2">#section2</a></h3>
<p>Not all of your current customers—and none of your potential customers—have your native app installed. Even your average customer is unlikely to have your app installed, and those customers who <em>do</em> have your app may still visit your site on a desktop computer.</p>
<p>Providing a better experience on the website itself will increase the chances that current and future customers will read your content or buy your products (or even download your native app!). A progressive web app can provide that better experience.</p>
<p>Despite what the tech press might have you believe, the mobile web is growing faster than native apps. comScore compared the top one thousand apps to the top one thousand mobile web properties and found that “<a href="https://www.comscore.com/Insights/Presentations-and-Whitepapers/2016/The-2016-US-Mobile-App-Report">mobile web audiences are almost 3x the size and growing 2x as fast as app audiences</a>”.</p>
<p>And while it’s true that people spend more time in their favorite apps than they do on the web, you may have trouble convincing people to install your app in the first place. <a href="https://www.comscore.com/Insights/Presentations-and-Whitepapers/2017/The-2017-US-Mobile-App-Report">Over half of smartphone users in the United States don’t download any apps</a> in a typical month.</p>
<p>Having a native app in an app store doesn’t guarantee that people will install it. It costs a lot to advertise an app and convince people to try it. According to app marketing company Liftoff, <a href="https://www.emarketer.com/Article/Cost-of-Acquiring-Mobile-App-User/1016688">the average cost to get someone to install an app is $4.12</a>, and that shoots up to $8.21 per install if you want someone to create an account in your app.</p>
<p>If you’re lucky enough to get someone to install your app, the next hurdle is convincing them to continue to use it. When analyst Andrew Chen analyzed user retention data from 125 million mobile phones, he found that “<a href="https://andrewchen.co/new-data-shows-why-losing-80-of-your-mobile-users-is-normal-and-that-the-best-apps-do-much-better/">the average app loses 77% of its DAUs [daily active users] within the first 3 days</a> after the install. Within 30 days, it’s lost 90% of DAUs. Within 90 days, it’s over 95%” (Fig 2.3).</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2018/12/fig2-3.jpg" alt="Chart: The average retention curve for Android apps drops precipitously within the first three days and continues to drop more slowly to near 0 over the next 90 days." /><figcaption><strong>Fig 2.3:</strong> App loyalty remains a big issue for native apps. The average app loses over 95 percent of its daily active users within 90 days.</figcaption></figure><p>Progressive web apps don’t have those same challenges. They’re as easy for people to discover as your website is, because they <em>are</em> your website. And the features of a progressive web app are available immediately. There’s no need to jump through the hoops of visiting an app store and downloading the app. Installation is fast: it happens in the background during the first site visit, and can literally be as simple as adding an icon to the home screen.</p>
<p>As Alex Russell wrote in <a href="https://medium.com/dev-channel/why-are-app-install-banners-still-a-thing-18f3952d349a">a 2017 Medium post</a>:</p>
<figure class="quote"><blockquote>
<p>The friction of PWA installation is <em>much</em> lower. Our internal metrics at Google show that for similar volume of prompting for PWA banners and native app banners — the closest thing to an apples-to-apples comparison we can find — <em>PWA banners convert 5–6x more often</em>. More than half of users who chose to install a native app from these banners fail to complete installing the app whereas PWA installation is near-instant.</p>
</blockquote>
</figure><p>In short, a large and growing percentage of your customers interact with you on the web. Progressive web apps can lead to more revenue and engagement from more customers.</p>
<h3>Secure your website<a class="subhead-anchor" href="#section3">#section3</a></h3>
<p>If you’re collecting credit cards or private information, providing a secure website for your web visitors is a must. But even if your website doesn’t handle sensitive data, it still makes sense to use HTTPS and provide a secure experience. Even seemingly innocuous web traffic can provide signals that can identify individuals and potentially compromise them. That’s not to mention the concerns raised by revelations of government snooping.</p>
<p>It used to be that running a secure server was costly, confusing, and (seemingly) slower. Things have changed. SSL/TLS certificates used to cost hundreds of dollars, but now certificate provider <a href="https://letsencrypt.org/">Let’s Encrypt</a> gives them out for free. Many hosting providers have integrated with certificate providers so you can set up HTTPS with a single click. And it turns out that <a href="https://istlsfastyet.com/">HTTPS wasn’t as slow as we thought it was</a>.</p>
<p>Websites on HTTPS can also move to a new version of HTTP called HTTP/2. The biggest benefit is that HTTP/2 is significantly faster that HTTP/1. For many hosting providers and content delivery networks (CDNs), the moment you move to HTTPS, you get HTTP/2 with no additional work.</p>
<p>If that wasn’t enough incentive to move to HTTPS, browser makers are using a carrot-and-stick approach for pushing websites to make the change. For the stick, Chrome has started warning users when they enter data on a site that isn’t running HTTPS. By the time you read this, <a href="https://blog.chromium.org/2017/04/next-steps-toward-more-connection.html">Google plans to label all HTTP pages with a “Not secure” warning</a> (Fig 2.4). Other browsers will likely follow suit and start to flag sites that aren’t encrypted to make sure users are aware that their data could be intercepted.</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2018/12/fig2-4.jpg" alt="The eventual treatment of all HTTP pages in Chrome will be to show a red yield icon with the words 'Not secure'." /><figcaption>Fig 2.4: Google has announced its intention to <a href="https://www.chromium.org/Home/chromium-security/marking-http-as-non-secure">label any website that isn’t running HTTPS as not secure</a>. Different warning styles will be rolled out over time, until the label reaches the final state shown here.<br /></figcaption></figure><p>For the HTTPS carrot, browsers are starting to require HTTPS to use new features. If you want to utilize the latest and greatest web tech, <a href="https://blog.mozilla.org/security/2018/01/15/secure-contexts-everywhere/">you’ll need to be running HTTPS</a>. In fact, some features that used to work on nonsecure HTTP that are considered to contain sensitive data—for example, geolocation—are being restricted to HTTPS now. On second thought, perhaps this is a bit of a stick as well. A carrot stick?</p>
<p>With all that in mind, it makes sense to set up a secure website for your visitors. You’ll avoid scary nonsecure warnings. You’ll get access to new browser features. You’ll gain speed benefits from HTTP/2. And: you’ll be setting yourself up for a progressive web app.</p>
<p>In order to use service workers, the core technology for progressive web apps, your website <em>must</em> be on HTTPS. So if you want to reap the rewards of all the PWA goodness, you need to do the work to make sure your foundation is secure.</p>
<h3>Generate more revenue<a class="subhead-anchor" href="#section4">#section4</a></h3>
<p>There are numerous studies that show a connection between the speed of a website and the amount of time and money people are willing to spend on it. DoubleClick found that “<a href="https://marketingplatform.google.com/about/resources/">53% of mobile site visits are abandoned if pages take longer than 3 seconds to load</a>.” Walmart found that <a href="https://www.slideshare.net/devonauerswald/walmart-pagespeedslide">for every 100 milliseconds of improvement to page load time, there was up to a one percent increase in incremental revenue</a>.</p>
<p>Providing a fast web experience makes a big difference to the bottom line. Unfortunately, the average load time for mobile websites is <a href="https://marketingplatform.google.com/about/resources/">nineteen seconds on 3G connections</a>. That’s where a progressive web app can help.</p>
<p>Progressive web apps use service workers to provide an exceptionally fast experience. Service workers allow developers to explicitly define what files the browser should store in its local cache and under what circumstances the browser should check for updates to the cached files. Files that are stored in the local cache can be accessed much more quickly than files that are retrieved from the network.</p>
<p>When someone requests a new page from a progressive web app, most of the files needed to render that page are already stored on the local device. This means that the page can load nearly instantaneously because all the browser needs to download is the incremental information needed for that page.</p>
<p>In many ways, this is the same thing that makes native apps so fast. When someone installs a native app, they download the files necessary to run the app ahead of time. After that occurs, the native app only has to retrieve any new data. Service workers allow the web to do something similar.</p>
<p>The impact of progressive web apps on performance can be astounding. For example, <a href="https://medium.com/@addyosmani/a-tinder-progressive-web-app-performance-case-study-78919d98ece0">Tinder cut load times from 11.91 seconds to 4.69 seconds</a> with their progressive web app—and it’s 90 percent smaller than their native Android app. Hotel chain Treebo launched a progressive web app and <a href="https://tech.treebo.com/we-didnt-see-a-speed-limit-so-we-made-it-faster-treebo-and-pwas-the-journey-so-far-f7378410abc7">saw a fourfold increase in conversion rates year-over-year</a>; conversion rates for repeat users saw a threefold increase, and their median interactive time on mobile dropped to 1.5 seconds.</p>
<h3>Ensure network reliability<a class="subhead-anchor" href="#section5">#section5</a></h3>
<p>Mobile networks are flaky. One moment you’re on a fast LTE connection, and the next you’re slogging along at 2G speeds—or simply offline. We’ve all experienced situations like this. But our websites are still primarily built with an assumption that networks are reliable.</p>
<p>With progressive web apps, you can create an app that continues to work when someone is offline. In fact, the technology used to create an offline experience is the same technology used to make web pages fast: service workers.</p>
<p>Remember, service workers allow us to explicitly tell the browser what to cache locally. We can expand what is stored locally—not only the assets needed to render the app, but also the content of pages—so that people can continue to view pages offline (Fig 2.5).</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2018/12/fig2-5.jpg" alt="Three screens from the housing.com site show how the design adapts to show when it is offline and that it can continue to show saved results even when offline." /><figcaption><strong>Fig 2.5:</strong> The header in <a href="https://housing.com">housing.com’s progressive web app</a> changes from purple (left) to gray when offline (middle). Content the user has previously viewed or favorited is available offline (right), which is important for housing.com’s home market in India, where network connectivity can be slow and unreliable.<br /></figcaption></figure><p>Using a service worker, we can even precache the shell of our application behind the scenes. This means that when someone visits a progressive web app for the first time, the whole application could be downloaded, stored in the cache, and ready for offline use without requiring the person to take any action to initiate it. For more on when precaching makes sense, see Chapter 5.</p>
<h3>Keep users engaged<a class="subhead-anchor" href="#section6">#section6</a></h3>
<p>Push notifications are perhaps the best way to keep people engaged with an application. They prompt someone to return to an app with tantalizing nuggets of new information, from breaking news alerts to chat messages.</p>
<p>So why limit push notifications to those who install a native application? For instance, if you have a chat or social media application, wouldn’t it be nice to notify people of new messages (Fig 2.6)?</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2018/12/fig2-6.jpg" alt="Two screens: On the left, a list of system notifications including one from the Twitter website. On the right, the notification opened on the Twitter site to a funny tweet about WiFi passwords in a bar." /><figcaption><strong>Fig 2.6:</strong> Twitter’s progressive web app, Twitter Lite, sends the same notifications that its native app sends. They appear alongside other app notifications (left). Selecting one takes you directly to the referenced tweet in Twitter Lite (right).</figcaption></figure><p>Progressive web apps—specifically our friend the service worker—make push notifications possible for any website to use. Notifications aren’t required for something to be a progressive web app, but they are often effective at increasing re-engagement and revenue:</p>
<ul><li>United eXtra Electronics saw <a href="https://developers.google.com/web/showcase/2016/extra">a fourfold increase in re-engagement and a 100 percent increase in sales</a> from users arriving via push notifications.</li>
<li>Notifications contributed to <a href="https://developers.google.com/web/showcase/2017/lancome">a 12 percent increase in recovered carts</a> for Lancôme.</li>
<li>Classified ads company OLX saw <a href="https://developers.google.com/web/showcase/2017/olx">a 250 percent increase in re-engagement</a> using push notifications and a 146 percent higher click-through rate on ads.</li>
<li>Carnival Cruise Line garnered <a href="https://developers.google.com/web/showcase/2016/carnival">a 42 percent open rate from its push notifications</a>. In addition to the 24 percent of mobile users who opted in to the notifications, 16 percent of desktop users opted in as well.</li>
</ul><p>We’ll talk more about push notifications in Chapter 6. For now, it can be helpful to know that progressive web apps can send push notifications, just like a native app—which may help you make the case to your company.</p>
<p>Whether you have a native app or not, a progressive web app is probably right for you. Every step toward a progressive web app is a step toward a better website. Websites <em>should</em> be secure. They <em>should</em> be fast. They would be better if they were available offline and able to send notifications when necessary.</p>
<p>For your customers who don’t have or use your native app, providing them with a better website experience is an excellent move for your business. It’s really that simple.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Our own @zeldman paints the complicated catch-22 that our free, democratized web has with our money-making capitalist roots. As creators, how do we untangle this web? #LetsFixThis</div><div class="entry-content">A month of experiencing a temporary disability changed @fcorradini’s perspective on how to take more care when conducting accessibility testing. He shares the impact.</div><div class="entry-content">Jeremy Wagner plots a course to avoid the unnecessary bloat and inaccessible patterns of current JavaScript trends.</div><div class="entry-content">Technology can easily become a platform for hate, and we have an ethical responsibility to fix it. ALA's own Tatiana Mac discusses</div><div class="entry-content">Screen readers are diverse and complex: front-end developer Melanie Richards breaks down how they access our content step-by-step.</div>]]></description>
      <link>https://alistapart.com/article/progressive-web-apps-excerpt/</link>
      <guid>https://alistapart.com/article/progressive-web-apps-excerpt/</guid>
      <pubDate>Thu, 06 Dec 2018 03:12:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[var to JIT]]></title>
      <description><![CDATA[<p>In our previous article we described how the browser uses CSS to render beautiful pixels to the user’s screen. Although modern CSS can (and should!) be used to create highly interactive user experiences, for the last mile of interactivity, we need to dynamically update the HTML document. For that, we’re going to need JavaScript.</p>
<h2>Bundle to bytecode</h2>

<div class="utility-side-bar">
<div class="banner banner-wide pantheon"><a href="http://cloudinary.rocks/ala"><img class="banner-logo" src="https://alistapart.com/components/assets/img/cloudinary_vertical_logo_for_white_bg.jpg" alt="Cloudinary Logo" /><p>Want the best way to store and serve images and videos? Try Cloudinary. Get your own free account.</p>
</a></div>
<div class="banner a-book-apart"><a href="https://abookapart.com"><img class="banner-logo" src="https://alistapart.com/components/assets/img/logo_a-book-apart-color.png" alt="" /><p>A Book Apart:<br />
Brief books for people who make websites.</p>
</a></div>
<div class="banner"><a href="https://aneventapart.com/"><img class="banner-logo" src="https://alistapart.com/components/assets/img/AEA_2017_80x80.png" alt="" /><p>An Event Apart:<br />
3 days of design, code, and content for web &amp; UX designers &amp; devs.</p>
</a></div>
</div>
<p>For a modern web application, the JavaScript that the browser first sees will typically not be the JavaScript written by a developer. Instead, it will most likely be a bundle produced by a tool such as webpack. And it will probably be a rather large bundle containing a UI framework such as React, various <em>polyfills</em> (libraries that emulate new platform features in older browsers), and an assortment of other packages found on npm. The first challenge for the browser’s JavaScript engine is to convert that big bundle of text into instructions that can be executed on a virtual machine. It needs to parse the code, and because the user is waiting on JavaScript for all that interactivity, it needs to do it fast.</p>
<p>At a high level, the JavaScript engine parses code just like any other programming language compiler. First, the stream of input text is broken up into chunks called <em>tokens</em>. Each token represents a meaningful unit within the syntactic structure of the language, similar to words and punctuation in natural written language. Those tokens are then fed into a <a href="https://en.wikipedia.org/wiki/Top-down_parsing"><em>top-down parser</em></a> that produces a tree structure representing the program. Language designers and compiler engineers like to call this tree structure an <em>AST (abstract syntax tree)</em>. The resulting AST can then be analyzed to produce a list of virtual machine instructions called bytecode.</p>
<figure><img src="https://alistapart.com/d/var-to-jit/fig1.png" alt="JavaScript is run through the abstract syntax tree, which produces byte code" /></figure><p>The process of generating an AST is one of the more straightforward aspects of a JavaScript engine. Unfortunately, it can also be slow. Remember that big bundle of code we started out with? The JavaScript engine has to parse and build syntax trees for the entire bundle before the user can start interacting with the site. Much of that code may be unnecessary for the initial page load, and some may not even be executed at all!</p>
<p>Fortunately, our compiler engineers have invented a variety of tricks to speed things up. First, some engines parse code on a background thread, freeing up the main UI thread for other computations.  Second, modern engines will delay the creation of in-memory syntax trees for as long as possible by using a technique called <em>deferred parsing</em> or <em>lazy compilation</em>. It works like this: if the engine sees a function definition that might not be executed for a while, it will perform a fast, “throwaway” parse of the function body. This throwaway parse will find any syntax errors that might be lurking within the code, but it will not generate an AST. Later, when the function is called for the first time, the code will be parsed again. This time, the engine will generate the full AST and bytecode required for execution. In the world of JavaScript, doing things twice can sometimes be faster than doing things once!</p>
<p>The best optimizations, though, are the ones that allow us to bypass doing any work at all. In the case of JavaScript compilation, this means skipping the parsing step completely. Some JavaScript engines will attempt to cache the generated bytecode for later reuse in case the user visits the site again. This isn’t quite as simple as it sounds. JavaScript bundles can change frequently as websites are updated, and the browser must carefully weigh the cost of serializing bytecode against the performance improvements that come from caching.</p>
<h2>Bytecode to runtime</h2>
<p>Now that we have our bytecode, we’re ready to start execution. In today’s JavaScript engines, the bytecode that we generated during parsing is first fed into a virtual machine called an <em>interpreter</em>. An interpreter is a bit like a CPU implemented in software. It looks at each bytecode instruction, one at a time, and decides what actual machine instructions to execute and what to do next.</p>
<p>The structure and behavior of the JavaScript programming language is defined in a document formally known as <a href="https://tc39.github.io/ecma262"><em>ECMA-262</em></a>. Language designers like to call the structure part “syntax” and the behavior part “semantics.” The semantics of almost every aspect of the language is defined by algorithms that are written using prose-like pseudo-code. For instance, let’s pretend we are compiler engineers implementing the <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Bitwise_Operators#%3E%3E_(Sign-propagating_right_shift)"><em>signed right shift operator</em> (&gt;&gt;)</a>. Here’s what the <a href="https://tc39.github.io/ecma262/#sec-signed-right-shift-operator-runtime-semantics-evaluation">specification tells us</a>:</p>
<p><em>ShiftExpression</em> : <em>ShiftExpression</em> &gt;&gt; <em>AdditiveExpression</em></p>
<ol><li>Let <var>lref</var> be the result of evaluating <em>ShiftExpression</em>.</li>
<li>Let <var>lval</var> be ? <a href="https://tc39.github.io/ecma262/#sec-getvalue">GetValue</a>(<var>lref</var>).</li>
<li>Let <var>rref</var> be the result of evaluating <em>AdditiveExpression</em>.</li>
<li>Let <var>rval</var> be ? GetValue(<var>rref</var>).</li>
<li>Let <var>lnum</var> be ? <a href="https://tc39.github.io/ecma262/#sec-toint32">ToInt32</a>(<var>lval</var>).</li>
<li>Let <var>rnum</var> be ? <a href="https://tc39.github.io/ecma262/#sec-touint32">ToUint32</a>(<var>rval</var>).</li>
<li>Let <var>shiftCount</var> be the result of masking out all but the least significant 5 bits of <var>rnum</var>, that is, compute <var>rnum</var> &amp; 0x1F.</li>
<li>Return the result of performing a sign-extending right shift of <var>lnum</var> by <var>shiftCount</var> bits. The most significant bit is propagated. The result is a signed 32-bit integer.</li>
</ol><p>In the first six steps we convert the operands (the values on either side of the &gt;&gt;) into 32-bit integers, and then we perform the actual shift operation. If you squint, it looks a bit like a recipe. If you <em>really</em> squint, you might see the beginnings of a syntax-directed interpreter.</p>
<p>Unfortunately, if we implemented the algorithms exactly as they are described in the specification, we’d end up with a very slow interpreter. Consider the simple operation of getting a property value from a JavaScript object.</p>
<p>Objects in JavaScript are conceptually like dictionaries. Each property is keyed by a string name. Objects can also have a <em>prototype object</em>.</p>
<figure><img src="https://alistapart.com/d/var-to-jit/fig2.png" alt="A JavaScript object with a prototype, an arrow pointing to an object.prototype, an arrow pointing to obj, an arrow pointing to obj2" /></figure><p>If an object doesn’t have an entry for a given string key, then we need to look for that key in the prototype. We repeat this operation until we either find the key that we’re looking for or get to the end of the prototype chain.</p>
<p>That’s potentially a lot of work to perform every time we want to get a property value out of an object!</p>
<p>The strategy used in JavaScript engines for speeding up dynamic property lookup is called <em>inline caching</em>. Inline caching was first developed for the language <a href="https://en.wikipedia.org/wiki/Smalltalk">Smalltalk</a> in the 1980s. The basic idea is that the results from previous property lookup operations can be stored directly in the generated bytecode instructions.</p>
<p>To see how this works, let’s imagine that the JavaScript engine is a towering gothic cathedral. As we step inside, we notice that the engine is chock full of objects swarming around. Each object has an identifiable shape that determines where its properties are stored.</p>
<p>Now, imagine that we are following a series of bytecode instructions written on a scroll. The next instruction tells us to get the value of the property named “x” from some object. You grab that object, turn it over in your hands a few times to figure out where “x” is stored, and find out that it is stored in the object’s second data slot.</p>
<p>It occurs to you that any object with this same shape will have an “x” property in its second data slot.  You pull out your quill and make a note on your bytecode scroll indicating the shape of the object and the location of the “x” property. The next time you see this instruction you’ll simply check the shape of the object. If the shape matches what you’ve recorded in your bytecode notes, you’ll know exactly where the data is located without having to inspect the object. You’ve just implemented what’s known as a <em>monomorphic inline cache</em>!</p>
<p>But what happens if the shape of the object doesn’t match our bytecode notes? We can get around this problem by drawing a small table with a row for each shape we’ve seen. When we see a new shape, we use our quill to add a new row to the table. We now have a <em>polymorphic inline cache</em>. It’s not quite as fast as the monomorphic cache, and it takes up a little more space on the scroll, but if there aren’t too many rows, it works quite well.</p>
<p>If we end up with a table that’s too big, we’ll want to erase the table, and make a note to remind ourselves to not worry about inline caching for this instruction. In compiler terms, we have a <em>megamorphic callsite</em>.</p>
<p>In general, monomorphic code is very fast, polymorphic code is almost as fast, and megamorphic code tends to be rather slow. Or, in haiku form:</p>
<figure class="text">One shape, flowing wind<br />
Several shapes, jumping fox<br />
Many shapes, turtle</figure><h2>Interpreter to just-in-time (JIT)</h2>
<p>The great thing about an interpreter is that it can start executing code quickly, and for code that is run only once or twice, this “software CPU” performs acceptably fast. But for “hot code” (functions that are run hundreds, thousands, or millions of times) what we really want is to execute machine instructions directly on the actual hardware. We want <a href="https://en.wikipedia.org/wiki/Just-in-time_compilation">just-in-time (JIT) compilation</a>.</p>
<p>As JavaScript functions are executed by the interpreter, various statistics are gathered about how often the function has been called and what kinds of arguments it is called with. If the function is run frequently with the same kinds of arguments, the engine may decide to convert the function’s bytecode into machine code.</p>
<p>Let’s step once again into our hypothetical JavaScript engine, the gothic cathedral. As the program executes, you dutifully pull bytecode scrolls from carefully labeled shelves. For each function, there is roughly one scroll. As you follow the instructions on each scroll, you record how many times you’ve executed the scroll. You also note the shapes of the objects encountered while carrying out the instructions. You are, in effect, a <em><a href="https://en.wikipedia.org/wiki/Profiling_(computer_programming)">profiling</a> interpreter</em>.</p>
<p>When you open the next scroll of bytecode, you notice that this one is “hot.” You’ve executed it dozens of times, and you think it would run much faster in machine code. Fortunately, there are two rooms full of scribes that are ready to perform the translation for you. The scribes in the first room, a brightly lit open office, can translate bytecode into machine code quite fast. The code that they produce is of good quality and is concise, but it’s not as efficient as it could be. The scribes in the second room, dark and misty with incense, work more carefully and take a bit longer to finish. The code that they produce, however, is highly optimized and about as fast as possible.</p>
<p>In compiler-speak, we refer to these different rooms as <em>JIT compilation tiers</em>. Different engines have different numbers of tiers depending on the tradeoffs they’ve chosen to make.</p>
<p>You decide to send the bytecode to the first room of scribes. After working on it for a bit, using your carefully recorded notes, they produce a new scroll containing machine instructions and place it on the correct shelf alongside the original bytecode version. The next time you need to execute the function, you can use this faster set of instructions.</p>
<p>The only problem is that the scribes made quite a few assumptions when they translated our scroll. Perhaps they assumed that a variable would always hold an integer. What happens if one of those assumptions is invalidated?</p>
<p>In that case we must perform what’s known as a <em>bailout</em>. We pull the original bytecode scroll from the shelf, and figure out which instruction we should start executing from. The machine code scroll disappears in a puff of smoke and the process starts again.</p>
<h2>To infinity and beyond</h2>
<p>Today’s high-performance JavaScript engines have evolved far beyond the relatively simple interpreters that shipped with Netscape Navigator and Internet Explorer in the 1990s. And that evolution continues. New features are incrementally added to the language. Common coding patterns are optimized. <a href="https://webassembly.org/">WebAssembly</a> is maturing. A richer standard module library is being developed. As developers, we can expect modern JavaScript engines to deliver fast and efficient execution as long as we keep our bundle sizes in check and try to make sure our performance-critical code is not overly dynamic.</p>
<footer class="entry-footer nocontent"><h1>About the Author</h1>
<div class="byline author vcard"><a class="photo" href="https://alistapart.com/author/kevinsmith"><img src="https://alistapart.com/d/_made/pix/authors/photos/kevin-smith_120_120_c1.jpg" alt="Image of Kevin Smith" /></a>
<h2>
Kevin works on the JavaScript engine of Microsoft Edge, focusing on programming language design and standardization. After a decade of writing web applications and toy compilers, he now serves as a Microsoft representative at TC39, the committee responsible for the evolution and specification of JavaScript.</h2></div>

</footer>]]></description>
      <link>http://alistapart.com/article/var-to-jit</link>
      <guid>http://alistapart.com/article/var-to-jit</guid>
      <pubDate>Thu, 29 Nov 2018 01:11:00 +0100</pubDate>
    </item>
    <item>
      <title><![CDATA[<![CDATA[ var to JIT ]]]]><![CDATA[>]]></title>
      <description><![CDATA[<div class="entry-content">
<p>In our previous article we described how the browser uses CSS to render beautiful pixels to the user’s screen. Although modern CSS can (and should!) be used to create highly interactive user experiences, for the last mile of interactivity, we need to dynamically update the HTML document. For that, we’re going to need JavaScript.</p>

<div class="ala-single-sidebar-wrapper">Article Continues Below
</div>
<h2>Bundle to bytecode<a class="subhead-anchor" href="#section1">#section1</a></h2>
<p>For a modern web application, the JavaScript that the browser first sees will typically not be the JavaScript written by a developer. Instead, it will most likely be a bundle produced by a tool such as webpack. And it will probably be a rather large bundle containing a UI framework such as React, various <em>polyfills</em> (libraries that emulate new platform features in older browsers), and an assortment of other packages found on npm. The first challenge for the browser’s JavaScript engine is to convert that big bundle of text into instructions that can be executed on a virtual machine. It needs to parse the code, and because the user is waiting on JavaScript for all that interactivity, it needs to do it fast.</p>
<p>At a high level, the JavaScript engine parses code just like any other programming language compiler. First, the stream of input text is broken up into chunks called <em>tokens</em>. Each token represents a meaningful unit within the syntactic structure of the language, similar to words and punctuation in natural written language. Those tokens are then fed into a <a href="https://en.wikipedia.org/wiki/Top-down_parsing"><em>top-down parser</em></a> that produces a tree structure representing the program. Language designers and compiler engineers like to call this tree structure an <em>AST (abstract syntax tree)</em>. The resulting AST can then be analyzed to produce a list of virtual machine instructions called bytecode.</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2018/11/fig1.png" alt="JavaScript is run through the abstract syntax tree, which produces byte code" /><br /></figure><p>The process of generating an AST is one of the more straightforward aspects of a JavaScript engine. Unfortunately, it can also be slow. Remember that big bundle of code we started out with? The JavaScript engine has to parse and build syntax trees for the entire bundle before the user can start interacting with the site. Much of that code may be unnecessary for the initial page load, and some may not even be executed at all!</p>
<p>Fortunately, our compiler engineers have invented a variety of tricks to speed things up. First, some engines parse code on a background thread, freeing up the main UI thread for other computations. Second, modern engines will delay the creation of in-memory syntax trees for as long as possible by using a technique called <em>deferred parsing</em> or <em>lazy compilation</em>. It works like this: if the engine sees a function definition that might not be executed for a while, it will perform a fast, “throwaway” parse of the function body. This throwaway parse will find any syntax errors that might be lurking within the code, but it will not generate an AST. Later, when the function is called for the first time, the code will be parsed again. This time, the engine will generate the full AST and bytecode required for execution. In the world of JavaScript, doing things twice can sometimes be faster than doing things once!</p>
<p>The best optimizations, though, are the ones that allow us to bypass doing any work at all. In the case of JavaScript compilation, this means skipping the parsing step completely. Some JavaScript engines will attempt to cache the generated bytecode for later reuse in case the user visits the site again. This isn’t quite as simple as it sounds. JavaScript bundles can change frequently as websites are updated, and the browser must carefully weigh the cost of serializing bytecode against the performance improvements that come from caching.</p>
<h2>Bytecode to runtime<a class="subhead-anchor" href="#section2">#section2</a></h2>
<p>Now that we have our bytecode, we’re ready to start execution. In today’s JavaScript engines, the bytecode that we generated during parsing is first fed into a virtual machine called an <em>interpreter</em>. An interpreter is a bit like a CPU implemented in software. It looks at each bytecode instruction, one at a time, and decides what actual machine instructions to execute and what to do next.</p>
<p>The structure and behavior of the JavaScript programming language is defined in a document formally known as <a href="https://tc39.github.io/ecma262"><em>ECMA-262</em></a>. Language designers like to call the structure part “syntax” and the behavior part “semantics.” The semantics of almost every aspect of the language is defined by algorithms that are written using prose-like pseudo-code. For instance, let’s pretend we are compiler engineers implementing the <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Bitwise_Operators#%3E%3E_(Sign-propagating_right_shift)"><em>signed right shift operator</em> (&gt;&gt;)</a>. Here’s what the <a href="https://tc39.github.io/ecma262/#sec-signed-right-shift-operator-runtime-semantics-evaluation">specification tells us</a>:</p>
<p><em>ShiftExpression</em> : <em>ShiftExpression</em> &gt;&gt; <em>AdditiveExpression</em></p>
<ol><li>Let <var>lref</var> be the result of evaluating <em>ShiftExpression</em>.</li>
<li>Let <var>lval</var> be ? <a href="https://tc39.github.io/ecma262/#sec-getvalue">GetValue</a>(<var>lref</var>).</li>
<li>Let <var>rref</var> be the result of evaluating <em>AdditiveExpression</em>.</li>
<li>Let <var>rval</var> be ? GetValue(<var>rref</var>).</li>
<li>Let <var>lnum</var> be ? <a href="https://tc39.github.io/ecma262/#sec-toint32">ToInt32</a>(<var>lval</var>).</li>
<li>Let <var>rnum</var> be ? <a href="https://tc39.github.io/ecma262/#sec-touint32">ToUint32</a>(<var>rval</var>).</li>
<li>Let <var>shiftCount</var> be the result of masking out all but the least significant 5 bits of <var>rnum</var>, that is, compute <var>rnum</var> &amp; 0x1F.</li>
<li>Return the result of performing a sign-extending right shift of <var>lnum</var> by <var>shiftCount</var> bits. The most significant bit is propagated. The result is a signed 32-bit integer.</li>
</ol><p>In the first six steps we convert the operands (the values on either side of the &gt;&gt;) into 32-bit integers, and then we perform the actual shift operation. If you squint, it looks a bit like a recipe. If you <em>really</em> squint, you might see the beginnings of a syntax-directed interpreter.</p>
<p>Unfortunately, if we implemented the algorithms exactly as they are described in the specification, we’d end up with a very slow interpreter. Consider the simple operation of getting a property value from a JavaScript object.</p>
<p>Objects in JavaScript are conceptually like dictionaries. Each property is keyed by a string name. Objects can also have a <em>prototype object</em>.</p>
<figure><img src="https://alistapart.com/wp-content/uploads/2018/11/fig2.png" alt="A JavaScript object with a prototype, an arrow pointing to an object.prototype, an arrow pointing to obj, an arrow pointing to obj2" /><br /></figure><p>If an object doesn’t have an entry for a given string key, then we need to look for that key in the prototype. We repeat this operation until we either find the key that we’re looking for or get to the end of the prototype chain.</p>
<p>That’s potentially a lot of work to perform every time we want to get a property value out of an object!</p>
<p>The strategy used in JavaScript engines for speeding up dynamic property lookup is called <em>inline caching</em>. Inline caching was first developed for the language <a href="https://en.wikipedia.org/wiki/Smalltalk">Smalltalk</a> in the 1980s. The basic idea is that the results from previous property lookup operations can be stored directly in the generated bytecode instructions.</p>
<p>To see how this works, let’s imagine that the JavaScript engine is a towering gothic cathedral. As we step inside, we notice that the engine is chock full of objects swarming around. Each object has an identifiable shape that determines where its properties are stored.</p>
<p>Now, imagine that we are following a series of bytecode instructions written on a scroll. The next instruction tells us to get the value of the property named “x” from some object. You grab that object, turn it over in your hands a few times to figure out where “x” is stored, and find out that it is stored in the object’s second data slot.</p>
<p>It occurs to you that any object with this same shape will have an “x” property in its second data slot. You pull out your quill and make a note on your bytecode scroll indicating the shape of the object and the location of the “x” property. The next time you see this instruction you’ll simply check the shape of the object. If the shape matches what you’ve recorded in your bytecode notes, you’ll know exactly where the data is located without having to inspect the object. You’ve just implemented what’s known as a <em>monomorphic inline cache</em>!</p>
<p>But what happens if the shape of the object doesn’t match our bytecode notes? We can get around this problem by drawing a small table with a row for each shape we’ve seen. When we see a new shape, we use our quill to add a new row to the table. We now have a <em>polymorphic inline cache</em>. It’s not quite as fast as the monomorphic cache, and it takes up a little more space on the scroll, but if there aren’t too many rows, it works quite well.</p>
<p>If we end up with a table that’s too big, we’ll want to erase the table, and make a note to remind ourselves to not worry about inline caching for this instruction. In compiler terms, we have a <em>megamorphic callsite</em>.</p>
<p>In general, monomorphic code is very fast, polymorphic code is almost as fast, and megamorphic code tends to be rather slow. Or, in haiku form:</p>
<figure class="text">One shape, flowing wind<br />
Several shapes, jumping fox<br />
Many shapes, turtle</figure><h2>Interpreter to just-in-time (JIT)<a class="subhead-anchor" href="#section3">#section3</a></h2>
<p>The great thing about an interpreter is that it can start executing code quickly, and for code that is run only once or twice, this “software CPU” performs acceptably fast. But for “hot code” (functions that are run hundreds, thousands, or millions of times) what we really want is to execute machine instructions directly on the actual hardware. We want <a href="https://en.wikipedia.org/wiki/Just-in-time_compilation">just-in-time (JIT) compilation</a>.</p>
<p>As JavaScript functions are executed by the interpreter, various statistics are gathered about how often the function has been called and what kinds of arguments it is called with. If the function is run frequently with the same kinds of arguments, the engine may decide to convert the function’s bytecode into machine code.</p>
<p>Let’s step once again into our hypothetical JavaScript engine, the gothic cathedral. As the program executes, you dutifully pull bytecode scrolls from carefully labeled shelves. For each function, there is roughly one scroll. As you follow the instructions on each scroll, you record how many times you’ve executed the scroll. You also note the shapes of the objects encountered while carrying out the instructions. You are, in effect, a <em><a href="https://en.wikipedia.org/wiki/Profiling_(computer_programming)">profiling</a> interpreter</em>.</p>
<p>When you open the next scroll of bytecode, you notice that this one is “hot.” You’ve executed it dozens of times, and you think it would run much faster in machine code. Fortunately, there are two rooms full of scribes that are ready to perform the translation for you. The scribes in the first room, a brightly lit open office, can translate bytecode into machine code quite fast. The code that they produce is of good quality and is concise, but it’s not as efficient as it could be. The scribes in the second room, dark and misty with incense, work more carefully and take a bit longer to finish. The code that they produce, however, is highly optimized and about as fast as possible.</p>
<p>In compiler-speak, we refer to these different rooms as <em>JIT compilation tiers</em>. Different engines have different numbers of tiers depending on the tradeoffs they’ve chosen to make.</p>
<p>You decide to send the bytecode to the first room of scribes. After working on it for a bit, using your carefully recorded notes, they produce a new scroll containing machine instructions and place it on the correct shelf alongside the original bytecode version. The next time you need to execute the function, you can use this faster set of instructions.</p>
<p>The only problem is that the scribes made quite a few assumptions when they translated our scroll. Perhaps they assumed that a variable would always hold an integer. What happens if one of those assumptions is invalidated?</p>
<p>In that case we must perform what’s known as a <em>bailout</em>. We pull the original bytecode scroll from the shelf, and figure out which instruction we should start executing from. The machine code scroll disappears in a puff of smoke and the process starts again.</p>
<h2>To infinity and beyond<a class="subhead-anchor" href="#section4">#section4</a></h2>
<p>Today’s high-performance JavaScript engines have evolved far beyond the relatively simple interpreters that shipped with Netscape Navigator and Internet Explorer in the 1990s. And that evolution continues. New features are incrementally added to the language. Common coding patterns are optimized. <a href="https://webassembly.org/">WebAssembly</a> is maturing. A richer standard module library is being developed. As developers, we can expect modern JavaScript engines to deliver fast and efficient execution as long as we keep our bundle sizes in check and try to make sure our performance-critical code is not overly dynamic.</p>
<div class="ala-single-sidebar-wrapper sidebar-related">
</div>
</div><div class="entry-content">Our own @zeldman paints the complicated catch-22 that our free, democratized web has with our money-making capitalist roots. As creators, how do we untangle this web? #LetsFixThis</div><div class="entry-content">A month of experiencing a temporary disability changed @fcorradini’s perspective on how to take more care when conducting accessibility testing. He shares the impact.</div><div class="entry-content">Jeremy Wagner plots a course to avoid the unnecessary bloat and inaccessible patterns of current JavaScript trends.</div><div class="entry-content">Technology can easily become a platform for hate, and we have an ethical responsibility to fix it. ALA's own Tatiana Mac discusses</div><div class="entry-content">Screen readers are diverse and complex: front-end developer Melanie Richards breaks down how they access our content step-by-step.</div>]]></description>
      <link>https://alistapart.com/article/var-to-jit/</link>
      <guid>https://alistapart.com/article/var-to-jit/</guid>
      <pubDate>Thu, 29 Nov 2018 01:11:00 +0100</pubDate>
    </item>
  </channel>
</rss>
