RE: Reporting Structure/Work Model for Documentation Department

Subject: RE: Reporting Structure/Work Model for Documentation Department
From: "Sean O'Donoghue-Hayes (EAA)" <Sean.O'Donoghue-Hayes -at- ericsson -dot- com -dot- au>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 18 Dec 2002 18:09:06 +1100

Ahhhhhh the old content versus style,
and coherent
raises it's old ugly head,
like a hydra that we slay and slay and slay,
then it pops back,
a weed beneath our feet,
a garden rake whacking into our face,
a true Three Stooges moment,
yes content is important,
yes communicating with SMEs is important,
yes white space is important,
yes fondling a font in public is indecent,
yes style,
yes presentation,
yes relationships with management,
yes working with others well, and professionally,
are all very important,
one with out the other,
is like a baseball game without a bat,
or without a ball,
or without a diamond,
how the players play is important,
and the style is important,
but so is winning,
if content wins it for you,
focus content,
if style wins it for you,
focus style,
if fonts win it for you,
focus fonts,
but each without the other is all the weaker.
So this seems to have content,
but is probably,
real, painful to read,
yeah style can hurt,
and build,
as can a lack of content,
or a repetitive attack of
the same content,
presented the same,
it called a cliche.

But back to the cliche...I mean discussion, of style versus content...

regards and thanks,


Subject: Re: Reporting Structure/Work Model for Documentation Department

<mary -dot- kendig -at- convergys -dot- com> wrote in message news:180503 -at- techwr-l -dot- -dot- -dot-

> Does the doc group function as a "center of excellence," producing doc
> standards and templates for others in the company to follow, providing
> guidance and recommendations for all doc issues, etc.?

None of these things would make a tech pubs department a "center of
excellence." More like a "center of mediocrity." A true "center of
for a doc department would be a team of writers with exceptional *technical*
knowledge about their employers products and services and the ability to
both customers and internal staff use and understand those goods and
through comprehensive and insightful documentation & training materials.
Templates and standards are of minimal consequence.

Andrew Plato

Order RoboHelp X3 in December and receive $100 mail in rebate, FREE WebHelp
Merge Module and the new RoboPDF - add powerful PDF output functionality
to RoboHelp X3. Order online today at

Check out SnagIt - The Screen Capture Standard!
Download a free 30-day trial from
Find out what all the other tech writers, including Dan, already know!

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 for more resources and info.

Previous by Author: RE: OT: Whaddaya Mean, "The debate that won't die?"
Next by Author: RE: Another day in the Life of an Independent Contractor...
Previous by Thread: Re: Reporting Structure/Work Model for Documentation Department
Next by Thread: Re: Reporting Structure/Work Model for Documentation Department

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

Sponsored Ads