Re: Article: Document or else

[Stuart Burnfield <sburnf -at- au1 -dot- ibm -dot- com>]

The independent trustee in the case called that material "totally unfit"
for use by rival software makers, and a consulting firm for the commission
called it "entirely inadequate," "devoted to obsolete functionality" and
"self-contradictory."

   After what Brad Smith, Microsoft's general counsel and lead attorney on
   the European case, called a "breakthrough" hearing in Brussels in March,
   Microsoft says it finally knows what the commission wants and it is
   rushing to provide it.

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

Stuart

austechwriter-bounce -at- freelists -dot- org wrote on 03/07/2006 08:40:12 AM:
> 'Guilty' pleasure??? Nah *lol*
>
> Although I did wince at the idea of the engineers 'banging out'
> documentation... thank God I'm not likely to ever have to read it, I'd
> probably cry!
>
> - Naomi

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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.