focus

It’s Not Your Equipment … It’s a Lack of Documentation! – Marilyn Armstrong

Maybe I should just give up, but I spent my career writing material to help folks use complicated equipment and sometimes very obscure software.

I should probably start by mentioning that I’ve fought this battle for long years … and was utterly defeated. About 7 or 8 years ago, high-tech companies, in a money crunch and driven by that bottom line that seems to be the only thing that matters anymore, began to eliminate technical writers. Entire departments were dismantled and eliminated. Jobs disappeared and what remained paid so badly it was insulting.

A decision had been made at the corporate level: YOU don’t need documentation. No matter how complicated or expensive the equipment or software you purchase may be, don’t need documentation. Companies provide the minimum the law requires or they can get away with. Quality is no object nor usability. Information is limited to basic stuff like how to install a battery and if you are lucky, where the compartment is.

I was a technical writer for about 75% of my career, the rest being divided between journalism, editing, promotions and advertising. But mostly, I wrote documentation and I though my work mattered. Probably naive, but I believe that if I documented a system, it should be well written, clear, organized, and useful., When a user needed to find something, it would be in the book and in the online help. It would be easy to find. I carefully avoided using mysterious search parameters that could be deduced via a psychic link to my brain. If you knew what you wanted, I made it easy for you to find it.

I was proud of my work. I still believe the fundamental goal of documentation is to make complicated things simple. Not necessarily easy because sometimes, the product was not easy to use, but that didn’t mean that it had to be hard to understand. My documentation was good for another reason: I used the product and tested what I wrote to make sure it was true. This testing makes the difference between a pile useless gibberish and a manual.

Thus, when you get something that appears to be documentation, stop and read it. Appearances are deceiving. Most “manuals”  are generated, not written, and never checked for accuracy or usability. Such “manuals” are as likely to increase your confusion as provide illumination.

I bought a PEN EP3 camera from Olympus. Seven months and hundreds of photographs later, it remains one of the mysteries of my world. It takes wonderful pictures, and it has hundreds of functions. I haven’t the slightest idea how to find most functions and have no idea what to do with them if I could find them.

I grew up in a pre-digital world. I know F-stop, depth-of-field, shutter speed, aperture and focus, film speed and composition. I have a good eye. I’m no genius, but my pictures are pretty and I enjoy taking them.

He solves the problem the way most do: Automatic everything, then shoot.

New digital cameras have a vast and overwhelming array of functions, most of which you or I will never use or need. I believe they are there entirely to impress us with the super high tech-ness of the equipment. I doubt that even the designers — especially the designers — expects us to actually use them. Which is good, because I don’t know what they are supposed to do anyhow or why I would need them. Ansel Adams didn’t need them. Neither did Edward Weston. Neither do I. But, the more you pay for a camera, the more of these obscure functions you get and I figure that the least they owe me is an explanation of what these setting do and how to find them.

I’m not sure whether to curse or say thank you. Maybe if Olympus provided a manual that explained these options, I’d be grateful, but that is not happening.

I spent half our shooting time trying to find the menu to change the ISO.

This is true of cameras, but the lack of documentation on your computer is actually worse … much worse because most of us depend on our computers. We need them to work and we need to have some control over the environment in which we work. Configuration of our computers to suit our needs is not a minor detail: it’s the difference between having a tool that does what you need and one which is a burden … an enemy with which you do daily battle.

I spent all last night — until dawn — trying to figure out how to turn off the touchscreen functions of my monitor. Before Mac users jump in and point out that it’s because Windows doesn’t work, that’s irrelevant and untrue. Windows works fine. It’s just that the company doesn’t provide any written documentation. There is embedded information in the operating system, but much of it isn’t logically arranged. It’s rather like looking for your car keys after you’ve dropped them someplace you don’t normally put them. You know they’re in the house, but where? It could be years before you find them..

On a new computer, you typically get an “introductory” video and that’s pretty much it. I watched it. It showed me in exquisite detail how to do what I already knew how to do.

Operating systems are designed to be used the way the system’s developers expect you to use it. If you prefer a different setup, trouble starts. The only way to figure out how to do something differently is to keep querying the system and hope you’ll stumble on the right  key word — the word that will bring up the information you need. What is most frustrating is that you are sure it IS there, but whether or not you will ever find it is a different issue.

If you are sufficiently persistent and a bit lucky, you will eventually find a mystery menu after which you fix your problem in a few seconds.

