Skip to main content

Sharing academic credit in an open source project

We live in truly wonderful times to develop software. Thanks to the growth of the Open Source movement and emergence of platforms such as GitHub, coding became something more than just an engineering task. Social interactions, bonds between developers, and guiding new contributors are sometimes as important as sheer technical acumen.
A strong and healthy developer community revolving around a software tool or library is very important. It makes the tool more robust (tested in many more environments), sustainable (the progress does not depend on a single person), and feature rich (more developers == more features). Even though there exist some excellent guides on how to build a welcoming and thriving community they miss out on one aspect that is specific to software development performed by academics - academic credit.
For those not familiar with how things run in academia a quick refresher: the main currency of science is papers (manuscripts) and the number of times they are referenced (cited) by other papers. It’s a little bit like the the PageRank algorithm - more cited papers are more important and help academics in their careers. Papers could be describing many things: a new discovery, new algorithm, dataset, and - yes - a piece of software. In fact some of the most cited papers are indeed linked to a piece of software.
Many open source software projects have papers linked to them - such as this Frontiers in Neuroinformatics paper we published about a framework for neuroimaging data processing called Nipype. At the time of writing we invited everyone involved to co author the paper, but the developer community was relatively small and hence the paper has only 7 authors. If you go to Nipype GitHub page you will notice that now the project has over 100 contributors. Once a paper is published it is very hard to change it (and unheard of to modify the list of authors). Thus unfortunately everyone who joined the project after the paper was published is not on the paper.  So how can they receive academically meaningful credit for their work? How to reward academics in long running collaborative software projects?
Solution - new “paper” for every release
Ideally one would be able to version the paper - primary citation for your software tool - and add new contributors/authors for every new release. Unfortunately this is not possible with any publisher I know of. However, there is something very similar - enter the wonderful world of Zenodo.
Zenodo is a free repository for research products (papers, data, software etc.) supported by OpenAIRE (a European Union project) and CERN (you know - the birthplace of the Internet). Zenodo allows you to deposit your software and get a Digital Object Identifier (DOI) for it making it citable in the literature the same way as any other paper. What is more Zenodo recently introduced a feature allowing to group DOIs of different versions of the same piece of software. The most fantastic aspect of the system is that it could be fully automated. This is how you do it:
  1. In your repository create a .zenodo.json file with all of the authors, their affiliations and ORCIDs. You can find an example here.
  2. Add information to your file (the one that is linked to each time someone opens a Pull Request) asking new contributors to add their names to .zenodo.json.
  3. Login to with your GitHub account, go to your profile, click GitHub and enable integration for your repository.
  4. Create a new release on GitHub - a new DOI will be automatically created on Zenodo.
Finally you should instruct users to cite the Zenodo handle instead or in addition to your paper (this is how we did this in Nipype). This way the new publication will start accruing citation. By setting up this system you will give all of your contributors academic credit for their work and build up a sense of common ownership of the tool you all create together. There is one more bonus side effect: your project will be now backed up in on Zenodo in case GitHub disappears.


  1. I am really enjoying reading your well written articles. It looks like you spend a lot of effort and time on your blog. I have bookmarked it and I am looking forward to reading new articles. Keep up the good work.
    PMP Certification

    PMP Certification in Malaysia

  2. A debt of gratitude is in order for sharing the information, keep doing awesome... I truly delighted in investigating your site. great asset...
    data science course
    data science course in malaysia
    data science certification
    data science course malaysia

  3. Excellent Blog! I would like to thank for the efforts you have made in writing this post. I am hoping the same best work from you in the future as well. I wanted to thank you for this websites! Thanks for sharing. Great websites!
    PMP Course

    360DigiTMG PMP Certification

  4. Hi buddies, it is great written piece entirely defined, continue the good work constantly.
    data science course

  5. Excellent post for learning and researching.

    python course london

  6. While HR systems should assist with discovering approaches to hold key staff in the organization, associations need to by the by be ready for turnovers and limit their dangers. Probably the most serious danger for individuals focused, information specialist associations is the deficiency of information when representatives leave.Click Here

  7. This is a very nice one and gives in-depth information. I am really happy with the quality and presentation of the article. I’d really like to appreciate the efforts you get with writing this post. Thanks for sharing.
    Spoken English Classes in Kolkata

  8. Essay writing services. are in demand these days. They provide a valuable service to students who need to get their work done quickly, and they offer a variety of different features, such as editing and proofreading services.

  9. European gamers face solely a 2.7 p.c edge, and that's lowered to 1.four p.c on even-money bets by a rule referred to as en jail, which is described later in this article. At 1.four p.c, roulette becomes competitive with different on line casino games; at 5.26 p.c, it is a very troublesome sport to beat. Multi-Wheel Roulette takes full advantage of its on-line capabilities to ship several of} games at once. Instead of placing your chips and ready, you'll be able to|you probably 온라인 카지노 순위 can} hold the motion going throughout completely different wheels. But ought to use|you have to use} that desk to bet throughout several of} spinning roulette wheels, often positioned simply above the desk.

  10. This comment has been removed by the author.

  11. Choosing WritingTree for thesis writing was a wise decision. Their services are reliable, efficient, and the quality is outstanding. I appreciate their commitment to delivering excellence in academic writing. Highly recommended Writing Services for PhD

  12. Thanks for the Valuable information and it is really helpful information.
    The digital marketing agency. #zoopersolutions

  13. This article is exceptionally impressive. 3 bhk flats gwalior

  14. Nasha Mukti Kendra Indore

    nasha mukti kendra in indore is situated at a height of 553 meters from sealevel on the banks of two small rivers Saraswati river and Khan River. These to rivers unite inside the city at a place called sangamnath where a small temple of lord mahadev called Indreshwar temple is built. The name of Indore city is based on this temple. Indore is the biggest city of state Madhya Pradesh. Indore is also called as business capital of Madhya Pradesh


Post a Comment