I'd Rather Be Writing Podcast: Why simple language isn't so simple: the struggle to create plain language in documentation

Tom Johnson Tom Johnson 7/27/17 - Episode Page

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...