labarba / oss_in_rr

Defining the role of open source software in research reproducibility
4 stars 0 forks source link

Reviewer 1 #1

Open labarba opened 2 years ago

labarba commented 2 years ago

Recommendation: Accept With No Changes

Comments: I have no major criticism of the article and would like to instead offer just some small comments and suggestions for places where the scope could be broadened or shifted somewhat. But I don't consider any of my comments crucial.

Additional Questions:

  1. How relevant is this manuscript to the readers of this periodical? Please explain your rating in the Detailed Comments section.: Don’t know the readership

  2. Please summarize what you view as the key point(s) of the manuscript and the importance of the content to the readers of this periodical. If you don't have any comments, please type No Comments.: This paper links the praxis of open source software with the goals of computational reproducibility.

  3. Is the manuscript technically sound? Please explain your answer in the Detailed Comments section.: Yes

  4. What do you see as this manuscript's contribution to the literature in this field?: Using Winograd and Flores concept of connectivity, the article reaches the conclusion that reproducibility is not primarily a technical issue, but a socio-technical one, revolving around creating and maintaining trust through conversation. Along the way, the paper does nicely in providing an explanation of some of the basic tenets of open-source software development and the mechanics of the conversations that underlie these mechanics, and at the same time in providing a framework for thinking about how these mechanics create a particular substrate for reproducible research, especially within computational science.

  5. What do you see as the strongest aspect of this manuscript?: Novel framework for thinking about the links between open-source software and broader computational reproducibility.

  6. What do you see as the weakest aspect of this manuscript?:

  7. Does the manuscript contain sufficient and appropriate references? Please elaborate in the Detailed Comments section.: References are sufficient and appropriate

  8. Does the introduction state the objectives of the manuscript in terms that encourage the reader to read on? Please explain your answer in the Detailed Comments section.:

  9. How would you rate the organization of the manuscript? Please elaborate in the Detailed Comments section.:

  10. Is the length of the manuscript appropriate for the topic? Please elaborate in the Detailed Comments section.: Satisfactory

  11. Please rate the readability of this manuscript in the Detailed Comments section.: Easy to read

Please rate the manuscript. Explain your choice in the Detailed Comments section.: Excellent

labarba commented 2 years ago
labarba commented 2 years ago
labarba commented 2 years ago

This raises some question about the conclusion reached at the end of the section "Open-source software in research" -- suggesting instead that there is a partial overlap between reproducibility and reusability

I'm unclear about the point the referee is making here. The third paragraph of that section in the manuscript makes the point that transparency (making code available) is not sufficient for reproducibility, and that the ability of other researchers to confirm the results with an original author's artifacts also requires that the code be (at least somewhat) reusable.

Gael's post comments on the fact that a lot of code released to accompany a paper is prototype quality and not built for easy maintenance or reuse: "prototypes are designed to be thrown away." Then he says that in his opinion "quality is indeed central to doing science with code" and "Good scientific code is code that can be reused"—which I interpret to be in agreement with my suggestion that transparency as proxy for reproducibility is not sufficient. Gael later emphasizes that we also do not want to focus too early on high quality, which comes at a cost. He then says that "Reuse is very difficult and cannot be a requirement for all publications." But here he means reuse as "applying the analysis to different problems or data," whereas for reproducibility we require a weaker form of reuse: in the context of the original publication to confirm the results.

labarba commented 2 years ago
labarba commented 2 years ago

discuss some of the challenges/risks of openness

Thank you for the suggestion, but I have reached the article length limits and this topic seems a little tangential to my argument.