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.
I can't imagine using humor in a technical document. In fact, I'm dead set
against anything that distracts from the facts. Let me tell you what
happened the last time somebody tried to muck with perfection.
Sing along, everybody!
Doc Like a Man
(to the tune of Walk Like a Man by The Four Seasons)
===============
Oh, how you tried,
To feminize my guide,
By striking passive voice and tortured tense.
Ooo-waah, Ooo-waah, Ooo-waah
But our managers all expect,
Our docs in good old milspec.
They like all our books boring and dense.
I'm going to...
Doc like a man
Pompous and bland
Doc like a man
My deaarr!
I'm going to stash,
Your redlines in the trash,
And I'll doc like a man,
My dear.
You say our customers are feeling,
Our books should be more appealing,
With snazzy graphics and lots of white space.
Ooo-waah, Ooo-waah, Ooo-waah
But users should be educated,
To appreciate the complicated.
We've got to keep the customer in his place.
We're going to...
Doc like a man
Stick to the plan
Doc like a man
My cutey!
We don't need more pearls,
From educated girls.
We'll still doc like a man
My dear.
You say it would be so fine,
To put the doc set online,
And cut the paper at the user's site
Ooo-waah, Ooo-waah, Ooo-waah
But you'll soon see the futility,
Of your strive for usability,
We're insensitive to the user's plight.
That's why we...
Doc like a man
As much paper as we can
Doc like a man
My baby!
You've no respect from me,
For your techwriting degree.
We'll still doc like a man
My honey.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
FrameMaker-to-PDF TimeSavers Assistants let you enhance & automate navigation
in PDF doc sets (chapter tabs, next/prev chapter/pg, bookmarks, popup menus);
create interactive PDF forms, rollover popups; presentations: http://www.microtype.com
Experience RoboHelp X3! This new RoboHelp release combines single sourcing,
print-quality documentation, conditional text and much more, into the most
monumental release of RoboHelp ever! http://www.ehelp.com/techwr-l
---
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.
