0:00
Welcome to the Technical Writing Success Podcast from Kurt Robbins, where we help you
0:03
get smarter than your competition.
0:06
Higher Kurt to coach you or your employees in AI to avoid a pink slip or having your competition
0:13
This is episode one ninety three.
0:16
And I am Daphne Blake.
0:17
And today we are tackling something that I know is on literally everyone's mind right
0:22
now because you know if you are terrified that generative AI is going to just straight
0:26
up replace your job.
0:27
Or on the flip side if you are just stubbornly refusing to use it at all.
0:32
If you're ignoring it, hoping it just goes away.
0:35
This episode is really going to show you that pragmatic middle ground.
0:37
We are exploring how AI is actually a reality in our writing tools right now.
0:42
And how you can use it responsibly to you know assist human expertise rather than trying
0:47
We are basing today's exploration on a really fantastic article by Giuseppe Getto.
0:52
Oh, it's such a good piece.
0:54
Why AI won't replace tech writers, but will reshape their work.
0:58
And it was published in TC World magazine in October 2025.
1:02
So let's just get right into the existential dread, right?
1:05
The fear of the machine taking over.
1:08
But honestly, there's a much more practical fear every writer actually faces every single
1:15
The completely blank intimidating page staring at the cursor just blinking at you when
1:19
you have to start like a massive API reference guide.
1:24
But that is exactly where Getto introduces the first big workflow to his AI assisted
1:30
Or he calls it scaffold drafting.
1:38
Because to be really clear, this is not about telling the AI, you know, hey, write an
1:39
entire user guide for me from scratch.
1:43
Because if you do that, you just get this generic, totally inaccurate block of text that
1:48
sounds vaguely corporate, but means nothing.
1:51
Scaffold drafting is different.
1:52
Creating the AI, your specific constraints.
1:55
So like your existing templates, your outlines, maybe some legacy snippets for tone.
1:59
So you're giving it the boundaries.
2:02
Take an installation guide, for example, you feed the AI, your standard structure, you
2:06
know, prerequisites, setup verification, troubleshooting, and then you drop in the new
2:11
product description.
2:13
And it gives you this rough starting point.
2:14
It just fills in those predictable gaps, which saves you literally hours of just basic
2:18
formatting and boilerplate text.
2:21
But let me push back on that for a second.
2:22
Because isn't this just like high-tech mad lives?
2:28
I mean, how do you prevent a burned out writer on a Friday afternoon from just hitting
2:32
generate, skimming it, and calling it a day?
2:35
Well, honestly, that is the biggest risk here, letting speed replace actual sense.
2:40
You have to remember the AI is a collaborator.
2:42
It is absolutely not a co-author.
2:44
That's a huge distinction.
2:47
It requires a really strict internal human checklist.
2:50
You have to verify the accuracy, the tone, the facts, before anything gets published.
2:54
The human is still fully in charge of the quality.
2:57
So you use the AI to pour the concrete into the mold, but you still have to inspect
3:02
the foundation yourself.
3:04
Which actually moves us right into the next phase.
3:07
Because once we have that scaffold adraft, how do we polish it?
3:11
How does AI help us revise without just completely ruining all the careful technical nuances
3:17
This is the second workflow, AI-supported revision.
3:20
Because when you've been staring at the same document for days, you go totally blind
3:25
You miss unclear phrasing, or you keep repeating the same words, or across huge documentation
3:30
sets, you get terminology drift.
3:32
Oh, terminology drift is a nightmare.
3:36
But AI is fantastic at spotting those things that humans just naturally miss after multiple
3:42
It acts as this tireless second set of eyes.
3:45
So for example, if I have this super dense paragraph at a knowledge-based article, I can
3:50
just prompt the AI to simplify it, like make it easier for a new user or a field technician
3:58
You can target the prompt for a specific reading level.
4:01
But again, I've got a concern here straight from the text.
4:04
If the AI is in there smoothing out the pros and making it sound pretty, aren't we risking
4:08
it like improving a sentence by accidentally deleting a crucial technical to term, or slightly
4:15
changing a process step because it thinks it flows better?
4:19
And in tech comms, that trade-off is just entirely unacceptable.
4:22
We cannot sacrifice accuracy for flow.
4:25
So how do we stop it from doing that?
4:26
ghetto has a great solution for this.
4:28
It has to be a rigidly enforced two-step process.
4:31
The AI suggests the edits in attract changes environment.
4:34
Oh, attract changes.
4:36
It never just overrides the original file.
4:38
And then a human manually reviews and explicitly accepts or rejects every single change.
4:46
So you keep total control, but you still get the benefit of the AI flagging the clunky sentence.
4:51
It's advisory, not authoritative.
4:54
Let's take a brief break for a special message from our producer, Kurt Robbins.
4:58
This is Kurt Robbins.
4:59
First, thanks for listening.
5:00
I truly appreciate your support.
5:02
I want to let you know that I'm currently accepting new clients.
5:05
My rates are affordable, and I have more than 25 years of experience working for enterprise
5:10
companies like Microsoft, Northrop Grumman, Oracle, PNC Bank, FedEx, USAA, and Wells Fargo,
5:19
If you want to improve your IT documentation and communications, hire me.
5:24
Know how to use AI to improve efficiency and accuracy, and love going the extra mile
5:29
to satisfy my clients.
5:31
Thank you for subscribing and listening.
5:33
Back to you, Daphne and Fred.
5:35
Welcome back to the Technical Writing Success Podcast, where we help you get smarter than
5:38
your competition by coaching you and AI.
5:41
So we've talked about drafting with scaffolds, and we've talked about using AI as an advisory
5:45
editor for revision.
5:47
But there's still one last massive hurdle before this stuff goes to the user.
5:51
The dreaded QA phase.
5:55
The last line of defense between our flawed documentation and a very frustrated user.
5:59
And this is Ghetto's third workflow.
6:02
And honestly, this is where AI really shines because it excels at repetitive rule-based
6:10
The stuff humans hate doing.
6:11
The stuff we are terrible at.
6:13
The AI acts as this tireless proofreader.
6:16
It can scan massive documentation sets in seconds for inconsistent product names, broken
6:21
cross references, missing alt text on images, or even tone mismatches, right?
6:26
But it sounds like a spell checker on steroids.
6:28
And my worry is that people will just assume automation equals accuracy.
6:32
What about false positives?
6:33
It might catch an obvious error, but it doesn't really understand the context.
6:36
You're totally right.
6:37
It often misses subtle contextual errors or mismatched version info that is actually intentional
6:43
for a legacy product.
6:45
Because it doesn't know the history of the software.
6:48
So the optimal method here is to let the AI do the first pass to just generate a report
6:53
of potential inconsistencies.
6:55
A diagnostic report.
6:57
Humans can even use shared AI dashboards to track these things over time.
7:02
Like if the same terminology issue keeps popping up, you know you have a systemic problem.
7:07
Again, human oversight remains completely mandatory.
7:11
The human reviews the report and decides what's actually an error.
7:15
So the AI points the flashlight, but you still have to decide what you're looking at.
7:19
Perfect way to put it.
7:20
But none of these three workflows drafting revision QA, none of the matter if the whole
7:25
system is just built on a totally irresponsible foundation, which brings us to the most important
7:30
part of Ghetto's article.
7:32
He outlines four cross workflow principles, essentially guard rails to keep AI from just
7:37
becoming another source of noise.
7:39
And what's the first one?
7:40
Number one is clarity.
7:42
Because as we discussed, perfect grammar means absolutely nothing if it confuses the reader.
7:47
If an elegant sense doesn't help the user solve their problem, it's a useless sentence.
7:52
Number two is accuracy.
7:54
AI is a predictive text engine, not a database of facts.
7:58
It cannot verify facts like a real subject matter expert.
8:03
It guesses very confidently.
8:05
So human validation is non-negotiable.
8:09
What's number three?
8:12
Humans are always legally and ethically responsible for the published content.
8:17
You can't just blame the algorithm if a server crashes because of a bad instruction.
8:22
You have to worry about data, privacy, bias, compliance.
8:26
The organization owns the output.
8:29
And finally, number four is transparency.
8:33
It means sharing your AI practices openly to build trust with your stakeholders.
8:37
Don't hide the fact that you're using these tools.
8:39
Be clear about where and how they are deployed.
8:41
So people know there's a human at the wheel.
8:44
To sum it all up, the core thesis here is really encouraging.
8:46
AI won't replace you, but it will fundamentally reshape your time.
8:50
By offloading all these mechanical tasks, the scaffolding, the tedious QA tech writers
8:55
can actually focus on what matters, solving real user problems and designing much better
9:01
information systems.
9:02
It elevates the role entirely.
9:04
But I want to leave you the listener with a final thought to mull over today.
9:08
If AI eventually handles all the repetitive scaffolding, all the checking, all the formatting,
9:14
how will your core identity as a technical writer evolve?
9:18
That's a great question.
9:19
Do you become less of a traditional writer and maybe more of an information architect or
9:24
maybe a dedicated user advocate?
9:26
It's something we're all going to have to figure out very soon.