[Author Prev][Author Next][Thread Prev][Thread Next]
[Author Index (this month)][Thread Index (this month)][Top of Archive]

Re: Writing software documentation without the software

Subject: Re: Writing software documentation without the software
From: "CapDev Communications" <capdev -dot- communications -at- gmail -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Thu, 14 Dec 2006 11:08:43 -0800

I often lift from the management consultants, who are paid considerably more
than I am, and label everything "DRAFT--FOR DISCUSSION ONLY." This way, I
show that I am ready, willing, and able to do my job and be part of The
Team. I also offer to test the product, even as it's being developed. The
engineers often appreciate my willingness to pitch in and help. Management
gets everything just as soon as it exists.

Pat


On 12/14/06, Evans, Diane L (Rosetta) <diane_evans -at- merck -dot- com> wrote:


>Your contribution to the product is not only the written material, but
also the questions, sometimes very embarrassing
>ones, that you pose to the software developers.

I am in a wonderful position because I am embedded with the developers.
I have access to any SME I want; after five years, they know that I will
come by their office -- often with little or no warning.

My favorite questions to ask are "the emperor has no clothes" questions,
where they are not allowed to tell me that this is the way it has always
been done, or similar excuses for doing things a certain way.

The three most valuable questions to ask when learning about software
are "Always?" "Never?" and "Huh?"

Diane Evans
Requirements Analyst
ASQ CSQE
Rosetta Inpharmatics
206-802-6560



------------------------------------------------------------------------------
Notice: This e-mail message, together with any attachments, contains
information of Merck & Co., Inc. (One Merck Drive, Whitehouse Station,
New Jersey, USA 08889), and/or its affiliates (which may be known
outside the United States as Merck Frosst, Merck Sharp & Dohme or MSD
and in Japan, as Banyu - direct contact information for affiliates is
available at http://www.merck.com/contact/contacts.html) that may be
confidential, proprietary copyrighted and/or legally privileged. It is
intended solely for the use of the individual or entity named on this
message. If you are not the intended recipient, and have received this
message in error, please notify us immediately by reply e-mail and then
delete it from your system.


------------------------------------------------------------------------------
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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
capdev -dot- communications -at- gmail -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/capdev.communications%40gmail.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.




--
Patricia Egan
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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.

References:
Re: Writing software documentation without the software: From: neilson
RE: Writing software documentation without the software: From: Evans, Diane L (Rosetta)

Previous by Author: Re: Documentation estimates
Next by Author: Re: American English
Previous by Thread: RE: Writing software documentation without the software
Next by Thread: RE: Writing software documentation without the software

[Top of Archive] | [Author Index (this month)] | [Thread Index (this month)]

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

Sponsored Ads