Four simple recommendations to encourage best practices in research software

Rafael C. Jiménez, Mateusz Kuzak, Monther Alhamdoosh, Michelle Barker, Bérénice Batut, Mikael Borg, Salvador Capella-Gutierrez, Neil Chue Hong, Martin Cook, Manuel Corpas, Madison Flannery, Leyla Garcia, Josep Ll Gelpí, Simon Gladman, Carole Goble, Montserrat González Ferreiro, Alejandra Gonzalez-Beltran, Philippa C. Griffin, Björn Grüning, Jonas Hagberg & 29 others Petr Holub, Rob Hooft, Jon Ison, Daniel S Katz, Brane Leskošek, Federico López Gómez, Luis J. Oliveira, David Mellor, Rowland Mosbergen, Nicola Mulder, Yasset Perez-Riverol, Robert Pergl, Horst Pichler, Bernard Pope, Ferran Sanz, Maria V. Schneider, Victoria Stodden, Radosław Suchecki, Radka Svobodová Vařeková, Harry Anton Talvik, Ilian Todorov, Andrew Treloar, Sonika Tyagi, Maarten van Gompel, Daniel Vaughan, Allegra Via, Xiaochuan Wang, Nathan S. Watson-Haigh, Steve Crouch

Research output: Contribution to journalArticle

Abstract

Scientific research relies on computer software, yet software is not always developed following practices that ensure its quality and sustainability. This manuscript does not aim to propose new software development best practices, but rather to provide simple recommendations that encourage the adoption of existing best practices. Software development best practices promote better quality software, and better quality software improves the reproducibility and reusability of research. These recommendations are designed around Open Source values, and provide practical suggestions that contribute to making research software and its source code more discoverable, reusable and transparent. This manuscript is aimed at developers, but also at organisations, projects, journals and funders that can increase the quality and sustainability of research software by encouraging the adoption of these recommendations.

Original languageEnglish (US)
Article number876
JournalF1000Research
Volume6
DOIs
StatePublished - Jan 1 2017

Fingerprint

Practice Guidelines
Software
Research
Sustainable development
Software engineering
Reusability

Keywords

  • Best practices
  • Code
  • FAIR
  • Guidelines
  • Open Science
  • Open Source
  • Quality
  • Recommendations
  • Software
  • Sustainability

ASJC Scopus subject areas

  • Biochemistry, Genetics and Molecular Biology(all)
  • Immunology and Microbiology(all)
  • Pharmacology, Toxicology and Pharmaceutics(all)

Cite this

Jiménez, R. C., Kuzak, M., Alhamdoosh, M., Barker, M., Batut, B., Borg, M., ... Crouch, S. (2017). Four simple recommendations to encourage best practices in research software. F1000Research, 6, [876]. https://doi.org/10.12688/f1000research.11407.1

Four simple recommendations to encourage best practices in research software. / Jiménez, Rafael C.; Kuzak, Mateusz; Alhamdoosh, Monther; Barker, Michelle; Batut, Bérénice; Borg, Mikael; Capella-Gutierrez, Salvador; Chue Hong, Neil; Cook, Martin; Corpas, Manuel; Flannery, Madison; Garcia, Leyla; Gelpí, Josep Ll; Gladman, Simon; Goble, Carole; González Ferreiro, Montserrat; Gonzalez-Beltran, Alejandra; Griffin, Philippa C.; Grüning, Björn; Hagberg, Jonas; Holub, Petr; Hooft, Rob; Ison, Jon; Katz, Daniel S; Leskošek, Brane; López Gómez, Federico; Oliveira, Luis J.; Mellor, David; Mosbergen, Rowland; Mulder, Nicola; Perez-Riverol, Yasset; Pergl, Robert; Pichler, Horst; Pope, Bernard; Sanz, Ferran; Schneider, Maria V.; Stodden, Victoria; Suchecki, Radosław; Svobodová Vařeková, Radka; Talvik, Harry Anton; Todorov, Ilian; Treloar, Andrew; Tyagi, Sonika; van Gompel, Maarten; Vaughan, Daniel; Via, Allegra; Wang, Xiaochuan; Watson-Haigh, Nathan S.; Crouch, Steve.

In: F1000Research, Vol. 6, 876, 01.01.2017.

Research output: Contribution to journalArticle