Last night, I searched, searched again and again. It didn’t call Dell because I knew the support person wouldn’t know the answer either. They pretty much never do.

So I tried one word combination after another, recombining them in the hope that it would lead to a menu buried in the system. There had to be a way to deactivate touch input.

Around 5 in the morning, I found it. It took me less than 30 seconds to eliminate the problem that had been driving me nuts since I got the computer. Now, it’s a monitor. A great, high-definition, 23-inch monitor that’s a joy to work on and makes photo editing a pleasure. No more configuration by crawling insect. I am mistress of my virtual world at last!

A technical writers earns less than an entry-level developer. I understand the guys in India who provide telephone tech support work cheap, but I bet a tech writer would cost less than a network of telephone support no matter how cheaply they work.

Assuming you are under warranty and you can get through the voice mail  maze … and further assuming you get someone who understands the problem and don’t get blown off because software is not part of your warranty (Note: If someone can tell me how, without using software, you can determine if you have a hardware problem, I’d like to hear it) … Round and around you go.

It doesn’t have to be this way.

Would it blow the budget to hire a competent technical writer to embed online help that will live on even after the warranty period is over? Wouldn’t it be nice to help users avoid needless aggravation and not wind up with angry, frustrated, exhausted, and homicidal customers whose problems remain unsolved?

Granting that many home users have a limited understanding of how their computers work and for them, it wouldn’t much matter what documentation you supply. Most problems result from insufficient understanding of a product or process. If you are talking about a novice user, perhaps more information wouldn’t help. But …

I’m not inexperienced and I still can’t find essential information I need to configure my monitor. Wouldn’t it be reasonable to expect a menu on the control panel that I could use to configure the monitor’s capabilities, not merely its resolution but any other functions it may have. Functions not available on a particular model could be grayed out. How about that?

There is nothing wrong with my computer that better organized and easier to find information would not solve..

Every issue I’ve had over the last 5 or 6 years was ultimately fixed with a few clicks of the mouse. The problem was never something broken. It was always lack of documentation.

That pisses me off. Because tech writers — even highly experienced ones — work pretty cheap. Users do need documentation, and not just for software and computers. We need documents that let us use our cameras and telephones and DVD players and all those other pricey little devices that we own and often, don’t know how to use. Online FAQs are insufficient.

This is an old battle I’ve already lost. I know it’s hopeless. I find it infuriating that I can barely figure out my telephone without customer support, so rather than spend time on the phone with customer service, I don’t use anything I can’t easily configure.

I had to buy a separate book on how to use Photoshop and another for my first camera. I was able to get some help from a fellow user of my new camera, but that only goes so far. For my PEN P3 camera, there IS no customer support nor any after market book. I depend, as Blanche DuBois said, “… on the kindness of strangers.”.

My camera will remain a mystery until someone writes a “Dummies” book for it. Hopefully I’ll still own the it when the book finally gets published.

It’s not fair. The reason they get away with it is because we let them. Think about it.

So how did I finally figure it out? The “monitor” menu should have been a gateway, but was useless. The only thing you can the “Monitor” menu lets you do is lower your screen’s resolution. That’s useless.

Finally, I typed: Touchscreen.

Up came something that I hadn’t considered. Flicks. Now, for me? That means the movies. Having never used it, I had no idea it had anything to do with the monitor or its touchscreen technology. Once I got to “Flicks,”, I started opening menus and voilà, there were two check boxes allowing me to toggle an option:

  • Enable finger as pointing device.
  • Do not allow finger as pointing device.

I un-checked the first one by checking the second. I clicked “Apply.” As the sun rose in the east, my problem was solved and I went to bed, to sleep, perchance to dream  … of murder, destruction and vengeance.

Weekly Photo Challenge: Focus – Sweet Bokeh

Kaity

Weekly Photo Challenge: Focus or Lack Thereof

Weekly Photo Challenge: Focus – Tall, high and far away

Life along the way

I spent the day doing a task all photographers must face. It’s no fun, but there’s no avoiding it. Sooner or later, the time comes to weed through the pictures, to take stock and get organized. It was time to do more than simply store the pictures. I looked through almost every file, years of digital photographs. The artistic stuff, the family photographs, the vacation pictures and holidays. Time to discard the bad ones I should have dumped in the first place. I converted all the RAW and TIFF  files to JPGs because I admitted to myself I am unlikely to need them. I’m not going to be making  lots of prints … and even if I were, the printer wants high quality JPGs, not TIFF or RAW. Time to let them go.

