Writing Clear and Effective Training Manuals

✍️ Golden Rules For UX Writing. With practical guidelines on how to avoid confusion and help people understand better ↓ ✅ Always write with respect, for people as smart as you. ✅ Write mobile-first: short, plain language, bite-sized chunks. ✅ Decide what to say, then find the shortest way to say it. 🚫 Avoid long buttons: use 2–4 words, max. 25 characters. 🚫 Avoid long links: at least 8 chars, max. 8 words (55 chars). ✅ Use sentence case by default, Title Case only for headings. ✅ Use progress anchors for long forms: “Next: Payment details”. 🚫 Don’t use placeholders as replacement for labels or hints. 🚫 Don’t hide critical details or guidelines behind a tooltip. 🚫 Don’t hide frequently used filters/nav behind a button. ✅ Front-load keywords in headings and text summary. ✅ Make people hunt for destructive buttons to avoid mistakes. ✅ Leave room for translation. Expect your text to grow by 40%. 🚫 Avoid more than 20 words/sentence, 50 words/paragraph. 🚫 Never mix 2+ type treatments (color, bold, indents, italic). Good writing is an incredible opportunity. Not only to help people get work done faster and with confidence, but also to build a strong and lasting relationships. To be charming when users get started. To help without a fuss when things go wrong. To show respect and sincerity, but also understanding and care when it’s needed. One little technique that has helped me is to imagine a real person speaking to the customer before I choose words to communicate something to them. I think about how they speak — from voice and tone to speed and intonation. How casual or formal they are dressed. What their personality is. And, most importantly, what traits, values, beliefs and principles they uphold. A product then needs to match that personality, and adapt tone based on user’s context. Once we have it, we write down all the questions users might have. We re-arrange them in order of importance and severity. We decide what to say, and find the shortest way to say it. And then we test, by reading out a piece of content loud. And if it doesn’t sound right, it doesn’t read right either. ✤ Content Design in Design Systems Atlassian: https://lnkd.in/eGpzQqm4 Amplitude: https://lnkd.in/eaB85T7n 👍 DHL: https://lnkd.in/eF494fkT 👍 Duolingo: https://lnkd.in/egCSX9At Girlguiding: https://lnkd.in/eZ8zMyC3 👍 Gov.uk: https://lnkd.in/ekRadXad Intuit: https://lnkd.in/eGyBUrZ2 👍 JSTOR: https://lnkd.in/eAnyrtcu 👍 MetLife: https://lnkd.in/evVE8sqf Progressive’s: https://lnkd.in/evx_8bzY 👍 Shopify: https://lnkd.in/eAKgEHNW Skrill: https://lnkd.in/e2HGTq4q 👍 Zendesk: https://lnkd.in/euxijT5m 👍 Wise: https://lnkd.in/eWk-Mvf9 ✤ Books – Strategic Writing for UX, by Torrey Podmajersky – Content Design, by Sarah Winters – Nicely Said, by Nicole Fenton, Kate Kiefer Lee – Everybody Writes, by Ann Handley – Conversational Design by Erika Hall – Writing Is Designing, by Michael Metts, Andy Welfle ✏️ [continues in the comments ↓ ] #ux #writing

Did you know that adjusting your communication style can increase team efficiency by up to 40%? Here are seven proven strategies to adapt your communication style to different workplace audiences:- - Customize message complexity → Executives prefer brief summaries, while specialists seek detailed explanations. - Adjust formality levels → Be casual with team members, professional with clients, and formal with senior leadership. - Match communication channels → Use emails for detailed information, chats for quick updates, and calls for urgent matters. - Time communications wisely → Provide morning updates for early birds and end-of-day summaries for busy managers. - Adapt presentation formats → Employ visuals for creative teams, data-heavy presentations for analytical minds, and narratives for client meetings. - Utilize audience-specific language → Incorporate technical terms for IT professionals and simplify explanations for non-experts. - Focus on relevant benefits → Highlight ROI for finance teams, efficiency for operations, and growth opportunities for sales teams. 📌 Key insight: The most effective communicators are those who skillfully observe and adapt to their audience's needs. These approaches have been tested across teams in three different industries. Remember: The core message remains constant; it's the delivery that shifts. Looking to elevate your workplace communication? Begin with one strategy and expand upon it. P.S. Which of these strategies would make the biggest impact in your current role? Share your thoughts below. 👇 #communication #workplace #teams

