Skip to content

Latest commit

 

History

History
118 lines (99 loc) · 7.46 KB

08.methods.md

File metadata and controls

118 lines (99 loc) · 7.46 KB

Methods

Continuous collaborative manuscript drafting

We recognized that deep learning in precision medicine is a rapidly developing area. Hence, diverse expertise was required to provide a forward-looking perspective. Accordingly, we collaboratively wrote this review in the open, enabling anyone with expertise to contribute. We wrote the manuscript in markdown and tracked changes using git. Contributions were handled through GitHub, with individuals submitting "pull requests" to suggest additions to the manuscript. This collaborative writing approach was later generalized into Manubot [@doi:10.1371/journal.pcbi.1007128].

Manubot supports citations of persistent identifiers, such as DOIs, PubMed Central IDs, PubMed IDs, arXiv IDs, and URLs. This reduces one major barrier to writing collaboratively, which is syncing reference managers between participants. In addition, Manubot uses continuous integration to build and deploy manuscripts. This allows for automated error checking of proposed changes to catch malformated citations and invalid syntax. Originally, the Deep Review used Travis CI for continuous integration, but in 2020 switched to GitHub Actions, which became the default for Manubot manuscripts.

For version 1.0 of the Deep Review, author order was randomized as described in [version 1.0] [@tag:techblog-perkel]. However, this was a one-time manual process. Starting with version 2.0, we began shuffling authors for every manuscript version. Manubot allowed us to automate this process, using the Git commit hash as a random seed to ensure reproducible ordering.

Author contributions

Version 2.0

