3 ms·
> So here's my tip: > > smaller sentences. More paragraphs. Simpler language. I've also found thinking about sensual clues to be helpful, e.g. what would the
by aeorgnoieang 8y ago
> So here's my tip:
>
> smaller sentences. More paragraphs. Simpler language.
I've also found thinking about sensual clues to be helpful, e.g. what would the user/customer/whatever see (or hear or feel) at this point? What (exact) text would they reasonably anchor on based on everything they might see? I also try to visually distinguish different types of info, e.g. exact text of some kind of UI element, code.
Another really helpful tip is to confirm that the user/customer/whatever sees/hears/feels some (exact) specific thing at a specific { step / point in space-time }. If they don't provide the (near) exact response I expect, I try to notice my confusion and debug right then and there until my confusion is resolved.
- scarecrowbob 8y agoThis is useful advice. If you abstract it, the general form is something like "work with concepts that your audience is already familiar with", which is good advice for any communication. And, similarly, be on the look out for any data that says your communication has started to go awry.