Over 80% of users skim, so when a PDP tries to say everything at once, it ends up saying nothing. A cluttered PDP gets more friction than function. Overwhelming users, leading to: - less time spent on page - missing value cues - fewer checkouts A well structured PDP doesn’t overwhelm, rather presents the information in a clear and digestible manner. Encouraging them to take action. In this post, I’ve broken down 12 changes I made to make the PDP easier to read and more focused on what actually helps users purchase. 1. Highlight customer satisfaction upfront. Show how many customers have purchased in the announcement bar. This builds immediate social proof that stays on all your pages. 2. Add benefit-focused badges above the product name. These help shoppers understand what key problems the product solves without needing to read through paragraphs. 3. Keep the title clear, and use a short subtitle to summarise the product and its core benefit. This helps users get both the “what” and the “why” at a glance. 4. Show the number of reviews beside the rating. It adds transparency and makes the rating feel more trustworthy, especially for first-time visitors. 5. Clarify price and pack size early. It saves users from searching for basic details which keeps attention focused on the purchase. 6. Use a context-rich main image. Featuring the product in its real-world use makes it easier to understand what’s being sold and how it fits into everyday life. 7. Expand image thumbnails beyond angles. Include images that show packaging and portion size to help customers evaluate fit and quality. 8. Add 2–3 bullet points above the fold. These help break down the product’s key benefits clearly, making it easier for skimmers to understand what makes it different. 9. Reinforce trust near the Add to Cart section. This is where buying hesitation happens so highlight things like delivery speed, return policies, or support to reduce friction. 10. Use icon-based highlights instead of long descriptions. Visual markers help users absorb information faster and keep the layout clean and scannable. 11. Break down product details visually. Showing ingredient percentages or content breakdowns in a simplified format helps make complex info more digestible. 12. Use accordions (not horizontal tabs). This allows users to expand only what they need, keeping the page organized and improving mobile usability. 13. Bring related variants closer to the decision zone. Show similar options earlier to help customers switch easily without needing to scroll to the bottom. Other UI/UX changes I did – Reduced text density to improve readability – Used consistent icons to simplify scanning – Added color cues for visual balance Found this useful? Let me know in the comments. PS: This checklist helps PDPs be clear and easy to follow without cramming in too much at once. This in turn will help the users make informed decisions that drive action. 