We continued using the open repository on the GitHub version control platform (greenelab/deep-review) [@url:https://github.com/greenelab/deep-review], which was established to write the version 1.0 manuscript. {% for v2, authors in manubot.authors|groupby('v2') %} {% if v2|length %}{{ v2 }}: {% for author in authors %}{{author.name }}{% if not loop.last %}, {% endif %}{% endfor %}. {% endif %} {% endfor %}

Version 2.0 competing interests

|Author|Competing Interests|Last Reviewed| |---|---|---|{% for author in manubot.authors %} |{{author.name}}|{{author.coi.string}}|{{author.coi.lastapproved}}|{% endfor %}

Version 2.0 funding statement

We acknowledge funding from the Gordon and Betty Moore Foundation award GBMF4552 (C.S.G. and D.S.H.); the National Institutes of Health awards R01HG010067 (C.S.G. and D.S.H.), R01CA237170 (C.S.G), T32LM012204 (A.J.T.), R01CA216265 (B.C.C.); the Burroughs Wellcome Fund Big Data in the Life Sciences training grant at Dartmouth (J.L.L,); and the Dartmouth College Neukom Institute for Computational Science CompX award (B.C.C.).

Version 1.0

We created an open repository on the GitHub version control platform (greenelab/deep-review) [@url:https://github.com/greenelab/deep-review]. Here, we engaged with numerous authors from papers within and outside of the area. The manuscript was drafted via GitHub commits by individuals who met the ICMJE standards of authorship. These were individuals who contributed to the review of the literature; drafted the manuscript or provided substantial critical revisions; approved the final manuscript draft; and agreed to be accountable in all aspects of the work. Individuals who did not contribute in all of these ways, but who did participate, are acknowledged below. We grouped authors into the following four classes of approximately equal contributions and randomly ordered authors within each contribution class. Drafted multiple sub-sections along with extensive editing, pull request reviews, or discussion: Travers Ching, Brett K. Beaulieu-Jones, Alexandr A. Kalinin, Brian T. Do, Gregory P. Way, Enrico Ferrero, Paul-Michael Agapow, Michael Zietz, Michael M. Hoffman. Edited the manuscript, reviewed pull requests, and developed Manubot: Daniel S. Himmelstein. Drafted one or more sub-sections: Wei Xie, Gail L. Rosen, Benjamin J. Lengerich, Johnny Israeli, Jack Lanchantin, Stephen Woloszynek, Anne E. Carpenter, Avanti Shrikumar, Jinbo Xu, Evan M. Cofer, Christopher A. Lavender, Srinivas C. Turaga, Amr M. Alexandari, Zhiyong Lu. Drafted sub-sections, edited the manuscript, reviewed pull requests, and coordinated co-authors: Anthony Gitter, Casey S. Greene. Revised specific sub-sections or supervised drafting one or more sub-sections: David J. Harris, Dave DeCaprio, Yanjun Qi, Anshul Kundaje, Yifan Peng, Laura K. Wiley, Marwin H.S. Segler, Simina M. Boca, S. Joshua Swamidass, Austin Huang.

Version 1.0 competing interests
Author Competing Interests Last Reviewed
Travers Ching None 2017-05-26
Daniel S. Himmelstein None 2017-05-26
Brett K. Beaulieu-Jones None 2017-05-26
Alexandr A. Kalinin None 2017-05-26
Brian T. Do None 2017-05-26
Gregory P. Way None 2017-05-26
Enrico Ferrero Full-time employee of GlaxoSmithKline. 2017-05-26
Paul-Michael Agapow None 2017-05-26
Michael Zietz None 2017-05-26
Michael M. Hoffman None 2017-05-26
Wei Xie None 2017-05-26
Gail L. Rosen None 2017-05-26
Benjamin J. Lengerich None 2017-05-26
Johnny Israeli None 2017-05-26
Jack Lanchantin None 2017-05-26
Stephen Woloszynek None 2017-05-26
Anne E. Carpenter None 2017-05-26
Avanti Shrikumar None 2017-05-26
Jinbo Xu None 2017-05-26
Evan M. Cofer None 2017-05-26
Christopher A. Lavender None 2017-05-26
Srinivas C. Turaga None 2017-05-26
Amr M. Alexandari None 2017-05-26
Zhiyong Lu None 2017-05-26
David J. Harris None 2017-05-26
Dave DeCaprio None 2017-05-26
Yanjun Qi None 2017-05-26
Anshul Kundaje Advisory Board of Deep Genomics Inc. 2017-05-26
Yifan Peng None 2017-05-26
Laura K. Wiley None 2017-05-26
Marwin H.S. Segler None 2017-05-26
Simina M. Boca None 2017-05-26
S. Joshua Swamidass None 2017-05-26
Austin Huang None 2017-05-26
Anthony Gitter None 2017-05-26
Casey S. Greene None 2017-05-26
Version 1.0 funding statement

We acknowledge funding from the Gordon and Betty Moore Foundation awards GBMF4552 (C.S.G. and D.S.H.) and GBMF4563 (D.J.H.); the Howard Hughes Medical Institute (S.C.T.); the National Institutes of Health awards DP2GM123485 (A.K.), P30CA051008 (S.M.B.), R01AI116794 (B.K.B.), R01GM089652 (A.E.C.), R01GM089753 (J.X.), R01LM012222 (S.J.S.), R01LM012482 (S.J.S.), R21CA220398 (S.M.B.), T32GM007753 (B.T.D.), T32HG000046 (G.P.W.), and U54AI117924 (A.G.); the National Institutes of Health Intramural Research Program and National Library of Medicine (Y.P. and Z.L.); the National Science Foundation awards 1245632 (G.L.R.), 1531594 (E.M.C.), and 1564955 (J.X.); the Natural Sciences and Engineering Research Council of Canada award RGPIN-2015-3948 (M.M.H.); and the Roy and Diana Vagelos Scholars Program in the Molecular Life Sciences (M.Z.).

Acknowledgements

We gratefully acknowledge Christof Angermueller, Kumardeep Chaudhary, Gökcen Eraslan, Mikael Huss, Bharath Ramsundar and Xun Zhu for their discussion of the manuscript and reviewed papers on GitHub. We would like to thank Aaron Sheldon, who contributed text but did not formally approve the manuscript. We would like to thank Anna Greene for a careful proofreading of the manuscript in advance of the first submission. We would like to thank Sebastian Raschka for clarifying edits to the abstract and introduction. We would like to thank Robert Gieseke, Ruibang Luo, Stephen Ra, Sourav Singh, and GitHub user snikumbh for correcting typos, formatting, and references.