Re: Post current product user docs to company website?

Subject: Re: Post current product user docs to company website?
From: <neilson -at- windstream -dot- net>
To: "V. Camgros" <camgros -at- mindspring -dot- com>, "McLauchlan, Kevin" <Kevin -dot- McLauchlan -at- safenet-inc -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 6 Dec 2007 17:19:13 -0500

Like it or not, the developer is almost certainly correct. And even
though it seems to put our jobs in jeopardy, the new way of publishing
docs will be as controlled wikis. (We'll have to leave the almost
totally uncontrolled ones to Jimbo Wales and his Wikipedia.) The docwiki
will be updatable by its users, but only if they have permission. There
likely will be levels of permission, so that users cannot initially make
changes to proposed specs. (Indeed, I'd be surprised to see commercial
specs on the Internet. They are usually secret until after FCS at least.)

I've seen some prototype docwikis on the web, but I've not bothered to
get passwords to them because I'm addicted to copyediting, and if I can
edit every durned docset on the internet, then I WILL, 170 hours a week.
(It's bad enough that I mark for deletion the "greengrocer's apostrophes"
in the "BANANA'S" signs at the supermarket.)

Vickie Camgros suggested:
> Kevin McLauchlan wants to know why he should or shouldn't pursue putting his product documentation on the corporate web site.
> One of my developers continues to push for this (I agree with him) because he says he uses Google search to find information about everything he uses. If our product documentation isn't on the web, he can't find it that way.
> He claims many/most(?) developer search this way.
> You'd have to look at your user base, of course, to see whether they have this quality in common with developers, or to prove him wrong.


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.


Previous by Author: Re: Software Bug Databases
Next by Author: Re: Post current product user docs to company website?
Previous by Thread: Re: Post current product user docs to company website?
Next by Thread: Re: Post current product user docs to company website?

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

Sponsored Ads