Re: End User Manual and SharePoint Wiki

Subject: Re: End User Manual and SharePoint Wiki
From: "Gene Kim-Eng" <techwr -at- genek -dot- com>
To: "Dan Goldstein" <DGoldstein -at- riverainmedical -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Mon, 10 Dec 2007 08:11:01 -0800

My experience in these matters has been that upper
management that makes process decisions without
asking for input from the people actually doing the
work is usually convinced that they know these
things better and will turn a deaf ear toward any
arguement offered on these grounds. The approach
that has the best chance of being successful is to
determine the maximum level of disaster possible
if a user posts incorrect information to the wiki
and another user follows it 30 seconds later, then
secure the support of someone in the upper
management level whose ox will be gored by
said disaster. If you can't come up with a suitable
disaster, then perhaps there's nothing to be lost by
posting the "known good" document that you have
prepared and giving the wiki a try. Just be sure
to select a platform for it that doesn't require a
lot of hands-on work by the doc team.

Gene Kim-Eng

(unless they indicate otherwise
----- Original Message -----
From: "Dan Goldstein" <DGoldstein -at- riverainmedical -dot- com>

> My only suggestion is to demonstrate the following on a single,
> double-spaced page:
> * How much more the project would cost (in dollars) if the company
> adopts this system
> * How much the project would be delayed (in days) if the company adopts
> this system
> I'm not disparaging the qualitative issues that you raised (end-users
> have no benchmark to measure the documentation, edits can't be
> effectively validated and incorporated, etc.). However, those who
> support the wiki also have arguments on their side. Your ability to
> quantify the potential "waste" might give you an edge.


Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more.

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity!

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

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 for more resources and info.


RE: Software Bug Databases: From: Ben
End User Manual and SharePoint Wiki: From: Jim Barrow
RE: End User Manual and SharePoint Wiki: From: Dan Goldstein

Previous by Author: Re: MS Word screws up yet ANOTHER project?
Next by Author: Re: A Good Response to "No One Reads the Help Anyway"
Previous by Thread: RE: End User Manual and SharePoint Wiki
Next by Thread: Re: End User Manual and SharePoint Wiki

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

Sponsored Ads