At least once a week when I'm reading, or editing, copy related to work I'll skim over something and realize that what I just read makes no sense. Sure, the words are used properly. The paragraph is composed of sentences that seem grammatically correct. But if you stop to think about what the copy is … Continue reading Three sentences in a trench coat pretending to be a coherent thought
Category: Writing
3 ways to reduce technical debt in content: Avoid bare URLs, events and analyst content
Infrastructure and code aren't the only things in your organization that incur technical debt. Content marketing on blogs is a major offender. Here's just three things to cut down on technical debt in your content marketing on blogs. Content marketing practice to avoid: Bare URLs/URIs in content Be kind to your readers and to yourself: … Continue reading 3 ways to reduce technical debt in content: Avoid bare URLs, events and analyst content
reMarkable 2 and its unremarkable software: Substandard tools hobble excellent hardware
The reMarkable 2 is a nifty piece of engineering. It's about the size of a thin college (U.S.) notebook, responsive and feels as close to writing on paper as a tablet is likely to get. The tools, on the other hand, leave a lot to be desired. reMarkable 2 and cloud services The reMarkable 2 … Continue reading reMarkable 2 and its unremarkable software: Substandard tools hobble excellent hardware
Make your sentences poorer, get out of the three comma club
There's a running gag in the show Silicon Valley about a character obsessed with being in the "three comma" club. Being a billionaire, in other words. When he loses enough money to drop from $1.2 billion to "merely" $900 million, he's "financially ruined" and despondent. Judging by the way some folks write sentences, they're just … Continue reading Make your sentences poorer, get out of the three comma club
Changed history forever
People often try to fluff up the importance of an event or person by saying it “changed history,” “changed the course of history,” or “changed history forever.” (Or something along those lines, you get the idea.) There’s just one problem with that type of phrase: it’s completely, 100% wrong. History is stuff that has already … Continue reading Changed history forever
9 phrases we should stop seeing in tech journalism
“This reporter” – Just use the first person. It might have worked for Edward R. Murrow, but with tech journalism – particularly blogs – it sounds like a ridiculous affectation. If you wouldn’t say it out loud when retelling a story, don’t write it. (And if you would say this out loud when telling a story, … Continue reading 9 phrases we should stop seeing in tech journalism
Writing ledes, writing for feeds…
Too many ledes in tech publications and blogs suck. I’ve been doing more editing and more content curation lately. The upshot of that is noticing a lot of really boring, fluffy, slow-to-the-point ledes that utterly fail at drawing the reader in. It’s not hard to do a decent lede as long as you remember a … Continue reading Writing ledes, writing for feeds…
Peak vs. Pique
Here’s another writing pet peeve — when folks confuse peak (or peek), and pique. Here’s an example of proper usage: I live in Denver, Colorado, so I have a lovely view of the mountain peaks when I look to the West, but my interest is piqued when I find a good book about world history. … Continue reading Peak vs. Pique
Vim tips: Folding fun
The problem with writing and editing on a computer, versus having words on paper, is that it's usually hard to compare text from different sections of a document when they don't fit on the screen together. One way to do it is to use Vim's viewports feature. Another is to "fold" the text. Using Vim's … Continue reading Vim tips: Folding fun
How to make money writing, the query letter (or email…)
Prior to taking the job I have now as editorial director for Linux.com, I was a freelancer for about six years, writing for Linux Magazine, Enterprise Linux Magazine, UnixReview.com, Linux Weekly News, IBM developerWorks, ZDNet, and a few others. I thought I’d share a few tips here that might help prospective authors get a little … Continue reading How to make money writing, the query letter (or email…)