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-10] Are the formats used by the data consumed or produced by the software open and a reference provided to the format? #11

Open
karacolada opened this issue Nov 10, 2023 · 1 comment
Labels
enhancement New feature or request

Comments

@karacolada
Copy link
Member

karacolada commented Nov 10, 2023

D5.2 p18+p27

Detailed Description

The use of open file formats for data improves the reusability and understandability of the software.

Domain-agnostic comments

This metric is inherently difficult to implement as at present there is no standardised or common method for describing the data / file formats used by a piece of software in a machine-readable way. Community standards commonly define the data formats in use in a discipline, and resources such as FAIRsharing.org provide a curated catalogues of standards.

CESSDA comments

CESSDA documents its approach to open data standards in CMA7 - Standards Compliance.

Context

I1: Software reads, writes and exchanges data in a way that meets domain-relevant community standards.
I2: Software includes qualified references to other objects.

Possible Implementation

domain-agnostic

requirements Software source code, Software documentation
method Check the software source code and documentation for references to the data formats used.
essential The documentation describes the data formats used.
important The data formats used are open.
useful A reference to the schema is provided.

CESSDA

requirements Software source code, Software documentation
method Check that data content used by CESSDA services is machine-readable
essential The data formats used by the software are noted in the documentation.
important The data complies with a recognised standard used by the CESSDA community (typically DDI/XML, RDF/XML, TURTLE, JSON-LD or SKOS).
useful Where a public API is used to access the data content, it complies with the OpenAPI standard.
@karacolada karacolada added the enhancement New feature or request label Nov 10, 2023
@karacolada
Copy link
Member Author

Extend file format evaluator:

class FAIREvaluatorFileFormat(FAIREvaluator):

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

1 participant