Skip to content

MaastrichtU-Library/the-FAIR-extension

Repository files navigation

the FAIR extension

fair-software.eu

logo

"The FAIR extension" is an open-source web browser extension that allows researchers to do FAIR metrics evaluations directly to the web source. 👩🏻‍💻🚦


Quickstart for Users

To run the extension as a user:

  1. Go to the Google Chrome Store and add the extension to your browser.
  2. Navigate to the webpage you want to evaluate.
  3. Activate the extension by clicking on its icon.
  4. The extension will detect and highlight DOIs on the webpage. Click "Evaluate" next to a DOI to assess it.
  5. Open the extension popup by clicking its icon on the top-right of your browser to see the evaluation results.

Note: The evaluation process takes 2 to 5 seconds, depending on the website. ⚠️

Warning: When the extension is active, it can mess with some websites (e.g. YouTube). This is a known bug, and we'll solve it soon. A workaround is to select "On click" access. This config indicates that the extension should only work when you click it, not "all the time."

👉🏼 chrome://extensions/ > Details > Site access > On click

Try the extension with some of the following examples:


Quickstart for Developers

To edit the project:

  1. Download the project as a Zip folder.
  2. Extract the folder.
  3. Open the project in a code editor such as Visual Studio Code.

Working files:

  • Manifest.json: Controls the structure of the extension, from essential elements like the title to complex features such as permissions and workflows.
  • background.js: Acts as a medium between the extension's files, maintaining communication between content scripts and popup JSON files. It also handles redirection to the DOI.
  • popup.js: Triggered by index.html. It modifies the user's view of the popup, including the DOI evaluation. This file also controls the communication between the extension and the FAIR-enough API.
  • index.html: The front end of the Chrome extension's popup. You can edit the style of the extension in this file.
  • contentScript.js: Triggered when the extension is given access. It injects scripts into the website to highlight text, detects DOIs in the webpage, injects code to highlight them and adds buttons next to them, and sends the indicated DOI to background.js for evaluation.

Use Cases

  1. A student wanting to use a DO (e.g. software package) must know which to choose. The FAIR extension will indicate which one is more FAIR and aid the decision-making process
  2. A Data steward recommending sources
  3. A researcher who wants to display all FAIR metrics of their DOs on a research profile
  4. A PI that wants to evaluate an aggregated metric for a project.

About 👓

The scientific community’s efforts have increased regarding evaluating the FAIRness of research Digital Objects such as publications, datasets, or research software. However, this requires a steep learning curve for the average researcher when learning the FAIR evaluation frameworks, disengaging some.

This project aims to use technology close this gap and make this process more accessible by bringing the FAIR evaluation to the researcher’s profiles. “The FAIR extension” is an open-source, user-friendly web browser extension allowing researchers to do FAIRness evaluations directly from scholarly aggregators such as PURE, Google Scholar, or ResearchGate without additional knowledge. The browser extension follows the FAIR metrics group specification, building on top of the community-accepted FAIR evaluators’ APIs. 

We aim to demonstrate that low-entry-level tools can bridge the gap between the researcher and the FAIR metrics. e.g. A data steward recommending FAIR sources or a researcher evaluating all FAIR metrics directly on scholarly profiles.

The development of this extension is made possible thanks to the Netherlands eScience Center fellowship grant 2022-2023

- Contact

If there is an issue, please open one at Issues. Else, contact directly at p.hernandezserrano@maastrichtuniversity.nl

- Research Software Quality Checklist

Following the Software Sustainability Institute’s software evaluation approach

logo


Terms of Use 📃

- Licence

Copyright (c) 2022 Maastricht University Library

The code contained in this Github repository is free software: you can redistribute it and modify it under the terms of the Apache 2.0 License compatible with many copyleft licenses such as the GNU General Public License.

- Research Software Citation

Machine-actionable citation file: CITATION.cff
Should you require another format for citation, you can convert it using the cff-converter Tool

- Paper Citation

@article{10.3897/rio.8.e95006,
	author = {Pedro Hernandez Serrano and Vincent Emonet},
	title = {The FAIR extension: A web browser extension to evaluate Digital Object FAIRness},
	volume = {8},
	number = {},
	year = {2022},
	doi = {10.3897/rio.8.e95006},
	publisher = {Pensoft Publishers},
	pages = {e95006},
	URL = {https://doi.org/10.3897/rio.8.e95006},
	eprint = {https://doi.org/10.3897/rio.8.e95006},
	journal = {Research Ideas and Outcomes}
}