Ten simple rules for writing a paper about scientific software

Romano, Joseph D.; Moore, Jason H.

doi:10.1371/journal.pcbi.1008390

Cited by 4 publications

(1 citation statement)

References 30 publications

Supporting

Mentioning

Contrasting

Order By: Relevance

“…Following the examples of 10 Simple Rules papers for scientific software [ 13 , 14 ] and applications [ 15 ], writing about scientific software [ 16 ], and working with other people’s code [ 17 ], our rules are intended to make computable knowledge artifacts more shareable, useful, and reusable. These rules are useful for researchers who wish to go beyond traditional publication pathways for knowledge dissemination, and who want to both make their artifacts more accessible, and to help others use them.…”

Section: Ten Simple Rulesmentioning

confidence: 99%

Ten simple rules to make computable knowledge shareable and reusable

Conte,

Boisvert,

Barrison

et al. 2024

PLoS Comput Biol

View full text Add to dashboard Cite

Computable biomedical knowledge (CBK) is: “the result of an analytic and/or deliberative process about human health, or affecting human health, that is explicit, and therefore can be represented and reasned upon using logic, formal standards, and mathematical approaches.” Representing biomedical knowledge in a machine-interpretable, computable form increases its ability to be discovered, accessed, understood, and deployed. Computable knowledge artifacts can greatly advance the potential for implementation, reproducibility, or extension of the knowledge by users, who may include practitioners, researchers, and learners. Enriching computable knowledge artifacts may help facilitate reuse and translation into practice. Following the examples of 10 Simple Rules papers for scientific code, software, and applications, we present 10 Simple Rules intended to make shared computable knowledge artifacts more useful and reusable. These rules are mainly for researchers and their teams who have decided that sharing their computable knowledge is important, who wish to go beyond simply describing results, algorithms, or models via traditional publication pathways, and who want to both make their research findings more accessible, and to help others use their computable knowledge. These rules are roughly organized into 3 categories: planning, engineering, and documentation. Finally, while many of the following examples are of computable knowledge in biomedical domains, these rules are generalizable to computable knowledge in any research domain.

show abstract