TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
On 07/25/2001 1:02 PM, Kelly Williamson (kwcwtech -at- iwaynet -dot- net) wrote:
>What you do need to do is test the software/product
>and make sure it actually does what you think it's going to do. My last
>project was a Web application. While I'm extremely competent with HTML, I
>never once needed to look at the code to describe to the users how to use
>the application.
In this example, a quick view of the underlying code could tell you, for
example, how many characters a user can enter into a field. You could
also ask the developer (who may or may not know, and who most likely
would just look at the code) or type characters until the product stops
you, but it's easier and quicker to check the code yourself.
If you didn't know HTML, you might be able to document the product, but
you'd be doing it either with less detail or less efficiently.
In this example, more knowledge leads to more efficiency, because you
depend less on SMEs to tell you what you need to know.
Bottom line is that if you know too little about a product, you are
*incapable* of making a reasoned decision about what to include and
exclude, because you don't know the full set of information that could be
included.
----->Mike
________________________________________________________________
stockman -at- jagunet -dot- com -- AOL and AOL Instant Messenger:MStockman
*** Deva(tm) Tools for Dreamweaver and Deva(tm) Search ***
Build Contents, Indexes, and Search for Web Sites and Help Systems
Available now at http://www.devahelp.com or info -at- devahelp -dot- com
Learn about tools and technologies for user assistance developers at
The Help Technology Conference, August 21-24 in Boston, MA
Details and online registration at http://www.SolutionsEvents.com
---
You are currently subscribed to techwr-l as: archive -at- raycomm -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.
