A Little Something for the Clock-Minded Technical Writers

Over the weekend, my wife was winding our grandfather clock when the pendulum came out of the clock in her hands.

Being the intrepid souls that we are, we took the cowl off the top of the clock to take a gander at the innards to see what we could do to remedy the situation.

We quickly determined that a miniscule suspension spring had broken -- it lasted just shy of 50 years, pretty good for a tiny assemblage of plastic and metal.

Luckily, we had a spare spring included with the clock paperwork, so after a bit of trial and error and the use of a few pairs of tweezers, we got the new spring installed. No help to the instructions. We knew where the spring went because we could see a broken bit still in place.

Here's the envelope the spring came in. Good luck with the instructions. Note: the illustration does not match our clock.

But alas, when we connected the pendulum, we could see that the pendulum hanger and rod were now interfering with the chime bars that give grandfather clocks their charm.

I thought, "Well, I'll look online to see if I can find a video to help us out." That after a few glances at the paperwork included with the clock revealed that it was pretty hopeless to look at it for any help.

It's text-heavy. The illustrations are line drawings, a bit smudged, and upon further examination, were for clocks and equipment that didn't match our clock's innards.

Another example, on pendulum hanging. It not only doesn't match our clock, but it doesn't match the illustration on the spring envelope.

So the typical one-size-fits-all documentation we lament today was clearly alive and well in the 1970s.

Alas, an appeal to the Internet for help brings up a hodge-podge of similar material, none of it all that helpful because it doesn't quite apply to our situation.

As a technical writer, I say that stinks.

First, I guess clock repair people are guarding their secrets. It's a rare situation where you don't find some helpful video on YouTube showing you how to fix the exact problem you're facing with ancient technology, or new stuff for that matter.

Second, a lot of what I found is still in that "one size fits all" mold that we all know isn't really all that helpful when at the foundation of it all, the parts they're showing and the methods they're using don't translate to the real world.

So as I struggle with my own writing challenges, I'm given a fresh reminder that we need to be careful to write to the exact situation and not leave people frustrated and guessing and hoping the Utah "Clock Doc" hasn't made one of his semiannual runs to Idaho yet. We'll see.