Software Citation and Other Incentives at BD2K Software Discovery Workshop
Download as PPTX, PDF1 like1,127 views
This document discusses the need for incentives and processes to properly recognize software and code as scholarly works. It notes that currently, software engineers lack publications and contributions from code are not well-measured or valued. The document proposes that treating code similarly to research papers, with citations and peer review, could help address this issue and incentivize important work. It provides examples of how code could be packaged, documented, and reviewed to enable proper scholarly attribution through citation.
Software Citation and Other Incentives at BD2K Software Discovery Workshop
- 1. Software Citation and Other Incentives NIH BD2K Software Discovery Workshop, May 12-13, 2014, Washington DC Martin Hammitzsch, Helmholtz Centre Potsdam, GFZ German Research Centre for Geosciences
- 2. software engineer with empty publication list independent contributions poorly perceived & hardly measurable, not assessed & not valued lack of common understanding & defined processes direct release not possible as scientific publication workaround publications in desired journals Image: http://katherinepreston.com/owning-your-own-story/
- 3. The paper must be accompanied by the code, or means of accessing the code, for the purpose of peer-review. If the code is normally distributed in a way which could compromise the anonymity of the referees, then the code must be made available to the editor. The referee/editor is not required to review the code in any way, but they may do so if they so wish. All papers must include a section at the end of the paper entitled “Code availability”. In this section, instructions for obtaining the code (e.g. from a supplement, or from a website) should be included; alternatively, contact information should be given where the code can be obtained on request, or the reasons why the code is not available should be clearly stated. We strongly encourage authors to upload any user manuals associated with the code. For models where this is practicable, we strongly encourage referees to compile the code, and run test cases supplied by the authors where appropriate. Unlike internal reports, GMD papers undergo a peer-review process, which establishes the criteria for full publication of model developments. Submitted code has not itself been peer- reviewed by GMD, but, as one of our new initiatives, we will require that referees and editors obtain the model code, and encourage them to execute test cases where practical. example #1
- 4. example #2
- 5. example #3
- 6. example #4
- 7. example #5
- 8. example #6
- 9. citation identifier asset landingspot,accessible&persistentwebpagewithrelatedcontent documentationwhatitis,whatitdoes&whatitisusedfor binary,test&exampledata,guidehowtouse code,compilehow-to,got-stuckFAQ,dependencyinformation,thirdpartyreleases codedesign&architecture,dev-envhow-to,APIreference,automatedtests&builds authors,contacts,responsibilities,ORCIDreferences identifier,snippetshowtocite,metadata integratedorhyperlinks license software,bundle,package,release It’s not just making code citable … nor citing self-contained code. Image: https://boxfresh.com.au/products/fruit-veg
- 10. Image: http://tepperjacksontravelcollection.com/fun_luggage_tagscool_id_tags Citability and DOI are no quality criteria. visibility · credit · balance · incentive badges · reviews · discussions · ratings · citation counts · metrics based evaluations social aspect · commitment · persistence · maintenance
- 11. community of practice Publish. Acknowledge. Cite. Get credit. use existing but imperfect mechanisms · gain experience · get used to it while using it drivingfactor commonunderstanding defined,accepted&adoptedprocesses jointincentives&platform approaches nosinglesolution,noone sizefitsall Image: http://www.artofblog.com/wp-content/uploads/2012/07/Lego_People.jpeg
- 12. being able to cite, means important work is done Image: http://www.kirsty-yoga-marbella.com/yoga-blog/the-most-difficult-yoga-pose-relaxation-posesavasana/