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.
Paula Flanders writes: A lot of the audience for my doc has Word, but some
people do not and need to use a browser to look at it.
Well, in the 21st century and unless your users work in a hostile
environment where they can't use a computer, I would concentrate on creating
help in html and consider Word a thing of the past, or as is often heard
now, "last century." Probably you're correct some people don't have Word,
but more importantly I'd wager many more have internet access (even those
that do have Word).
Now, while it takes effort for holders of paper manuals to ensure they have
the latest version, if your help is on the internet and served from your
company site, your users always have the latest version. They also have no
system management worries should your document contain hypertext, which
certainly it should. I recommend designing web pages rather than "word
processor" pages. And, Word is definitely not the tool for designing web
pages. Html is pretty easy to learn, and once you know it you'll agree
you'll never find a code generator that can do it better than you can. The
"huge resistance" in your company to pdf is well founded. I think it's just
momentum and the consequent feeling "it doesn't print pretty" that keeps
folks tied to Word, Acrobat, and the like and resisting the inevitability of
the web. BTW, my company presents all its internal policies/procedures on
its intranet, and each document contains up front the warning "IMPORTANT
NOTICE: A printed copy of this document may not be the document currently in
effect. The official version is located on the ... (intranet)."