Word template

Subject: Word template
From: SB <sylvia -dot- braunstein -at- gmail -dot- com>
To: TECHWR-L <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Sat, 17 May 2008 19:08:29 +0200

I have already posted here regarding this issue.

I started working alone in the company. Due to so much pressure and Word
crashing, when a style would not behave, I created a new style, which may
have been the wrong approach but this was the fasted I could get the work
done without focussing on troubleshooting.

Bottom line, the documentation had many unwanted styles.

The technical writer with whom I worked created a new template with brand
new styles but we cannot afford converting everything from scratch.

So, he renamed a lot of the styles and we attached the template. Most of it
works fine and needs minor fixing.

One of the issues is that now, most of the documentation has a template
except that a lot of styles do not talk to each other and I have no clue how
to get rid of them without buiding everything from scratch. Having clean
documents is particularly important in light of the fact that we plan to
make a transition to AuthorIT. If we keep all this variety of styles created
as I needed them, it will probably be imported in AutorIT, or will it?

The other issue is that the guy that is in charge of the template keeps
making changes and additions which sort of defeats the purpose of having a
template since again, it is not backwards compatible with what we have
already created. For example he decided to rename "bold" to "bold ch",
"reference" to "reference ch", etc. As is, we have hundred of styles that
are not part of the template. With this renaming, we have even more of those
that will not talk to the template. I started a matrix, which took me a long
time to compile part of the style naming. However, these constant changes
and improvements make me wonder about whether using this template is any
different than not using one since there is always a discrepancy as the
template changes, thus making all the efforts useless. I am wondering how
you people use templates to improve documentation. Freezing the template
means that we don't have all the tools we need, continuing to edit it means
that the styles are not backward compatible with the previous template and
here we have new styles again that we need to get rid of.

I would like to get your feedback on how to implement the Word template in
an efficient manner and how to optimize it for the upcoming AuthorIT



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! http://www.helpandmanual.com

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 http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com

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
http://www.techwr-l.com/ for more resources and info.


Previous by Author: Re: Is Vista "there" yet?
Next by Author: Is there a real-time collaboration tool for MS Word 2003?
Previous by Thread: Re: RE: Re: what computer, what software for a lab?
Next by Thread: Re: Word template

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

Sponsored Ads

Sponsored Ads