RE: Writing software documentation without the software

Subject: RE: Writing software documentation without the software
From: "Sean Hower" <hokumhome -at- freehomepage -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 15 Dec 2006 07:26:16 -0800



> Brasel, Russell asked:
> Has anyone here had an experience like this?
> The only problem is that I don't have the
> application on my box.


This question has been asked before:
http://www.techwr-l.com/techwhirl/archives/0607/techwhirl-0607-00555.html


As for advice, I'd start with asking the reasons for not having access to the software. This should be done in a non-confrontational way, a way that I cannot think of at 7:30AM on a Friday. ;-) You can then examine the reasons and construct an arguement (logical not whining) that invalidates those reasons. That's assuming that there is some logic behind not letting you have access to the software. If it's an emotional thing--your developers dont' trust people outside of their cabal for example--you'll have to take a different approach. If neither of these work, you'll have to go for the ROI argument, which means documenting the time that it takes doing documentation with vs. without access to the software and showing a real dollar savings for having access. If you have shown that their logic is faulty, have soothed their emotions, and proven a better ROI, and they still don't let you have access, then you're just hosed and you should go get the t-shirt! ;-)

********************************************
Sean Hower - communications specialist
http://www.seanhower.com










_____________________________________________________________
Create your own web site for FREE at http://www.freehomepage.com
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today! http://www.webworks.com/techwr-l

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include single source authoring, team authoring,
Web-based technology, and PDF output. http://www.DocToHelp.com/TechwrlList

---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40infoinfocus.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.


Previous by Author: Documentation feedback
Next by Author: persuasion
Previous by Thread: RE: Writing software documentation without the software
Next by Thread: RE: MS Word TOC Numbering Ghost


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


Sponsored Ads