The Types, Roles, and Practices of Documentation in Data Analytics Open Source Software Libraries

被引:17
|
作者
Geiger, R. Stuart [1 ]
Varoquaux, Nelle [1 ,2 ]
Mazel-Cabasse, Charlotte [1 ]
Holdgraf, Chris [1 ,3 ]
机构
[1] Univ Calif Berkeley, Berkeley Inst Data Sci, 190 Doe Lib, Berkeley, CA 94730 USA
[2] Univ Calif Berkeley, Dept Stat, Berkeley Inst Data Sci, Berkeley, CA 94720 USA
[3] Univ Calif Berkeley, Helen Wills Neurosci Inst, Berkeley Inst Data Sci, Berkeley, CA 94720 USA
来源
COMPUTER SUPPORTED COOPERATIVE WORK-THE JOURNAL OF COLLABORATIVE COMPUTING AND WORK PRACTICES | 2018年 / 27卷 / 3-6期
关键词
Documentation; Standards; Invisible work; Motivations; Peer production; Collaboration; Infrastructure; Ethnography; Open source; ORGANIZATIONAL PROCESS; WORK;
D O I
10.1007/s10606-018-9333-1
中图分类号
TP39 [计算机的应用];
学科分类号
081203 ; 0835 ;
摘要
Computational research and data analytics increasingly relies on complex ecosystems of open source software (OSS) "libraries" - curated collections of reusable code that programmers import to perform a specific task. Software documentation for these libraries is crucial in helping programmers/analysts know what libraries are available and how to use them. Yet documentation for open source software libraries is widely considered low-quality. This article is a collaboration between CSCW researchers and contributors to data analytics OSS libraries, based on ethnographic fieldwork and qualitative interviews. We examine several issues around the formats, practices, and challenges around documentation in these largely volunteer-based projects. There are many different kinds and formats of documentation that exist around such libraries, which play a variety of educational, promotional, and organizational roles. The work behind documentation is similarly multifaceted, including writing, reviewing, maintaining, and organizing documentation. Different aspects of documentation work require contributors to have different sets of skills and overcome various social and technical barriers. Finally, most of our interviewees do not report high levels of intrinsic enjoyment for doing documentation work (compared to writing code). Their motivation is affected by personal and project-specific factors, such as the perceived level of credit for doing documentation work versus more 'technical' tasks like adding new features or fixing bugs. In studying documentation work for data analytics OSS libraries, we gain a new window into the changing practices of data-intensive research, as well as help practitioners better understand how to support this often invisible and infrastructural work in their projects.
引用
收藏
页码:767 / 802
页数:36
相关论文
共 50 条
  • [41] Utilization of Open Source Software in Nigeria Academic Libraries: Matters Arising
    Kolawole, L. Folasade
    Oladokun, Taofeek A.
    CATALOGING & CLASSIFICATION QUARTERLY, 2021, 59 (04) : 399 - 407
  • [42] Zherlock: An open source data analysis software
    Alsberg, BK
    Kirkhus, L
    Hagen, R
    Knudsen, O
    Tangstad, T
    Anderssen, E
    SAR AND QSAR IN ENVIRONMENTAL RESEARCH, 2003, 14 (5-6) : 349 - 360
  • [43] Open Source Software for Spatial Data Science
    Anselin, Luc
    Rey, Sergio J.
    GEOGRAPHICAL ANALYSIS, 2022, 54 (03) : 429 - 438
  • [44] Economics of open source library software: evidences from Indian libraries
    Kampa, Raj Kishor
    Kaushik, Purnima
    GLOBAL KNOWLEDGE MEMORY AND COMMUNICATION, 2019, 68 (4-5) : 337 - 355
  • [45] The Role of Open Source Software to Create Digital Libraries and Standards Assessment
    ALbeladi, Salmah Salem
    INTERNATIONAL JOURNAL OF COMPUTER SCIENCE AND NETWORK SECURITY, 2021, 21 (07): : 241 - 248
  • [46] Issues and lessons learned in open source software adoption in Pakistani libraries
    Rafiq, Muhammad
    Ameen, Kanwal
    ELECTRONIC LIBRARY, 2009, 27 (04): : 601 - 610
  • [47] An empirical examination of open source software adoption in US public libraries
    Choi, Namjoo
    ELECTRONIC LIBRARY, 2021, 39 (05): : 695 - 712
  • [48] Using open source software for digital libraries A case study of CUSAT
    Cherukodan, Surendran
    Kumar, G. Santhosh
    Kabir, S. Humayoon
    ELECTRONIC LIBRARY, 2013, 31 (02): : 217 - 225
  • [49] Assessing exception handling testing practices in open-source libraries
    Luan P. Lima
    Lincoln S. Rocha
    Carla I. M. Bezerra
    Matheus Paixao
    Empirical Software Engineering, 2021, 26
  • [50] Assessing exception handling testing practices in open-source libraries
    Lima, Luan P.
    Rocha, Lincoln S.
    Bezerra, Carla I. M.
    Paixao, Matheus
    EMPIRICAL SOFTWARE ENGINEERING, 2021, 26 (05)