Re: Longhorn - Tech writing changes

Subject: Re: Longhorn - Tech writing changes
From: "Mike O." <obie1121 -at- yahoo -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 09 Jul 2004 09:33:50 -0400


chevotilburg -at- postmaster -dot- co -dot- uk wrote:

But many authors do fine. This quote sums up UI/UA design for me. "The
goal of the UI designer is to put the Help author out of a job". This from
a Microsoft Help author and team leader who I highly respect. You don't
need to document everything."

Maybe that'll work for Microsoft. Every time they release a major version of Windows they create a more and more minimal documentation paradigm. They can afford to do that because they are in a league of their own; they have a whole industry of third-party trainers and documentors supporting Microsoft products. And that's probably as it should be.

But as long as corporate PHBs and customers continue to write contracts that demand "complete documentation," us general corporate/commercial writers will just keep on truckin'.

Actually I don't really care if Microsoft documents every field in every dialog box in Windows, as long as the technical docs are good. AFAIK there are still lots of critical functions in the NT API that remain undocumented. And they never did publish a decent doc on the Word object model.

Mike O.

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

ROBOHELP X5: Featuring Word 2003 support, Content Management, Multi-Author
support, PDF and XML support and much more!
TRY IT TODAY at http://www.macromedia.com/go/techwrl

WEBWORKS FINALDRAFT: New! Document review system for Word and FrameMaker
authors. Automatic browser-based drafts with unlimited reviewers. Full
online discussions -- no Web server needed! http://www.webworks.com/techwr-l
---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -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.



Previous by Author: Re: Another FrameMaker question
Next by Author: Re: 'Old fashioned' Tech Writers
Previous by Thread: Re: Longhorn - Tech writing changes
Next by Thread: Re: Longhorn - Tech writing changes


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


Sponsored Ads