Gray/Grey

I wish I had learned this forever ago: If you are in America, it is gray If you are in England, it is grey It’s that simple. (I partially blame this confusion on Fifty Shades of Grey.)

FrameMaker and the Kinesis Advantage Keyboard

Because of RSI, I use a Kinesis Advantage keyboard. I used the Microsoft ergonomic keyboards for a while, but I’d burn one out every year, and the membrane keys are a bit mushy. I went whole-hog and spent the money on the Kinesis, which I don’t regret at all, except for one thing: the function […]

Adjusting Mic volume from the command line in Windows

I spend a lot of time in meetings on a USB headset. I have a Windows computer. So every day, multiple times a day, here’s the drill: Plug in headset. Mic volume is a random number. Right-click Sound. Wait for the right click to register, because half the time it doesn’t, and the lag is […]

REST API Doc article

I think the big problem with API docs is what to document. And it usually ends up with a comment per method, where you have “createFoo = creates a foo; deleteFoo = deletes a foo” and no real content. The question always becomes “well, what else?” And the real value of API docs is everything […]

The hoarding of 25,000 manuals

I started tech writing right around the time print was dying. My first job involved writing software documentation as a manual and as WinHelp, and it all went electronic after that. I also briefly wrote for print books about Linux and Emacs. So I have a box with versions of those manuals, and that box […]

Removing the Adobe Update Installer from the Mac menu bar

So at some point, Adobe Creative Cloud added a second notification to the menu bar on my Mac. There’s already one that opens the CC app, and always sits in the menu bar. And everyone else wants something in the menu bar. But Adobe started showing this second icon, with a perpetual 1 next to […]

Making Yosemite Readable

I resisted the upgrade to Yosemite, even though I have a pretty new mid-2014 MacBook Pro, because I’d rather let someone else beta-test things before I upgrade. When I finally did upgrade, I noticed a problem: my eyes were killing me. ¬†Granted, I’ve put a few hundred thousand miles on my eyeballs over the last […]

Photoshop CC Keyboard Shortcut Cheat Sheet

It seems like the days of cardboard key templates are over – they were a huge thing back in the old days when I started as a consultant in the computer labs back in college. Most of the cool kids would memorize everything, but more of the “returning” students would overlay the laminated cut-outs over […]

Blank Markers in FrameMaker

Here’s a FrameMaker problem I had once on a 64-bit Windows machine. I don’t remember having it on my next Win7 machine, but I’ve seen it more than once. The problem: the marker symbols were missing. These are the little “T” symbols you normally see when you insert a cross-reference or an index marker. The […]