On Mon, May 10, 2010 at 1:48 AM, Vishnu <greens...@mail.com> wrote: > 2. How much of these domain knowledge should go into a user manual? Will > users benefit if the business context or logic is described in detail in a > manual? Or will the user more interested in finishing a task, rather than > reading the context and other things?
It depends on who the audience is. I write a suite of books for contact center administrators, supervisors, and agents who use our software to manage the contact center. Agents just want to know how to do specific tasks (for example, transfer or conference a call, or enter reason codes). They do not care about how that is accomplished by the software, or why things work the way they do. They don't have time for theory, they just need to know which buttons to click to get their job done. Admins, and to a certain extent, supervisors, need to know much more about how the system works and how our software accomplishes what it does in order to fully understand the tools they use. So the Admin Guide gets much more explanatory text in it besides all the procedures for using the software. Nancy Kaminski ______________________________________________ ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or HTML and publish to the Web, Help systems or printed manuals. Download Free Trial. www.doctohelp.comhttp://www.techcommpros.com/componentone/ Interactive 3D Documentation Parts catalogs, animated instructions, and more. www.i3deverywhere.com _______________________________________________ Technical Communication Professionals Post a message to the list: email t...@techcommpros.com. Subscribe, unsubscribe, archives, account options, list info: http://techcommpros.com/mailman/listinfo/tcp_techcommpros.com Subscribe (email): send a blank message to tcp-subscr...@techcommpros.com Unsubscribe (email): send a blank message to tcp-unsubscr...@techcommpros.com Need help? Contact listad...@techcommpros.com Get the TCP whole experience! http://www.techcommpros.com