1. EachPod
EachPod

Why simple language isn't so simple: the struggle to create plain language in documentation

Author
Tom Johnson
Published
Thu 27 Jul 2017
Episode Link
https://idratherbewriting.com/2017/07/27/why-simple-language-isnt-so-simple/

Although you can adjust your content's style to be simpler and more readable, technical documentation introduces many new terms and concepts for readers to learn. Many readers who don't already understand the discourse community may find this language impenetrable. Glossaries and inline tooltips can potentially help novice users, but there's no easy solution for simplifying your language for both novice and expert users.

Share to: