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.
:: We are starting a new project, which is rewriting all our
:: documentation with
:: single-sourcing in mind. We will be using Frame and WWP.
:: We are
:: therefore new to Framemaker, WWP and ... single-sourcing!
:: We have started to define a template in Frame. Now and
:: before moving to the
:: writing part to test our template we want to know more
:: about the pitfalls of
:: single-sourcing with those tools (about documentation
:: structure etc.).
I can sum up the important things to remember in 4 words:
templates good, overrides bad
You need to create a template with styles the way you want them and stick to
them. The more you manually tweak the text, the more room you make for
pitfalls when trying to convert your files to an online format. Try to
follow a logical structure, keeping in mind both the print and online
desires and limitations of what you are trying to accomplish. I have written
a short introductory paper on this (the paper's a bit old, but still
applies): <http://www.geocities.com/bill_swallow/singlesource.html>
:: I have collected some information from a WWP manual, a few
:: whitepapers form
:: Scriptorium. But if some of you have interesting stories to
:: share or point
:: me to additional resources, we would feel more confident.
*****************
BILL SWALLOW
Technical Writer
C O U R I O N C O R P O R A T I O N
1881 Worcester Road
Framingham, Mass. 01701
T E L * 508-879-8400 x316
F A X * 508-879-8500
www.courion.com
*****************
*** Deva(tm) Tools for Dreamweaver and Deva(tm) Search ***
Build Contents, Indexes, and Search for Web Sites and Help Systems
Available now at http://www.devahelp.com or info -at- devahelp -dot- com
Sponsored by Cub Lea, specialist in low-cost outsourced development
and documentation. Overload and time-sensitive jobs at exceptional
rates. Unique free gifts for all visitors to http://www.cublea.com
---
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.
