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:Re: Any Techwhirlers in 3d games? From:"Martin Page" <mpage -at- csl -dot- co -dot- uk> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Tue, 1 Apr 2003 09:48:47 +0100
"Owen Flatau" <owenf -at- mighty -dot- co -dot- za> wrote in message news:192404 -at- techwr-l -dot- -dot- -dot-
>
> hi everyone,
>
This sounds familiar (from a previous incarnation). My advice, all IMHO....
You're the documentation expert.
Ask questions and work out what you think they need, define it in simple
terms, then tell the powers-that-be what you're doing in a short report: "I
have identified the following documentation needs which I propose to fulfil
in the order as set out here..."
They'll either approve it, or use it as a reference point for what they
really want. Either way, you have deliverables and a mandate from
management.
Then just do it, without making a fuss.
Ensure accuracy (and a well covered posterior) by getting relevant people to
sign off on your output, but don't tell them what your system is unless they
ask, because they really don't care.
In this sort of situation, it's vital to maintain the Jedi techwriter
mystique. In particular, don't show anybody anything but the final draft
because, as pointed out before on this list, engineers/SMEs tend to treat
drafts as failed attempts to produce a finished product. Instead, use email
to send people snippets: "Hi Cedric - Just wanted to check I understood the
XYZ feature. So far, I have: [your snippet here]"
It all sounds rather fun, actually
Take care
Martin
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Order RoboHelp X3 and receive a $100 mail-in rebate, plus FREE
RoboScreenCapture, WebHelp Merge Module and iMarkupSoftware, for a total
giveaway value of $473! Order here: http://www.ehelp.com/techwr-l
Help celebrate TECHWR-L's 10th Anniversary starting this month!
Check out the contests at http://www.raycomm.com/techwhirl/special/contests/
Happy birthday to you, happy birthday to you, happy birthday TECHWR-L....
---
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.