A Guide to Using GitHub for Developing and Versioning Data Standards and Reporting Formats
Authors:
- Robert Crystal‐OrnelasRCRobert Crystal‐Ornelas
- Charuleka VaradharajanCVCharuleka Varadharajan
- Ben Bond‐LambertyBBBen Bond‐Lamberty
- Kristin BoyeKBKristin Boye
- Madison BurrusMBMadison Burrus
- Shreyas CholiaSCShreyas Cholia
- Michael CrowMCMichael Crow
- Joan DamerowJDJoan Damerow
- Ranjeet DevarakondaRDRanjeet Devarakonda
- Kim S. ElyKEKim S. Ely
- Amy GoldmanAGAmy Goldman
- Susan HeinzSHSusan Heinz
Open Access
- 5 August 2021
- journal article
- research article
- Published by American Geophysical Union (AGU) in Earth and Space Science
- Vol. 8 (8)
Abstract
Data standardization combined with descriptive metadata facilitate data reuse, which is the ultimate goal of the Findable, Accessible, Interoperable, and Reusable (FAIR) principles. Community data or metadata standards are increasingly created through an approach that emphasizes collaboration between various stakeholders. Such an approach requires platforms for collaboration on the development process that centers on sharing information and receiving feedback. Our objective in this study was to conduct a systematic review to identify data standards and reporting formats that use version control for developing data standards and to summarize common practices, particularly in earth and environmental sciences. Out of 108 data standards and reporting formats identified in our review, 32 used GitHub as the version control platform, and no other platforms were used. We found no universally accepted methodology for developing and publishing data standards. Many GitHub repositories did not use key features that could help developers to gather user feedback, or to create and revise standards that build on previous work. We provide guidance for community‐driven standard development and associated documentation on GitHub based on a systematic review of existing practices.Keywords
Funding Information
- U.S. Department of Energy
- Brookhaven National Laboratory
- Office of Biological and Environmental Research
This publication has 30 references indexed in Scilit:
- Open collaboration in the public sector: The case of social coding on GitHubGovernment Information Quarterly, 2015
- Challenges and Confusions in Learning Version Control with Git2014
- The Synthetic Biology Open Language (SBOL) provides a community standard for communicating designs in synthetic biologyNature Biotechnology, 2014
- SWEET ontology coverage for earth system sciencesEarth Science Informatics, 2014
- Building an eScience Thesaurus for Librarians: A Collaboration Between the National Network of Libraries of Medicine, New England Region and an Associate Fellow at the National Library of MedicineJournal of eScience Librarianship, 2013
- Towards Standardization: A Participatory Framework for Scientific Standard-MakingInternational Journal of Digital Curation, 2013
- The environment ontology: contextualising biological and biomedical entitiesJournal of Biomedical Semantics, 2013
- Darwin Core: An Evolving Community-Developed Biodiversity Data StandardPLOS ONE, 2012
- Minimum information about a marker gene sequence (MIMARKS) and minimum information about any (x) sequence (MIxS) specificationsNature Biotechnology, 2011
- New Knowledge from Old DataScience, Technology, & Human Values, 2008