← Prev in month ← Prev in thread

definition of Help

From
Bruce Nevin (bnevin) <>
Date
2011-01-20T21:43:16+00:00
ID
Thread
definition of Help
I see http://wiki.oasis-open.org/dita-adoption/DITA_Help_Technologies_Guide_Allocation 
that I am on the hook for a definition of Help. Here's a quick draft for 
comment.

 

 

What is Online Help?

  
User assistance documentation.

  
Modular--relatively short topics, in some forms 
  (e.g. rollover) smaller than a topic.

  
Delivered online by software, either locally or on 
  the web.

  
Usually integrated with the UI of the software that 
  it documents.

  
    
May help with a user domain separate from its 
    software vehicle.

    
Is a kiosk or a guide to an exhibit online 
    Help?

  
May be context sensitive (linked to user action or 
  location or the state of the application).

These characteristics usually compel the Help 
developer to address the problem of relevance that is central to all 
documentation: access to the relevant topic from the context of 
need.

 

All user assistance documentation is part of the user 
interface; a Help system only more obviously so.

    
/B
← Prev in month ← Prev in thread