Showing 1–2 of 2 results for author: Clause, J

Shortcomings of Class-level Documentation: A Survey

Authors: Jianwei Wu, **ing Yu, David Shepherd, James Clause

Abstract: To better understand the shortcomings of class-level documentation, we conducted a survey of 167 experienced software developers. The survey focused on the participants' programming-related information needs and how often class-level documentation satisfies such needs. To better understand the shortcomings of class-level documentation, we conducted a survey of 167 experienced software developers. The survey focused on the participants' programming-related information needs and how often class-level documentation satisfies such needs. △ Less

Submitted 5 May, 2022; originally announced May 2022.

A Pattern-based Approach to Detect and Improve Non-descriptive Test Names

Authors: Jianwei Wu, James Clause

Abstract: Unit tests are an important artifact that supports the software development process in several ways. For example, when a test fails, its name can provide the first step towards understanding the purpose of the test. Unfortunately, unit tests often lack descriptive names. In this paper, we propose a new, pattern-based approach that can help developers improve the quality of test names of JUnit test… ▽ More Unit tests are an important artifact that supports the software development process in several ways. For example, when a test fails, its name can provide the first step towards understanding the purpose of the test. Unfortunately, unit tests often lack descriptive names. In this paper, we propose a new, pattern-based approach that can help developers improve the quality of test names of JUnit tests by making them more descriptive. It does this by detecting non-descriptive test names and in some cases, providing additional information about how the name can be improved. Our approach was assessed using an empirical evaluation on 34352 JUnit tests. The results of the evaluation show that the approach is feasible, accurate, and useful at discriminating descriptive and non-descriptive names with a 95% true-positive rate. △ Less

Submitted 11 May, 2020; originally announced May 2020.

Comments: Accepted by The Journal of Systems & Software

Journal ref: The Journal of Systems & Software 168C (2020) 110639