2. Performance-based Documentation Malcolm Graham ESN 393-2231 S954, Lab 3, CAR (043/33/H02)

3. This presentation will... Present a performance-based development model that relates information to acceptable user performance in acquiring specific skills and knowledge Describe how existing techniques from the documentation, training, IP-based product management, and the information technology fields are incorporated in the model Show how Nortel Networks information products can be developed to provide users with a truly Compelling Web Experience

4. Document design Before selecting and organizing document content, it is important to: To meet these requirements, this presentation: define content purposes identify how each purpose will be achieved know how purpose success will be verified defines the main purpose of product documentation explores adult learning and behavioral objectives describes a generic Information Category Model presents two examples that use the model

5. Let me tell you a story... Sea horse seeking fame and fortune... >Where do I want to go? >How do I get there? >Did I arrive? Relevance to selecting and designing information products?

6. Purposes information category Overall purpose? Communicate skills and knowledge to users in such a way that they will be able to demonstrate acquisition of skills and knowledge required to use product efficiently and effectively Six sub-purposes, to buy, plan, train, install, operate, maintain This category enables information to be associated with the intended use of the information

7. Adults learning... Acquisition of skills and knowledge requires that we define the required performance, conditions, and criterion of acceptable performance. This is facilitated by defining behavioral objectives for all information modules. Many adults... resist learning anything new avoid reading when using new systems, often guess how it works conditioned to have a production bias, throughput paramount rely on existing skills and knowledge

8. Behavioral objectives... Information products need to... Behavioral objectives need to... minimize reading and searching provide immediate feedback on task completion present information that links to existing skills and knowledge define small tasks for quick assimulation and feedback be clearly presented and used as criteria for success be part of hierarchy of expected behaviors use familiar language be phrased so that they can be used for usability testing

9. Examples of objectives...

10. Information categories (1 of 2) Good design is of little use if you can't find what you want when you need it. All information must map to user tasks and be provided when needed. This can be achieved by categorizing all objectives. I have identified 4 main information categories: USERS (associates information with specific types of user) PURPOSES (associates information with its intended use) TASKS (associates information with user tasks) PRIMITIVES (associates information with information type)

11. Information categories (2 of 2) USERS is the parent of PURPOSES; PURPOSES is the parent of TASKS; and TASKS is the parent of PRIMITIVES The USERS category could serve as the entry level for the other categories (via the WEB or the product API) The USERS, PURPOSES, TASKS, and PRIMITIVES categories are used to tag all modules (statically or dynamically) Hierarchical and associative relationships between each category and all modules is defined by means of tags (for example, XML tags) All information is modular; information categories define how the modules are accessed

12. Users information category Depends on the product, but generic ones could be defined; for example: This category enables information to be associated with the information needs of users >Buyer >Planner >Trainer >Installer >Operator >Maintainer

13. Tasks information category Depends on the product, but generic ones could be defined; for example: This category enables information to be associated with tasks that have to be performed by users >Operate >Configure >Describe >Monitor >Test >Order >Plan >Bill >Replace >Group >Sort >Install

14. Primitives information category >Messages >Alarms >Services >Hardware This category enables information to be associated with the type of product information needed by users Depends on the product, but generic ones could be defined; for example:

15. Information category model The following three slides present the Information Category Model and two examples that illustrate its use

16. Information Category Model

17. Example 1

18. Example 2

19. Model implementation... The model can be implemented in 3 stages: Stage A: Define behavioral objectives for each document module and organize information accordingly; identify SNMP MIB data Stage B: Categorize all objectives using generic information categories and assign all information modules to one or more categories; tag all information with the assigned categories using XML and associate with related SNMP MIB data Stage C: Perform usability testing using the objectives defined in Stage A as the evaluation criteria. Use formative usability on each module during their development and summative usability on the completed document

20. Conclusions Using a performance-based model for developing product documentation involves considering user needs from conception to completion. The resulting documentation is more likely to meet the actual information needs of users The model combines existing, tried and tested, techniques from the documentation (structure), training (objectives), and IP-based product management (SNMP MIB) fields; it can also accommodate the latest information technology (XML) The model supports multi-authorship since each module can be tested separately. The model also supports Web-based information development and the provision of specific information on a just-as-needed basis to provide users with a truly Compelling Web Experience