The Placeholder

Water cooler talk for tech writers.

Tuesday, October 31, 2023

Some Cliches Still Have Power

›
With writing, especially technical writing, we're supposed to get rid of cliches. Why? Cliches have been so overused where they lost mea...
Thursday, October 26, 2023

Simple yet deep (or difficult)

›
When I was choosing a vocation, I just want to do something simple, yet take a lifetime to grow in it. Writing seem to fit. Writing is actua...
Thursday, September 14, 2023

When you don't have all the pieces

›
When you create documentation, there are three fundamental questions you need to ask. 1. What is the thing you're trying to document? 2....
Friday, May 19, 2023

QA Your Docs: Final but often rushed step

›
Once you've written the docs, it's time to release. Right? No. Other Technical Writer: But I double-checked the text and the graphic...
Thursday, April 20, 2023

More Thinking, But Don't Overthink

›
What if we thought more before we said or wrote anything? I like what Warren Buffet said about how spends his time thinking . This sitting a...
Thursday, March 30, 2023

Be thorough, not Pedantic

›
As technical writers, we must be  thorough when we create or edit documentation. If we're not, then we might present shoddy, confusing, ...
Wednesday, March 8, 2023

Show, Not Tell–Bring Documentation to Life

›
As you've pursued the writing craft, you may have heard or read the following: "When you write, show not tell." This is great ...
‹
›
Home
View web version

About Me

William McFadden
My name is William McFadden and I have been a technical writer for over 25 years. What I'm hoping to accomplish here is to share my experiences, insights, and my philosophy of technical communication. And maybe, do some actual technical writing here. I don't want to get hung up on what tools to use or whether you should learn some programming language or not. Granted, these are helpful. I'm focused on talking about some core principles of technical writing, as well as issues that may surround it. I don't speak for all technical writers out there. I'm just one guy who's been doing this for a while. I'm hoping to encourage those who are new writers to consider this writing style or prose. I'm also hoping to encourage those who have been doing this for a while to continue. Thank you for stopping by. Hope you come again soon.
View my complete profile
Powered by Blogger.