Technical documentation that doesn’t include definitions amazes me. How can you be sure your audience is following along, especially when you’re using specific jargon? Defining terms in context works so long as you have a way for the user to come back to the context, to be reminded of the definition. Recently I hit an… Read More What are we saying here?
The text of an executive order crossed my screen and left me muttering and not (just) for political reasons. The order fails to define terms and consequently is self-contradictory. …The Fourteenth Amendment has always excluded from birthright citizenship persons who were born in the United States but not “subject to the jurisdiction thereof.” …Among the… Read More Executive Order Needs a Bigger Glossary
Writing about technology, I must use the correct terms to avoid losing or, worse, confusing my audience. While working on my current assignments, a non-technical SME confused the terms access and permissions. No one’s head exploded (though I think in one case, it was a near thing) and we were able to understand the very… Read More Access, Permissions, and a DEI Plug
I love the formal expression, “how may I be of service?” It conjures an image of a suited server with a silver tray and inspires the enjoyable anticipation of being pampered. For me. For some (looking at my best friend), it conjures the image of Tim Curry in his role from Clue. At first glance,… Read More How We Will Be Of Service
notably in chat channels. How (and when) do we move on, after a personnel change? … Read More Block, Mute, Delete, Unfriend… But When?
Technically Writing 