Difference between revisions of "GitHub-Zenodo linkage"

From GRASS-Wiki
Jump to: navigation, search
m
m
Line 18: Line 18:
  
 
== GitHub - Zenodo Integration ==
 
== GitHub - Zenodo Integration ==
 +
=== Generic Documentation ===
 +
* [https://guides.github.com/activities/citable-code/ GitHub Guide: Making Your Code Citable]
 +
* [https://genr.eu/wp/cite/ GenR-Blogpost: Make Your Code Citable Using GitHub and Zenodo: A How-to Guide]
 +
 +
=== GRASS GIS specific Information ===
 +
 +
The following feedback was provided by the Zenodo helpdesk in Q1/Q2 2019 in advance of the GRASS github migration:
 +
 +
==== Many DOI for individual GRASS modules or rather a DOI for the GRASS GIS software framework ? ====
 +
''"Yes, in principle it's possible to issue DOIs for all modules, but I'm I don't think this is useful. You mention e.g. that it would be nice to cite both the overall system as well as individual modules. This will essentially "dilute" the citations over many DOIs and thus the citation count for GRASS will seem a lot lower than it actually is. Thus for getting credit, it's better to have one DOI per major version of the grass (where each version can have an updated author list). Also, having many DOIs makes it very difficult for discovery systems to track the citations automatically. Essentially Zenodo is the first system, where we can actually aggregate citations for all versions and a specific version of software."''
 +
 +
''"If you want to give credit to individual modules, I think it's better to then simply mention it. For instance, the journal text could mention it used module X, and the landing page of DOI for GRASS, could simply have a description detailing who did which module."''
 +
 +
''"We have now collected some 5000 citations to software in Zenodo, and what we can see for the top cited packages is that if the project provides a "citation recommendation" then people actually follow it. Example:"''
 +
 +
* ''https://github.com/Lasagne/Lasagne/wiki/Lasagne-Citation-(BibTeX)''
 +
 +
* ''https://zenodo.org/record/27878'' "
  
 
== Options for future extensions ==
 
== Options for future extensions ==

Revision as of 03:27, 18 May 2019

GitHub - Zenodo Integration for GRASS GIS

Scope

This wiki-page provides information about the linkage between the GRASS GIS repository on GitHub and the data archive Zenodo. This includes the motivation why this is relevant for the GRASS GIS community, hands on advice from the Zenodo helpdesk how to do the task and strategic information about future development paths, as this is partially work in progress (scientific grade automated software citation by persistent identifiers).

Introducing Zenodo

Zenodo is a general-purpose open-access repository. It is developed under the European OpenAIRE program (a network of Open Access repositories, archives and journals that support Open Access policies) and operated by CERN. The services provided by Zenodo are based on an Open Source software stack. To users, including the GRASS GIS developer team, Zenodo provides long term archiving of digital content, including software.

Benefits for the GRASS GIS community

Long term archiving

Scientific citation by DOI

GitHub - Zenodo Integration

Generic Documentation

GRASS GIS specific Information

The following feedback was provided by the Zenodo helpdesk in Q1/Q2 2019 in advance of the GRASS github migration:

Many DOI for individual GRASS modules or rather a DOI for the GRASS GIS software framework ?

"Yes, in principle it's possible to issue DOIs for all modules, but I'm I don't think this is useful. You mention e.g. that it would be nice to cite both the overall system as well as individual modules. This will essentially "dilute" the citations over many DOIs and thus the citation count for GRASS will seem a lot lower than it actually is. Thus for getting credit, it's better to have one DOI per major version of the grass (where each version can have an updated author list). Also, having many DOIs makes it very difficult for discovery systems to track the citations automatically. Essentially Zenodo is the first system, where we can actually aggregate citations for all versions and a specific version of software."

"If you want to give credit to individual modules, I think it's better to then simply mention it. For instance, the journal text could mention it used module X, and the landing page of DOI for GRASS, could simply have a description detailing who did which module."

"We have now collected some 5000 citations to software in Zenodo, and what we can see for the top cited packages is that if the project provides a "citation recommendation" then people actually follow it. Example:"

Options for future extensions