72-MarilynCasual003

Photo: Debbie Stone

It was a complicated decision, one of many realities I’ve had to face. Not as hard as most life decisions, but tricky in its own small way.

For the last dozen years, much of life has involved recognizing and accepting limits, then figuring out how to work around them. There are physical limits, financial limits. I can’t afford things I don’t really need, though I sometimes splurge on something I want very much, like a lens for the camera or a bigger external hard drive. There are always choices to make and priorities to set.

Now, it’s facing one more fact of life: no more wall space. No room for anything, not for my  photographs or anything else. The walls are full of things I love. My photos are on display, but there are also paintings, some by friends, others bought at galleries in days when we had spare dollars to spend on non-necessities. Photos of Garry taken during his working years … with politicians and presidents.

Photo: Debbie Stone

Photo: Debbie Stone

He has awards and plaques and I have shadow-boxes filled with antique Chinese porcelain, Navajo pots, fetishes and figurines and Murano glass. Together we have a lifetime of vacation mementos and one small carved black peat cat bought in Ireland on our honeymoon. All the paintings, photos and things we bought on the Vineyard during a decade or more of summers. They need space. There’s no room, so I won’t be making lots of prints. I have dozens of paintings and photographs that were gifts from artist friends that I can’t afford to frame and if I could, I’d have no place to hang them.

I dumped hundreds of gigabytes of  RAW and TIFF files. While I was organizing, I consolidated files of similar things. I have dozens of New England autumns, thousands of pictures of dogs, kids, dogs and kids, friends and their kids and dogs.

72-TerribleTwo-2

This task sounds a lot more interesting than it actually is. In fact, it makes watching paint dry seem thrilling, but it needed to be done. And while I was sorting, reformatting and organizing, back on Serendipity, I quietly slipped over the 44,000 hit mark. I’ll celebrate at 45,000 I guess, or maybe I’ll wait for 50,000. The numbers have been moving so quickly.

Awards … another Liebster, more followers  — and I realize I have posted every day for more than six months. 868 posts as of tonight. Time has flown by. From thinking I’d put up an occasional post about something or other, maybe show some photographs … to recognizing that this blog has become important to me. It’s no longer a little hobby; it has become a focus.

I stopped bringing home a regular salary more than ten years ago when I became ill. I tried, intermittently, to work, but I couldn’t. Eventually, it became clear my career was over. My pride took a hit, but I don’t really miss work. I miss the paycheck, but work? Nope.

I settled down to not working and it required a bit of adjustment.  I’ve never been bored. For a while I was too sick to be bored, but I’ve always filled time by reading. It’s my fallback position. Somewhere in there I wrote a book. That consumed a couple of years and after that, for a few years I ran an online antique and collectibles business, which is where many of my antiques and other stuff originated. It was surprisingly successful, but the economy fell apart. The type of stuff I sold was based on people having spare money for things that are just beautiful, not necessarily useful. With the handwriting bright on the wall, I closed up shop.

Han pot

Han pot

If you aren’t going to school or working at a job, time tends to lose its shape. Blogging has given it a bit more form. It’s writing, which is as much who I am as what I do. As I move through my world, I look at the things I do and whatever is happening around me as stuff I can write about. When I hold a camera, I see the world in frames and perspective, I see colors and angles, light and shadow. When I think about it as a writer, I hear everything described in my mind, narrated.

Often, by the time I sit down to write, it’s almost written. It’s not always that easy, but sometimes it is. Sometimes words fall out of my fingers and it’s all just there, complete, waiting to put together.

Life has a rhythm, a pulse, a flow. From morning coffee to afternoon chores, to the evening when I write, watch a movie or some television, then write some more. Often, as now, I do both at the same time, something my husband finds baffling. If I think about it I suppose I’d find it baffling too, but I can do two things at a time. Usually. Depending on what the two things are.

The Mumford

If you’re waiting for me to get to the point, you’re out of luck. No point. Just a long ramble … rather like life.

In books, nothing happens without a reason. In literature, there are no coincidences, no accidental meetings. But life is full of things happening for no discernible reason. We can attribute meaning … religious meaning, omens, portents, whatever. But really, things just are what they are. We go from infancy to childhood then on into adulthood. We create goals and we push to achieve them, but the goals are not “real thing.” They are what we put in place to give our lives form, shape and direction, to make us feel purposeful.

