tekom - conferences

Writing Effective Definitions and Analogies for User Success

  • Workshop
  • Content Creation
  • 15. November
  • 11:30 - 13:15 AM (CET)
  • C9.3
  • finished
  • No presentation slides uploaded
  •  Leah Guren

    Leah Guren

    • Cow TC

Content

No matter how carefully you use simple, clear language, you can’t always avoid technical terms. Not all of your users may understand these terms. This can lead to poor user compliance in reading and following the documentation. In some cases, you may need to write a creative analogy to explain an abstract concept. Both of these skills help users understand the content and successfully complete tasks.

Takeaways

  • Understand the role of a technical definition and when you need one.
  • Learn the essential elements for a good definition.
  • Practice the art of creating a useful technical analogy.

Prior knowledge

Any TechComm practitioner with some writing experience.

Speaker

 Leah Guren

Leah Guren

  • Cow TC
Biography

Leah Guren is the owner/operator of Cow TC (technical communication training and consulting). Leah’s courses have introduced hundreds of new practitioners to the profession. She is a popular presenter, published author, consultant, and public-speaking coach.