CRCD/EI: Speaking of Software: Integrating Communication and Documentation Techniques Into An Undergraduate Software Engineering Curriculum

谈到软件：将通信和文档技术整合到本科软件工程课程项目摘要鉴于计算机软件对我们生活的影响越来越大，软件产品的开发人员与广泛的利益相关者轻松而准确地进行交流至关重要。此外，当今的软件产品是非常复杂和多样的构件，因此在定义这种交流的格式和内容时必须非常小心。然而，在本科CICE教育中，开发人员、客户、最终用户和其他利益相关者之间共享知识的过程通常很少被讨论。拟议的项目试图通过三种方式加强对软件工程本科学生的教育：启发他们了解其他利益相关者的需求和知识，使他们能够与这些利益相关者进行积极的沟通，以及使他们能够准确有效地进行沟通。课程材料将借鉴技术传播方面的研究成果，利用情景将最终用户和其他传统上被边缘化的利益攸关方吸引到开发进程中来。该项目还将使用新的软件工程工具和方法来记录需求和设计。问题框架将用于组织和分析软件问题，抽象状态机将用于设计文档、原型和验证。该项目汇集了技术交流和计算机科学方面的专家，以产生软件工程教育的新方法。从目前的软件工程研究中提取的材料还没有在很大程度上被带入课堂。新课程教材的实施和评估将在不同的环境中进行，由活跃于研究和本科教育经验的教职员工进行。本项目中提出的课程改进将有助于培养更有效的软件工程师和更好的软件。在与客户和用户进行仔细、深入的沟通方面进行培训，将通过更大的可用性和更少的缺陷来提高客户满意度。向开发人员灌输识字、精确的文档将促进开发人员之间的理解并简化维护。此外，拟议的项目还将活跃CISE课程，并为未来的软件工程师提供有用的技能。让学生参与积极的交流将使他们更专注于自己的职业，不那么容易受挫和精疲力竭。对真正的软件问题的关注将吸引那些更喜欢“有目的的计算”的学生，并对cise教育中常见的以计算机为中心的观念感到幻灭。最近的研究表明，许多女学生符合这一描述，提供现实申请的动机可能有助于在cise学科中招聘和留住更多女性。

Speaking of software:Integrating communication and documentation techniques into an undergraduate software engineering curriculumProject summaryGiven the ever-increasing influence of computer software on our lives, it is crucial for the developers of software products to communicate easily and precisely with a wide range of stakeholders. Furthermore, today's software products are artifacts of great complexity and variety, so great care must be taken in defining the format and content of such communication. Typically, however, the process of sharing knowledge between developer, customer, end user, and other stakeholders is discussed very little in undergraduate CISE education.The proposed project seeks to enhance the education of undergraduate software engineering students in three ways: enlightening them about the needs and knowledge of other stakeholders, empowering them to engage in active communication with these stakeholders, and enabling them to communicate precisely and effectively. Curricular materials will draw from results from research in technical communication, using scenarios to draw end users and other traditionally marginalized stakeholders into the development process. The project will also use new software engineering tools and methodologies for documenting requirements and design. Problem frames will be used to structure and analyze software problems, and Abstract State Machines will be used for design documentation, prototyping, and verification.Intellectual merit. This project brings together experts in technical communication and computer science to generate novel approaches to software engineering education. The material drawn from current software engineering research has not yet been brought into the classroom to any significant extent. The implementation and evaluation of the new curricular materials are to be performed in a variety of settings, by faculty members active in research and experienced in undergraduate education.Broader impact. The curricular enhancements proposed in this project will help to produce more effective software engineers and better software. Training in careful, intensive communication with customers and users will increase customer satisfaction through greater usability and fewer defects. Instilling a discipline of literate, precise documentation will foster understanding among developers and simplify maintenance.In addition, the proposed project will enliven the CISE curriculum and equip future software engineers with useful skills. Empowering students to participate in active communication will make them more engaged in their profession and less prone to frustration and burnout. The focus on real software problems will attract those students who prefer "computing with a purpose" and become disillusioned with the usual computer-centrism of CISE education. Recent studies have indicated that many female students fit this description, and that providing the motivation of realistic applications may help recruit and retain more women in CISE disciplines.