Re: Article: Document or else

Subject: Re: Article: Document or else
From: Ned Bedinger <doc -at- edwordsmith -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Sun, 02 Jul 2006 20:55:09 -0700

Stuart Burnfield wrote:

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:

http://en.wikipedia.org/wiki/Schadenfreude


Ned Bedinger
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.


References:
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


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


Sponsored Ads