Jiménez, RC, Kuzak, M, Alhamdoosh, M, Barker, M, Batut, B, Borg, M, Capella-Gutierrez, S, Chue Hong, N, Cook, M, Corpas, M, Flannery, M, Garcia, L, Gelpí, JL, Gladman, S, Goble, C, González Ferreiro, M, Gonzalez-Beltran, A, Griffin, PC, Grüning, B, Hagberg, J, Holub, P, Hooft, R, Ison, J, Katz, DS, Leskošek, B, López Gómez, F, Oliveira, LJ, Mellor, D, Mosbergen, R, Mulder, N, Perez-Riverol, Y, Pergl, R, Pichler, H, Pope, B, Sanz, F, Schneider, MV, Stodden, V, Suchecki, R, Svobodová Vařeková, R, Talvik, HA, Todorov, I, Treloar, A, Tyagi, S, van Gompel, M, Vaughan, D, Via, A, Wang, X, Watson-Haigh, NS & Crouch, S 2017, 'Four simple recommendations to encourage best practices in research software', F1000Research, vol. 6, 876. https://doi.org/10.12688/f1000research.11407.1
Jiménez RC, Kuzak M, Alhamdoosh M, Barker M, Batut B, Borg M et al. Four simple recommendations to encourage best practices in research software. F1000Research. 2017 Jan 1;6. 876. https://doi.org/10.12688/f1000research.11407.1
Jiménez, Rafael C. ; Kuzak, Mateusz ; Alhamdoosh, Monther ; Barker, Michelle ; Batut, Bérénice ; Borg, Mikael ; Capella-Gutierrez, Salvador ; Chue Hong, Neil ; Cook, Martin ; Corpas, Manuel ; Flannery, Madison ; Garcia, Leyla ; Gelpí, Josep Ll ; Gladman, Simon ; Goble, Carole ; González Ferreiro, Montserrat ; Gonzalez-Beltran, Alejandra ; Griffin, Philippa C. ; Grüning, Björn ; Hagberg, Jonas ; Holub, Petr ; Hooft, Rob ; Ison, Jon ; Katz, Daniel S ; Leskošek, Brane ; López Gómez, Federico ; Oliveira, Luis J. ; Mellor, David ; Mosbergen, Rowland ; Mulder, Nicola ; Perez-Riverol, Yasset ; Pergl, Robert ; Pichler, Horst ; Pope, Bernard ; Sanz, Ferran ; Schneider, Maria V. ; Stodden, Victoria ; Suchecki, Radosław ; Svobodová Vařeková, Radka ; Talvik, Harry Anton ; Todorov, Ilian ; Treloar, Andrew ; Tyagi, Sonika ; van Gompel, Maarten ; Vaughan, Daniel ; Via, Allegra ; Wang, Xiaochuan ; Watson-Haigh, Nathan S. ; Crouch, Steve. / Four simple recommendations to encourage best practices in research software. In: F1000Research. 2017 ; Vol. 6.
@article{898e900aa58c4a44a9c0b6e0a617ac9e,
title = "Four simple recommendations to encourage best practices in research software",
abstract = "Scientific research relies on computer software, yet software is not always developed following practices that ensure its quality and sustainability. This manuscript does not aim to propose new software development best practices, but rather to provide simple recommendations that encourage the adoption of existing best practices. Software development best practices promote better quality software, and better quality software improves the reproducibility and reusability of research. These recommendations are designed around Open Source values, and provide practical suggestions that contribute to making research software and its source code more discoverable, reusable and transparent. This manuscript is aimed at developers, but also at organisations, projects, journals and funders that can increase the quality and sustainability of research software by encouraging the adoption of these recommendations.",
keywords = "Best practices, Code, FAIR, Guidelines, Open Science, Open Source, Quality, Recommendations, Software, Sustainability",
author = "Jim{\'e}nez, {Rafael C.} and Mateusz Kuzak and Monther Alhamdoosh and Michelle Barker and B{\'e}r{\'e}nice Batut and Mikael Borg and Salvador Capella-Gutierrez and {Chue Hong}, Neil and Martin Cook and Manuel Corpas and Madison Flannery and Leyla Garcia and Gelp{\'i}, {Josep Ll} and Simon Gladman and Carole Goble and {Gonz{\'a}lez Ferreiro}, Montserrat and Alejandra Gonzalez-Beltran and Griffin, {Philippa C.} and Bj{\"o}rn Gr{\"u}ning and Jonas Hagberg and Petr Holub and Rob Hooft and Jon Ison and Katz, {Daniel S} and Brane Leskošek and {L{\'o}pez G{\'o}mez}, Federico and Oliveira, {Luis J.} and David Mellor and Rowland Mosbergen and Nicola Mulder and Yasset Perez-Riverol and Robert Pergl and Horst Pichler and Bernard Pope and Ferran Sanz and Schneider, {Maria V.} and Victoria Stodden and Radosław Suchecki and {Svobodov{\'a} Vařekov{\'a}}, Radka and Talvik, {Harry Anton} and Ilian Todorov and Andrew Treloar and Sonika Tyagi and {van Gompel}, Maarten and Daniel Vaughan and Allegra Via and Xiaochuan Wang and Watson-Haigh, {Nathan S.} and Steve Crouch",
year = "2017",
month = "1",
day = "1",
doi = "10.12688/f1000research.11407.1",
language = "English (US)",
volume = "6",
journal = "F1000Research",
issn = "2046-1402",
publisher = "F1000 Research Ltd.",

}

