Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Feature]: [FRSM-01] Does the software have a globally unique and persistent identifier? #1

Open
karacolada opened this issue Nov 9, 2023 · 2 comments
Labels
enhancement New feature or request good first metric Good for newcomers

Comments

@karacolada
Copy link
Member

karacolada commented Nov 9, 2023

D5.2, page 13, 23

Detailed Description

A software object may be assigned with a globally unique identifier such that it can be referenced unambiguously by humans or machines. Globally unique means an identifier should be associated with only one resource at any time. Examples of unique identifiers of data used for software include: Digital Object Identifier (DOI), the Handle System, Uniform Resource Identifier (URI) such as URL and URN, and Software Heritage Identifiers (SWHID). A data repository may assign a globally unique identifier to your data or metadata when you publish and make it available through its curation service.

Domain-agnostic comments

The type of identifier assigned will often depend on the type of repository that the software is deposited in, for example a URL for GitHub, DOI for Zenodo, or SWHID for Software Heritage. Note that URLs are not guaranteed to be persistent and by default GitHub only provides permalinks by request (GitHub Docs). It is not practical to directly test the global uniqueness or persistence of any individual identifier, therefore this metric proposes testing for an identifier scheme that provides guarantees of persistence.
The suitability of an identifier scheme may depend on the domain. If software metadata is available as a separate record, this should be FAIR (see FRSM-08).

CESSDA comments

See the Software Publication of open source components as per CESSDA’s Publication Policy & Procedures (CESSDA, 2020).
As described in the CESSDA ERIC Persistent Identifier Policy, CESSDA tools and services accept: DOI, Handle (including ePIC-handles), URN, ARK (fulfilling principle 10 of the CESSDA Data Access Policy).

Context

F1: Software is assigned a globally unique and persistent identifier.
R3: Software meets domain-relevant community standards.

Possible Implementation

domain-agnostic

requirements software identifier, list of globally unique identifier schemes
method Check if the software identifier is based on a suitable identifier scheme, and test it can be resolved.
essential Software has a human and machine-readable unique identifier that is resolvable to a machine-readable landing page and follows a defined unique identifier syntax.
important Identifier uses an identifier scheme that guarantees globally uniqueness and persistence.
useful Identifier scheme is commonly used in the domain.

CESSDA

requirements Software releases of open source components to be published in Zenodo, DOI handle
method Check that an established identifier scheme from the CESSDA Software Publication polices is used to identify software.
essential A version-dependent DOI must be added in the repository’s README as the recommended citation.
important Releases use the Semantic Versioning 2.0.0 notation.
useful Only Major and Minor releases are assigned DOIs.
@karacolada karacolada added the enhancement New feature or request label Nov 9, 2023
@karacolada
Copy link
Member Author

Assigning to principle F1 as this seems to be the more relevant and I can only choose one in f-uji.

@karacolada
Copy link
Member Author

Evaluator skeleton: FAIREvaluatorUniquePersistentIdentifierSoftware

class FAIREvaluatorUniquePersistentIdentifierSoftware(FAIREvaluator):

@karacolada karacolada added the good first metric Good for newcomers label May 29, 2024
joenio added a commit to joenio/fuji that referenced this issue Sep 28, 2024
joenio added a commit to joenio/fuji that referenced this issue Sep 28, 2024
this commit adds a new method on the metric FRSM-01-F1 to test if the project
repository contain a file codemeta.json at the root folder

Issue: softwaresaved#1
joenio added a commit to joenio/fuji that referenced this issue Sep 28, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request good first metric Good for newcomers
Projects
None yet
Development

No branches or pull requests

1 participant