Search
Subscribe

Enter your email address

Where I Am

FacebookTwitter

LinkedInRSS Feed

 

 

 University of Mississippi's Writers' Page


Resources


Create Your Writer's Life,
by Cynthia Morris

On My Nightstand

Some Assembly Required
by Anne Lamott

Still Alice
by Lisa Genova

Juicy Pens, Thirsty Paper
by SARK

River Flow
by David Whyte

Ending Your Day Right
by Joyce Meyer

And my monthly copy of
Down East Magazine


Powered by Squarespace
« Life Magazine Online Again, But Better | Main | Employee of the Month »
Thursday
Mar262009

Technical Writer Torture

Situation: There are gobs of flowcharts. So many that people roll their eyes at the mere mention of them. At first, I thought they reproduced at night when all the lights were off. Sort of like cockroaches. Despite folks’ pleas to management to stop producing them, they are continuously created.
Goal:
Because management thinks people are merely confused by the flowcharts, they want to develop a process document that explains at a high level what they do. From there, they can add support documentation on “work practices” (don’t say procedures in the office, it’s comparable to saying bomb in the airport). Everything would be in easy-to-find, connected, textual presentations to alleviate the reliance on people grasping a bunch of willy-nilly flowcharts.
Nine months later and the umpteenth dance around the goal:
Manager sends my first draft of process doc to Director for opinion.
Result: Director sends reply email to Manager:
----------
From: Director
To: Manager
Cc: Senior Manager
RE: Processes_All_Phases.doc

I did a quick read, looks pretty good. One thought: Might be easy to get lost in the process. I wonder if a high level flowchart (with brief descriptions of what the process is and why it’s done) would help?
------------

Reader Comments

There are no comments for this journal entry. To create a new comment, use the form below.

PostPost a New Comment

Enter your information below to add a new comment.
Author Email (optional):
Author URL (optional):
Post:
 
All HTML will be escaped. Hyperlinks will be created for URLs automatically.