Do CONTRIBUTING Files Provide Information about OSS Newcomers’ Onboarding Barriers?
Do CONTRIBUTING Files Provide Information about OSS Newcomers’ Onboarding Barriers?
复制标题
贡献文件是否提供有关 OSS 新人入职障碍的信息？
DOI：
10.1145/3611643.3616288
复制
发表时间：
2023
期刊：
影响因子：
--
通讯作者：
Steinmacher, Igor
中科院分区：
文献类型：
--
作者：
Fronchetti, Felipe;Shepherd, David C.;Wiese, Igor;Treude, Christoph;Gerosa, Marco Aurélio;Steinmacher, Igor
有效地引导新来者对于开源项目的成功至关重要。这些项目通常在其“贡献”文件中提供入职指南（例如，CONTRIBUTING.md on GitHub）。例如，这些文件解释了如何查找打开的任务、实现解决方案以及提交代码以供审阅。然而，这些文件通常不遵循标准结构，可能太大，并且错过新手通常发现的障碍。在本文中，我们提出了一种自动化的方法来解析这些贡献文件，并评估它们如何解决入职障碍。我们根据文献中的入职障碍模型对文件样本进行手动分类，训练机器学习分类器，自动预测每个段落的类别（精度：0.655，召回率：0.662），并调查开发人员调查他们对预测充分性的看法（75%的预测被认为是充分的）。我们发现，贡献文件通常不会涵盖新人面临的障碍（52%的分析项目至少错过了新人面临的6个障碍中的3个; 84%的项目至少错过了2个）。我们的分析还显示，关于选择任务和与社区对话的信息，这两个新来者面临的最常见的障碍，在超过75%的项目中被忽视了。我们将我们的分类器作为一个在线服务提供，它可以分析给定CONTRIBUTING文件的内容。我们的方法可以帮助社区建设者识别他们维护的项目生态系统中缺失的信息，新来者可以了解在贡献文件中期望的内容。
Effectively onboarding newcomers is essential for the success of open source projects. These projects often provide onboarding guidelines in their ’CONTRIBUTING’ files (e.g., CONTRIBUTING.md on GitHub). These files explain, for example, how to find open tasks, implement solutions, and submit code for review. However, these files often do not follow a standard structure, can be too large, and miss barriers commonly found by newcomers. In this paper, we propose an automated approach to parse these CONTRIBUTING files and assess how they address onboarding barriers. We manually classified a sample of files according to a model of onboarding barriers from the literature, trained a machine learning classifier that automatically predicts the categories of each paragraph (precision: 0.655, recall: 0.662), and surveyed developers to investigate their perspective of the predictions’ adequacy (75% of the predictions were considered adequate). We found that CONTRIBUTING files typically do not cover the barriers newcomers face (52% of the analyzed projects missed at least 3 out of the 6 barriers faced by newcomers; 84% missed at least 2). Our analysis also revealed that information about choosing a task and talking with the community, two of the most recurrent barriers newcomers face, are neglected in more than 75% of the projects. We made available our classifier as an online service that analyzes the content of a given CONTRIBUTING file. Our approach may help community builders identify missing information in the project ecosystem they maintain and newcomers can understand what to expect in CONTRIBUTING files.
登录
查看更多内容
除了漂亮的图片：检查代码可视化对开源新手的好处
DOI：
10.1109/vissof.2009.5336433
发表时间：
2009
期刊：
2009 5th IEEE International Workshop on Visualizing Software for Understanding and Analysis
影响因子：
--
作者：
Yunrim Park;Carlos Jensen
通讯作者：
Carlos Jensen
是什么吸引新人加入 OSS 项目？
DOI：
--
发表时间：
2019
期刊：
International Conference on Open Source Systems
影响因子：
--
作者：
Felipe Fronchetti;I. Wiese;G. Pinto;Igor Steinmacher
通讯作者：
Igor Steinmacher
如何运行一个成功的自由软件项目 - 生产开源软件
DOI：
--
发表时间：
2009
期刊：
影响因子：
--
作者：
K. Fogel
通讯作者：
K. Fogel
让我进来：新人成功加入开源项目的指南
影响因子：
3.3
作者：
Igor Steinmacher;Christoph Treude;M. Gerosa
通讯作者：
M. Gerosa
DOI：
10.1145/2652524.2652540
发表时间：
2014-09
期刊：
2015 IEEE 22nd International Conference on Software Analysis, Evolution, and Reengineering (SANER)
影响因子：
--
作者：
Fabian Fagerholm;Alejandro Sánchez Guinea;Jürgen Münch;Jay Borenstein
通讯作者：
Fabian Fagerholm;Alejandro Sánchez Guinea;Jürgen Münch;Jay Borenstein