"🌍 Crafting Inclusive UX Writing for a Global Audience Designing for a global audience transcends mere translation. It requires a deep understanding of cultural nuances, linguistic structures, and user expectations. Here's how UX writers and content designers can create experiences that resonate across diverse markets: 🧭 Key Concepts Translation: Converting text from one language to another. Localization: Adapting content to align with cultural, regional, and linguistic nuances. Internationalization: Designing content and systems to support multiple languages and regions from the outset. 📊 Global User Insights English users constitute approximately 26% of internet users. Top languages online include Chinese, Spanish, Arabic, and Portuguese. User preference leans towards content in their native language. Text length variations: French texts can be 20% longer, while Japanese texts may be 30–60% shorter than their English counterparts. ✅ Best Practices for UX Writers Design for Expansion: Allocate at least 30% additional space to accommodate text expansion in translations. Pseudolocalization: Use this technique to test how your UI handles different languages and scripts. Flexible UI: Ensure your design can handle varying text lengths, directions (LTR and RTL), and character sets. Cultural Sensitivity: Be mindful of colors, symbols, and imagery that may have different connotations across cultures. Inclusive Language: Use gender-neutral terms and avoid idioms or colloquialisms that may not translate well. 🚫 Common Pitfalls to Avoid Flags for Language Selection: Flags represent countries, not languages. Use language names instead. Assuming Name Structures: Not all cultures use first and last names. Opt for a single ""Full Name"" field when possible. Overlooking Context: Provide translators with context to ensure accurate and meaningful translations. 🔍 Deep Dive into Cultural Nuances Arabic Interfaces: Often require increased line spacing for readability. Chinese Users: Prefer dense information layouts. German Audiences: Expect detailed and comprehensive information to establish trust." Read also Designing Cross-Cultural and Multi-Lingual UX ( https://lnkd.in/d-7WFrMF) by Vitaly Friedman

Users don't suck, but the information provided to them can. If your IFU reads like a legal contract, people won’t read it. Why? Because they’re confusing. Too wordy. Too complex. Too scattered. A great IFU should feel like having a clear-headed expert guiding you step by step. The user needs to know what to do, how to do it, and when to do it. Here's 20 recommendations/writing rules to improve your IFU↴ 1. Write procedures in short, identifiable steps, and in the correct order. 2. Before listing steps, tell the reader how many steps are in the procedure. 3. Limit each step to no more than three logically connected actions. 4. Make instructions for each action clear and definite. 5. Tell the user what to expect from an action. 6. Discuss common use errors and provide information to prevent and correct them. 7. Each step should fit on one page. 8. Avoid referring the user to another place in the manual (no cross-referencing). 9. Use as few words as possible to present an idea or describe an action. 10. Use no more than one clause in a sentence. 11. Write in a natural, conversational way. Avoid overly formal language. 12. Express ideas of similar content in similar form. 13. Users should be able to read instructions aloud easily. Avoid unnecessary parentheses. 14. Use the same term consistently for devices and their parts. 15. Use specific terms instead of vague descriptions. 16. Use active verbs rather than passive voice. 17. Use action verbs instead of nouns formed from verbs. 18. Avoid abbreviations or acronyms unless necessary. Define them when first used and stay consistent. 19. Use lay language instead of technical jargon, especially for medical devices intended for laypersons. 20. Define technical terms the first time they appear and keep definitions simple. Prioritize the user while ensuring MDR/IVDR compliance.

Most think it's just about choosing the right words. But that's not even the half of it. Culturally smart copywriting is really about: -Understanding human differences -Appreciating unique ways of life -Respecting diverse cultures All this comes down to: Creating content that embraces humanity. Your content doesn't need to entice everyone. But it does need to RESPECT everyone. Here are 7 things culturally smart copy focuses on: 1-Understanding Your Audience Research their values, beliefs, customs and communication styles. 2-Using Inclusive Language Avoid jargon, idioms, or colloquialisms that could be offensive or misunderstood. 3-Respecting Cultural Differences Be aware of cultural sensitivities and show respect for all cultures in your content. 4-Celebrating Diversity Highlight the diversity of your audience in your content and celebrate their differences and experiences. 5-Keeping It Real Don't appropriate other cultures - keep it real in how you rep different cultures. 6-Providing Context When referencing aspects of a culture that may not be familiar to everyone, provide enough context to ensure understanding. 7-Being Open to the Evolution Cultures evolve over time. Stay updated on cultural trends and changes to keep your content relevant and respectful. P.S. Do you agree it's about feeling > words?

💡4 strategies for optimizing text content for better readability For most products, written language makes up about 95% of the content — which means making text readable is vital if you want to offer a great user experience. 1️⃣ Content layout & structure ✔ Use headings (H1, H2, and H3) to create individual sections and guide readers through them. ✔ Write short sentences: Aim for 15-20 words per sentence. ✔ Use bullet points & numbered lists: Bullet lists both help improve scannability and highlight key points. ✔ Add callouts/quotes: Use them to emphasize critical information. 2️⃣ Optimal character count per line Too long lines make it difficult to track lines, causing fatigue and reducing comprehension.  Too short lines force frequent line breaks, disrupting reading flow and causing frustration. ✔ 40-60 characters per line (CPL), including spaces, is generally ideal. ✔ Shorter lines (20-40 CPL) are preferable for mobile devices and narrow screens. ✔ Longer lines (75-100 CPL) can work for wide displays but may reduce readability. 3️⃣ Content flow  ✔ Use inverted pyramid style: Place the most important information at the top to maximize the chance users will see it.  ✔ Utilise common content scanning patterns (F-shape, Z-shape, Spotted): https://lnkd.in/dnAQ3aqF  ✔ First sentences of paragraphs should summarize the main point or create context. ✔ Ensure smooth transitions between sections and ideas. Individual sections should always feel like parts of a whole rather than a collection of individual pieces of information.  ✔ Write short paragraphs: Limit paragraphs to 3-4 sentences to prevent overwhelming readers. ✔ Break up text with relevant visuals. Paired with a good layout structure, it will help you avoid walls of text 4️⃣ Font & formatting ✔ Choose readable fonts: Choose sans-serif fonts for body text. Fonts like Open Sans or Roboto are easier to read on screens. ✔ Use 16px or larger for body text to improve legibility ✔ Align type to the baseline grid (i.e., 8px) ✔ Choose line height proportional to type size. Use 1.5x line spacing for web content to give text room to breathe. ✔ Keep paragraph spacing in the range between .75x and 1.25x of the type size. 🛠️ Tools to Improve Readability ✔ Hemingway Editor Check for complexity and highlight long sentences. https://hemingwayapp.com/ ✔ Readability Score Checkers Aim for a Flesch-Kincaid score that suits your audience (8th grade or lower for general audiences). https://lnkd.in/dzQijnYw 🖼️ Line length and text readability by Google (Material Design) #UI #uidesign #productdesign #design #uxdesign

Top Barriers in Mobile Accessibility and Best Practices to Fix them. Mobile devices have become an indispensable part of our lives. Yet, many users face significant barriers. A recent survey by Fable reveals key obstacles: Unlabelled Buttons/Links (60%): Navigating a mobile interface becomes a guessing game without clear labels. It's akin to walking in a city with no street signs. 🏙️ Best Practice: Always use descriptive labels for buttons and links. Implement ARIA labels if the visual text is not clear or sufficient. Small Buttons/Links (35%): Imagine trying to hit a tiny target with a dart - that's what small interactive elements feel like for many users. Size matters for accessibility. 🎯 Best Practice: Ensure buttons and links are of adequate size and spacing. The recommended minimum touch target size is 44x44 pixels. Gesture-Dependent Interaction (35%): Relying solely on gestures like swipes and pinches excludes many users with physical impairments 👆 Best Practice: Provide alternative navigation options that don’t rely solely on gestures, like simple taps or voice commands. 4. Screen Blockages (30%): Content blocked by other elements on the screen can be frustrating. Things like a chat widget or a sticky footer or modal. Best Practice: Design layouts that are responsive and adaptable to various screen sizes and orientations. Use CSS and flexible layouts to prevent blockages. 5️. Absence of Error Messages (26%): Without feedback on errors, users are left in the dark, unsure of what went wrong or how to proceed. 🌑 Best Practice: Provide clear and descriptive error messages, and guide users on how to correct them. 6️. Non-Resizable Text (22%): Fixed-size text can be a hurdle for users with visual impairments. The flexibility to adjust text size is crucial. 🔍 Best Practice: Use relative units (like em or rem) instead of fixed units (like pixels) for text size, ensuring that it can be resized according to user preferences. 7️. No Pinch and Zoom (21%): The inability to zoom in for a closer look can render content inaccessible, especially for users with low vision. 🔬 Best Practice: Don't disable zoom functionality in mobile browsers; ensure content can be magnified for users with visual impairments. Source:Insights: Mobile accessibility by Fable https://lnkd.in/gJr765ic #InclusiveDesign #Accessibility #DigitalAccessibility #A11Y #MobileAccessibility

“Why do smart people struggle to get their ideas approved?” 🤔 That’s how we opened the Business Communication session with engineers, project managers, and department heads at a leading oil and gas company. The room went quiet. Because everyone had experienced it: -Brilliant proposals rejected -Clear emails misunderstood -Presentations falling flat despite solid data What participants shared: “I’ve had projects delayed for months because management didn’t understand what I was asking for.” “I spend hours on reports that no one reads.” “I present the same idea three times before anyone takes it seriously.” Then we showed them an email. Two versions. Same information. Same request. One got approved in a day The other sat unanswered for two weeks The difference? -Not the content -Not the logic -The structure We dissected real examples of: -Emails that buried the main point in paragraph three -Presentations that led with process instead of impact -Reports that confused data with clarity -Proposals that explained what but never why it matters One participant said: “I sent this email last week. No response yet.” ☺️ The request was in the fifth paragraph. “You lost your reader by paragraph two.” They rewrote it: -Sharper subject line -Opened with the ask -Context supported, not buried Within an hour, they sent it. By evening, they had a reply. We worked through scenarios like: Structuring requests for immediate attention ☺️ Adapting messages for different audiences Engineers → systems Finance → ROI Leadership → outcomes Writing subject lines that get opened Communicating risks without triggering panic One manager asked: “I have to announce a policy change my team will hate. How do I do that?” We role-played it. Version one: directive, top-down → instant resistance Version two: acknowledged concerns, explained why, invited input Same message. Completely different reaction. A drilling supervisor said: “If I lead with cost, my equipment request gets rejected. If I lead with specs, they don’t get it.” The fix: Lead with impact (safety, downtime reduction, efficiency) Then cost Then specs By the end of the session, the shift was visible. “I didn’t realize my communication style was blocking my own progress.” ☺️ “This isn’t about better emails. It’s about being understood faster.” “I always thought communication was a soft skill. This is strategic.” Good communication isn’t about saying more. ☺️ It’s about being impossible to misunderstand. It’s the difference between: Being heard vs being ignored Waiting weeks for approval vs getting a yes in 24 hours Some sessions don’t just teach skills. They remove the invisible barriers holding smart people back. 🌿 #BusinessCommunication #Leadership #ProfessionalDevelopment #CorporateTraining

If your content only speaks to one learning style, you’re leaving most of your audience behind. None of us absorb information the same way. Some SEE it. Others HEAR it. Many of us have to FEEL it to believe it. ✅ Visual learners need to SEE your transformation. Show them bold before-and-afters. Paint vivid pictures with your words. Use metaphors that light up their imagination. ✅ Auditory learners need to HEAR the change. Let them hear your voice, tone, and confidence. Use rhythm, alliteration and repetition in your writing like a catchy chorus. ✅ Kinaesthetic learners need to FEEL. Speak to emotions, textures, movement. Describe what it’s like to actually live the "golden outcome". Use stories that make it real in their body, as well as their brain. When you appeal to the senses, you’re not just creating content. You’re delivering an experience. That's what people remember. Experiences get shared, and they're also what sell. Does your content address different learning styles?