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
structure
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,
old,
way.....
it called a cliche.

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

regards and thanks,
Sean

~~oh and MERRY CHRISTMAS, AND BEST WISHES FOR A HAPPY PROSPEROUS AND
ENJOYABLE NEW YEAR~

To: TECHWR-L
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
excellence"
for a doc department would be a team of writers with exceptional *technical*
knowledge about their employers products and services and the ability to
help
both customers and internal staff use and understand those goods and
services
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 http://www.ehelp.com/techwr-l

Check out SnagIt - The Screen Capture Standard!
Download a free 30-day trial from http://www.techsmith.com/rdr/txt/twr
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
http://www.raycomm.com/techwhirl/ 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


Sponsored Ads