ReedsStillPond-300-72

It’s harder when you are older and in what I like to think of as your post-career because the kinds of aims and goals we had before don’t work and we have to find new directions. Most of us do. The classic image that young people have of old people sitting around doing nothing and just fading into the twilight is based on misconception and stereotyping. They are in a hurry to grow up, to get on to whatever it is they perceive as the next stage of life. They can’t understand what life is like when your primary goal is to enjoy your time, not dash through everything as fast as possible.

They’ll find out.

It’s Not Your Equipment … It’s a Lack of Documentation!

Maybe I should just give up, but I spent my career writing material to help folks use complicated equipment and sometimes very obscure software.

I should probably start by mentioning that I’ve fought this battle for long years … and was utterly defeated. About 7 or 8 years ago, high-tech companies, in a money crunch and driven by that bottom line that seems to be the only thing that matters anymore, began to eliminate technical writers. Entire departments were dismantled and eliminated. Jobs disappeared and what remained paid so badly it was insulting.

A decision had been made at the corporate level: YOU don’t need documentation. No matter how complicated or expensive the equipment or software you purchase may be, don’t need documentation. Companies provide the minimum the law requires or they can get away with. Quality is no object nor usability. Information is limited to basic stuff like how to install a battery and if you are lucky, where the compartment is.

I was a technical writer for about 75% of my career, the rest being divided between journalism, editing, promotions and advertising. But mostly, I wrote documentation and I though my work mattered. Probably naive, but I believe that if I documented a system, it should be well written, clear, organized, and useful., When a user needed to find something, it would be in the book and in the online help. It would be easy to find. I carefully avoided using mysterious search parameters that could be deduced via a psychic link to my brain. If you knew what you wanted, I made it easy for you to find it.

I was proud of my work. I still believe the fundamental goal of documentation is to make complicated things simple. Not necessarily easy because sometimes, the product was not easy to use, but that didn’t mean that it had to be hard to understand. My documentation was good for another reason: I used the product and tested what I wrote to make sure it was true. This testing makes the difference between a pile useless gibberish and a manual.

Thus, when you get something that appears to be documentation, stop and read it. Appearances are deceiving. Most “manuals”  are generated, not written, and never checked for accuracy or usability. Such “manuals” are as likely to increase your confusion as provide illumination.

I bought a PEN EP3 camera from Olympus. Seven months and hundreds of photographs later, it remains one of the mysteries of my world. It takes wonderful pictures, and it has hundreds of functions. I haven’t the slightest idea how to find most functions and have no idea what to do with them if I could find them.

I grew up in a pre-digital world. I know F-stop, depth-of-field, shutter speed, aperture and focus, film speed and composition. I have a good eye. I’m no genius, but my pictures are pretty and I enjoy taking them.

He solves the problem the way most do: Automatic everything, then shoot.

New digital cameras have a vast and overwhelming array of functions, most of which you or I will never use or need. I believe they are there entirely to impress us with the super high tech-ness of the equipment. I doubt that even the designers — especially the designers — expects us to actually use them. Which is good, because I don’t know what they are supposed to do anyhow or why I would need them. Ansel Adams didn’t need them. Neither did Edward Weston. Neither do I. But, the more you pay for a camera, the more of these obscure functions you get and I figure that the least they owe me is an explanation of what these setting do and how to find them.

I’m not sure whether to curse or say thank you. Maybe if Olympus provided a manual that explained these options, I’d be grateful, but that is not happening.

I spent half our shooting time trying to find the menu to change the ISO.

This is true of cameras, but the lack of documentation on your computer is actually worse … much worse because most of us depend on our computers. We need them to work and we need to have some control over the environment in which we work. Configuration of our computers to suit our needs is not a minor detail: it’s the difference between having a tool that does what you need and one which is a burden … an enemy with which you do daily battle.

I spent all last night — until dawn — trying to figure out how to turn off the touchscreen functions of my monitor. Before Mac users jump in and point out that it’s because Windows doesn’t work, that’s irrelevant and untrue. Windows works fine. It’s just that the company doesn’t provide any written documentation. There is embedded information in the operating system, but much of it isn’t logically arranged. It’s rather like looking for your car keys after you’ve dropped them someplace you don’t normally put them. You know they’re in the house, but where? It could be years before you find them..

