Did you ever visit a website and eventually found yourself having trouble navigating it because certain elements weren’t placed where you expected them or didn’t look like you were used to? For example, there was no logo in the top left corner to help you return to...
Welcome back to our series on optimizing knowledge articles to your readers’ needs – we’re glad you’re here and ready to learn more about how to help make your readers’ daily work faster and less frustrating. Today it’s all about text meeting visuals. Not...
“Keep it simple” is a well-known principle in documentation. A manual or description that is written to be simple has a far lower risk of causing errors. “Simple” refers not only to the structure of the text, but above all to the wording. How well a...
Admittedly, it was a struggle not to make the subtitle of this article “Simplifying language for increased readability”. A lot of writers will agree that complex phrases and words come naturally while writing – they make a text more sophisticated, entertaining,...
If you write knowledge articles and instructions, you know there’s plenty to pay attention to: Are all necessary steps described, are all details correct, is everything up to date, do you need to include code snippets or flow diagrams…? With so many aspects to juggle,...