TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
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. http://www.DocToHelp.com/TechwrlList
True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-