On a new computer, you typically get an “introductory” video and that’s pretty much it. I watched it. It showed me in exquisite detail how to do what I already knew how to do.

Operating systems are designed to be used the way the system’s developers expect you to use it. If you prefer a different setup, trouble starts. The only way to figure out how to do something differently is to keep querying the system and hope you’ll stumble on the right  key word — the word that will bring up the information you need. What is most frustrating is that you are sure it IS there, but whether or not you will ever find it is a different issue.

If you are sufficiently persistent and a bit lucky, you will eventually find a mystery menu after which you fix your problem in a few seconds.

Last night, I searched, searched again and again. It didn’t call Dell because I knew the support person wouldn’t know the answer either. They pretty much never do.

So I tried one word combination after another, recombining them in the hope that it would lead to a menu buried in the system. There had to be a way to deactivate touch input.

Around 5 in the morning, I found it. It took me less than 30 seconds to eliminate the problem that had been driving me nuts since I got the computer. Now, it’s a monitor. A great, high-definition, 23-inch monitor that’s a joy to work on and makes photo editing a pleasure. No more configuration by crawling insect. I am mistress of my virtual world at last!

A technical writers earns less than an entry-level developer. I understand the guys in India who provide telephone tech support work cheap, but I bet a tech writer would cost less than a network of telephone support no matter how cheaply they work.

Assuming you are under warranty and you can get through the voice mail  maze … and further assuming you get someone who understands the problem and don’t get blown off because software is not part of your warranty (Note: If someone can tell me how, without using software, you can determine if you have a hardware problem, I’d like to hear it) … Round and around you go.

It doesn’t have to be this way.

Would it blow the budget to hire a competent technical writer to embed online help that will live on even after the warranty period is over? Wouldn’t it be nice to help users avoid needless aggravation and not wind up with angry, frustrated, exhausted, and homicidal customers whose problems remain unsolved?

Granting that many home users have a limited understanding of how their computers work and for them, it wouldn’t much matter what documentation you supply. Most problems result from insufficient understanding of a product or process. If you are talking about a novice user, perhaps more information wouldn’t help. But …

I’m not inexperienced and I still can’t find essential information I need to configure my monitor. Wouldn’t it be reasonable to expect a menu on the control panel that I could use to configure the monitor’s capabilities, not merely its resolution but any other functions it may have. Functions not available on a particular model could be grayed out. How about that?

There is nothing wrong with my computer that better organized and easier to find information would not solve..

Every issue I’ve had or the last 5 or 6 years was ultimately fixed with a few clicks of the mouse. The problem was never something broken. It was always lack of documentation.

That pisses me off. Because tech writers — even highly experienced ones — work pretty cheap. Users do need documentation, and not just for software and computers. We need documents that let us use our cameras and telephones and DVD players and all those other pricey little devices that we own and often, don’t know how to use. Online FAQs are insufficient.

This is an old battle I’ve already lost. I know it’s hopeless. I find it infuriating that I can barely figure out my telephone without customer support, so rather than spend time on the phone with customer service, I don’t use anything I can’t easily configure.

I had to buy a separate book on how to use Photoshop and another for my first camera. I was able to get some help from a fellow user of my new camera, but that only goes so far. For my PEN P3 camera, there IS no customer support nor any after market book. I depend, as Blanche DuBois said, “… on the kindness of strangers.”.

My camera will remain a mystery until someone writes a “Dummies” book for it. Hopefully I’ll still own the it when the book finally gets published.

It’s not fair. The reason they get away with it is because we let them. Think about it.

So how did I finally figure it out? The “monitor” menu should have been a gateway, but was useless. The only thing you can the “Monitor” menu lets you do is lower your screen’s resolution. That’s useless.

Finally, I typed: Touchscreen.

Up came something that I hadn’t considered. Flicks. Now, for me? That means the movies. Having never used it, I had no idea it had anything to do with the monitor or its touchscreen technology. Once I got to “Flicks,”, I started opening menus and voilà, there were two check boxes allowing me to toggle an option:

  • Enable finger as pointing device.
  • Do not allow finger as pointing device.

I un-checked the first one by checking the second. I clicked “Apply.” As the sun rose in the east, my problem was solved and I went to bed, to sleep, perchance to dream  … of murder, destruction and vengeance.