Of course, I'm assuming the worst but it's the flip side of assuming the best. In either case, they're unproven assumptions, so it's fruitless to dwell on woulda, coulda, or shoulda. The movie "It's a Wonderful Life" shows the downside of this kind of thinking when taken to its extreme. Though it's become cliché, the message is still powerful there. Besides, clichés wouldn't exist if they weren't effective with our psyche.
The Placeholder
Water cooler talk for tech writers.
Search This Blog
Tuesday, January 13, 2026
Perpetual Problem with Woulda, Coulda, Shoulda
Of course, I'm assuming the worst but it's the flip side of assuming the best. In either case, they're unproven assumptions, so it's fruitless to dwell on woulda, coulda, or shoulda. The movie "It's a Wonderful Life" shows the downside of this kind of thinking when taken to its extreme. Though it's become cliché, the message is still powerful there. Besides, clichés wouldn't exist if they weren't effective with our psyche.
Tuesday, September 9, 2025
Without growth and conflict, there's no story, even for technical writers
They say without conflict or growth in a character, there's no story. But why? Is this some tired trope or does it apply in real life? Well, let's walk this through. Is there a story when you're just going through your daily routine or when you're having choose between two great job offers? Is there a story when you're ready to get married but an old flame, whom you loved dearly, showed up? What makes even more interesting the reason for your breakup was a simple misunderstanding. Stories aren't just in the realm of fiction. Stories happen all the time in the real world! Why do some people read biographies, autobiographies, memoirs or historical accounts? They deem them to be worthy stories to read.
Even the Bible, though I fully believe it's God's Word, has elements of story. Here are a few examples:
- When God tested Abraham and told him to sacrifice his Isaac in Genesis 22. (Thankfully, there was a happy ending to this.)
- The story of Joseph and his brothers in Genesis 37-50.
- Joseph (different one) found out that Mary, who we was engaged to was pregnant and he wanted to divorce her quietly in Matthew 1:18-25. But he was informed that baby was the Promised Messiah, Jesus.
- When Jesus knew His death was near, He ask God, His Father, for Him not to go through it in Matthew 26:36-45, Mark 14:32-42, and Luke 22:39-46.
My Story: Creation of a Style Guide
Friday, July 11, 2025
Clear Writing is Crucial to Using AI
This post is an addendum to a previous post. Though I'm still not afraid of AI, I've come to terms it will alter the landscape of what we do as technical writers. With the launch of Grok4, despite the controversy that surrounded it, this reaffirms AI isn't a passing fad. Those who think otherwise are living in a fantasy land. Unless there's some grand event that causes technology to cease, there's a mass rejection of AI, or even a bigger innovative leap, it isn't going away. But despite how powerful it is or how it will get, AI is still a tool and it's a tool that we need to master. So how do we do this as technical writers? We focus on writing clearly.
If or when we need to use AI to help us create documentation, we'll need to use AI prompts. In those prompts, it will be key to write clear and specific instructions. We can lay this out how we want the documentation to look. Of course, we will still need to writing the content itself or we should. Using AI isn't an excuse for us to shirk our duties as technical writers. If anyone does this, I'm absolutely against it. Documentation will always need human nuance to make it good. So we still need to do the hard work!
One of the nice things about using these AI prompts is that we can constantly refine our creation so it will eventually match what you're looking for. Or, it might even exceed our expectations. Of course, it can become a problem with when you're using a free version of the AI. Waiting another day after you past the message limit to clear isn't always ideal, especially if you need get documentation out for an impending release.
By focusing writing in clear, specific, and concise instructions in these prompts, it drives us back to the heart of the technical writing style. In a weird way, it takes us back to good ole technical writing.
Is it a possibility that AI will eventually make technical writing disappear? Don't know. Only God knows the future. I may have still concerns with AI but it's not going to take over, if we don't let it. What I do know is new opportunities will arise when old ones die. We no longer have milkmen but we do have refrigerator repair technicians. Just keep on writing. If you need to use AI, then make sure your voice and skillset still shines. I think I'm with this topic for now.
Tuesday, June 17, 2025
An Alternative Way of Explaining
- Put yourself in the shoes of those who are visually impaired. How you want someone to explain this to you if you couldn't see well or not at all. In other words, enacting The Golden Rule. If you follow The Golden Rule, you'll be able to write great alt-text.
- Write brief, succinct descriptions of the images you're describing.
- Write 1-2 sentences for most cases. One sentence is optimal. The exceptions would be highly-detailed flowcharts, infographics, images, or screenshots. In those cases, you may write a few more brief sentences but I wouldn't go past that.
- Don't start with intros "This image shows..." or "This is a picture of..." That's condescending. Just state what the image is. For example, if you have an image of a boy petting a German Shepherd. Just say "Boy pets German Shepherd."
- Don't write alt-text for decorative images. Only write alt-text for images that convey actual information.
Thursday, June 5, 2025
Why I'm Not Afraid of AI
Tentative Stance
AI and Writing
Human Nuance
AI is just a Tool
AI Depends On Us
Let's play the worst case scenario
Let's play the not so worst case scenario
Those with Little Scruples
Folly on Display
Their Lack of Scruples May Create New Fields
Possible Counter-Strategy
AI is a Powerful Tool but Ultimately Powerless
Wednesday, February 26, 2025
Freedom in Obscurity
- Too much pressure to perform
- Have to constantly care what others think
- Your life is utterly scrutinized
- You can lose yourself in the process
- You can get a big head
- You can forget why you love what you do
- Never enough