The Placeholder

Water cooler talk for tech writers.

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 ...
Tuesday, February 7, 2023

Salmagundi within Documentation

›
According to Meriam Webster, Salmagundi  is: 1. A salad plate of chopped meats, anchovies, eggs, and vegetables arranged in rows for contras...
2 comments:
Monday, January 30, 2023

We'll Hang up Our Pens Someday

›
Recently, Pat Buchanan said he was retiring his long running column . This blog is beyond the scope of politics, so I'm not interested i...
Tuesday, January 24, 2023

Technical Writing Isn't Boring

›
I once saw a movie where an editor insulted a writer over her manuscript for a book and said she needed to write user manuals. I was incense...
Thursday, November 17, 2022

Perseverance Instead

›
I remember a martial artist, who is a master of his art, once told his students that he didn't get to his belt rank because he was any g...
Tuesday, October 11, 2022

Collaborate, Collaborate, Collaborate

›
Someone recently asked me if a technical writer is someone who collaborates with SMEs and takes technical jargon to make it into plain, easy...
‹
›
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.