首页> 外文期刊>ACM transactions on software engineering and methodology >Documenting Design-Pattern Instances: A Family of Experiments on Source-Code Comprehensibility
【24h】

Documenting Design-Pattern Instances: A Family of Experiments on Source-Code Comprehensibility

机译:记录设计模式实例:有关源代码可理解性的一系列实验

获取原文
获取原文并翻译 | 示例

摘要

Design patterns are recognized as a means to improve software maintenance by furnishing an explicit specification of class and object interactions and their underlying intent [Gamma et al. 1995]. Only a few empirical investigations have been conducted to assess whether the kind of documentation for design patterns implemented in source code affects its comprehensibility. To investigate this aspect, we conducted a family of four controlled experiments with 88 participants having different experience (i.e., professionals and Bachelor, Master, and PhD students). In each experiment, the participants were divided into three groups and asked to comprehend a nontrivial chunk of an open-source software system. Depending on the group, each participant was, or was not, provided with graphical or textual representations of the design patterns implemented within the source code. We graphically documented design-pattern instances with UML class diagrams. Textually documented instances are directly reported source code as comments. Our results indicate that documenting design-pattern instances yields an improvement in correctness of understanding source code for those participants with an adequate level of experience.
机译:通过提供明确的类和对象交互及其潜在意图的规范,设计模式被认为是改善软件维护的一种手段[Gamma等。 1995]。仅进行了一些实证研究,以评估在源代码中实现的设计模式文档的种类是否会影响其可理解性。为了对此方面进行调查,我们进行了四组受控实验,共有88名具有不同经验的参与者(即专业人士以及学士,硕士和博士学位学生)参加。在每个实验中,参与者分为三组,并要求他们理解一个开源软件系统的重要组成部分。根据组的不同,是否为每个参与者提供了源代码中实现的设计模式的图形或文本表示。我们使用UML类图以图形方式记录了设计模式实例。文本记录的实例直接以注释形式报告源代码。我们的结果表明,记录设计模式实例对于具有足够经验水平的那些参与者,可以更好地理解源代码。

著录项

相似文献

  • 外文文献
  • 中文文献
  • 专利
获取原文

客服邮箱:kefu@zhangqiaokeyan.com

京公网安备:11010802029741号 ICP备案号:京ICP备15016152号-6 六维联合信息科技 (北京) 有限公司©版权所有
  • 客服微信

  • 服务号