atw: Support for TWs in TechRepublic
- From: Allan Charlton <allancharlton@xxxxxxxxxxxxxx>
- To: austechwriter@xxxxxxxxxxxxx
- Date: Thu, 21 May 2009 09:30:35 +1000
Folks There's a refreshing article in TechRepublic today. "10 ways developers can ease user frustrations" Number 7 is Documentation. It says:"We all know how much developers dislike writing documentation. So we tell ourselves that the application is so easy to use, “only an idiot would need a manual.” There are two problems with this thinking. The first is that the world has plenty of idiots in it. The second is that we are usually wrong about how easy the application is to use. If your organization has a technical writer to create the documentation, involve that person from the get-go; the top complaint I hear from technical writers is that they are handed a nearly finished product and told to document it, with little insight into how it actually should be used. If you do not have a technical writer available, you will really need to work hard to make sure that the documentation does not merely state the obvious and is written in a way that will be helpful to end users who are unfamiliar with your application."
Read the whole entry at http://downloads.techrepublic.com.com/abstract.aspx?docid=975049&tag=nl.e101 Allan ************************************************** To view the austechwriter archives, go to www.freelists.org/archives/austechwriter To unsubscribe, send a message to austechwriter-request@xxxxxxxxxxxxx with "unsubscribe" in the Subject field (without quotes). To manage your subscription (e.g., set and unset DIGEST and VACATION modes) go to www.freelists.org/list/austechwriter To contact the list administrator, send a message to austechwriter-admins@xxxxxxxxxxxxx **************************************************
Other related posts:
- » atw: Support for TWs in TechRepublic - Allan Charlton