Re: Article: Document or else
It's an interesting thought: if you've been compelled to provide
information that you're desperate not to reveal, how would you go about
documenting in a way that made it useless to competitors, while complying
with the letter of the law?
It could almost be an exercise in anti-techwriting--turn all the principles
of good writing on their head:
- provide hardcopy only in a font that's difficult to read or scan
- no index, TOC, glossary or cross-refs
- little or no topic structure (no chapters or subheadings)
- no template and style guide and no editorial review, so no consistency
If active sabotage seems too Machiavellian, you could probably achieve the
same effect just by making 300 unwilling junior software engineers work
overtime on the documentation for weeks on end...
In this light, I'd be skipping past the guilty pleasures to dive headlong into that good old-fashioned German schadenfreude. See wikipedia's translation:
doc -at- edwordsmith -dot- com
WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content delivery. Try it today!. http://www.webworks.com/techwr-l
Doc-To-Help includes a one-click RoboHelp project converter. It's that easy. Watch the demo at http://www.DocToHelp.com/TechwrlList
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-
To unsubscribe send a blank email to techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40infoinfocus.com
To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.
Re: Article: Document or else: From: Stuart Burnfield
Previous by Author:
Outlook received "Today, Yesterday, Sunday..."
Next by Author: Re: Standard Doc Review Cycle-Online/Print Help
Previous by Thread: Re: Article: Document or else
Next by Thread: RE: Article: Document or else
Search our Technical Writing Archives & Magazine