Understanding the Characteristics of Visual Contents in Open Source Issue Discussions: A Case Study of Jupyter Notebook

Vishakha Agrawal,Yong-Han Lin,Jinghui Cheng

DOI: https://doi.org/10.1145/3530019.3534082

2022-04-28

Abstract:Most issue tracking systems for open source software (OSS) development include features for community members to embed visual contents, such as images and videos, to enhance the discussion. Although playing an important role, there is little knowledge on the characteristics of the visual contents to support their use. To address this gap, we conducted an empirical study on the Jupyter Notebook project. We found that more than a quarter of the issues in the Jupyter Notebook project included visual contents. Additionally, issues that had visual contents in the comments but not in the issue posts tended to have a longer discussion and to involve a larger number of discussants. In our qualitative analysis, we identified eight types of visual contents in our sample, with about 60% including screenshots or mockups of the main product. We also found that visual contents served diverse purposes, touching both problem and solution spaces of the issues. Our effort serves as an important step towards a comprehensive understanding of the characteristics of visual contents in OSS issue discussions. Our results provided several design implications for issue tracking systems to better facilitate the use of visual contents.

Software Engineering,Human-Computer Interaction

What problem does this paper attempt to address?

The paper attempts to address the lack of systematic research on the characteristics and usage of visual content (such as images and videos) in issue discussions within open source software (OSS) projects. Although this visual content plays a significant role in issue discussions, there is currently limited understanding of its characteristics, especially in supporting its effective use. Therefore, the authors aim to fill this gap through empirical research, specifically investigating the following questions:

1. **Frequency of visual content usage in issue discussions**: The researchers aim to understand how common the use of visual content is in issue discussions.
2. **Association between visual content usage and issue characteristics**: The researchers explore whether the use of visual content is related to factors such as the status of the issue, the length of the discussion, and the number of participants involved in the discussion.
3. **Common types of visual content**: The researchers aim to identify the common types of visual content in issue tracking systems through analysis.
4. **Common purposes for posting visual content**: The researchers aim to understand the main purposes for which discussion participants post visual content in issue discussions.

Through the study of these questions, the authors aim to comprehensively understand the role of visual content in open source issue discussions and provide design recommendations for improving the functionality of issue tracking systems. This not only helps to enhance the discussion efficiency of community members but also promotes the development of new issue tracking tools that better utilize this important communication medium.