{"status":"ok","message-type":"work","message-version":"1.0.0","message":{"indexed":{"date-parts":[[2025,5,14]],"date-time":"2025-05-14T04:12:01Z","timestamp":1747195921814,"version":"3.40.5"},"reference-count":39,"publisher":"Public Library of Science (PLoS)","issue":"11","license":[{"start":{"date-parts":[[2020,11,12]],"date-time":"2020-11-12T00:00:00Z","timestamp":1605139200000},"content-version":"vor","delay-in-days":0,"URL":"http:\/\/creativecommons.org\/licenses\/by\/4.0\/"}],"content-domain":{"domain":["www.ploscompbiol.org"],"crossmark-restriction":false},"short-container-title":["PLoS Comput Biol"],"abstract":"<jats:p>Papers describing software are an important part of computational fields of scientific research. These \u201csoftware papers\u201d are unique in a number of ways, and they require special consideration to improve their impact on the scientific community and their efficacy at conveying important information. Here, we discuss 10 specific rules for writing software papers, covering some of the different scenarios and publication types that might be encountered, and important questions from which all computational researchers would benefit by asking along the way.<\/jats:p>","DOI":"10.1371\/journal.pcbi.1008390","type":"journal-article","created":{"date-parts":[[2020,11,12]],"date-time":"2020-11-12T18:28:02Z","timestamp":1605205682000},"page":"e1008390","update-policy":"https:\/\/doi.org\/10.1371\/journal.pcbi.corrections_policy","source":"Crossref","is-referenced-by-count":6,"title":["Ten simple rules for writing a paper about scientific software"],"prefix":"10.1371","volume":"16","author":[{"ORCID":"https:\/\/orcid.org\/0000-0002-7999-4399","authenticated-orcid":true,"given":"Joseph D.","family":"Romano","sequence":"first","affiliation":[]},{"ORCID":"https:\/\/orcid.org\/0000-0002-5015-1099","authenticated-orcid":true,"given":"Jason H.","family":"Moore","sequence":"additional","affiliation":[]}],"member":"340","published-online":{"date-parts":[[2020,11,12]]},"reference":[{"key":"pcbi.1008390.ref001","doi-asserted-by":"crossref","DOI":"10.1093\/0195158709.001.0001","volume-title":"Extending ourselves: Computational science, empiricism, and scientific method","author":"P Humphreys","year":"2004"},{"issue":"6","key":"pcbi.1008390.ref002","doi-asserted-by":"crossref","first-page":"giaa056","DOI":"10.1093\/gigascience\/giaa056","article-title":"Recommendations to enhance rigor and reproducibility in biomedical research","volume":"9","author":"JJ Brito","year":"2020","journal-title":"GigaScience"},{"issue":"2","key":"pcbi.1008390.ref003","doi-asserted-by":"crossref","first-page":"15","DOI":"10.1145\/360262.360268","article-title":"Biopython: Python tools for computational biology","volume":"20","author":"B Chapman","year":"2000","journal-title":"ACM Sigbio Newsletter"},{"key":"pcbi.1008390.ref004","first-page":"2825","article-title":"Scikit-learn: Machine Learning in Python","volume":"12","author":"F Pedregosa","year":"2011","journal-title":"J Mach Learn Res"},{"issue":"16","key":"pcbi.1008390.ref005","doi-asserted-by":"crossref","first-page":"2078","DOI":"10.1093\/bioinformatics\/btp352","article-title":"The sequence alignment\/map format and SAMtools","volume":"25","author":"H Li","year":"2009","journal-title":"Bioinformatics"},{"issue":"3","key":"pcbi.1008390.ref006","doi-asserted-by":"crossref","first-page":"267","DOI":"10.1038\/ng1180","article-title":"PGC-1\u03b1-responsive genes involved in oxidative phosphorylation are coordinately downregulated in human diabetes","volume":"34","author":"VK Mootha","year":"2003","journal-title":"Nat Genet"},{"issue":"5795","key":"pcbi.1008390.ref007","doi-asserted-by":"crossref","first-page":"1929","DOI":"10.1126\/science.1132939","article-title":"The Connectivity Map: using gene-expression signatures to connect small molecules, genes, and disease","volume":"313","author":"J Lamb","year":"2006","journal-title":"Science"},{"issue":"8","key":"pcbi.1008390.ref008","doi-asserted-by":"crossref","first-page":"838","DOI":"10.1038\/ng.3593","article-title":"Functional characterization of somatic mutations in cancer using network-based inference of protein activity","volume":"48","author":"MJ Alvarez","year":"2016","journal-title":"Nat Genet"},{"journal-title":"Ten simple rules for making research software more robust","year":"2017","author":"M Taschuk","key":"pcbi.1008390.ref009"},{"journal-title":"Ten simple rules for documenting scientific software","year":"2018","author":"BD Lee","key":"pcbi.1008390.ref010"},{"journal-title":"Ten simple rules for developing usable software in computational biology","year":"2017","author":"M List","key":"pcbi.1008390.ref011"},{"journal-title":"Ten simple rules for taking advantage of Git and GitHub","year":"2016","author":"Y Perez-Riverol","key":"pcbi.1008390.ref012"},{"issue":"12","key":"pcbi.1008390.ref013","doi-asserted-by":"crossref","first-page":"e1002802","DOI":"10.1371\/journal.pcbi.1002802","article-title":"Ten simple rules for the open development of scientific software","volume":"8","author":"A Prli\u0107","year":"2012","journal-title":"PLoS Comput Biol"},{"journal-title":"Ten simple rules for writing and sharing computational analyses in Jupyter Notebooks","year":"2019","author":"A Rule","key":"pcbi.1008390.ref014"},{"journal-title":"Ten simple rules for developing public biological databases","year":"2016","author":"M Helmy","key":"pcbi.1008390.ref015"},{"key":"pcbi.1008390.ref016","unstructured":"Scope Guidelines\u2014Bioinformatics\u2014Oxford Academics; 2020. Available from: https:\/\/academic.oup.com\/bioinformatics\/pages\/scope_guidelines."},{"key":"pcbi.1008390.ref017","unstructured":"Submitting experimental metadata\u2014Submission Guidelines\u2014Scientific Data; 2020. Available from: https:\/\/www.nature.com\/sdata\/publish\/submission-guidelines#metadata."},{"key":"pcbi.1008390.ref018","first-page":"164","article-title":"Phylogenetic inference package (PHYLIP), version 3.2","volume":"5","author":"J Felsenstein","year":"1989","journal-title":"Cladistics"},{"issue":"2","key":"pcbi.1008390.ref019","first-page":"163","article-title":"Hennig86: a PC-DOS program for phylogenetic analysis","volume":"5","author":"J Farris","year":"1989","journal-title":"Cladistics"},{"issue":"3","key":"pcbi.1008390.ref020","doi-asserted-by":"crossref","first-page":"559","DOI":"10.1086\/519795","article-title":"PLINK: a tool set for whole-genome association and population-based linkage analyses","volume":"81","author":"S Purcell","year":"2007","journal-title":"Am J Hum Genet"},{"issue":"9","key":"pcbi.1008390.ref021","doi-asserted-by":"crossref","first-page":"1639","DOI":"10.1101\/gr.092759.109","article-title":"Circos: an information aesthetic for comparative genomics","volume":"19","author":"M Krzywinski","year":"2009","journal-title":"Genome Res"},{"key":"pcbi.1008390.ref022","unstructured":"Writing and using a software management plan. Available from: https:\/\/www.software.ac.uk\/resources\/guides\/software-management-plans."},{"journal-title":"Developing an ELIXIR Software Management plan for use in Life Science Project","year":"2020","author":"M Kuzak","key":"pcbi.1008390.ref023"},{"issue":"7","key":"pcbi.1008390.ref024","doi-asserted-by":"crossref","first-page":"e1002598","DOI":"10.1371\/journal.pcbi.1002598","article-title":"A quick guide to software licensing for the scientist-programmer","volume":"8","author":"A Morin","year":"2012","journal-title":"PLoS Comput Biol"},{"key":"pcbi.1008390.ref025","unstructured":"Contribute to NumPy\u2014NumPy; 2020. Available from: https:\/\/numpy.org\/contribute\/."},{"key":"pcbi.1008390.ref026","unstructured":"Contribution guide\u2014Penn Machine Learning Benchmarks; 2020. Available from: https:\/\/epistasislab.github.io\/penn-ml-benchmarks\/contributing.html."},{"key":"pcbi.1008390.ref027","unstructured":"Developer\u2019s Guide\u2014Scikit-Learn documentation; 2020. Available from: https:\/\/scikit-learn.org\/stable\/developers\/index.html."},{"issue":"1","key":"pcbi.1008390.ref028","doi-asserted-by":"crossref","first-page":"69","DOI":"10.1002\/bmb.2003.494031010165","article-title":"\u201cLink rot\u201d limits the usefulness of web-based educational materials in biochemistry and molecular biology","volume":"31","author":"J Markwell","year":"2003","journal-title":"Biochem Mol Biol Educ"},{"key":"pcbi.1008390.ref029","first-page":"S5","volume-title":"BMC bioinformatics","author":"J Hennessey","year":"2013"},{"key":"pcbi.1008390.ref030","doi-asserted-by":"crossref","unstructured":"Haugset B, Hanssen GK. Automated acceptance testing: A literature review and an industrial case study. In: Agile 2008 Conference. IEEE; 2008. p. 27\u201338.","DOI":"10.1109\/Agile.2008.82"},{"key":"pcbi.1008390.ref031","doi-asserted-by":"crossref","unstructured":"Hilton M, Tunnell T, Huang K, Marinov D, Dig D. Usage, costs, and benefits of continuous integration in open-source projects. In: 2016 31st IEEE\/ACM International Conference on Automated Software Engineering (ASE). IEEE; 2016. p. 426\u2013437.","DOI":"10.1145\/2970276.2970358"},{"key":"pcbi.1008390.ref032","doi-asserted-by":"crossref","first-page":"151","DOI":"10.1007\/978-3-030-05318-5_8","volume-title":"Automated machine learning","author":"RS Olson","year":"2019"},{"issue":"1","key":"pcbi.1008390.ref033","doi-asserted-by":"crossref","first-page":"250","DOI":"10.1093\/bioinformatics\/btz470","article-title":"Scaling tree-based automated machine learning to biomedical big data with a feature set selector","volume":"36","author":"TT Le","year":"2020","journal-title":"Bioinformatics"},{"key":"pcbi.1008390.ref034","unstructured":"Romano JD, Le TT, Fu W, Moore JH. Is deep learning necessary for simple classification tasks? arXiv preprint arXiv:200606730. 2020."},{"journal-title":"Ten simple rules for getting started on Twitter as a scientist","year":"2020","author":"V Cheplygina","key":"pcbi.1008390.ref035"},{"issue":"5","key":"pcbi.1008390.ref036","doi-asserted-by":"crossref","first-page":"549","DOI":"10.1016\/j.annemergmed.2015.04.022","article-title":"The altmetric score: a new measure for article-level dissemination and impact","volume":"66","author":"NS Trueger","year":"2015","journal-title":"Ann Emerg Med"},{"issue":"2","key":"pcbi.1008390.ref037","first-page":"176","article-title":"Academic Search Engine Optimization (aseo) Optimizing Scholarly Literature for Google Scholar & Co","volume":"41","author":"J Beel","year":"2010","journal-title":"J Sch Publ"},{"issue":"2","key":"pcbi.1008390.ref038","doi-asserted-by":"crossref","first-page":"574","DOI":"10.1016\/j.joi.2019.03.005","article-title":"Research software citation in the Data Citation Index: Current practices and implications for research software sharing and reuse","volume":"13","author":"H Park","year":"2019","journal-title":"J Informet"},{"issue":"2","key":"pcbi.1008390.ref039","doi-asserted-by":"crossref","first-page":"8","DOI":"10.1109\/MCSE.2019.2952840","article-title":"Software and Dependencies in Research Citation Graphs","volume":"22","author":"S Druskat","year":"2019","journal-title":"Computing in Science & Engineering"}],"container-title":["PLOS Computational Biology"],"original-title":[],"language":"en","link":[{"URL":"https:\/\/dx.plos.org\/10.1371\/journal.pcbi.1008390","content-type":"unspecified","content-version":"vor","intended-application":"similarity-checking"}],"deposited":{"date-parts":[[2020,11,12]],"date-time":"2020-11-12T18:29:01Z","timestamp":1605205741000},"score":1,"resource":{"primary":{"URL":"https:\/\/dx.plos.org\/10.1371\/journal.pcbi.1008390"}},"subtitle":[],"editor":[{"given":"Scott","family":"Markel","sequence":"first","affiliation":[]}],"short-title":[],"issued":{"date-parts":[[2020,11,12]]},"references-count":39,"journal-issue":{"issue":"11","published-online":{"date-parts":[[2020,11,12]]}},"URL":"https:\/\/doi.org\/10.1371\/journal.pcbi.1008390","relation":{},"ISSN":["1553-7358"],"issn-type":[{"type":"electronic","value":"1553-7358"}],"subject":[],"published":{"date-parts":[[2020,11,12]]}}}