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.
Subject:Re: departing from a template From:Janice Gelb <janiceg -at- marvin -dot- eng -dot- sun -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Wed, 17 Apr 2002 10:31:19 -0700 (PDT)
In article A49A7712BBF66B429012E546AD56AF6B07B429 -at- COCPISEX1 -dot- clear-technology -dot- com, ellen -dot- vanrenen -at- clear-technology -dot- com ("Ellen Vanrenen") writes:
>
>We have a style guide and a template. Our manager, who is the manager of =
>Customer Service and Support, becomes unhappy when we depart from the =
>template. I created the template. It is mostly for end user =
>documentation, and I always envisioned it as the "core" from which =
>individual documents might vary to some degree, depending on the needs =
>of the writer. With some variation allowed, documents would still have =
>the same "look and feel" if the writer adhered to the fonts and so =
>forth.
>Is it usual to consider a template the only way to create documents of =
>the same type, allowing the documentor no freedom depending on the =
>individual document?
>
I think the key phrase here is "documents of the same type."
A good template should be flexible enough for everyone to
be able to use it to create documents of a similar type.
As you note, creating a common look and feel is important,
so you don't want individual writers to have blanket permission
to deviate either. One person's slight variation is another
person's completely different look and feel.
If you have documents that are so different that the template
does not work for them, you may need to have different templates
for different needs. For example, we have different templates
for white papers than for user documentation.
*********************************************************************
Janice Gelb | Just speaking for me, not Sun.
janice -dot- gelb -at- eng -dot- sun -dot- com | http://www.geocities.com/Area51/8018/
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Free copy of ARTS PDF Tools when you register for the PDF
Conference by April 30. Leading-Edge Practices for Enterprise
& Government, June 3-5, Bethesda,MD. www.PDFConference.com
Are you using Doc-to-Help or ForeHelp? Switch to RoboHelp for Word for $249
or to RoboHelp Office for only $499. Get the PC Magazine five-star rated
Help authoring tool for less! Go to http://www.ehelp.com/techwr
---
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.