|
Hi Reader, I recently wrote about how "technical" depends on who you're comparing yourself to. Around the same time, someone told me they were worried about publishing something too simple, because other writers might read it and decide they didn't know much. I understand the worry, but it pictures the wrong reader. When you're afraid of looking basic, you're imagining the most experienced person who might see your work. That person already knows the answer and isn't looking for it. The people searching for it are the ones who need it. Basic answers find big audiencesSmall YouTube channels that answer basic questions well can reach far more people than follow them. A video called "What Is Technical Writing?" on William Smith's channel has 82,000 views. The channel has about 2,600 subscribers. APU Writing and Tutoring posted a workshop on the fundamentals of technical writing that has 272,000 views, on a channel with about 3,500 subscribers. Future with Fawzi posted a 12-minute explanation of how AI works about a year ago. It already has 237,000 views, on a channel with about 5,600 subscribers. Each of those videos has at least 30 times as many views as its channel has subscribers, and the newest one got there in a year. The channels had no audience waiting, so people found the videos by typing a question into a search bar. Experienced creators tend to skip basic questions because they assume everyone already knows, which leaves the answer to whoever is willing to write it. The same is true of documentation. The pages readers land on most are usually the getting-started guide, the installation steps, and the fix for the error everyone hits in their first week. You're judged on how well you answerReaders judge an answer to a simple question the same way they judge any other answer: by whether it got them what they needed. A weak answer to a basic question usually fails in one of these ways:
A strong answer puts the answer first, uses the words the reader searched for, and stops when the question is answered. Experienced readers notice that kind of answer, because they know how much it leaves out on purpose. This applies to your portfolio tooWhen writers put together a portfolio, many of them reach for their most complex sample to prove they can handle hard material. A clear answer to a simple question can be the stronger sample. It shows a hiring manager that you know your reader and can get them what they need without wasting their time. Diana Payton |
I'm a writer who helps technical professionals transition into technical writing. I also create content on my YouTube channels: Technical Writing Uncensored and Make, Mend, Grow with Diana.
Hi Reader, I've hired a lot of technical writers. Yes, I read your LinkedIn recommendations. Layoffs are everywhere right now, and they suck. Some of you got the surprise calendar invite this month, and some of you are still at your desks wondering who's next. Either way, the people who can vouch for your work are about to scatter. If you were laid off Ask for portfolio samples, and get the answer in writing. Yes, NDAs are a thing. Most of them come down to "do not share company material...
Hi Reader, Grocery receipts keep getting longer while the bags get lighter, and "recession" is back in the news. So I went back about a hundred years to see what people actually did during the Great Depression, and which of those habits still hold up. Most of them do. My new video covers 20, including: The 7½-cent lunch Eleanor Roosevelt served at the White House. It was cheap, nutritious, and bad enough that guests started eating before they showed up. How Seattle neighbors in the 1930s...
Hi Reader, The way your mouse scrolls can help a website identify you. Every mouse moves the page a slightly different number of pixels per notch, and that number stays consistent for your device. Add your screen size, your browser, and a few network settings, and a site can pick you out of a crowd without you ever signing in. That's browser fingerprinting, and it's the subject of this week's episode of Technical Writing Uncensored. My guest is Seth Honda, an English and computer science...