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:Business issues, documentation....hows and whys From:JRessler -at- ewa-denver -dot- com To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Thu, 10 Jan 2002 14:53:32 -0700
I too am struggling with incorporating the ?why? into ?how.?
Fortunately, or unfortunately depending on your view, I am writing under a
government contract. The government feels the need to introduce
requirements that are a bit redundant to say the least. I have found that
multiple sections often contain the same information, or information that
is extremely similar. To me, it is inconvenient to flip back and forth
from section to section every time I want to know ?why? to use something,
rather than just ?how? to do it.
I think your hyperlinking is a nifty idea, and is exactly how I have
alleviated my frustration. Screen tips (mouse/drag overs?) are useful
too. I often use them to give a bit more of a ?why? explanation to the
Obviously, the ?why? is often more subjective than the ?how? and requires
more thought. That is the fun part to me, taking all the possibilities
and conveying them in a concise, efficient manner.
The best case for a user is ?one-stop shopping.? I like the fact that I
can get how to do something, and why I should do it from one manual,
rather than outsourcing all the data. I don?t think that the ?why? should
be included in the ?how? process. Sometimes, I just want to do something,
and I don?t particularly care why it is done. Sometimes I already know
why, and I just don?t know how. Let the user decide.
That is obviously a ?for what it is worth? opinion. All the best.
Collect Royalties, Not Rejection Letters! Tell us your rejection story when you
submit your manuscript to iUniverse Nov. 6 -Dec. 15 and get five free copies of
your book. What are you waiting for? http://www.iuniverse.com/media/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.