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.
Is anyone familiar with taking a large amount of technical documentation
(existing in one main folder, but about 20 sub-folders with multiple Word,
Visio, and .pdf files in each) and bringing it all together into a
consistent format and getting it "published" on a company intranet?
I didn't do it myself, but a couple of former cow-orkers were landed with a
very similiar project - converting large quantities of elderly documentation
in WordPerfect into Word.
Does each document exist in Word, Visio, and .pdf files, or are these
different documents for different purposes?
Your first mission (should you choose to accept it) is to decide what the
future consistent format is going to be. Take a look through all the
documentation, figure out two or three rough ideas, and try to get some
feedback on which is most usable from the people who will actually be using
If that's already been decided for you, find out how much leeway you have to
make changes in this format, providing you remain consistent over the whole
project. You need to be able to make *some* decisions, otherwise you're
bound to get yourself locked into some bad choices that were made by people
who weren't as familiar with the whole documentation set as you will be.
Automate all the changes you can. Sort out the changes required into sets
(changing the styles, changing the page layout, changing the tables,
changing the text layout) and move through all the documentation one set at
a time. Before you start on one set of changes, make sure you have a full
Technical Writer, Compaq, UK
Unless stated otherwise, these opinions are mine, and mine alone.
Develop HTML-Based Help with Macromedia Dreamweaver 4 ($100 STC Discount)
**WEST COAST LOCATIONS** San Jose (Mar 1-2), San Francisco (Apr 16-17) http://www.weisner.com/training/dreamweaver_help.htm or 800-646-9989.
Sponsored by DigiPub Solutions Corp, producers of PDF 2001
Conference East, June 4-5, Baltimore/Washington D.C. area. http://www.pdfconference.com or toll-free 877/278-2131.
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit http://www.raycomm.com/techwhirl/ for more resources and info.