Re: Too many Notes

Subject: Re: Too many Notes
From: "Pooja Malhotra" <pooja -dot- malhotra -at- induslogic -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Tue, 4 Mar 2003 11:04:12 +0530


Thanks to Tara and Beth for their suggestions.

Tara, you guessed it right- I am an Indian working as a Technical
Writer.

>>Tara Wrote:
>> To solve the abcd vs efgh issue, I created a couple of graphics. You
know, pictures are worth a thousand words!

>>Beth wrote:
>> You could design a contents page for the kind of help system you'd
like it to be, then show him >>your proposed organization, and tell him
how quickly you can make the change.

I have in fact added quite much graphics in the Help along with
providing Search, Indexing and TOC (Generated help using RoboHelp). In
fact, its just a couple of hours job to create the separate pages, but,
for the time being, I have been told to put the changes on hold as the
"CLIENT is happy with the current output" n Guess, I got to leave it the
way it is.

Anyways, Thanks once again,

Pooja Malhotra
Technical Writer
Induslogic
Delhi

Hi,
I agree, it sounds like too many notes in the online help, and it sounds
like you care as much about your help systems as I do mine.

I've never had any of my managers, let alone a PM, tell me how to
organize and write my material. It sounds like he is "too close to the
subject" to have a true view of it.

One idea: You could design a contents page for the kind of help system
you'd like it to be, then show him your proposed organization, and tell
him how quickly you can make the change. You're the users' advocate, and
you have to keep trying for their sake.


If all efforts to change the PM fail, performing thorough indexing will
help the user find what he's looking for, even if topic organization is
messed up. And your PM will not even know you're spending time on
indexing (in case he's against that too). Good luck,

Beth Kane
Services Engineering Tech Writer
Pearson Education Technologies
beth -dot- kane -at- pearson -dot- com
www.pearsonedtech.com



^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Order RoboHelp Office X3 by March 14 and receive a $100 mail-in rebate,
plus FREE WebHelp Merge Module and FREE iMarkup Software, for a
total giveaway value of $439! Order today at 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.



Previous by Author: FW: Too many notes
Next by Author: Tech Documentation info to Developers and QA
Previous by Thread: FW: Too many notes
Next by Thread: Making the move to permanent work from contract?


What this post helpful? Share it with friends and colleagues:


Sponsored Ads