Data · dataset · 2026
README for research data deposits in Borealis: minimum and enhanced metadata elements
Listed in Borealis
The Borealis Expert Group's README Working Group was established to develop standardized README templates for research data deposits within Borealis, a Canadian research data repository platform.
Description
Comprising members from seven Canadian universities, the Working Group analyzed approximately 20 README templates from Canadian institutions, international organizations, and discipline-specific sources, using AI-assisted analysis followed by manual quality assurance to identify and define a common set of metadata elements.
The Working Group's central output is a two-tiered README framework. The Minimum README establishes a baseline of nine essential elements, including title, author, description, contact information, licensing, persistent identifier, research methodology, related publications, and software requirements, providing enough context for users to locate, evaluate, and potentially reuse a dataset. The Enhanced (Recommended) README builds on this foundation with thirteen additional elements covering variable lists, file inventories, data collection and processing details, geographic and temporal coverage, funding information, versioning, and contributor acknowledgements.
Read the rest (2 more)
Together, these tiers give depositors a scalable, practical documentation standard suited to datasets of varying complexity. The framework is designed to serve both researchers depositing data and curators supporting them, ensuring that README files consistently address the who, what, where, when, why, and how of a dataset. Clear definitions for each element reduce ambiguity and support the long-term discoverability, usability, and reproducibility of research data.
With the framework now finalized, the next phase of work will focus on technical implementation — integrating these elements into the Borealis platform to enable automated README generation at the point of deposit.
Links
Where it is published
- Dataverse dataset page borealisdata.ca/dataset.xhtml?persistentId=doi%3A10.5683%2FSP3%2FCJ5X5O ↗
landing page · from borealisdata ca
- DOI doi.org/10.5683/sp3/cj5x5o ↗
DOI / persistent id · from borealisdata ca
Catalogue records · 1
- Dataverse API borealisdata.ca/api/datasets/:persistentId/?persistentId=doi%3A10.5683%2FSP3%2… ↗
metadata API · from borealisdata ca
Topics
- Stated by source
- Computer and Information Science
- From keywords
- Computer Science & AI
- Inferred from text
- Library and information studies 70%
Provenance · 1 source records, 9 field assertions
| Source | Key | Last seen | Raw |
|---|---|---|---|
| Borealis | doi:10.5683/SP3/CJ5X5O | 13 d ago | JSON v1 |
| Field | Assertion | Extractor | Evidence |
|---|---|---|---|
| concepts[field].anzsrc:group:4610 | enrichment · borealisdata ca | taxonomy-embedding@1.1.0 | title+keywords+description (70%) |
| concepts[field].dataverse_subject:computer-and-information-science | source · borealisdata ca | connector:borealisdata_ca@1.0.0 | /subjects |
| concepts[field].local:field:computer-science-ai | mapping · borealisdata ca | connector:borealisdata_ca@1.0.0 | /subjects |
| created_date | source · borealisdata ca | connector:borealisdata_ca@1.0.0 | |
| description | source · borealisdata ca | connector:borealisdata_ca@1.0.0 | /description |
| publication_date | source · borealisdata ca | connector:borealisdata_ca@1.0.0 | |
| title | source · borealisdata ca | connector:borealisdata_ca@1.0.0 | /name |
| updated_date | source · borealisdata ca | connector:borealisdata_ca@1.0.0 | |
| version_label | source · borealisdata ca | connector:borealisdata_ca@1.0.0 |