1. Delivering the System 中国科学技术大学软件学院 孟宁 2012 年 11 月

2. Contents 10.1 Training 10.2 Documentation What should we do in the process of Delivering the System ?

3. Chapter 10: Delivering the System ♦It is more than just putting the system in place ♦It is also helping users to understand and feel comfortable with the system –Training –Documentation

4. 10.1 Training Types of People Who Use a System ♦Users: exercise the main system functions ♦Operators: perform supplementary functions –create back up copies of data files –define who has access to the system

5. 10.1 Training User and Operators Functions User FunctionsOperator Functions Manipulating data filesGranting user access Simulating activitiesGranting file access Analyzing dataPerforming backups Communicating dataInstalling new devices Drawing graphs and chartsInstalling new software Recovering damage files

6. 10.1 Training Types of Training ♦User training –Introduces the primary functions ♦Operator training –Focuses on support functions and addresses how the system works rather than what the system does –Runs in two levels how to bring up and run the new system how to support users ♦Special training needs

7. 10.1 Training Training Aids ♦Documents –Formal documentation, manuals –A small percentages of the users read them ♦Icons and online help –Metaphors (for objects and functions) –Online manuals provide hypertext links ♦Demonstrations and classes –More individualized, more dynamic; uses of multimedia (hearing, seeing) ♦Expert users (and trained individuals) –Role models can be convincing

8. 10.1 Training Guidelines for Training ♦Understand the personal preferences, work styles, and organizational pressures ♦Need to accommodate different types of students – individualized system ♦Divide a training class or demonstration into presentation units with short, limited scope ♦Determines the type of training based on the location of the students –Hundreds of students all over? Use web-based training

9. 10.2 Documentation Considering the Audience ♦Need to understand the intended audience –Users –Operators –Customer staff –Other member of development team ♦Design different document for different audience –Include a “gentle” introduction

10. 10.2 Documentation Types of Documentations ♦User’s manual ♦Operator’s manual ♦General system guide ♦Tutorials and automated overviews ♦Other documentation: Programmer guide

11. 10.2 Documentation User’s Manuals ♦Beginning with the general purpose, and progressing to detailed functional description –system’s purpose or objectives –system’s capabilities and functions –system features, characteristics, advantages

12. 10.2 Documentation Operator’s Manuals ♦Hardware and software configuration ♦Methods of granting and denying access to a user ♦Procedures for adding and removing peripherals from system ♦Techniques for duplicating or backing up files and documents

13. 10.2 Documentation General System Guide ♦The system details in terms the customer can understand ♦The system hardware and software configuration ♦The philosophy behind the system’s construction ♦Provide cross-referencing

14. 10.2 Documentation Tutorials and Automated System Overviews ♦Multimedia-based, step-by-step, automated tutorials

15. 10.2 Documentation Other Documentation: Programmer’s Guide ♦An overview of how the software and hardware are configured ♦Software components detailed and their functions performed ♦System support functions ♦System enhancements

16. 10.2 Documentation User Helps and Troubleshooting ♦Failure message reference guide ♦Online helps files ♦Quick reference guide (a quick summary of primary uses, configuration)

17. 谢谢大家！ References 软件工程 - 理论与实践（第四版 影印版） Software Engineering: Theory and Practice (Fourth Edition),Shari Lawrence Pfleeger,Joanne M. Atlee, 高等教育出版社 软件工程 - 理论与实践（第四版） Software Engineering: Theory and Practice (Fourth Edition),Shari Lawrence Pfleeger,Joanne M. Atlee, 杨卫 东译, 人民邮电出版社 软件工程 — 实践者的研究方法（ Software Engineering-A Practitioner’s Approach ） ; ( 美 ) Roger S. Pressman 著； 机械工业出版社 ISBN ： 7-111- 07282-0 http://code.google.com/p/advancedsoftwareengineering/