面向案例驱动软件撰写能力培养研究.docVIP

面向案例驱动软件撰写能力培养研究 　　摘 要 为了改善软件专业学生重编程轻文档的现状，采用面向案例驱动的软件文档撰写教学方法。通过系统的软件文档写作实践，培养学生撰写用户文档、开发文档和管理文档的技能，锻炼学生编制、管理和维护软件文档的能力，同时也为提高学生的毕业论文撰写水平奠定基础。 　　关键词 软件文档写作；案例驱动；毕业论文 　　中图分类号：G642.0 文献标识码：B 　　文章编号：1671-489X（2017）18-0092-03 　　Research on Case-Driven Software Document Writing Ability Training//LIU Haiyan， WANG Xiaochi， ZHANG Lijie， TAO Yong-peng 　　Abstract In order to improve the current situation of emphasizing programming and despising documents for software majors’ stu-dents， the case-driven teaching method is adopted in the practice of software document writing. Through the system practice of software document writing， improve students’ skills to write user documents， development documents and management documents. Train the abi- 　　lity of students to develop， manage and maintain software docu-ments. At the same time， lay the foundation for improving the gra-duation thesis writing level of students. 　　Key words software document writing； case-driven； graduation thesis 　　1 前言 　　?算机软件由程序、数据和文档组成，文档是计算机软件产品的重要组成部分。文档记录目标系统各个阶段的设计思想和研究成果，不仅是项目管理的依据、技术交流的语言、软件质量的保证、人员培训的资料、软件维护的支持、软件历史的记载和档案，而且在开发人员、维护人员、管理人员、用户与计算机之间起到桥梁作用[1]。如果无开发计划、无文档地直接面对计算机编程，软件开发过程中的可见度很低，就会导致软件开发周期加长，开发和维护成本提高，软件质量得不到保障。因此，近年来越来越多的软件企业意识到软件文档撰写的重要性。 　　软件专业的学生需要了解软件文档在软件开发过程中的作用，了解各种文档编制规范，熟悉软件文档的编写方法，能够根据项目要求，初步具备按照国家标准和国际规范撰写软件生命周期各阶段文档的能力。 　　2 软件文档写作教学内容 　　软件文档写作课程主要介绍软件文档的基本概念、标准、表达、要求和管理维护，以及开发文档、管理文档和用户文档的撰写内容和方法，主要教学内容如表1所示。各个章节主要的学习要求简述如下。 　　软件文档概述 要求学生了解软件文档的概念，理解软件文档的作用，了解软件文档的分类，了解软件文档与使用者以及软件文档编制与软件生命周期的关系。 　　软件文档标准 要求学生了解软件工程标准化 　　概念，了解软件工程标准编制的层次，了解中国的软件标准，了解ISO9000、CMM国际标准。 　　软件文档表达 要求学生了解软件文档的表达载体和涉众，理解软件文档编制的规则，理解软件文档编制的质量要求。 　　软件文档写作要求 要求学生了解软件编档的灵活性，掌握如何制订软件文档计划，理解软件编档步骤，熟悉建立软件编档规程。 　　软件开发文档 要求学生了解软件开发文档编制的内容，掌握主要软件文档的撰写，理解编码规约，掌握测试用例的设计方法。 　　软件管理文档 要求学生了解常用管理文档，了解项目开发计划的制订，掌握文档评审结果和测试结果的记录方法，掌握开发进度报告和周报的撰写，掌握软件配置管理的主要内容，了解项目风险的标识，了解项目开发总结报告的编制。 　　软件用户文档 要求学生了解编制软件用户文档的基本要求，掌握软件用户使用说明文档的编制。 　　软件文档管理 要求学生了解软件文档的管理和维护方法，了解软件文档管理的常用工具。 　　3 面向案例驱动的软件文档写作实践