TY - JOUR

T1 - Four simple recommendations to encourage best practices in research software

AU - Jiménez, Rafael C.

AU - Kuzak, Mateusz

AU - Alhamdoosh, Monther

AU - Barker, Michelle

AU - Batut, Bérénice

AU - Borg, Mikael

AU - Capella-Gutierrez, Salvador

AU - Chue Hong, Neil

AU - Cook, Martin

AU - Corpas, Manuel

AU - Flannery, Madison

AU - Garcia, Leyla

AU - Gelpí, Josep Ll

AU - Gladman, Simon

AU - Goble, Carole

AU - González Ferreiro, Montserrat

AU - Gonzalez-Beltran, Alejandra

AU - Griffin, Philippa C.

AU - Grüning, Björn

AU - Hagberg, Jonas

AU - Holub, Petr

AU - Hooft, Rob

AU - Ison, Jon

AU - Katz, Daniel S

AU - Leskošek, Brane

AU - López Gómez, Federico

AU - Oliveira, Luis J.

AU - Mellor, David

AU - Mosbergen, Rowland

AU - Mulder, Nicola

AU - Perez-Riverol, Yasset

AU - Pergl, Robert

AU - Pichler, Horst

AU - Pope, Bernard

AU - Sanz, Ferran

AU - Schneider, Maria V.

AU - Stodden, Victoria

AU - Suchecki, Radosław

AU - Svobodová Vařeková, Radka

AU - Talvik, Harry Anton

AU - Todorov, Ilian

AU - Treloar, Andrew

AU - Tyagi, Sonika

AU - van Gompel, Maarten

AU - Vaughan, Daniel

AU - Via, Allegra

AU - Wang, Xiaochuan

AU - Watson-Haigh, Nathan S.

AU - Crouch, Steve

PY - 2017/1/1

Y1 - 2017/1/1

N2 - Scientific research relies on computer software, yet software is not always developed following practices that ensure its quality and sustainability. This manuscript does not aim to propose new software development best practices, but rather to provide simple recommendations that encourage the adoption of existing best practices. Software development best practices promote better quality software, and better quality software improves the reproducibility and reusability of research. These recommendations are designed around Open Source values, and provide practical suggestions that contribute to making research software and its source code more discoverable, reusable and transparent. This manuscript is aimed at developers, but also at organisations, projects, journals and funders that can increase the quality and sustainability of research software by encouraging the adoption of these recommendations.

AB - Scientific research relies on computer software, yet software is not always developed following practices that ensure its quality and sustainability. This manuscript does not aim to propose new software development best practices, but rather to provide simple recommendations that encourage the adoption of existing best practices. Software development best practices promote better quality software, and better quality software improves the reproducibility and reusability of research. These recommendations are designed around Open Source values, and provide practical suggestions that contribute to making research software and its source code more discoverable, reusable and transparent. This manuscript is aimed at developers, but also at organisations, projects, journals and funders that can increase the quality and sustainability of research software by encouraging the adoption of these recommendations.

KW - Best practices

KW - Code

KW - FAIR

KW - Guidelines

KW - Open Science

KW - Open Source

KW - Quality

KW - Recommendations

KW - Software

KW - Sustainability

UR - http://www.scopus.com/inward/record.url?scp=85024481292&partnerID=8YFLogxK

UR - http://www.scopus.com/inward/citedby.url?scp=85024481292&partnerID=8YFLogxK

U2 - 10.12688/f1000research.11407.1

DO - 10.12688/f1000research.11407.1

M3 - Article

VL - 6

JO - F1000Research

JF - F1000Research

SN - 2046-1402

M1 - 876

ER -