TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:Tech Writing and McDonald's... From:Charles E Vermette <cvermette -at- juno -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Fri, 1 Mar 2002 09:15:56 -0500
Our resident sigaholic Keith Cronin closed a recent post with the
<<<I'm pretty excited - I found this great job posting for a position as
a high-speed culinary distribution technician at some local firm called
McDonald's. Wonder what kind of software they make...>>>
After reviewing their product descriptions, they certainly need some tech
writing help - as obvious from the following example (a description of
the ingredients in their "Big Mac" product line:)
* Two all beef patties
* Special sauce
* Onions, on a
* Sesame seed bun
This is clearly a case of someone who thought that because they knew
something about Information Mapping, that could call themselves a Tech
Writer! Yes, the 7 +/-2 rule is observed, but note the information
missing that is critical to both the developers and the target audience:
* What exactly are "all beef patties," and how does this distinguish
McDonald from the competition? Why are two better than one? In this day
and age? How do you know if the target audience values quantity over
Furthermore, what are the dimensions of these patties? Let's save some
calls to tech support by putting this information in the document.
* Most egregious of all, what is "special" about the "special sauce"? The
users want features and benefits. The developers need infomration on
process. They need a cross reference to the API Guide should they want to
customize the sauce for McDonald's "New Tastes Menu" initiative.
* There are myriad varieties of Lettuce, Cheese, Pickles and Onions.
Again, more detail on features is needed. Users have different
preferences for these items, and want to know if they can be customized.
For example - my wife is Filipino, and I am an SME of Filipino culture
who has eaten at McDonald's in the Philippines. The Philippine standard
is to have sweet pickles, as opposed to dill pickles, in their
hamburgers. The issue of customization is especially critical for the
localization process, and if this writer was willing to be involved in
the product development they would address this. Burger King, one of
their strongest competitors, emphasizes that the user can "have it their
* Finally, some needed detail. While we know specifically that we have a
"Sesame Seed Bun," is this the only option available to the user? Again,
a good writer would flesh out these details.
This is what happens when a TW doesn't want to dig into the technical
details, be involved in product development, or understand the internal
and external audience.
Now's a great time to buy RoboHelp! You'll get SnagIt screen capture
software and a $200 onsite training voucher FREE when you buy RoboHelp
Office or RoboHelp Enterprise. Hurry, this offer expires February 28, 2002. www.ehelp.com/techwr
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit http://www.raycomm.com/techwhirl/ for more resources and info.